跳转到主要内容

​
故障排除

​
前 60 秒

按顺序运行这些: 
openclaw status
openclaw status --all
openclaw gateway probe
openclaw logs --follow
openclaw doctor
如果网关可访问,深度探测: 
openclaw status --deep

​
常见”它崩溃了”情况

​
openclaw: command not found

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

​
安装程序失败(或您需要完整日志)

在详细模式下重新运行安装程序以查看完整跟踪和 npm 输出: 
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 而不是标志。

​
网关”未授权”、无法连接或持续重新连接

​
控制 UI 在 HTTP 上失败(需要设备身份)

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

一些 Comcast/Xfinity 连接通过 Xfinity Advanced Security 阻止 docs.openclaw.ai。 禁用 Advanced Security 或将 docs.openclaw.ai 添加到允许列表,然后重试。

​
服务显示正在运行,但 RPC 探测失败

​
模型/身份验证失败(速率限制、计费、“所有模型都失败”)

​
/model 说 model not allowed

这通常意味着 agents.defaults.models 被配置为允许列表。当它非空时, 只有那些提供程序/模型键可以被选择。
  • 检查允许列表: openclaw config get agents.defaults.models
  • 添加您想要的模型(或清除允许列表)并重试 /model
  • 使用 /models 浏览允许的提供程序/模型

​
提交问题时

粘贴安全报告: 
openclaw status --all
如果可以,从 openclaw logs --follow 包括相关的日志尾部。