メインコンテンツへスキップ

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

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

​
コマンドの段階的確認

まず次の順に実行してください。 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
正常なベースライン:
  • Runtime: running
  • RPC probe: ok
  • チャンネルプローブで転送が接続済みと表示され、サポートされる場合はworksまたはaudit okも表示される

​
WhatsApp

​
WhatsAppの障害シグネチャ

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

​
Telegram

​
Telegramの障害シグネチャ

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

​
Discord

​
Discordの障害シグネチャ

症状最速の確認方法修正
ボットはオンラインだがguildで返信しないopenclaw channels status --probeguild/channelを許可し、message content intentを確認する。
グループメッセージが無視されるメンション制御による破棄のログを確認ボットにメンションするか、guild/channelのrequireMention: falseを設定する。
DM返信がないopenclaw pairing list discordDMペアリングを承認するか、DMポリシーを調整する。
完全なトラブルシューティング: /channels/discord#troubleshooting

​
Slack

​
Slackの障害シグネチャ

症状最速の確認方法修正
Socket modeは接続済みだが応答しないopenclaw channels status --probeアプリトークン、ボットトークン、必要なスコープを確認する。SecretRefベースのセットアップではbotTokenStatus / appTokenStatus = configured_unavailableに注意する。
DMがブロックされるopenclaw pairing list slackペアリングを承認するか、DMポリシーを緩和する。
チャンネルメッセージが無視されるgroupPolicyとチャンネル許可リストを確認チャンネルを許可するか、ポリシーをopenに切り替える。
完全なトラブルシューティング: /channels/slack#troubleshooting

​
iMessageとBlueBubbles

​
iMessageとBlueBubblesの障害シグネチャ

症状最速の確認方法修正
受信イベントがないwebhook/サーバー到達性とアプリ権限を確認webhook URLまたはBlueBubblesサーバー状態を修正する。
送信はできるがmacOSで受信できないMessages automationのmacOSプライバシー権限を確認TCC権限を再付与し、チャンネルプロセスを再起動する。
DM送信者がブロックされるopenclaw pairing list imessageまたはopenclaw pairing list bluebubblesペアリングを承認するか、許可リストを更新する。
完全なトラブルシューティング:

​
Signal

​
Signalの障害シグネチャ

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

​
QQ Bot

​
QQ Botの障害シグネチャ

症状最速の確認方法修正
ボットが「gone to Mars」と返信する設定内のappIdとclientSecretを確認認証情報を設定するか、Gatewayを再起動する。
受信メッセージがないopenclaw channels status --probeQQ Open Platformで認証情報を確認する。
音声が文字起こしされないSTTプロバイダー設定を確認channels.qqbot.sttまたはtools.media.audioを設定する。
プロアクティブメッセージが届かないQQプラットフォームのインタラクション要件を確認最近のやり取りがないと、QQがボット主導メッセージをブロックすることがある。
完全なトラブルシューティング: /channels/qqbot#troubleshooting

​
Matrix

​
Matrixの障害シグネチャ

症状最速の確認方法修正
ログイン済みだがルームメッセージを無視するopenclaw channels status --probegroupPolicy、ルーム許可リスト、メンション制御を確認する。
DMが処理されないopenclaw pairing list matrix送信者を承認するか、DMポリシーを調整する。
暗号化ルームが失敗するopenclaw matrix verify statusデバイスを再検証し、その後openclaw matrix verify backup statusを確認する。
バックアップ復元が保留中/壊れているopenclaw matrix verify backup statusopenclaw matrix verify backup restoreを実行するか、リカバリーキーを使って再実行する。
cross-signing/bootstrapが不正に見えるopenclaw matrix verify bootstrapシークレットストレージ、cross-signing、バックアップ状態を一括で修復する。
完全なセットアップと設定: Matrix