openclaw doctor --fixコマンド完全解説2026：自動診断ツールの全機能と使い方

openclaw doctor [OPTIONS]

オプション一覧:
  --fix              検出した問題を自動修復する（推奨）
  --verbose, -v      詳細な診断情報を表示する
  --json             出力をJSON形式にする（スクリプト用）
  --check <項目>     特定の診断項目のみ実行する
  --skip <項目>      特定の診断項目をスキップする
  --timeout <秒>     各チェックのタイムアウト秒数（デフォルト30）
  --output <ファイル> 診断レポートをファイルに保存する
  --no-color         カラー出力を無効にする（ログ保存用）
  --help, -h         ヘルプを表示する

使用例:
  openclaw doctor                    # 基本診断
  openclaw doctor --fix              # 診断+自動修復
  openclaw doctor --verbose --fix    # 詳細診断+自動修復
  openclaw doctor --check gateway    # Gateway接続のみチェック
  openclaw doctor --json > report.json  # JSON出力をファイルに保存

$ openclaw doctor --fix

OpenClaw Diagnostics Report v1.9.5
====================================
Running 34 checks...

[SYSTEM]
✅ Operating System: macOS Sequoia 15.3 (compatible)
✅ Node.js: v22.14.0 (required: v20+)
✅ npm: 10.9.0 (required: v9+)
✅ pnpm: 9.12.3 (required: v8+)
✅ OpenClaw: v1.9.5 (latest: v1.9.5)
⚠️  Disk space: 4.2GB free (recommended: 10GB+)

[INSTALLATION]
✅ Config directory: ~/.openclaw/ (exists, readable)
✅ Skills directory: ~/.openclaw/skills/ (exists, 12 skills found)
✅ SOUL.md: found (1,247 tokens)
✅ MEMORY.md: found (3,891 tokens)
❌ auth-profiles.json: INVALID JSON syntax at line 47
   Fix: Repairing auth-profiles.json... ✅ Fixed

[GATEWAY]
✅ Gateway process: running (PID: 12847)
✅ Port 18789: listening
✅ Device token: synchronized
⚠️  Gateway version: v1.9.3 (OpenClaw CLI is v1.9.5 - minor mismatch)
   Fix: Updating Gateway... ✅ Fixed

[AI PROVIDERS]
✅ Anthropic Claude: API key valid, rate limit OK
⚠️  OpenAI: API key valid, but quota 87% used
❌ Google Gemini: API key expired (401)
   Fix: Run `openclaw models refresh --provider google`

[CHANNELS]
✅ Discord: bot connected (3 servers)
✅ Telegram: bot active
⚠️  WhatsApp: webhook timeout (>5s response)
❌ iMessage: AppleScript permission denied
   Fix: Grant Automation permissions in System Settings > Privacy

[SKILLS]
✅ 12 skills loaded successfully
❌ virustotal-scan: dependency missing ([email protected] not found)
   Fix: Installing dependencies... ✅ Fixed

Summary: 3 errors found, 3 auto-fixed. 3 warnings. Run with -v for details.

[SYSTEM] セクションの診断項目:

✅ Operating System  - macOS 13+、Windows 10+、Ubuntu 20.04+をチェック
✅ Node.js version   - v20.0.0以上が必要（v22推奨）
✅ npm version       - v9.0.0以上が必要
✅ pnpm version      - v8.0.0以上が必要（pnpmインストール使用時）
✅ OpenClaw version  - 最新版かどうかを確認
✅ Disk space        - 10GB以上の空き容量を推奨
✅ Memory            - 4GB以上のRAM推奨（8GB推奨）
✅ PATH設定          - openclaw実行ファイルがPATHに含まれるか確認

# Node.jsバージョン問題の--fix自動修復内容:
# → .nvmrc または .node-version ファイルを確認して適切なバージョンを提案
# → nvm・nodenvを使っている場合は自動でバージョンを切替

# 手動でNode.jsを更新する場合:
nvm install 22
nvm use 22
node --version  # v22.x.x を確認

[GATEWAY] セクションの全診断項目（--verbose時）:

✅/❌ Gateway process      - プロセスが実行中かどうか（PID確認）
✅/❌ Port 18789           - ポートがリッスン状態かどうか
✅/❌ Device token sync    - CLIとGatewayのトークンが一致するか
✅/❌ Gateway version      - CLIとGatewayのバージョンが一致するか
✅/❌ LaunchAgent status   - macOSのLaunchAgent設定が正しいか
✅/❌ Windows Service      - Windowsサービスが登録・起動しているか
✅/❌ Gateway health API   - /health エンドポイントへのHTTPレスポンス
✅/❌ Gateway auth API     - /auth エンドポイントへの認証確認
✅/❌ Browser relay        - ブラウザ拡張との接続確認
✅/❌ WebSocket connection - リアルタイム接続の確認

--fixで自動修復できる項目:
  - Device token sync (openclaw gateway --sync を自動実行)
  - Gateway version mismatch (openclaw update を自動実行)
  - LaunchAgent plist のパス誤り (自動生成・置換)

[AI PROVIDERS] セクションの診断項目（--verbose）:

各プロバイダごとに以下をチェック:
✅/❌ API key format      - キーの形式が正しいか（sk-ant-、sk-proj- など）
✅/❌ API key validity    - 実際にAPIにテストリクエストを送って有効性確認
✅/❌ Rate limit status   - 現在のレート制限状態
✅/❌ Quota usage         - 使用量の割合（80%以上で⚠️警告）
✅/❌ Model availability  - 設定したモデルが使用可能かどうか
✅/❌ Billing status      - 課金状態（無料枠・有料プラン）の確認

# --fixが自動修復する内容:
# ・APIキー文字列の前後のスペース・改行を削除
# ・auth-profiles.jsonの構文エラーを修正
# ・環境変数とconfig.jsonのAPIキーが異なる場合、どちらを使うか確認

# 手動でAPIキーを更新するコマンド:
openclaw models set-key --provider anthropic \
  --key "sk-ant-api03-..." \
  --profile primary

[SKILLS & MEMORY] セクションの診断項目:

スキル関連:
✅/❌ Skills directory     - ~/.openclaw/skills/ の存在確認
✅/❌ Skill syntax         - 各スキルのJSONL/YAMLシンタックスチェック
✅/❌ Skill dependencies   - 各スキルが必要とするnpmパッケージの確認
✅/❌ Skill permissions    - スキルが要求するシステム権限の確認
⚠️     Skill complexity    - 重すぎるスキル（10,000トークン超）の警告

メモリ・設定ファイル関連:
✅/❌ SOUL.md              - ファイルの存在・読み取り可能か確認
✅/❌ MEMORY.md            - ファイルの存在・サイズ確認
✅/❌ config.json          - 設定ファイルのJSONシンタックス確認
✅/❌ auth-profiles.json   - 認証設定のシンタックス確認
⚠️     MEMORY.md size      - 50,000文字超で⚠️警告（/compactを推奨）

# スキル依存関係の--fix自動修復:
# → npm install を自動実行して不足パッケージをインストール

# 具体的な修復コマンド例
cd ~/.openclaw/skills/virustotal-scan
npm install  # axios等の不足パッケージをインストール