Skip to content

故障排查

常见问题和解决方案。

常见问题

Agent 不回复

可能原因:

  • 服务未运行
  • API 配置错误
  • 网络问题

解决方法:

bash
# 检查服务状态
openclaw status

# 重启服务
openclaw restart

技能不工作

可能原因:

  • 技能未正确加载
  • SKILL.md 格式错误
  • 依赖缺失

解决方法:

bash
# 查看技能列表
/skills list

# 重新加载技能
/skills reload

内存不足

可能原因:

  • 上下文过大
  • 对话历史太多

解决方法:

  • 定期开始新对话
  • 清理历史记录
  • 优化 System Prompt

调试技巧

启用推理模式

AGENTS.md 中设置:

yaml
reasoning: on

这样可以看到 Agent 的思考过程。

查看日志

bash
# 查看实时日志
openclaw logs

# 查看错误日志
openclaw logs --error

获取帮助


← 返回进阶指南