前 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 问题。从这里开始:
安装器失败(或需要完整日志)
以 verbose 模式重新运行安装器,查看完整追踪和 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 代替标志。
Gateway "unauthorized"、无法连接或持续重连
Control UI 在 HTTP 上失败(需要设备身份)
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")
/model 显示 model not allowed
这通常意味着 agents.defaults.models 配置为白名单。当它非空时,只能选择那些 provider/model 键。
- 检查白名单:
openclaw config get agents.defaults.models - 添加你想要的模型(或清除白名单)然后重试
/model - 使用
/models浏览允许的提供商/模型
提交问题时
粘贴安全报告:
openclaw status --all
如果可以,包含 openclaw logs --follow 的相关日志尾部。