openclaw doctor とは
openclaw doctor は OpenClaw の組み込み診断ツールで、ランタイム環境、設定ファイル、サービス接続ステータスを自動的にチェックし、インストールやデプロイの問題を迅速に特定・解決するのに役立ちます。インストール直後でも、運用中に障害が発生した場合でも、openclaw doctor を最初のトラブルシューティングステップとして使用すべきです。
基本的な使い方
ターミナルで以下を実行します：
openclaw doctor
このコマンドは複数のチェックを順番に実行し、わかりやすい形式で結果を出力します。各チェック項目には合格、警告、失敗のいずれかのマークが付けられます。
チェック項目の説明
openclaw doctor は以下の主要項目をチェックします。それぞれのチェック内容とよくある問題を見ていきましょう。
Node.js バージョンチェック
OpenClaw には Node.js 22 以上が必要です。doctor は現在の Node.js バージョンがこの要件を満たしているかチェックします。
よくある問題：システムに複数の Node.js バージョンがインストールされており、実際に使用されているバージョンが 22 未満。
解決策：
node --version
バージョンが 22 未満の場合はアップグレードが必要です。nvm で Node.js バージョンを管理することを推奨します：
nvm install 22
nvm use 22
nvm alias default 22
重要な注意：Bun を Node.js の代替として使用しないでください。Bun は一部のシナリオで高速ですが、WhatsApp および Telegram の WebSocket 接続で既知の互換性問題があり、OpenClaw チームは推奨していません。
設定ファイルチェック
doctor は ~/.openclaw/openclaw.json 設定ファイルが存在し、有効なフォーマットであるかを確認します。
よくある問題：
- 設定ファイルが存在しない：通常、初期化ウィザードが実行されていないため
- JSON フォーマットエラー：手動編集時に導入された構文エラー
解決策：
設定ファイルが存在しない場合は、オンボーディングウィザードを実行します：
openclaw onboard --install-daemon
JSON フォーマットが無効な場合は、以下で検証できます：
python3 -m json.tool ~/.openclaw/openclaw.json
よくある JSON エラーには、カンマの欠落、末尾のカンマ、引用符の不一致があります。
ネットワーク接続チェック
doctor は OpenClaw コアサービスおよびさまざまな AI モデル API へのネットワーク接続をテストします。
よくある問題：
- ファイアウォールがアウトバウンド接続をブロック
- プロキシ設定の誤り
- DNS 解決の失敗
解決策：
基本的なネットワーク接続を確認します：
curl -I https://api.openai.com
curl -I https://api.anthropic.com
プロキシが必要なネットワーク環境にいる場合は、正しいプロキシ環境変数が設定されていることを確認してください：
export HTTP_PROXY=http://proxy:port
export HTTPS_PROXY=http://proxy:port
AI モデル API チェック
doctor は設定された AI モデル API キーが有効かを検証し、API 接続をテストします。
よくある問題：
- API キーが期限切れまたは無効
- API クォータの枯渇
- 選択したモデルが利用不可
解決策：
設定ファイルを開いて API キーを確認します：
cat ~/.openclaw/openclaw.json
キーが正しい形式で期限切れでないことを確認します。各 AI プロバイダーのコンソールでキーのステータスと残りクォータを確認できます。キーを更新するには、設定ファイルを直接編集するか、オンボーディングウィザードを再実行します。
チャットプラットフォーム接続チェック
doctor は設定された各チャットプラットフォーム（WhatsApp、Telegram、Discord など）の接続ステータスを1つずつチェックします。
よくある問題：
- WhatsApp セッションの期限切れ、再スキャンが必要
- Telegram Bot Token が無効
- Discord Bot がターゲットサーバーに招待されていない
- Webhook URL に到達できない
解決策：
WhatsApp 接続の問題の場合：
openclaw onboard
オンボーディングウィザードに再度入り、WhatsApp の再接続を選択してプロンプトに従い QR コードをスキャンします。
Telegram の問題の場合は、Bot Token が有効か確認します：
curl https://api.telegram.org/botYOUR_TOKEN/getMe
Webhook URL の問題の場合は、サーバーが外部からアクセス可能で、ポート 3000（または設定したポート）がファイアウォールでブロックされていないことを確認してください。
ポート占有チェック
doctor は OpenClaw が必要とするポート（デフォルト 3000）が他のプログラムに占有されていないかチェックします。
よくある問題：
- 別の OpenClaw インスタンスがすでに実行中
- 別の Web アプリケーションが同じポートを使用中
解決策：
ポート使用状況を確認します：
# Linux
ss -tlnp | grep 3000
# macOS
lsof -i :3000
ポートが占有されている場合は、そのポートを使用しているプロセスを停止するか、OpenClaw の設定を変更して別のポートを使用してください。
ディスク容量チェック
doctor は ~/.openclaw/ を含むパーティションに十分なディスク容量があるかチェックします。
よくある問題：
- 蓄積されたログファイルが容量を圧迫
- ディスク容量不足によるサービス異常
解決策：
df -h ~
du -sh ~/.openclaw/*
容量が不足している場合は、不要なログファイルをクリーンアップします：
rm -rf ~/.openclaw/logs/*.log.old
デーモンステータスチェック
doctor は OpenClaw のデーモンプロセスが適切に設定され実行されているかチェックします。
よくある問題：
- systemd サービスが有効化されていない（Linux）
- LaunchAgent がロードされていない（macOS）
- サービスが停止または失敗状態
解決策：
Linux の場合：
systemctl status openclaw
sudo systemctl restart openclaw
macOS の場合：
launchctl list | grep openclaw
launchctl start com.openclaw.agent
よくある診断シナリオ
シナリオ1：インストール直後
インストール後にまず行うべきことは、環境がすべての要件を満たしていることを確認するために openclaw doctor を実行することです：
npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw doctor
シナリオ2：サービスが突然動作しなくなった
OpenClaw がメッセージへの応答を突然停止した場合：
openclaw doctor
チェック結果を使用して問題を特定します。通常はネットワークの変更、API キーの期限切れ、またはチャットプラットフォームセッションのタイムアウトが原因です。
シナリオ3：アップグレード後の問題
OpenClaw のアップグレード後に doctor を実行して互換性を確認します：
npm install -g openclaw@latest
openclaw doctor
シナリオ4：移行後の確認
OpenClaw を1つのサーバーから別のサーバーに移行した後：
openclaw doctor
設定ファイルが適切に復元され、新しい環境ですべての接続が機能していることを確認します。
出力の解釈
doctor の出力は色とシンボルを使用して各チェックのステータスをマークします：
- 合格：チェックは完全に正常で、アクションは不要
- 警告：潜在的な問題があるが基本的な動作には影響しない。注意は必要
- 失敗：チェックを通過できず、即座の対応が必要
失敗したチェック項目に対して、doctor は通常、具体的なエラーメッセージと修復の提案を提供します。提案に従って問題を1つずつ修正し、すべてのチェックが合格するまで openclaw doctor を再実行してください。
より詳細な診断情報の取得
標準の診断では不十分な場合は、OpenClaw のランタイムログでより多くの情報を確認できます：
# Linux systemd
journalctl -u openclaw -n 100
# macOS LaunchAgent
cat /tmp/openclaw.stderr.log
# または OpenClaw 自体のログを確認
ls ~/.openclaw/logs/
コミュニティからのヘルプ
問題を自力で解決できない場合は、OpenClaw の GitHub Issues やコミュニティフォーラムで openclaw doctor の完全な出力を共有してヘルプを求めることができます。診断出力は十分な環境情報を提供し、コミュニティメンバーが問題を迅速に特定するのに役立ちます。
Issue を提出する際は、以下を含めることを推奨します：
- 完全な
openclaw doctor出力 openclaw --versionバージョン情報node --versionバージョン情報- オペレーティングシステムの種類とバージョン
- 問題の詳細な説明と再現手順
まとめ
openclaw doctor は OpenClaw エコシステムで最も実用的な診断ツールの1つです。インストール後、アップグレード後、問題発生時にすぐに doctor を実行する習慣を身につけることで、インストールとデプロイに関する大半の問題を迅速に特定・解決できます。ランタイム環境からサービス接続まですべてを体系的にチェックし、OpenClaw の安定した運用に欠かせないセーフガードです。