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

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

チャンネルが接続されているにもかかわらず、動作が正しくない場合にこのページを使用します。

​
コマンドラダー

まずは次の順番で実行してください。 
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/プロキシルーティングを修正します。
アップグレード後に allowlist によってブロックされる場合openclaw security audit と設定 allowlistopenclaw 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 で送信できるが受信できないメッセージ自動化に関する 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