Fehlerbehebung

Beginnen Sie hier, wenn etwas nicht funktioniert. Folgen Sie den Schritten der Reihe nach.

Erste Schritte

1. Pruefen Sie, ob der Daemon laeuft

triggerfish status

Wenn der Daemon nicht laeuft, starten Sie ihn:

triggerfish start

2. Pruefen Sie die Logs

triggerfish logs

Dies zeigt die Log-Datei in Echtzeit an. Verwenden Sie einen Level-Filter, um das Rauschen zu reduzieren:

triggerfish logs --level ERROR
triggerfish logs --level WARN

3. Diagnose ausfuehren

triggerfish patrol

Patrol prueft, ob das Gateway erreichbar ist, der LLM-Provider antwortet, Kanaele verbunden sind, Policy-Regeln geladen sind und Skills erkannt wurden. Jede Pruefung, die als CRITICAL oder WARNING markiert ist, zeigt Ihnen, wo Sie sich konzentrieren sollten.

4. Konfiguration validieren

triggerfish config validate

Dies parst triggerfish.yaml, prueft erforderliche Felder, validiert Klassifizierungsstufen und loest Secret-Referenzen auf.

Fehlerbehebung nach Bereich

Wenn die obigen ersten Schritte nicht auf das Problem hingewiesen haben, waehlen Sie den Bereich, der zu Ihren Symptomen passt:

• Installation - Installationsskript-Fehler, Build-aus-Quellcode-Probleme, Plattformprobleme
• Daemon - Dienst startet nicht, Port-Konflikte, "already running"-Fehler
• Konfiguration - YAML-Parse-Fehler, fehlende Felder, Secret-Aufloesungsfehler
• Kanaele - Bot antwortet nicht, Authentifizierungsfehler, Nachrichtenzustellungsprobleme
• LLM-Provider - API-Fehler, Modell nicht gefunden, Streaming-Fehler
• Integrationen - Google OAuth, GitHub PAT, Notion API, CalDAV, MCP-Server
• Browser-Automatisierung - Chrome nicht gefunden, Startfehler, Navigation blockiert
• Sicherheit & Klassifizierung - Write-Down-Blockierungen, Taint-Probleme, SSRF, Policy-Ablehnungen
• Secrets & Anmeldedaten - Schluesselbund-Fehler, verschluesselter Dateispeicher, Berechtigungsprobleme

Immer noch nicht weiter?

Wenn keiner der obigen Leitfaeden Ihr Problem geloest hat:

1. Sammeln Sie ein Log-Bundle
2. Lesen Sie die Anleitung zum Erstellen von Issues
3. Erstellen Sie ein Issue auf GitHub