文档
帮助
故障排除

故障排除

适用范围

在以下情况使用本页：

  • 您看到错误并想要修复路径
  • 安装程序说"成功"但 CLI 不起作用

前 60 秒

按顺序运行这些命令：

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

如果 gateway 可访问，深度探测：

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 而不是使用标志。

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

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

docs.clawd.bot 显示 SSL 错误（Comcast/Xfinity）

一些 Comcast/Xfinity 连接通过 Xfinity 高级安全阻止 docs.clawd.bot。 禁用高级安全或将 docs.clawd.bot 添加到白名单，然后重试。

  • Xfinity 高级安全帮助：https://www.xfinity.com/support/articles/using-xfinity-xfi-advanced-security
  • 快速完整性检查：尝试移动热点或 VPN 以确认它是 ISP 级别的过滤

服务说正在运行，但 RPC 探测失败

模型/身份验证失败（速率限制、计费、“all models failed”）

/model 说 model not allowed

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

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

提交问题时

粘贴一个安全的报告：

clawdbot status --all

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

FAQ