OpenClaw チャンネル接続トラブル解決ガイド

チャネル接続がうまくいかないとき、原因の切り分けに時間がかかってしまうことは、多くの開発者が経験する悩みです。設定は正しいはずなのにメッセージが届かない、あるいは特定のプラットフォームでだけ挙動がおかしいといったトラブルを、効率的に解決するためのガイドをまとめました。

OpenClaw を使用したチャネルのトラブルシューティングでは、まずシステム全体の健全性を確認することが重要です。このガイドでは、各プラットフォームごとの典型的なエラーパターンと、その解決策を整理しています。

コマンドによる診断手順 (Command ladder)

まずは以下のコマンドを順番に実行し、システムの現在の状態を確認してください。これらは、OpenClaw の接続トラブルを特定するための標準的な診断手順です。

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

正常な状態の基準は以下の通りです：

Runtime: running であること
Connectivity probe: ok であること
Capability: read-only, write-capable, または admin-capable であること
チャネルのプローブ結果でトランスポートが接続されており、サポートされている場合は works または audit ok と表示されること

WhatsApp のトラブルシューティング

WhatsApp 接続で問題が発生した場合、まずはペアリング状況や設定ポリシーを確認しましょう。

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

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

Telegram のトラブルシューティング

OpenClaw Telegram 連携において、API 呼び出しやボットのプライバシー設定が原因で問題が起きることがあります。

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

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

Discord のトラブルシューティング

Discord でボットが反応しない場合、権限やメッセージのインテント設定が影響している可能性があります。

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

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

Slack のトラブルシューティング

Slack の Socket mode 接続では、トークンやスコープの設定が正しく行われているかを確認してください。

症状	最速の確認方法	解決策
Socket mode は接続済みだが応答がない	`openclaw channels status --probe`	アプリトークンとボットトークン、必要なスコープを確認してください。SecretRef を使用している場合は `botTokenStatus` / `appTokenStatus = configured_unavailable` に注意してください。
DMがブロックされる	`openclaw pairing list slack`	ペアリングを承認するか、DMポリシーを緩和してください。
チャネルメッセージが無視される	`groupPolicy` とチャネルの許可リストを確認	チャネルを許可するか、ポリシーを `open` に切り替えてください。

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

iMessage および BlueBubbles のトラブルシューティング

macOS 上での権限設定や、Gateway 経由の通信状態が主なチェックポイントです。

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

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

Signal のトラブルシューティング

Signal では、バックグラウンドで動作するデーモンの状態が鍵となります。

症状	最速の確認方法	解決策
デーモンには到達できるがボットが沈黙	`openclaw channels status --probe`	`signal-cli` デーモンの URL/アカウントと受信モードを確認してください。
DMがブロックされる	`openclaw pairing list signal`	送信者を承認するか、DMポリシーを調整してください。
グループ返信がトリガーされない	グループの許可リストとメンションパターンを確認	送信者/グループを追加するか、制限を緩和してください。

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

QQ Bot のトラブルシューティング

QQ Bot の接続には、認証情報とプラットフォーム側の対話要件が大きく関わります。

症状	最速の確認方法	解決策
ボットが「火星に行った」と返信する	設定内の `appId` と `clientSecret` を確認	認証情報を設定するか、Gateway を再起動してください。
インバウンドメッセージがない	`openclaw channels status --probe`	QQ Open Platform 上の認証情報を確認してください。
音声が文字起こしされない	STT プロバイダーの設定を確認	`channels.qqbot.stt` または `tools.media.audio` を設定してください。
能動的なメッセージが届かない	QQ プラットフォームの対話要件を確認	最近の対話がない場合、ボットが開始するメッセージがブロックされる可能性があります。

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

Matrix のトラブルシューティング

Matrix の暗号化やバックアップ機能に関連するトラブルは、専用の検証コマンドで解決できます。

症状	最速の確認方法	解決策
ログイン済みだがルームメッセージを無視する	`openclaw channels status --probe`	`groupPolicy`、ルームの許可リスト、メンション制限を確認してください。
DMが処理されない	`openclaw pairing list matrix`	送信者を承認するか、DMポリシーを調整してください。
暗号化されたルームで失敗する	`openclaw matrix verify status`	デバイスを再検証し、`openclaw matrix verify backup status` を確認してください。
バックアップの復元が保留中/破損している	`openclaw matrix verify backup status`	`openclaw matrix verify backup restore` を実行するか、リカバリーキーを使用して再実行してください。
クロス署名/ブートストラップの状態がおかしい	`openclaw matrix verify bootstrap`	シークレットストレージ、クロス署名、バックアップ状態を一度に修復してください。

詳細なセットアップと設定: Matrix

さらなるサポートが必要な場合は、AI Setup Assistant をご利用ください。

次のステップ

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。