チャンネルトラブルシューティング
チャンネルは接続しているのに動作がおかしい場合は、このページを使用してください。コマンドの手順
まず、次の順番で実行してください。Runtime: runningConnectivity probe: okCapability: read-only、write-capable、またはadmin-capable- チャンネルプローブでトランスポートが接続済みと表示され、サポートされている場合は
worksまたはaudit okが表示される
WhatsAppの障害シグネチャ
| 症状 | 最速の確認方法 | 修正 |
|---|---|---|
| 接続済みだがDMに返信しない | openclaw pairing list whatsapp | 送信者を承認するか、DMポリシー/許可リストを変更します。 |
| グループメッセージが無視される | 設定内のrequireMentionとメンションパターンを確認 | botにメンションするか、そのグループのメンションポリシーを緩めます。 |
| ランダムに切断/再ログインを繰り返す | openclaw channels status --probe + ログ | 再ログインし、認証情報ディレクトリが正常か確認します。 |
Telegram
Telegramの障害シグネチャ
| 症状 | 最速の確認方法 | 修正 |
|---|---|---|
/startは動くが実際に使える返信フローがない | openclaw pairing list telegram | ペアリングを承認するか、DMポリシーを変更します。 |
| botはオンラインだがグループでは無反応 | メンション必須設定とbotのプライバシーモードを確認 | グループで見えるようにプライバシーモードを無効にするか、botにメンションします。 |
| ネットワークエラーで送信に失敗する | Telegram API呼び出し失敗のログを確認 | api.telegram.orgへのDNS/IPv6/プロキシ経路を修正します。 |
| ポーリングが停止する、または再接続が遅い | openclaw logs --followでポーリング診断を確認 | アップグレードしてください。再起動が誤検知ならpollingStallThresholdMsを調整します。継続的な停止は依然としてプロキシ/DNS/IPv6が原因です。 |
起動時にsetMyCommandsが拒否される | BOT_COMMANDS_TOO_MUCHのログを確認 | Plugin/Skills/カスタムTelegramコマンドを減らすか、ネイティブメニューを無効にします。 |
| アップグレード後に許可リストでブロックされる | openclaw security auditと設定の許可リストを確認 | openclaw doctor --fixを実行するか、@usernameを数値の送信者IDに置き換えます。 |
Discord
Discordの障害シグネチャ
| 症状 | 最速の確認方法 | 修正 |
|---|---|---|
| botはオンラインだがguildで返信しない | openclaw channels status --probe | guild/channelを許可し、message content intentを確認します。 |
| グループメッセージが無視される | メンションゲーティングによるドロップのログを確認 | botにメンションするか、guild/channelでrequireMention: falseを設定します。 |
| DM返信がない | openclaw pairing list discord | DMペアリングを承認するか、DMポリシーを調整します。 |
Slack
Slackの障害シグネチャ
| 症状 | 最速の確認方法 | 修正 |
|---|---|---|
| Socket modeは接続済みだが応答しない | openclaw channels status --probe | app tokenとbot token、および必要なスコープを確認します。SecretRefベースの設定ではbotTokenStatus / appTokenStatus = configured_unavailableも確認してください。 |
| DMがブロックされる | openclaw pairing list slack | ペアリングを承認するか、DMポリシーを緩めます。 |
| チャンネルメッセージが無視される | groupPolicyとチャンネル許可リストを確認 | チャンネルを許可するか、ポリシーをopenに変更します。 |
iMessageとBlueBubbles
iMessageとBlueBubblesの障害シグネチャ
| 症状 | 最速の確認方法 | 修正 |
|---|---|---|
| 受信イベントがない | Webhook/サーバー到達性とアプリ権限を確認 | Webhook URLまたはBlueBubblesサーバーの状態を修正します。 |
| 送信できるがmacOSで受信できない | Messages automationに対するmacOSプライバシー権限を確認 | TCC権限を再付与してチャンネルプロセスを再起動します。 |
| DM送信者がブロックされる | openclaw pairing list imessageまたはopenclaw pairing list bluebubbles | ペアリングを承認するか、許可リストを更新します。 |
Signal
Signalの障害シグネチャ
| 症状 | 最速の確認方法 | 修正 |
|---|---|---|
| デーモンには到達できるがbotが無反応 | openclaw channels status --probe | signal-cliデーモンURL/アカウントと受信モードを確認します。 |
| DMがブロックされる | openclaw pairing list signal | 送信者を承認するか、DMポリシーを調整します。 |
| グループ返信がトリガーされない | グループ許可リストとメンションパターンを確認 | 送信者/グループを追加するか、ゲーティングを緩めます。 |
QQ Bot
QQ Botの障害シグネチャ
| 症状 | 最速の確認方法 | 修正 |
|---|---|---|
| Botが「gone to Mars」と返す | 設定内のappIdとclientSecretを確認 | 認証情報を設定するか、Gatewayを再起動します。 |
| 受信メッセージがない | openclaw channels status --probe | QQ Open Platform上の認証情報を確認します。 |
| 音声が文字起こしされない | STT provider設定を確認 | channels.qqbot.sttまたはtools.media.audioを設定します。 |
| プロアクティブメッセージが届かない | QQプラットフォームのインタラクション要件を確認 | 最近のやり取りがないと、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を実行するか、リカバリキーで再実行します。 |
| クロス署名/ブートストラップの状態がおかしい | openclaw matrix verify bootstrap | シークレットストレージ、クロス署名、バックアップ状態を一括で修復します。 |