Configuration

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

チャネルは接続できるが動作が間違っている場合は、このページを使用します。

コマンド手順

まず、次を順番に実行します。

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

正常なベースライン:

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

更新後

Telegram、iMessage、BlueBubbles 時代の設定、または別の Plugin チャネルが更新後に消える場合に使用します。

bash

openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --all

openclaw status --all で plugin load failed: dependency tree corrupted; run openclaw doctor --fix を探します。これはチャネルは設定されているが、 Plugin のセットアップ/ロードパスがチャネル登録ではなく破損した依存関係ツリーに到達したことを意味します。openclaw doctor --fix は古い Plugin 依存関係のステージングディレクトリと古い認証シャドウを削除し、その後 openclaw gateway restart がクリーンな状態を再読み込みします。

WhatsApp の失敗シグネチャ

症状	最速の確認	修正
接続済みだが DM 返信がない	`openclaw pairing list whatsapp`	送信者を承認するか、DM ポリシー/許可リストを切り替えます。
グループメッセージが無視される	設定内の `requireMention` とメンションパターンを確認	ボットにメンションするか、そのグループのメンションポリシーを緩和します。
QR ログインが 408 でタイムアウトする	Gateway の `HTTPS_PROXY` / `HTTP_PROXY` env を確認	到達可能なプロキシを設定します。`NO_PROXY` はバイパスにのみ使用します。
ランダムな切断/再ログインループ	`openclaw channels status --probe` + ログ	現在接続中でも最近の再接続はフラグされます。ログを監視し、Gateway を再起動して、それでも不安定なら再リンクします。
`status=408 Request Time-out` ループ	プローブ、ログ、doctor、その後 Gateway ステータス	まずホストの接続性/タイミングを修正します。ループが続く場合は認証をバックアップしてアカウントを再リンクします。
返信が数秒/数分遅れて届く	`openclaw doctor --fix`	doctor は、Gateway イベントループを劣化させていることが確認された古いローカル TUI クライアントを停止します。

完全なトラブルシューティング: WhatsApp のトラブルシューティング

Telegram の失敗シグネチャ

症状	最速の確認	修正
`/start` しても利用可能な返信フローがない	`openclaw pairing list telegram`	ペアリングを承認するか、DM ポリシーを変更します。
ボットはオンラインだがグループが沈黙する	メンション要件とボットのプライバシーモードを確認	グループでの可視性のためにプライバシーモードを無効にするか、ボットにメンションします。
ネットワークエラーで送信に失敗する	Telegram API 呼び出し失敗のログを調査	`api.telegram.org` への DNS/IPv6/プロキシルーティングを修正します。
起動時に `getMe returned 401` と報告される	設定されたトークンソースを確認	BotFather トークンを再コピーまたは再生成し、`botToken`、`tokenFile`、またはデフォルトアカウントの `TELEGRAM_BOT_TOKEN` を更新します。
ポーリングが停止する、または再接続が遅い	ポーリング診断のために `openclaw logs --follow`	アップグレードします。再起動が偽陽性なら、`pollingStallThresholdMs` を調整します。持続的な停止は引き続きプロキシ/DNS/IPv6 を示します。
起動時に `setMyCommands` が拒否される	`BOT_COMMANDS_TOO_MUCH` のログを調査	Plugin/skill/カスタム Telegram コマンドを減らすか、ネイティブメニューを無効にします。
アップグレード後に許可リストでブロックされる	`openclaw security audit` と設定の許可リスト	`openclaw doctor --fix` を実行するか、`@username` を数値の送信者 ID に置き換えます。

完全なトラブルシューティング: Telegram のトラブルシューティング

Discord

Discord の失敗シグネチャ

症状	最速の確認	修正
ボットはオンラインだが guild 返信がない	`openclaw channels status --probe`	guild/チャネルを許可し、メッセージ内容 intent を確認します。
グループメッセージが無視される	メンションゲートによるドロップのログを確認	ボットにメンションするか、guild/チャネルの `requireMention: false` を設定します。
タイピング/トークン使用はあるが Discord メッセージがない	これが ambient ルームイベントなのか、モデルが `message(action=send)` を逃したオプトイン済み `message_tool` ルームなのかを確認	Gateway の詳細ログで抑制された最終ペイロードメタデータを調査し、`messages.groupChat.unmentionedInbound` を確認し、Ambient ルームイベントを読むか、通常のグループリクエストでは `messages.groupChat.visibleReplies: "automatic"` を維持します。
DM 返信がない	`openclaw pairing list discord`	DM ペアリングを承認するか、DM ポリシーを調整します。

完全なトラブルシューティング: Discord のトラブルシューティング

Slack

Slack の失敗シグネチャ

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

完全なトラブルシューティング: Slack のトラブルシューティング

iMessage

iMessage の失敗シグネチャ

症状	最速の確認	修正
`imsg` がない、または非 macOS で失敗する	`openclaw channels status --probe --channel imessage`	Messages の Mac で OpenClaw を実行するか、`cliPath` に SSH ラッパーを使用します。
macOS で送信できるが受信できない	Messages 自動化の macOS プライバシー権限を確認	TCC 権限を再付与し、チャネルプロセスを再起動します。
DM 送信者がブロックされる	`openclaw pairing list imessage`	ペアリングを承認するか、許可リストを更新します。

完全なトラブルシューティング:

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

Signal

Signal の失敗シグネチャ

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

完全なトラブルシューティング: Signal のトラブルシューティング

QQ Bot

QQ Bot の失敗シグネチャ

症状	最速の確認	修正
ボットが「火星へ行きました」と返信する	設定の `appId` と `clientSecret` を確認	認証情報を設定するか、Gateway を再起動します。
受信メッセージがない	`openclaw channels status --probe`	QQ Open Platform の認証情報を確認します。
音声が文字起こしされない	STT provider 設定を確認	`channels.qqbot.stt` または `tools.media.audio` を設定します。
プロアクティブメッセージが届かない	QQ プラットフォームのインタラクション要件を確認	QQ は最近のインタラクションがないボット発信メッセージをブロックする場合があります。

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

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` を実行するか、リカバリキーを使って再実行する。
クロス署名/bootstrap が正しく見えない	`openclaw matrix verify bootstrap`	シークレットストレージ、クロス署名、バックアップ状態を一度に修復する。

完全なセットアップと設定: Matrix