Zum Inhalt springen
DE
Zu Chrome hinzufügen

Eine Modell-App oder ein Agent braucht einen Schlüssel oder eine Einstellung

LösungNeu
Symptom

Eine Karte in Riff Home › Modelle zeigt Needs an API key (API-Schlüssel nötig), Key not accepted (Schlüssel abgelehnt) oder Needs one setting (Eine Einstellung fehlt), oder eine Antwort, ein Beitrag oder ein Chat bricht mit einer Meldung über einen Schlüssel, eine Einstellung oder das Nachdenken ab.

Für alle, deren Modell-App auf einem anderen Rechner oder deren Agent sich nicht verbindet oder nicht antwortet. Für LM Studio oder Ollama auf diesem Rechner siehe auch LM Studio oder Ollama verbindet sich nicht.

API-Schlüssel nötig: auf der Karte einfügen, Schlüssel speichern, und es verbindet sich.

Die Karte zeigt

Die Karte zeigtWas zu tun ist
Needs an API key (API-Schlüssel nötig)Die App will einen Schlüssel. Die Karte zeigt ein Feld: Füge den Schlüssel ein und klicke auf Save key (Schlüssel speichern). In LM Studio findest du Schlüssel unter Developer › Server settings › API tokens. Bei Hermes ist es API_SERVER_KEY in der .env des Agenten
Key not accepted (Schlüssel abgelehnt)Der Schlüssel ist falsch oder wurde in der App geändert. Füge den richtigen ein und klicke auf Save key (Schlüssel speichern)
Needs one setting (Eine Einstellung fehlt)Die App oder der Agent antwortet, lehnt Riff aber ab. Siehe unten
Not found (Nicht gefunden)Riff erreicht die Adresse nicht. Die Karte sagt, was zu prüfen ist: ob die App läuft, im Netzwerk lauscht oder der Tunnel steht Modell-Apps in deinem Netzwerk oder unter einer https-Adresse

Eine Einstellung fehlt

  • LM Studio: Schalte die Server-Option Enable CORS ein und klicke dann auf Connect (Verbinden).
  • Ollama: Erlaube Riff mit OLLAMA_ORIGINS; die Karte zeigt den Befehl LM Studio oder Ollama verbindet sich nicht.
  • Hermes-Agent: Hermes lehnt diese Kopie von Riff ab, bis ihre ID erlaubt ist. Füge die Zeile von der Karte zu ~/.hermes/.env hinzu (nach einem Komma, wenn die Zeile schon da ist), führe hermes gateway restart aus und klicke dann auf Connect (Verbinden) Einen Hermes-Agenten verbinden.
  • Andere (OpenAI-kompatibel): Prüfe ihren API-Schlüssel und ob sie Anfragen von Browsererweiterungen annimmt (CORS).

Eine Meldung statt einer Antwort

MeldungWas zu tun ist
LM Studio wants an API key. Add it in Home › Models. (LM Studio will einen API-Schlüssel. Füge ihn in Home › Modelle hinzu.)Wie Needs an API key (API-Schlüssel nötig) oben
… refused Riff. Check its API key and settings in Home › Models. (… hat Riff abgelehnt. Prüfe API-Schlüssel und Einstellungen in Home › Modelle.)Wie Key not accepted (Schlüssel abgelehnt) oder Needs one setting (Eine Einstellung fehlt) oben
… isn't answering. Is it running? (… antwortet nicht. Läuft es?)Starte die App oder den Tunnel und versuche es noch einmal
… used its whole answer on thinking and wrote nothing. (… hat die ganze Antwort mit Nachdenken verbraucht und nichts geschrieben.)Siehe den nächsten Abschnitt
Hermes refuses this copy of Riff … (Hermes lehnt diese Kopie von Riff ab …)Füge die angezeigte Zeile mit der Erweiterungs-ID hinzu, wie oben
Hermes can't use that session from here … (Hermes kann diese Sitzung von hier aus nicht nutzen …)Die Sitzung wurde in der Hermes-CLI oder einer Messaging-App gestartet. Starte einen neuen Chat Mit deinem Agenten chatten
Hermes is busy with other runs. (Hermes ist mit anderen Aufgaben beschäftigt.)Warte kurz und sende noch einmal

„Ganze Antwort mit Nachdenken verbraucht“

Manche Modelle (Qwen und andere) denken vor der Antwort nach, und das Nachdenken kann alles aufbrauchen, was sie schreiben dürfen. Riff fordert Antworten, Beiträge und das Lesen des Beitrags schon ohne Nachdenken an, und der Chat versucht es einmal ohne. Kommt die Meldung trotzdem:

  1. Schalte in der Modell-App das Nachdenken für dieses Modell aus, oder wähle ein Modell, das nicht erst nachdenkt.
  2. Versuche es noch einmal.

Scheitert das Lesen des Beitrags mit Some models answer the "read the post" step with thinking or tool calls instead. (Manche Modelle beantworten den Schritt „Beitrag lesen“ stattdessen mit Nachdenken oder Tool-Aufrufen.), hilft dasselbe, oder wähle unter Modelle ein anderes Modell für Antworten.

Kommst du mit einem Agenten nicht weiter? Unter der fehlgeschlagenen Antwort kopiert Copy agent log (Agenten-Protokoll kopieren), was Riff und der Agent einander gesagt haben, ohne deinen Schlüssel, zum Mitschicken mit einem Fehlerbericht.