OpenClaw 常见问题及修复方案大全

星玥养虾54天，踩坑13次，总结出这套修复大全

从”系统无限重启”到”飞书掉线”，从”消息卡住”到”配置错误”，这些问题我都遇到过。本文整理了真实踩坑案例和修复方案，帮你快速解决OpenClaw常见问题。

🔧 快速修复四件套

遇到问题先试这4招（按顺序）：

第1招：新建会话（直接发openclaw )

/new

适用场景：会话卡住、回复异常、状态混乱、消息卡顿

第2招：自动诊断修复

(直接在你的openclaw 终端运行命令自动检测修复）

openclaw doctor --fix

适用场景：配置错误、插件异常、系统问题

第3招：求助DeepSeek

(直接在你的openclaw 终端运行命令自动检测修复失败后将所有代码复制发给DeepSeek，它会给你答案然后反复操作追问直到修复）

openclaw doctor --fix

然后复制诊断输出，发给 DeepSeek 分析

第4招：恢复备份（前三招无效，只能恢复备份了，每个openclaw 恢复备份的命令不一样具体问你的龙虾）

cd /etc/lighthouse/openclaw/bak/
ls -lt | head -5
openclaw gateway restart

适用场景：严重错误，系统无法启动

📖 常见问题

🔴 问题1：系统无限重启怎么办？

用户问：我修改了 openclaw.json 配置，重启后系统一直重启，怎么办？

星玥答：这是最严重的问题！通常是添加了不存在的配置项。

修复步骤：

# 1. 停止服务
openclaw gateway stop

# 2. 检查最近修改
cat ~/.openclaw/openclaw.json |grep -B2 -A2 "respondToMentionAll"

# 3. 删除无效配置或恢复备份
vi ~/.openclaw/openclaw.json

# 4. 重启服务
openclaw gateway start

# 5. 验证
openclaw status

🔴 问题2：飞书等通道突然掉线了？

关键理解：

●channels.feishu 是消息通道（管道），必须启用

●openclaw-lark 是工具提供者，必须启用

●plugins.feishu 是旧版工具，必须禁用

修复步骤：

# 1. 自动诊断修复
openclaw doctor --fix

# 2. 重启
openclaw gateway restart

🔴 问题3：文件编辑失败怎么办？

一句话口诀：大文件write，小文件edit，JSON永远write！

🟠 问题4：飞书卡片显示乱码？

建议：定时任务推送，Markdown最稳！别折腾卡片JSON！

🟠 问题5：消息卡住不动怎么办？

快速修复：/new

一句话口诀：先干活，再说话！

🎯 常用修复方案总结

💡 防坑指南

配置修改铁律

●✅ 修改前先备份

●✅ 只添加文档中有的配置项

工具使用铁律

●✅ 大文件用write，小文件用edit

●✅ JSON文件永远用write

技能调用铁律

●✅ 调用前必须先读SKILL.md

●✅ 从文件提取配置，禁止脑补

📊 统计数据

备注

一般问题：只备份openclaw.json 配置文件即可。当修改导致异常时可快速回退到历史版本。