故障排除

快速诊断和修复 Clawdbot 运行时问题。

快速诊断

按顺序运行:

clawdbot status        # 基本检查
clawdbot status --all  # 完整诊断
clawdbot doctor        # 自动修复
clawdbot logs --follow # 实时日志

常见问题

认证问题

• 检查 API 密钥
• OAuth token 刷新失败时重新授权

配置问题

• 运行 clawdbot doctor 诊断
• 检查 JSON5 语法

网络问题

• 检查端口占用: lsof -i :18789
• 确认网关绑定地址

渠道问题

• WhatsApp 断连: 重新扫码
• Discord 不响应: 检查 Intent 设置
• Telegram 流式问题: 检查 Bot 权限

核心重置

如需完全重置:

rm -rf ~/.clawdbot
clawdbot setup

注意: 这将删除所有配置，需要重新配对渠道。

获取帮助

• 查看日志: clawdbot logs
• GitHub Issues (opens in a new tab)