設定

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

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

コマンドラダー

まず以下の順序で実行してください:

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

正常なベースライン:

  • Runtime: running
  • RPC probe: ok
  • チャネルプローブが connected/ready を示す

WhatsApp

WhatsApp 障害の特徴

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

完全なトラブルシューティング: /channels/whatsapp#troubleshooting-quick

Telegram

Telegram 障害の特徴

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

完全なトラブルシューティング: /channels/telegram#troubleshooting

Discord

Discord 障害の特徴

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

完全なトラブルシューティング: /channels/discord#troubleshooting

Slack

Slack 障害の特徴

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

完全なトラブルシューティング: /channels/slack#troubleshooting

iMessage と BlueBubbles

iMessage と BlueBubbles 障害の特徴

症状最速の確認方法修正方法
受信イベントがないWebhook/サーバーの到達性とアプリの権限を確認Webhook URLまたはBlueBubblesサーバーの状態を修正します。
送信はできるがmacOSで受信できないMessages自動化のための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

Matrix

Matrix 障害の特徴

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

完全なトラブルシューティング: /channels/matrix#troubleshooting

チャネルロケーションパーシング