OpenClaw Botの不具合を徹底解明：あなたのチャットボットが沈黙する本当の理由と修正手順

「OpenClawが動かない」という漠然とした不具合には、実は明確な診断ルートが存在します。現時点で特定の原因を断定できる証拠は不十分ですが、修正への近道は、公式ドキュメントが定めた「コマンドラダー」を一段ずつ登ることです。

最初に実行すべき5つの診断コマンド

OpenClawが正常に動作しているのか、それとも根本的な問題を抱えているのかを切り分けるには、以下のコマンドを必ずこの順番で実行してください。これが全てのトラブルシューティングの起点となります。

1. openclaw status

2. openclaw gateway status

3. openclaw logs --follow

4. openclaw doctor

5. openclaw channels status --probe

これらの出力から、以下の「健全なベースライン」を満たしているかどうかを確認します。

• Runtime: running

  であること

• Connectivity probe: ok

  であること
• Capability が read-only、write-capable、または admin-capable のいずれかであること
• チャンネルプローブが「トランスポート接続済み」を示し、サポート環境では works または

  audit ok

  と表示されること

Telegram Botが沈黙するときの4大チェックポイント

Telegramチャンネルは、一見正常に接続されていても、以下の設定が原因でメッセージに反応しなくなることがよくあります。

1. グループで完全に無視される：プライバシーモードとメンション設定

Botがオンラインと表示されているにもかかわらず、グループ内のメッセージに一切反応しない場合、最初に疑うべきはTelegramのプライバシーモードです。

• 原因: デフォルトでは、Botは「/」で始まるコマンドや自分へのメンション以外のメッセージを見ることができません。
• 修正方法: BotFatherで /setprivacy コマンドを実行し、プライバシーモードを「無効 (Disable)」に設定します。設定変更後、グループから一度Botを削除し、再度追加することで、変更が確実に適用されます。また、OpenClaw側の設定で requireMention が有効になっていないかも確認してください。

2. 起動直後に「401 Unauthorized」エラー

Botの起動ログに

getMe returned 401

• 修正方法: 設定ファイルの botToken、tokenFile、または環境変数 TELEGRAM_BOT_TOKEN に設定されたトークンが、BotFatherから発行された最新のものと一致しているか確認し、更新してください。

3. ネットワークエラーでメッセージが送信できない

ログにネットワーク関連のエラーが頻出する場合、インフラストラクチャに問題がある可能性が高いです。

• 原因: 特にプロキシ環境やIPv6が有効なネットワークでは、Telegram APIサーバー (api.telegram.org) への到達性に問題が生じることがあります。
• 修正方法: DNS設定、IPv6の無効化、またはプロキシルーティングの見直しを実施し、Telegram APIへの安定した接続を確保してください。

4. 「409 Conflict」でポーリングが停止する

ログに getUpdates に関する「409 Conflict」エラーが表示された場合、これはトークンの競合を示しています。

• 原因: 同一のBotトークンを使用して、別のOpenClawゲートウェイプロセスや外部スクリプトが同時に実行されています。OpenClawのロングポーリングは、1つのトークンにつき1つのプロセスでのみ動作するよう設計されています。
• 修正方法: 同じトークンを使用している他のプロセスをすべて特定し、停止させてください。

アップデート後にBotが壊れた場合の復旧手順

ソフトウェアのアップデート後に動作が不安定になった場合、依存関係の破損が原因である可能性があります。この場合、以下の手順を順に試してください。

1. openclaw status --all

   で全体的な状態を確認します。

2. openclaw doctor --fix

   を実行します。このコマンドは、破損した依存関係ツリーや、古いステージング/認証ファイルをクリーンアップするためにドキュメントで指定されています。

3. openclaw gateway restart

   でゲートウェイを再起動します。
4. 再度

   openclaw status --all

   で正常に復旧したか確認します。

特に、

plugin load failed: dependency tree corrupted

openclaw doctor --fix

Telegramチャンネル設定の正しい流れ

Telegramチャンネルの設定方法にも注意が必要です。OpenClawのTelegram連携は、

openclaw channels login telegram

1. 設定ファイルで

   channels.telegram.enabled: true

   を設定するか、環境変数にトークンを渡します。
2. ゲートウェイを起動します。
3. ダイレクトメッセージ（DM）はデフォルトでペアリングが必要です。

   openclaw pairing list telegram

   で状況を確認し、

   openclaw pairing approve telegram <コード>

   で承認してください。

結論：推測ではなく証拠に基づく修正を

「OpenClawが動かない」という表面的な症状の裏には、実に様々な技術的要因が潜んでいます。原因を推測で決め打ちするのは非効率です。

今すぐ5つの診断コマンドを実行し、システムの状態を示す生の証拠を集めてください。特にTelegramの場合は、以下の4つの観点から問題を切り分けることで、多くの不具合は迅速に解決へと導けます。

• プライバシーとメンション設定
• Botトークン（401エラー）
• ネットワーク接続（DNS/IPv6/Proxy）
• トークン競合（409エラー）