OpenClawSkills
GitHub
ヘルプ・FAQ • TutorialHeader.readTime

トラブルシューティング

OpenClaw のセットアップ/実行時トラブルを素早く切り分けます

Tutorial.step

最初の 60 秒

まずは以下のコマンドで素早く状況を確認します:

Bash
openclaw status
openclaw status --all
openclaw gateway probe
openclaw logs --follow
openclaw doctor

まだ解決しない場合は、より深いプローブを実行します:

Bash
openclaw status --deep
Tutorial.step

よくあるケース

よくあるケースは順次追加します。

Tutorial.step

openclaw コマンドが見つからない

多くの場合 PATH またはインストールの問題です。まずはこちら:

- Node/npm/PATH の確認

解決しない場合はインストーラーを再実行し、シェルが更新された PATH を読み込んでいるか確認してください。

Tutorial.step

インストーラーが失敗する

verbose でインストーラーを再実行:

Bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

beta を入れる場合:

Bash
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

不具合報告時は --verbose の出力を添付してください。

プロキシ/企業ネットワークの場合は別ネットワークでも試し、verbose 出力を保存してください。

Tutorial.step

Dashboard が unauthorized になる

- Gateway トラブルシューティング

- Gateway 認証

token 付きの Dashboard URL(または信頼された Tailscale の ID ヘッダー)で認証を満たしてください。

Tutorial.step

Web UI が開かない

- Gateway トラブルシューティング

- TUI の Web 画面

Gateway が到達可能で、ポート/バインド設定がネットワークと一致しているか確認してください。

Tutorial.step

docs.openclaw.ai にアクセスできない(SSL エラー)

ERR_CERT_DATE_INVALID が出る場合、システム時刻と TLS 検査設定を確認してください。

NET::ERR_CERT_AUTHORITY_INVALID が出る場合、ネットワークが TLS を中継/検査している可能性があります。

- 別ネットワーク(例:モバイル回線/テザリング)で試す。

- 企業の TLS 検査を無効化するか、正しいルート CA を導入する。

解決しない場合は、ブラウザのエラー全文と OS/ネットワーク情報を共有してください。

Tutorial.step

RPC プローブが失敗する

- Gateway トラブルシューティング

- バックグラウンドプロセス

デーモンが動作していて RPC エンドポイントが到達可能か確認してください。

Tutorial.step

モデル/プロバイダーの認証に失敗する

- モデルの状態

- OAuth(概念)

プロバイダーの認証情報と、使用中の auth profile を確認してください。

Tutorial.step

モデルが許可されていません

Model … is not allowed は、Gateway のポリシーでブロックされていることを意味します。

設定でモデルを許可するか、許可済みモデルに切り替えてください。

- models.default の既定モデル設定を確認する。

- openclaw models status でプロバイダーの利用可否を確認する。

- サブスクリプション OAuth の場合、正しい profile を選択しているか確認する。

不明な場合は、脱機密化した <code>openclaw models status</code> の出力を貼ってください。

Tutorial.step

Issue の作成

質問/報告の際は、再現手順と以下の出力を添付してください:

Bash
openclaw status --all

openclaw status --all(token はマスクされます)と、関連ログの末尾を少し添付してください。