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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

接続はできるものの動作が誤っている場合は、このページを使用してください。

​
コマンドの段階的確認

まず、以下を順番に実行します。 
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 とメンションパターンを確認bot にメンションするか、そのグループのメンションポリシーを緩和します。
QR ログインが 408 でタイムアウトするGateway の HTTPS_PROXY / HTTP_PROXY env を確認到達可能なプロキシを設定します。NO_PROXY はバイパスのみに使用します。
ランダムな切断/再ログインループopenclaw channels status --probe + ログ現在接続済みでも、最近の再接続はフラグ付けされます。ログを監視し、Gateway を再起動してから、揺れが続く場合は再リンクします。
返信が数秒/数分遅れて届くopenclaw doctor --fixDoctor は、Gateway イベントループを劣化させていることが検証済みの古いローカル TUI クライアントを停止します。
詳細なトラブルシューティング: WhatsApp のトラブルシューティング

​
Telegram

​
Telegram の失敗シグネチャ

症状最速の確認方法修正
/start したが利用可能な返信フローがないopenclaw pairing list telegramペアリングを承認するか、DM ポリシーを変更します。
bot はオンラインだがグループが沈黙するメンション要件と bot のプライバシーモードを確認グループの可視性のためにプライバシーモードを無効化するか、bot にメンションします。
ネットワークエラーで送信に失敗する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 の失敗シグネチャ

症状最速の確認方法修正
bot はオンラインだがギルド返信がないopenclaw channels status --probeギルド/チャンネルを許可し、メッセージコンテンツ intent を確認します。
グループメッセージが無視されるメンションゲートによるドロップのログを確認bot にメンションするか、ギルド/チャンネルの requireMention: false を設定します。
入力中/トークン使用はあるが Discord メッセージがないセッションログに didSendViaMessagingTool: false のアシスタントテキストがあるモデルがメッセージツールを呼び出さず、非公開で回答しています。ツール呼び出しの信頼性が高いモデルを使用するか、messages.groupChat.visibleReplies: "automatic" を設定して自動投稿します。
DM 返信がないopenclaw pairing list discordDM ペアリングを承認するか、DM ポリシーを調整します。
詳細なトラブルシューティング: Discord のトラブルシューティング

​
Slack

​
Slack の失敗シグネチャ

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

​
iMessage

​
iMessage の失敗シグネチャ

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

​
Signal

​
Signal の失敗シグネチャ

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

​
QQ Bot

​
QQ Bot の失敗シグネチャ

症状最速の確認方法修正
bot が「gone to Mars」と返信する設定の appId と clientSecret を確認資格情報を設定するか、Gateway を再起動します。
受信メッセージがないopenclaw channels status --probeQQ Open Platform の資格情報を確認します。
音声が文字起こしされないSTT プロバイダー設定を確認channels.qqbot.stt または tools.media.audio を設定します。
プロアクティブメッセージが届かないQQ プラットフォームのインタラクション要件を確認直近のインタラクションがない場合、QQ は bot 起点のメッセージをブロックすることがあります。
詳細なトラブルシューティング: QQ Bot のトラブルシューティング

​
Matrix

​
Matrix の失敗シグネチャ

症状最速の確認方法修正
ログイン済みだがルームメッセージを無視するopenclaw channels status --probegroupPolicy、ルーム許可リスト、メンションゲートを確認します。
DM が処理されないopenclaw pairing list matrix送信者を承認するか、DM ポリシーを調整します。
暗号化ルームが失敗するopenclaw matrix verify statusデバイスを再検証し、その後 openclaw matrix verify backup status を確認します。
バックアップ復元が保留中/壊れているopenclaw matrix verify backup statusopenclaw matrix verify backup restore を実行するか、リカバリーキーで再実行します。
クロス署名/ブートストラップが誤って見えるopenclaw matrix verify bootstrapシークレットストレージ、クロス署名、バックアップ状態を一度に修復します。
完全なセットアップと設定: Matrix

​
関連