跳到主要内容

故障排除

前 60 秒​

按顺序运行以下命令：

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

如果网关可访问，进行深度探测：

clawdbot status --deep

常见的“出故障”情况​

clawdbot: command not found (找不到命令)​

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

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

以详细模式重新运行安装程序，以查看完整的追踪和 npm 输出：

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

对于 Beta 版安装：

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

您也可以设置 CLAWDBOT_VERBOSE=1 来代替该标志。

网关显示“未经授权 (unauthorized)”、无法连接或不断重连​

控制 UI 在 HTTP 上失败 (需要设备标识)​

docs.clawd.bot 显示 SSL 错误 (Comcast/Xfinity)​

某些 Comcast/Xfinity 连接会通过 Xfinity Advanced Security 拦截 docs.clawd.bot。 请禁用 Advanced Security 或将 docs.clawd.bot 添加到白名单，然后重试。

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

模型/身份验证失败 (速率限制、账单、“所有模型均失败”)​

/model 显示 model not allowed (模型未允许)​

这通常意味着 agents.defaults.models 被配置为白名单。当它不为空时， 只有那些提供商/模型键可以被选择。

  • 检查白名单：clawdbot config get agents.defaults.models
  • 添加您想要的模型（或清除白名单）并重试 /model
  • 使用 /models 浏览允许的提供商/模型

提交 Issue 时​

请粘贴一份安全的报告：

clawdbot status --all

如果可以的话，请包含来自 clawdbot logs --follow 的相关日志尾部。