トラブルシューティング
何か動かない場合はここから始めてください。手順を順番に実行してください。
最初のステップ
1. デーモンが実行中か確認する
bash
triggerfish statusデーモンが実行されていない場合は起動します：
bash
triggerfish start2. ログを確認する
bash
triggerfish logsこれによりリアルタイムでログファイルを追跡します。ノイズを減らすにはレベルフィルターを使用します：
bash
triggerfish logs --level ERROR
triggerfish logs --level WARN3. 診断を実行する
bash
triggerfish patrolPatrolはGatewayに到達可能か、LLMプロバイダーが応答するか、チャンネルが接続されているか、ポリシールールが読み込まれているか、スキルが検出されているかを確認します。CRITICAL または WARNING とマークされたチェックがどこに集中するべきかを示します。
4. 設定を検証する
bash
triggerfish config validateこれにより triggerfish.yaml を解析し、必須フィールドを確認し、分類レベルを検証し、シークレット参照を解決します。
エリア別トラブルシューティング
上記の最初のステップで問題が解決しない場合は、症状に合うエリアを選択してください：
- インストール - インストールスクリプトの失敗、ソースからのビルドの問題、プラットフォームの問題
- デーモン - サービスが起動しない、ポートの競合、「すでに実行中」エラー
- 設定 - YAML解析エラー、フィールドの欠落、シークレット解決の失敗
- チャンネル - ボットが応答しない、認証失敗、メッセージ配信の問題
- LLMプロバイダー - APIエラー、モデルが見つからない、ストリーミング失敗
- インテグレーション - Google OAuth、GitHub PAT、Notion API、CalDAV、MCPサーバー
- ブラウザ自動化 - Chromeが見つからない、起動失敗、ナビゲーションがブロックされる
- セキュリティと分類 - write-downブロック、Taintの問題、SSRF、ポリシー拒否
- シークレットと認証情報 - キーチェーンエラー、暗号化ファイルストア、権限の問題
それでも解決しない場合
上記のガイドで問題が解決しない場合：