OpenClaw Doctorコマンド：すべてのフラグと修正の完全ガイド [2026]

openclaw doctorコマンドは、何か問題が起きた時の最初の防衛線です。問題を診断し、何が壊れているか説明し、ほとんどの問題を自動修正できます。

基本的な使い方

# 問題を診断（読み取り専用）
openclaw doctor

# 診断と自動修正
openclaw doctor --fix

doctorは一連のヘルスチェックを実行し、結果をOK、WARN、FAILとして報告します。

Doctorがチェックする項目

1. ゲートウェイ設定

gateway.modeが設定されていて有効かチェックします。

FAIL  gateway.mode is unset — gateway start will be blocked
FIX:  openclaw config set gateway.mode local

--fixでの自動修正： gateway.modeをlocalに設定します。

2. デバイストークンミスマッチ

デバイストークンがゲートウェイの期待するトークンと一致するかチェックします。

FAIL  device token mismatch — stored token doesn't match gateway
FIX:  regenerating device token

--fixでの自動修正： 一致するトークンを再生成し、デバイスを再ペアリングします。

3. 不明な設定キー

openclaw.json内の認識されないキーをチェックします。

WARN  unknown config key: "model" (did you mean "ai.model"?)
WARN  unknown config key: "telegramToken" (did you mean "telegram.token"?)

--fixでの自動修正： 認識されないキーを削除するか、正しい名前に移行します。

4. 設定バリデーション

無効な値、必須フィールドの欠落、不正なJSONをチェックします。

FAIL  config validation failed: "gateway.port" must be a number

--fixでの自動修正： 型の不一致を修正し、欠落しているフィールドにデフォルト値を設定します。

5. ペアリングステータス

Telegramやその他の統合が正しくペアリングされているかチェックします。

WARN  pairing required — Telegram bot is configured but not paired
FIX:  openclaw pairing approve telegram CODE

--fixでの自動修正： ペアリングフローを開始し、承認コマンドを提供します。

6. ディレクトリ権限

OpenClawのデータディレクトリが存在し、書き込み可能かチェックします。

FAIL  data directory not writable: /app/data
FIX:  fixing permissions

7. ポートの空き状況

設定されたゲートウェイポートが利用可能かチェックします。

FAIL  port 3001 is already in use by process 12345
FIX:  kill the process or change gateway.port

8. Node.jsバージョン

Node.jsバージョンが最低要件（22以上）を満たしているかチェックします。

FAIL  Node.js 18.x detected — OpenClaw requires Node.js 22+

便利なフラグ

--fix

検出されたすべての問題を自動修正します：

openclaw doctor --fix

複数回実行しても安全です。すでに正しいものは変更しません。

--generate-gateway-token

新しいゲートウェイトークンを生成します（device token mismatch後に便利）：

openclaw doctor --generate-gateway-token

--verbose

詳細な診断出力を表示します：

openclaw doctor --verbose

--json

結果をJSONとして出力します（スクリプト用に便利）：

openclaw doctor --json

よくあるシナリオ

新規インストール後

openclaw doctor --fix

ゲートウェイモードを設定し、ディレクトリをセットアップし、初期設定を検証します。

アップグレード後

openclaw doctor --fix

非推奨の設定キーを移行し、アップグレードによる破壊的変更を修正します。

コンテナ再構築後

docker exec -it CONTAINER_ID openclaw doctor --fix

再構築で失われたトークンを再生成し、デバイスを再ペアリングします。

他に何も効かない時

openclaw doctor --fix --verbose

verboseフラグは何がチェックされ修正されているか正確に表示し、doctorが自動修復できない問題を特定するのに役立ちます。

Doctorが修正できないもの

一部の問題は手動介入が必要です：

• 間違ったAPIキー：DoctorはAIプロバイダーの認証情報を検証できません
• ネットワークの問題：ファイアウォールルール、DNS、ISPのブロック
• リバースプロキシの設定ミス：Caddy/Nginxの設定はOpenClawのスコープ外
• Telegramボットの競合：同じボットトークンをポーリングする別のプロセス

これらについては、openclaw logs --followで具体的なエラーメッセージを確認してください。

Doctorを定期的に実行する

openclaw doctorをメンテナンスルーチンに追加しましょう — 特にアップデート後に。設定のドリフトを問題が発生する前にキャッチします。

事前設定済み、Doctor不要

ClawTankはOpenClawの設定を自動的に管理します。doctorの実行は不要 — ゲートウェイトークン、設定バリデーション、ペアリングはプラットフォームが処理します。