トラブルシューティング

問題が発生しましたか？慌てないでください！以下の方法に沿って順番に調べれば、ほとんどの問題は自分で解決できます。

🔍 診断ステップ（順番に進めてください）

OpenClaw に問題が発生した場合、以下の順序で段階的に調査してください：

実行状態を確認

openclaw status

OpenClaw がまだ実行中かどうか確認します。「stopped」と表示されたりエラーが出る場合は、まず再起動を試してみてください。

ゲートウェイの状態を確認

openclaw gateway status

ゲートウェイは OpenClaw がチャットプラットフォームに接続するための橋渡しです。ゲートウェイの状態に異常がある場合、チャットメッセージの送受信ができません。

ログを確認

openclaw logs

ログには OpenClaw の実行に関するすべての詳細が記録されています。エラーがある場合、通常ログに赤いエラーメッセージが表示され、どこに問題があるか教えてくれます。

ヘルスチェックを実行

openclaw doctor

包括的なヘルスチェックです。どのコンポーネントが正常で、どのコンポーネントに問題があるか教えてくれます。

チャンネル接続を確認

openclaw channels status

各チャットチャンネルの接続状態を確認して、どのチャンネルが切断されているか確認します。

🐛 よくあるエラーと解決方法

エラー：「openclaw: command not found」

原因：システムが openclaw コマンドを見つけられません。通常は PATH 環境変数の問題です。

解決方法：

# openclaw のインストール場所を確認
npm list -g openclaw

# npm のグローバルディレクトリを PATH に追加
export PATH="$(npm config get prefix)/bin:$PATH"

# 上記のコマンドを shell の設定ファイルに追加して永続化
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

エラー：ポートの競合（EADDRINUSE: address already in use :::18789）

原因：ポート 18789 がすでに別のプログラムに使われています。

解決方法：

# ポートを使用しているプロセスを確認
lsof -i :18789

# 古い OpenClaw プロセスの場合、停止
openclaw stop

# OpenClaw プロセスでない場合は、設定でポートを変更
# ~/.openclaw/openclaw.json を編集して port の値を変更

エラー：429 Too Many Requests（レート制限）

原因：リクエストの送信が頻繁すぎます。AI モデルプロバイダーは API 呼び出しに頻度制限を設けています。

解決方法：

数分待ってから再試行
メッセージの送信頻度を減らす
API の有料プランをアップグレードして、より高いレート制限を取得
制限がより緩やかなモデルプロバイダーへの切り替えを検討

エラー：ゲートウェイが起動しない

原因：Bot Token が無効、ネットワーク接続の問題、またはチャットプラットフォーム API の変更が考えられます。

解決方法：

# ゲートウェイログを確認
openclaw gateway logs

# Bot Token が有効か検証
openclaw channels verify

# ゲートウェイを再起動
openclaw gateway restart

エラー：メッセージが送信できない

原因：チャンネル設定のミス、ネットワークの問題、または Bot の権限不足が考えられます。

解決方法：

チャンネルの状態を確認：openclaw channels status
Bot が該当プラットフォームでメッセージ送信の権限を持っているか確認
ネットワーク接続が正常か確認
ログに具体的なエラー情報がないか確認

エラー：コントロールパネルが開けない

原因：OpenClaw サービスが実行されていない、またはポート設定が間違っている可能性があります。

解決方法：

# OpenClaw が実行中か確認
openclaw status

# 実行されていない場合、起動
openclaw start

# その後、コントロールパネルを開く
openclaw dashboard

# または、ブラウザで直接アクセス
# http://127.0.0.1:18789/

🆘 それでも解決しない場合は？

上記の方法でも解決できない場合は、以下を試してみてください：

GitHub Issues で検索するか、問題を報告する
OpenClaw の Discord コミュニティに参加してヘルプを求める
質問する際は、openclaw doctor と openclaw logs の出力を添付してください