1. openclaw status
2. openclaw gateway status
3. openclaw logs --follow
4. openclaw doctor
5. openclaw channels status --probe

これらの出力を確認することで、問題がゲートウェイ自体にあるのか、特定のチャンネルの設定なのか、あるいはネットワークレベルなのかを初めて正しく切り分けられます。

健全な状態の「基準値」を知る

コマンドを実行した結果、システムが正常かどうかの判断基準（ベースライン）は以下のとおりです。

• openclaw gateway status が Runtime: running, Connectivity probe: ok を表示し、Capability: ... の行が存在すること。
• openclaw channels status --probe が、チャンネルのトランスポート（通信経路）が接続状態であることを示し、対応環境では works または audit ok と表示されること。
• openclaw doctor が、動作を妨げる重大な設定ミスやサービスの問題を報告しないこと。

これらの状態が確認できて初めて、「システムは動いている」と言えます。

Telegramボットの場合、どこを見るべきか

Telegramは特に設定項目が多く、よくある「ボットはオンラインだが、グループで反応しない」といった問題も発生しやすいチャンネルです。OpenClawのドキュメントと実際の障害報告から、以下の典型的な障害パターンと調査ポイントが明らかになっています。

• ボットがグループ内で沈黙する場合: openclaw gateway statusで起動は確認できるのに、メッセージに反応しない。この場合、ボットのプライバシーモードと、グループ内でのメンション要求設定を確認します。
• ネットワークエラーで送信失敗する場合: Telegram APIへの通信が失敗している可能性があります。ログ(openclaw logs --follow)に network errors や polling stall が記録されていないか監視し、api.telegram.org へのDNS解決、IPv6の有効性、プロキシ経路を疑い、必要に応じて autoSelectFamily の設定変更を検討します。
• 起動時に getMe returned 401 エラーが出る場合: これはBotFatherで取得したトークンが無効か、期限切れであることを示す、明確なサインです。設定ファイルの botToken、tokenFile、環境変数 TELEGRAM_BOT_TOKEN のいずれかに正しい値がセットされているか再確認します。
• メッセージ受信が途絶える/再接続が遅い: GatewayのCPU使用率が異常に高い（CPUスピン）場合、Telegramの応答が遅延し、一見ゲートウェイが止まっているように見えることがあります。これについても、まずopenclaw logs --follow でGatewayのログに異常がないか継続的に監視することが調査の起点です。

結論：推測を排除し、出力に基づいて判断する

「おそらくネットワークの問題だ」「トークンが間違っているはずだ」と、診断結果が出る前に原因を決めつけることは、問題解決において最も避けるべき行為です。これはまさに、根拠なく話を進めてしまった失敗のケースに他なりません。

正しい手順はただ一つ、上記5つのコマンドの出力を最初に取得することです。その結果を基にして初めて、不具合の原因がGateway、トークン、プラグイン、あるいはネットワークのどこにあるのかを断定できます。これが開発者としてプロフェッショナルな問題解決の姿勢です。

1. openclaw status
2. openclaw gateway status
3. openclaw logs --follow
4. openclaw doctor
5. openclaw channels status --probe

これらの出力を確認することで、問題がゲートウェイ自体にあるのか、特定のチャンネルの設定なのか、あるいはネットワークレベルなのかを初めて正しく切り分けられます。

健全な状態の「基準値」を知る

コマンドを実行した結果、システムが正常かどうかの判断基準（ベースライン）は以下のとおりです。

• openclaw gateway status が Runtime: running, Connectivity probe: ok を表示し、Capability: ... の行が存在すること。
• openclaw channels status --probe が、チャンネルのトランスポート（通信経路）が接続状態であることを示し、対応環境では works または audit ok と表示されること。
• openclaw doctor が、動作を妨げる重大な設定ミスやサービスの問題を報告しないこと。

これらの状態が確認できて初めて、「システムは動いている」と言えます。

Telegramボットの場合、どこを見るべきか

Telegramは特に設定項目が多く、よくある「ボットはオンラインだが、グループで反応しない」といった問題も発生しやすいチャンネルです。OpenClawのドキュメントと実際の障害報告から、以下の典型的な障害パターンと調査ポイントが明らかになっています。

• ボットがグループ内で沈黙する場合: openclaw gateway statusで起動は確認できるのに、メッセージに反応しない。この場合、ボットのプライバシーモードと、グループ内でのメンション要求設定を確認します。
• ネットワークエラーで送信失敗する場合: Telegram APIへの通信が失敗している可能性があります。ログ(openclaw logs --follow)に network errors や polling stall が記録されていないか監視し、api.telegram.org へのDNS解決、IPv6の有効性、プロキシ経路を疑い、必要に応じて autoSelectFamily の設定変更を検討します。
• 起動時に getMe returned 401 エラーが出る場合: これはBotFatherで取得したトークンが無効か、期限切れであることを示す、明確なサインです。設定ファイルの botToken、tokenFile、環境変数 TELEGRAM_BOT_TOKEN のいずれかに正しい値がセットされているか再確認します。
• メッセージ受信が途絶える/再接続が遅い: GatewayのCPU使用率が異常に高い（CPUスピン）場合、Telegramの応答が遅延し、一見ゲートウェイが止まっているように見えることがあります。これについても、まずopenclaw logs --follow でGatewayのログに異常がないか継続的に監視することが調査の起点です。

結論：推測を排除し、出力に基づいて判断する

「おそらくネットワークの問題だ」「トークンが間違っているはずだ」と、診断結果が出る前に原因を決めつけることは、問題解決において最も避けるべき行為です。これはまさに、根拠なく話を進めてしまった失敗のケースに他なりません。

正しい手順はただ一つ、上記5つのコマンドの出力を最初に取得することです。その結果を基にして初めて、不具合の原因がGateway、トークン、プラグイン、あるいはネットワークのどこにあるのかを断定できます。これが開発者としてプロフェッショナルな問題解決の姿勢です。