真实踩坑总结,看完能避开90%的坑
前言
养OpenClaw小龙虾两周,我的心态经历了从“这啥玩意儿”到“太香了”再到“坑爹啊”的过山车。
安装确实简单,一行命令搞定。但实际用起来,那叫一个波折。本文把我踩过的6个坑全盘托出,每个坑都附带了解决方案。建议先收藏再看,别等踩坑了才回来找。
坑1:飞书发消息显示成功但对方没收到
现象
在飞书给机器人发消息,界面显示“发送成功”,但对方压根没收到。
排查过程
刚开始我还以为是飞书API抽风,查了半天才发现–Gateway被杀掉了!
日志显示,是子小龙虾执行时触发了超时,导致整个进程被系统KO。
解决
- 用
openclaw status检查Gateway状态,确保服务在跑 - 定时任务别设置太长的超时时间
- 必要时用
openclaw gateway restart重启
血的教训:服务没Running,一切都是白搭。
坑2:定时任务写入文件失败
现象
配置了定时任务让AI写文件到指定目录,结果一直失败。
排查过程
报错信息长这样:"Path escapes workspace root"
查了半天才懂–OpenClaw的write工具被限制在工作区内,根本写不到~/Documents/Projects/这种外部路径。
解决
用exec工具执行cat命令来写入:
exec 工具执行 "cat > /path/to/file.md << 'EOF'
内容
EOF"
或者直接问你的小龙虾怎么解决,它会帮你配置。
坑3:X发帖只有tag没有正文
现象
定时任务发的X帖子只有一堆tag,正文是空的,尴尬极了。
排查过程
一看prompt才发现–当初我只强调了要打哪些tag,完全没提正文的事儿。
AI表示:你就让我打tag,我哪儿知道还要写正文?
解决
发帖prompt必须明确格式:
正文内容(50-100字)
#tag1 #tag2 #tag3
教训:prompt里没写的,AI真的不会做。
坑4:定时任务投递到飞书失败
现象
任务执行成功,日志显示完成,但飞书就是收不到通知。
排查过程
排查半天,日志里一行字:"No delivery target resolved"
哦,没配收件人。
解决
配置正确的收件人,直接和你的小龙虾说就行:
openclaw cron edit <job-id> --channel feishu --account main --to "ou_xxxxx"
记得把ou_xxxxx换成你的飞书ID。
坑5:Gateway自动退出
现象
好端端的,Gateway自己就停了。第二天醒来,发现AI已经离线一晚上了。
排查过程
可能的原因太多了:
- 电脑自动锁屏
- 断网
- OOM(内存不足)
- 配置错误
- 系统信号
解决
- 用
openclaw status检查状态 - 用
openclaw logs --follow查看实时日志 - 必要时重启Gateway
- 或者直接让你的小龙虾排查日志,它会告诉你具体原因
坑6:最严重的失忆问题
这个坑太重要了,单独开一篇都不为过。
现象
电脑重启、Gateway重新打开,或者第二天醒来–之前让小龙虾记住的东西全忘了!
让它记住的偏好、任务背景、工作进度,全部清零。
排查过程
查了半天才搞懂原理:
session-memory hook只在
/new命令时触发保存,不是每次会话结束或重启时自动保存的!
也就是说,你以为小龙虾会自动记住一切,其实它只在收到/new信号时才保存。
解决方案
方案一:别完全依赖自动保存,让小龙虾自己记住
- 重要任务开始时 → 主动记录到
memory/YYYY-MM-DD.md - 任务完成后 → 更新状态到memory
- 每天结束前 → 汇总到
MEMORY.md - 定期用Git备份整个
.openclaw目录
cd ~/.openclaw
git init
git add memory/ MEMORY.md
git commit -m "Backup memory"
方案二:搭建自动记忆系统(强烈推荐!)
让AI每次对话时自动加载记忆,重启也不怕:
-
配置记忆文件(在workspace目录下):
MEMORY.md- 长期记忆(重要信息、偏好、决策)memory/YYYY-MM-DD.md- 每日工作日志AGENTS.md- 智能体身份配置
-
配置自动加载(在workspace的AGENTS.md中添加):
## Every Session Before doing anything else: 1. Read `SOUL.md` - this is who you are 2. Read `USER.md` - this is who you're helping 3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context -
养成好习惯:
- 重要任务开始时 → 主动记录到memory
- 任务完成后 → 更新状态
- 定期用Git备份整个
.openclaw目录
配置好之后,每次对话AI会自动读取这些记忆文件,就算重启也不会失忆啦!
总结
这6个坑,每一个都是我亲身踩过的。
核心教训:
- 先检查服务状态——Gateway没跑,一切白搭
- prompt要写全——小龙虾不会做你没说的事
- 配置要完整——收件人、路径、权限一个都不能少
- 做好记忆备份——别依赖自动,Git备份最靠谱
OpenClaw确实香,但用起来确实需要渡劫。祝各位小伙伴渡劫成功!
下期预告:怎么在飞书里用上多Agent,被一群机器人包围是什么体验?敬请期待~