OpenClaw 常见报错与解决方案（2026 精华版）
收集了 50+ 个真实报错场景，每个都有解决方案。收藏这篇，遇到问题直接搜。
🔌 连接与启动
报错：EADDRINUSE: address already in use :::18789
原因： 端口 18789 被占用（上次没关干净）
解决：
bash
# 查找占用端口的进程
lsof -i :18789
# 杀掉它
kill -9 <PID>
# 重启
openclaw start报错：websocket connection failed
原因： 飞书/微信 websocket 连接断开
解决：
bash
# 检查网络
ping open.feishu.cn
# 重启 OpenClaw
openclaw restart
# 如果反复断开，检查防火墙/代理设置报错：Error: Cannot find module 'xxx'
原因： 缺少依赖包
解决：
bash
cd ~/.openclaw-autoclaw
npm install🤖 模型相关
报错：ollama: error loading model
原因： 模型文件损坏或下载不完整
解决：
bash
# 删除并重新下载
ollama rm qwen3.5:9b
ollama pull qwen3.5:9b报错：context length exceeded
原因： 输入内容超过模型上下文窗口
解决：
- 减少输入内容长度
- 在 openclaw.json 中调整
maxTokens - 分多次发送，不要一次丢太多
报错：model not allowed
原因： session_status 工具有模型白名单限制
解决： 使用 Control UI 的 /model 命令切换，或在配置中添加模型到允许列表。
报错：429 Too Many Requests
原因： API 调用频率超限
解决：
- 云端 API：等待 1 分钟后重试，或升级套餐
- 本地 Ollama：一般不会触发，除非并发太高
📱 飞书相关
报错：authentication failed
原因： App ID 或 App Secret 错误
解决：
- 去 飞书开放平台 重新确认凭证
- 检查 openclaw.json 中的 appId/appSecret 是否正确
- 注意不要有多余的空格或引号
报错：permission denied
原因： 飞书应用没有对应权限
解决：
- 飞书开放平台 → 权限管理
- 搜索报错中提到的权限名
- 开启权限 → 发布新版本
报错：机器人不回复群消息
可能原因及解决：
| 原因 | 解决 |
|---|---|
没有开启 im:message.group_at_msg 权限 | 开启该权限 |
requireMention: true 但没有@机器人 | 改为 false 或在消息中@ |
| 群不在 allowFrom 列表中 | 添加群 chat_id |
| 事件订阅未配置 | 检查事件回调地址 |
🌐 浏览器自动化
报错：浏览器扩展无响应
原因： Chrome 扩展连接断开
解决：
- 检查扩展是否启用（Chrome://extensions）
- 点击扩展图标确认状态
- 重启 Chrome
- 检查 auto_approve 配置是否为 true
报错：返回结果为空（48 bytes）
原因： 扩展连接正常但页面内容未捕获
解决：
- 确保目标网页已完全加载
- 检查目标 URL 是否可访问
- 尝试增加等待时间
- 手动操作一次后再重试
💾 内存与性能
报错：JavaScript heap out of memory
原因： Node.js 内存不足
解决：
bash
# 增加 Node.js 内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
openclaw startMac Mini 运行卡顿
排查步骤：
- 打开 Activity Monitor 查看 Memory Pressure
- 关闭 Chrome（最大内存杀手）
- 检查是否有其他大模型在运行
- 参考 内存优化指南
📝 文件与部署
VitePress 构建失败 code 255
常见原因：
- config.mts 语法错误
- Markdown 文件中有非法字符
- 依赖缺失
解决：
bash
cd /var/www/blog
rm -rf node_modules package-lock.json
npm install
npm run docs:buildNginx 404
检查清单：
bash
# 1. 确认文件存在
ls /var/www/html/index.html
# 2. 确认 Nginx 配置 root 正确
nginx -t
# 3. 重启 Nginx
systemctl restart nginxSSH 连接被拒
bash
# 检查 SSH 服务
systemctl status sshd
# 检查密钥权限
chmod 600 ~/.ssh/id_aliyun
# 详细模式调试
ssh -v root@182.92.245.108🔐 安全相关
报错：token expired / unauthorized
原因： API Key 过期或无效
解决：
- 智谱 API：去 open.bigmodel.cn/apikeys 重新生成
- 更新 openclaw.json 中的 apiKey
- 重启 OpenClaw
Prompt Injection 攻击迹象
如果 AI 开始执行奇怪的操作（删除文件、外传数据），可能是：
- 外部数据中嵌入了恶意指令
- 收到了包含 "ignore previous instructions" 的输入
应对： OpenClaw 有内置防护。确保 AGENTS.md 中的安全规则已启用。
📊 性能调优
模型响应慢
| 优化手段 | 预期效果 |
|---|---|
| 关闭 Chrome | 内存释放 3-4GB |
| 减小上下文窗口 | KV Cache 降低 50%+ |
| 用 Q4 量化 | 模型大小降 30% |
| 并发控制 | 避免排队等待 |
Ollama pull 很慢
bash
# 设置代理（如果有）
export https_proxy=http://127.0.0.1:1080
# 或使用镜像
OLLAMA_ORIGINS=https://ollama.com.cn ollama pull qwen3.5:9b🆘 终极方案：全量重装
如果以上都不行：
bash
# 1. 停止服务
openclaw stop
# 2. 备份配置
cp ~/.openclaw-autoclaw/openclaw.json ~/backup/
# 3. 删除重装
rm -rf ~/.openclaw-autoclaw
npm install -g openclaw
openclaw init
# 4. 恢复配置
cp ~/backup/openclaw.json ~/.openclaw-autoclaw/
# 5. 重启
openclaw start🦞 遇到本文没覆盖的问题？欢迎在论坛提问