故障排查
常见问题和解决方案。
常见问题
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获取帮助
- 查看文档:https://docs.openclaw.ai
- 提交 Issue:https://github.com/openclaw/openclaw/issues
- 社区讨论:https://discord.gg/clawd