Skip to content

分类排查

按问题类型详细排查。

类型 1:机器人不回复

完全不回复(超过 1 分钟)

可能原因

  • OpenClaw 服务未运行
  • 网络连接中断
  • API 配置错误

解决

联系管理员,提供:
- 什么时候开始的
- 你发了什么
- 是否所有人都这样

回复很慢(超过 30 秒)

可能原因

  • API 限速
  • 对话太长
  • 网络延迟

解决

  • 等 5 分钟后重试
  • 开始新对话
  • 简化问题

偶尔不回复

可能原因

  • 网络不稳定
  • 服务器繁忙

解决

  • 等一会儿重试
  • 不要频繁刷屏

类型 2:AI 回复错误

错误 1:"出错了"或"API 错误"

可能原因

  • API 余额不足
  • API Key 过期
  • API 服务异常

解决

联系管理员,提供:
- 完整错误信息
- 发生时间
- 使用的功能

错误 2:"不理解"或"无法处理"

可能原因

  • 问题太模糊
  • 超出能力范围
  • 缺少上下文

解决

✅ 重新描述,更具体:
"帮我写个邮件"
→ "帮我写一封给客户的邮件,通知他们系统维护"

错误 3:"权限不足"或"无法执行"

可能原因

  • 操作太危险
  • 需要管理员权限
  • 安全限制

解决

联系管理员,说明:
- 你想做什么
- 为什么需要
- 预期结果

类型 3:功能不工作

提醒不工作

检查

1. 确认提醒已设置
   → "查看有哪些提醒"

2. 确认时间正确
   → 现在几点了?

3. 确认格式正确
   → "明天上午10点提醒我开会"

技能不工作

检查

1. 确认技能已安装
   → "查看有哪些技能"

2. 确认使用方式正确
   → "天气技能怎么用?"

文件操作失败

可能原因

  • 文件不存在
  • 权限不足
  • 路径错误

解决

✅ 确认文件存在
✅ 提供完整路径
✅ 联系管理员检查权限

类型 4:性能问题

响应越来越慢

原因

  • 对话太长(几百条消息)
  • 历史记录太多
  • 服务器负载高

解决

✅ 开始新对话
✅ 定期清理历史
✅ 避免高峰期

API 费用太高

原因

  • 使用了昂贵的模型
  • 对话太频繁
  • 内容太长

解决

✅ 切换更便宜的模型
✅ 简化问题
✅ 减少对话频率

← 上一节:快速诊断 | 下一节:场景排查 →