问题解决

欢迎来到 OpenClaw 问题解决中心。这里汇集了常见问题的解答和故障排查指南。

快速诊断

遇到问题时，请按以下步骤排查：

1. 检查版本 - 确保使用最新版本

   openclaw --version
   openclaw update

2. 查看日志 - 启用调试模式获取详细信息

   openclaw <command> --debug

3. 验证配置 - 检查配置文件格式

   openclaw config validate

4. 清理缓存 - 清除可能损坏的缓存

   openclaw clean

问题分类

安装问题

• 安装失败或权限错误
• 依赖安装问题
• 环境配置问题

运行问题

• 开发服务器启动失败
• 构建错误
• 测试失败
• 部署问题

性能问题

• 构建速度慢
• 内存占用高
• 运行时性能问题

错误代码

• 完整的错误代码列表
• 每个错误的详细说明和解决方案

常见问题速查

Q: 如何更新 OpenClaw？

# 使用 npm
npm update -g openclaw

# 或使用包管理器
openclaw update

Q: 如何查看详细日志？

# 调试模式
openclaw build --debug

# 或设置环境变量
DEBUG=openclaw:* openclaw build

Q: 如何重置配置？

# 删除本地配置
rm .openclawrc

# 重置项目配置
openclaw init --force

Q: 如何完全卸载？

# 卸载包
npm uninstall -g openclaw

# 删除配置和数据
rm -rf ~/.openclaw
rm -rf .openclaw

获取帮助

如果问题仍未解决：

1. 搜索 Issues - 在 GitHub Issues 搜索类似问题
2. 查看 Discussions - 在 Discussions 寻找答案
3. 提问 - 创建新的 Issue 或 Discussion
4. 加入社区 - 在 Discord 寻求帮助

提交问题报告

提交问题时，请提供以下信息：

• OpenClaw 版本 (openclaw --version)
• 操作系统和版本
• Node.js 版本 (node --version)
• 完整的错误信息和堆栈跟踪
• 复现步骤
• 相关配置文件（注意脱敏）

贡献解决方案

如果你解决了某个问题，欢迎贡献文档：

1. Fork 文档仓库
2. 添加你的解决方案
3. 提交 Pull Request