帮助中心
欢迎来到 OpenClaw 帮助中心。无论你是遇到了安装问题、运行故障还是性能瓶颈，都可以在这里找到解决方案。
快速诊断
遇到问题时，请先执行以下三步快速诊断：
bash
# 步骤 1：检查 OpenClaw 运行状态
openclaw status
# 步骤 2：运行系统诊断工具
openclaw doctor
# 步骤 3：实时查看日志输出
openclaw logs --follow大多数问题可以通过 openclaw doctor 自动检测并修复
该命令会检查 Node.js 版本、端口占用、配置文件完整性、模型连接状态等关键项，并给出修复建议。
帮助文档导航
| 页面 | 说明 | 适用场景 |
|---|---|---|
| 常见问题 (FAQ) | 高频问题快速解答 | 初次使用、基本概念疑问 |
| 故障排查 | 通用问题解决流程 | 安装失败、服务异常 |
| 调试指南 | 日志分析与问题定位 | 深入排查复杂问题 |
| 环境变量 | 完整配置参考手册 | 自定义配置、环境搭建 |
| 测试指南 | 验证部署与功能 | 部署后验收、功能测试 |
| 实用脚本 | 运维自动化脚本 | 备份、监控、批量操作 |
社区资源
GitHub
- Issues（问题追踪）：github.com/openclaw/openclaw/issues — 提交 Bug 或查看已知问题
- Discussions（社区讨论）：github.com/openclaw/openclaw/discussions — 功能建议、使用交流
Discord
加入官方 Discord 社区获取实时帮助：discord.gg/openclaw
#help— 提问与求助#中文交流— 中文用户专属频道#showcase— 分享你的使用案例
国内用户
如果无法访问 Discord，可加入 QQ 群：639101910，或关注微信公众号「久邦科技」获取帮助。
如何报告 Bug
发现 Bug 后，请按以下步骤提交：
- 收集诊断信息：
bash
# 导出完整诊断报告
openclaw doctor --export > diagnostic-report.txt
# 查看版本信息
openclaw --version- 前往 GitHub Issues 创建新 Issue，包含以下信息：
- OpenClaw 版本号
- 操作系统与 Node.js 版本
- 复现步骤（Steps to Reproduce）
- 期望行为与实际行为
- 诊断报告或相关日志片段
提交 Issue 前请先搜索是否已有相同问题
重复的 Issue 会增加维护者的工作量，也不利于问题的集中讨论。
如何请求新功能
- 前往 GitHub Discussions 的 Ideas 分类
- 描述你的使用场景和需求
- 社区投票达到一定数量后会纳入开发计划
紧急问题处理
如果 OpenClaw 服务完全不可用，请尝试以下紧急恢复步骤：
bash
# 强制停止所有 OpenClaw 进程
openclaw stop --force
# 检查并修复配置
openclaw doctor --fix
# 以安全模式重新启动（仅加载核心功能）
openclaw start --safe-mode如果以上步骤均无法恢复
请参考故障排查页面的「完全重装」章节，或在社区寻求帮助。
国内用户专区
如果你是中国大陆用户，以下资源可能对你更有帮助：
文档反馈
如果你发现文档中有错误或遗漏，欢迎通过以下方式反馈：
- 点击每个页面底部的「在 GitHub 上编辑此页」链接直接提交修改
- 在 GitHub Issues 中创建文档类 Issue，标签选择
documentation