ヘルプ
トラブルシューティング
時間が2分しかない場合は、このページをトリアージの入り口として使用してください。
最初の60秒
この正確なラダーを順番に実行してください:
openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow
1行での良好な出力:
openclaw status→ 設定されたチャネルが表示され、明らかな認証エラーがない。openclaw status --all→ 完全なレポートが存在し、共有可能である。openclaw gateway probe→ 期待されるゲートウェイターゲットに到達可能。openclaw gateway status→Runtime: runningおよびRPC probe: ok。openclaw doctor→ ブロッキングする設定/サービスエラーがない。openclaw channels status --probe→ チャネルがconnectedまたはreadyと報告する。openclaw logs --follow→ 安定したアクティビティ、繰り返し発生する致命的なエラーがない。
Anthropic 長文コンテキスト 429
HTTP 429: rate_limit_error: Extra usage is required for long context requests が表示される場合、/gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context に移動してください。
プラグインインストールが openclaw extensions の欠如で失敗する
インストールが package.json missing openclaw.extensions で失敗する場合、プラグインパッケージがOpenClawが受け入れなくなった古い形状を使用しています。プラグインパッケージ内で修正してください:
package.jsonにopenclaw.extensionsを追加する。- エントリをビルド済みランタイムファイル（通常は
./dist/index.js）に向ける。 - プラグインを再公開し、
openclaw plugins install <npm-spec>を再度実行する。
例:
{
"name": "@openclaw/my-plugin",
"version": "1.2.3",
"openclaw": {
"extensions": ["./dist/index.js"]
}
}
参照: /tools/plugin#distribution-npm