故障排除

60秒快速诊断

按顺序运行以下命令：

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

如果网关可达，运行深度探测：

openclaw status --deep

常见问题

openclaw: command not found

几乎总是 Node/npm PATH 问题。请参阅：安装说明

安装程序失败（或需要完整日志）

以详细模式重新运行安装程序：

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

Beta 安装：

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

也可以设置 OPENCLAW_VERBOSE=1 环境变量。

网关 "unauthorized"、无法连接或持续重连

请参阅：

• 网关故障排除
• 网关认证

Control UI 在 HTTP 上失败（需要设备身份）

请参阅：

• 网关故障排除
• Control UI

docs.openclaw.ai 显示 SSL 错误 (Comcast/Xfinity)

部分 Comcast/Xfinity 连接会通过 Xfinity Advanced Security 错误地阻止 docs.openclaw.ai。

解决方法：禁用 Advanced Security 或将 docs.openclaw.ai 添加到白名单。

• Xfinity Advanced Security 帮助：https://www.xfinity.com/support/articles/using-xfinity-xfi-advanced-security
• 快速检查：尝试使用移动热点或 VPN 确认是否为 ISP 级别过滤

服务显示运行中，但 RPC 探测失败

请参阅：

• 网关故障排除
• 后台进程/服务

模型/认证失败（速率限制、计费、"all models failed"）

请参阅：

• 模型
• OAuth/认证概念

/model 提示 model not allowed

这通常意味着 agents.defaults.models 配置为白名单模式。当非空时，只有这些 provider/model 键可以被选择。

• 检查白名单：openclaw config get agents.defaults.models
• 添加你想要的模型（或清空白名单）然后重试 /model
• 使用 /models 浏览允许的 providers/models

提交 Issue

粘贴安全报告：

openclaw status --all

如果可以，请附上 openclaw logs --follow 的相关日志。