故障排查

前 60 秒

按顺序执行：

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

如果网关可达，再做深度检查：

moltbot status --deep

常见「坏了」情况

moltbot: command not found

多半是 Node/npm 的 PATH 问题。先看：

• 安装（Node/npm PATH 检查）

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

用详细模式重新运行安装器：

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

Beta 版本：

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

也可以用环境变量 CLAWDBOT_VERBOSE=1 代替参数。

网关「未授权」、连不上或反复重连

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

控制台在 HTTP 下失败（需要设备身份）

• 网关故障排查
• 控制台

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

部分 Comcast/Xfinity 网络会通过 Xfinity Advanced Security 拦截 docs.molt.bot。关闭 Advanced Security 或将 docs.molt.bot 加入白名单后重试。

• Xfinity Advanced Security 说明：https://www.xfinity.com/support/articles/using-xfinity-xfi-advanced-security 
• 快速验证：用手机热点或 VPN 试一下，确认是运营商层面的拦截

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

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

模型/认证失败（限流、计费、「所有模型失败」）

• 模型
• OAuth / 认证概念

/model 显示「model not allowed」

通常表示 agents.defaults.models 配置成了白名单。非空时只能选择白名单里的 provider/model。

• 查看白名单：moltbot config get agents.defaults.models
• 加入你要的模型（或清空白名单）后重试 /model
• 用 /models 浏览当前允许的提供商/模型

提交 issue 时

贴一份安全报告：

moltbot status --all

如有可能，附上 moltbot logs --follow 的相关日志末尾。