刚上手 OpenClaw?本文整理了新手最容易遇到的问题和解决方案,帮你快速绕过常见坑。

1. Gateway 无法启动

解决方案

  • 检查端口占用:lsof -i :18789
  • 确认 Node.js 版本 >= 18
  • 删除 ~/.openclaw/gateway.db 重试

2. 认证失败(401 Unauthorized)

解决方案

  • 检查 Bearer Token 是否正确
  • 确认 Token 未过期,重新生成

3. 插件安装失败

解决方案

  • 检查网络连接
  • 确认技能名称拼写正确
  • 尝试手动安装到 ~/.openclaw/workspace/skills/

4. 记忆不生效

解决方案

  • 确认是主会话(私聊),群聊不加载 MEMORY.md
  • 尝试直接让 AI「把这个记到 MEMORY.md」

5. 浏览器自动化不工作

解决方案

  • 先运行 openclaw browser start
  • 确认 Chrome 已安装
  • 尝试 --reset 参数重置浏览器配置

6. 模型响应很慢

解决方案

  • 使用 token-optimizer 减少上下文大小
  • 切换到响应更快的模型

7. 定时任务不执行

解决方案

  • 确认 Gateway 一直在运行
  • 检查任务是否被暂停:openclaw cron list
  • 检查服务器时间是否正确

调试技巧

openclaw status
openclaw logs --tail 50
openclaw doctor

获取帮助

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。