トラブルシューティング
OpenClaw のセットアップ/実行時トラブルを素早く切り分けます
最初の 60 秒
まずは以下のコマンドで素早く状況を確認します:
openclaw status openclaw status --all openclaw gateway probe openclaw logs --follow openclaw doctor
まだ解決しない場合は、より深いプローブを実行します:
openclaw status --deep
よくあるケース
よくあるケースは順次追加します。
openclaw コマンドが見つからない
多くの場合 PATH またはインストールの問題です。まずはこちら:
解決しない場合はインストーラーを再実行し、シェルが更新された PATH を読み込んでいるか確認してください。
インストーラーが失敗する
verbose でインストーラーを再実行:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose
beta を入れる場合:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose
不具合報告時は --verbose の出力を添付してください。
プロキシ/企業ネットワークの場合は別ネットワークでも試し、verbose 出力を保存してください。
Dashboard が unauthorized になる
Web UI が開かない
docs.openclaw.ai にアクセスできない(SSL エラー)
ERR_CERT_DATE_INVALID が出る場合、システム時刻と TLS 検査設定を確認してください。
NET::ERR_CERT_AUTHORITY_INVALID が出る場合、ネットワークが TLS を中継/検査している可能性があります。
- 別ネットワーク(例:モバイル回線/テザリング)で試す。
- 企業の TLS 検査を無効化するか、正しいルート CA を導入する。
解決しない場合は、ブラウザのエラー全文と OS/ネットワーク情報を共有してください。
RPC プローブが失敗する
モデル/プロバイダーの認証に失敗する
モデルが許可されていません
Model … is not allowed は、Gateway のポリシーでブロックされていることを意味します。
設定でモデルを許可するか、許可済みモデルに切り替えてください。
- models.default の既定モデル設定を確認する。
- openclaw models status でプロバイダーの利用可否を確認する。
- サブスクリプション OAuth の場合、正しい profile を選択しているか確認する。
不明な場合は、脱機密化した <code>openclaw models status</code> の出力を貼ってください。
Issue の作成
質問/報告の際は、再現手順と以下の出力を添付してください:
openclaw status --all
openclaw status --all(token はマスクされます)と、関連ログの末尾を少し添付してください。