OpenClawのTelegramボットが応答しない時の自己診断ガイド

OpenClawのTelegramボットが突然沈黙したり、メッセージを送っても返事が来なくなった時の自己診断手順をまとめました。設定ファイルをやみくもに編集する前に、以下の3層チェックを行ってください。

ボットトラブルの3層チェック

OpenClawのドキュメントによると、問題の切り分けには以下の3つの層を理解する必要があります。

• ゲートウェイ・ランタイムの状態: 健全な状態の指標は

  Runtime: running

  かつ

  Connectivity probe: ok

  です。
• Telegramチャンネルの接続状態: チャンネルプローブが transport connected を示し、対応していれば works または

  audit ok

  の表示が必要です。
• Telegramトークンと設定: OpenClawのTelegramは

  openclaw channels login telegram

  というログインフローを使用しません。ボットトークンは設定ファイルまたは環境変数 TELEGRAM_BOT_TOKEN から読み取ります。

ボットが完全に沈黙している場合

以下のいずれか、または複数が原因である可能性が高いです。

• ゲートウェイまたはランタイムが起動していない、もしくはプローブが失敗している。
• Telegramのボットトークンが設定されていない、または誤った値が設定されている。
• Telegramプラグインが正しく読み込まれていない。GitHub上の実際のIssueでも

  telegram plugin not available

  というエラーが報告されています。

接続は確立しているが応答が遅延・停止する場合

調査で確認されている最も可能性の高い原因は、ゲートウェイのランタイム問題です。具体的には、ゲートウェイのCPUスピン（過負荷状態）によってTelegramの応答がストールするというバグレポートが存在します。これはトークン単体の問題ではなく、システム全体のリソース問題である点に注意が必要です。

正しい診断手順

1. ゲートウェイとランタイムの健全性を確認する。まずは診断CLIコマンドを使用し、これらが正常に稼働しているか確認します。設定の変更はその後です。
2. チャンネルプローブでTelegramの接続状態を確認する。Transportが Connected であり、works ステータスが表示されているかをチェックします。
3. 1と2が正常にもかかわらずTelegramが動作しない場合、トークンと設定ファイルを確認する。前述の通り、Telegramはログインフローを使わず、config/envのトークンを直接参照するため、ここに誤りがないか精査します。

4. telegram plugin not available

   のようなエラーが表示された場合は、プラグインや依存関係の問題です。ボットトークンの問題ではないため、OpenClawのプラグイン読み込み状況や doctor コマンドによる修復を試みます。

エビデンスに基づく結論

• OpenClawのTelegramボットは、稼働中のゲートウェイと設定ファイルまたは環境変数で指定された正しいボットトークンに依存しています。

• openclaw channels login telegram

  は使用しません。この点が他のチャンネルと混同しやすいポイントです。
• 迅速な診断のためには、まずランタイム、プローブ、チャンネル状態を確認すべきであり、ユーザーへの追加質問よりも先にシステムステータスを確認します。

診断の確度について

• ランタイム、プローブ、トークンの確認手順は、公式ドキュメントによって明確に裏付けられています。
• 「CPUスピンによるボット応答停止」の問題は、特定のバグレポートで報告されているものです。強力な可能性の一つではありますが、あなたの環境に対して100%保証される結論ではありません。

一言でまとめると: OpenClawのTelegramボットがどこで止まっているかを知るには、まずゲートウェイとランタイムの健全性をプローブで確認し、その後にTelegramトークンの設定（config/env）を確認してください。Telegramチャンネルはログインフローではなく、設定ファイルから直接トークンを読み込むことがキーポイントです。