チャンネルのトラブルシューティング

チャンネルは接続されているが動作がおかしい場合に、このページをご利用ください。

コマンドの実行手順

まず以下のコマンドを順番に実行してください：

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

正常な状態：

症状	最速の確認方法	修正方法
接続済みだがDMに返信しない	`openclaw pairing list whatsapp`	送信者を承認するか、DMポリシー/許可リストを変更する。
グループメッセージが無視される	設定の`requireMention` + メンションパターンを確認	ボットにメンションするか、グループのメンションポリシーを緩和する。
ランダムな切断/再ログインループ	`openclaw channels status --probe` + ログ	再ログインし、認証情報ディレクトリが正常か確認する。

詳細なトラブルシューティング：/channels/whatsapp#troubleshooting-quick

症状	最速の確認方法	修正方法
`/start`後に応答フローが機能しない	`openclaw pairing list telegram`	ペアリングを承認するか、DMポリシーを変更する。
ボットはオンラインだがグループで無反応	メンション要件とボットのプライバシーモードを確認	グループの可視性のためプライバシーモードを無効にするか、ボットにメンションする。
ネットワークエラーによる送信失敗	ログのTelegram APIコール失敗を確認	`api.telegram.org`へのDNS/IPv6/プロキシルーティングを修正する。
起動時に`setMyCommands`が拒否される	ログの`BOT_COMMANDS_TOO_MUCH`を確認	プラグイン/スキル/カスタムTelegramコマンドを減らすか、ネイティブメニューを無効にする。
アップグレード後に許可リストでブロック	`openclaw security audit`と設定の許可リスト	`openclaw doctor --fix`を実行するか、`@username`を数値の送信者IDに置き換える。

詳細なトラブルシューティング：/channels/telegram#troubleshooting

症状	最速の確認方法	修正方法
ボットはオンラインだがギルドで無反応	`openclaw channels status --probe`	ギルド/チャンネルを許可し、Message Content Intentを確認する。
グループメッセージが無視される	ログのメンションゲーティングドロップを確認	ボットにメンションするか、ギルド/チャンネルで`requireMention: false`を設定する。
DMの返信がない	`openclaw pairing list discord`	DMペアリングを承認するか、DMポリシーを調整する。

詳細なトラブルシューティング：/channels/discord#troubleshooting

症状	最速の確認方法	修正方法
Socket Mode接続済みだが応答なし	`openclaw channels status --probe`	アプリトークン＋ボットトークンと必要なスコープを確認する。
DMがブロックされる	`openclaw pairing list slack`	ペアリングを承認するか、DMポリシーを緩和する。
チャンネルメッセージが無視される	`groupPolicy`とチャンネル許可リストを確認	チャンネルを許可するか、ポリシーを`open`に変更する。

詳細なトラブルシューティング：/channels/slack#troubleshooting

症状	最速の確認方法	修正方法
受信イベントなし	ウェブフック/サーバーの到達性とアプリの権限を確認	ウェブフックURLまたはBlueBubblesサーバーの状態を修正する。
macOSで送信可能だが受信不可	Messagesオートメーションに対するmacOSプライバシー権限を確認	TCC権限を再付与し、チャンネルプロセスを再起動する。
DM送信者がブロックされる	`openclaw pairing list imessage`または`openclaw pairing list bluebubbles`	ペアリングを承認するか、許可リストを更新する。

詳細なトラブルシューティング：

症状	最速の確認方法	修正方法
デーモンに到達可能だがボットが無反応	`openclaw channels status --probe`	`signal-cli`デーモンのURL/アカウントと受信モードを確認する。
DMがブロックされる	`openclaw pairing list signal`	送信者を承認するか、DMポリシーを調整する。
グループの返信がトリガーされない	グループ許可リストとメンションパターンを確認	送信者/グループを追加するか、ゲーティングを緩和する。

詳細なトラブルシューティング：/channels/signal#troubleshooting

症状	最速の確認方法	修正方法
ログイン済みだがルームメッセージを無視	`openclaw channels status --probe`	`groupPolicy`とルーム許可リストを確認する。
DMが処理されない	`openclaw pairing list matrix`	送信者を承認するか、DMポリシーを調整する。
暗号化ルームで失敗	暗号化モジュールと暗号化設定を確認	暗号化サポートを有効にし、ルームを再参加/同期する。

詳細なトラブルシューティング：/channels/matrix#troubleshooting