排障

前 60 秒

按顺序运行这些命令：

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

如果 gateway 可达，可做更深度探测：

openclaw status --deep

常见“坏了”场景

openclaw: command not found

几乎总是 Node/npm 的 PATH 问题。从这里开始：

• 安装（Node/npm PATH 自检）

安装器失败（或你需要完整日志）

用 verbose 模式重跑安装脚本，以查看完整 trace 与 npm 输出：

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

对 beta 安装：

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

你也可以设置 OPENCLAW_VERBOSE=1 来替代该 flag。

Gateway “unauthorized”、无法连接、或不断重连

• Gateway 排障
• Gateway 鉴权

Control UI 在 HTTP 下失败（device identity required）

• Gateway 排障
• Control UI

docs.openclaw.ai 显示 SSL 错误（Comcast/Xfinity）

部分 Comcast/Xfinity 网络会通过 Xfinity Advanced Security 阻止 docs.openclaw.ai。 请关闭 Advanced Security 或将 docs.openclaw.ai 加入 allowlist，然后重试。

• Xfinity Advanced Security 帮助：https://www.xfinity.com/support/articles/using-xfinity-xfi-advanced-security
• 快速自检：尝试手机热点或 VPN，以确认是否为 ISP 级过滤

Service 显示 running，但 RPC probe 失败

• Gateway 排障
• 后台进程 / service

模型/鉴权失败（限流、计费、“all models failed”）

• Models
• OAuth / 鉴权概念

/model 提示 model not allowed

这通常意味着 agents.defaults.models 被配置成了 allowlist。当它非空时， 只有那些 provider/model keys 才允许被选中。

• 查看 allowlist：openclaw config get agents.defaults.models
• 添加你想用的模型（或清空 allowlist）后重试 /model
• 用 /models 浏览允许的 providers/models

提交 issue 时

请粘贴一份安全的报告：

openclaw status --all

如果可以，也请附上 openclaw logs --follow 的相关日志尾部（log tail）。