Eine Modell-App oder ein Agent braucht einen Schlüssel oder eine Einstellung
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.
Die Karte zeigt
| Die Karte zeigt | Was 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/.envhinzu (nach einem Komma, wenn die Zeile schon da ist), führehermes gateway restartaus 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
| Meldung | Was 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:
- Schalte in der Modell-App das Nachdenken für dieses Modell aus, oder wähle ein Modell, das nicht erst nachdenkt.
- 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.