乐于分享
好东西不私藏

OpenClaw,我踩过的那些坑(一)

OpenClaw,我踩过的那些坑(一)

用 OpenClaw 一段时间了,陆续创建了 多个智能体,经历了各种奇葩问题。今天把最常见的几个坑整理一下,供大家参考。很多坑均可以用openclaw协助解决,不懂就问它!


一、Mac 熄屏/SSH 断开后,OpenClaw 还能运行吗?

答案:能,但需要正确配置。

一开始我的做法是开一个终端窗口挂着,SSH 进去跑命令。后来发现:

  • 熄屏后终端会话可能断开
  • SSH 长时间空闲可能会被踢掉
  • 电脑合盖休眠后进程就没了

解决方案:使用 macOS LaunchAgent

我把 OpenClaw Gateway 注册成了系统服务(LaunchAgent),配置文件在:

bash~/Library/LaunchAgents/ai.openclaw.gateway.plist

核心配置就三行:

xml<key>RunAtLoad</key><true/><key>KeepAlive</key><true/>

这样 OpenClaw 会在 Mac 开机时自动启动,熄屏、休眠、断开 SSH 都不影响。而且如果进程意外崩溃,系统会自动帮我重启。

效果: 现在 Mac 就像一台 24 小时运行的服务器,随时通过飞书远程控制,完全不用操心它的运行状态。

备注:Linux服务器也有类似的操作。


二、飞书远程控制失灵了?怎么远程重启

这是最头疼的问题。

OpenClaw 安装、升级时经常需要重启 Gateway,偶尔会遇到飞书远程控制突然失效的情况——这时候你想发消息让它重启,但消息根本发不出去。

手机 SSH?别想了。一般的解决办法就是手动去mac上操作,或者SSH进去配置,反正需要用电脑,但是很多时候电脑不在身边,就很麻烦。

不过现在我有了终极解决方案:Openclaw和Hermes 双向守护,一个出问题了,让另外一个重启,有一种左脚踩右脚,右脚踩左脚,原地升天的感觉。

效果: 现在基本不需要手动进电脑操作,全手机飞书解决。


三、创建多个智能体?一定要分开 workspace!

这是最恼火的问题。

OpenClaw 的机制是每个智能体一个独立的文件夹,默认放在 ~/.openclaw/workspace/ 下。我一开始不知道,一直在用openclaw的main agent创建其他智能体,直到创建了 6 个智能体后才发现:

  • 很多智能体的工作区文件都堆在 main智能体 的 workspace 里
  • 有的智能体甚至和其他智能体共用同一个工作区文件夹
  • 因为混乱的文件管理,有些智能体的 SOUL.mdIDENTITY.md 直接没生成,用的默认的

问题根源: 创建新智能体时没有指定独立的 workspace。

正确做法:在openclaw创建智能体时,一定要指定独立的工作目录,或者如下手动创建智能体。

bash# 创建 xagent,指定单独的 workspaceopenclaw agents create xagent --workspace ~/.openclaw/workspace-xagent# 创建 data-agent,指定另一个 workspace  openclaw agents create data-agent --workspace ~/.openclaw/workspace-data-agent

因为长时间的运行,每个智能体里面的project都很多,我费了好几天才整理完成和进行配置工作区,下面是自己整理后的目录结构,清爽多了:

bash~/.openclaw/├── workspace/       # 主智能体├── workspace-ai_tech/    # AI科技号助手├── workspace-battery/    # 电池技术分析├── workspace-claude/     # Claude 代码助手├── workspace-data/       # 数据分析助手├── workspace-shooting/   # 射击项目数据助手

教训: 创建智能体前先规划好目录,创建时就把 workspace 指定清楚,后期能省大量麻烦。


四、智能体内部文件混乱?

这个问题更隐蔽。

智能体用久了,发现它特别”随性”——我交代的任务,代码、文档、图片、截图全部堆在一起:

bashworkspace/├── 新垣结衣.jpg├── 会议记录.docx├── 处理一下.py├── 截图.png├── 改改改.py├── 改改改_v2.py├── 改改改_final.py├── 改改改_真的_final.py├── 数据.xlsx└── 等等我看看.txt

就像有些人的电脑桌面,密密麻麻全是文件。

后果:

  • 任务多了之后,根本找不到”当时那个任务是怎么做的”
  • 想回顾学习进度,发现 AI 自己都乱了
  • 新任务和老任务混在一起,上下文污染严重

解决方案:项目制文件夹 + 强调规则

在 SOUL.md 里特别强调:

markdown## 文件管理规则每个项目单独建文件夹,格式:`project_项目名/`工作流程:1. 新任务 → 先创建项目文件夹2. 任务相关文件 → 全部放入该文件夹3. 任务结束 → 在文件夹内写 README.md 总结

改造后:

bashworkspace/├── project_公众号选题/│   ├── 选题库.md│   ├── 热词分析.py│   └── 参考文章/├── project_数据报告/│   ├── 原始数据/│   ├── 分析脚本.py│   └── 报告_2026-04.docx└── project_代码重构/    ├── README.md    ├── 旧版本/    └── 新版本/

但问题还没完全解决: 虽然 SOUL.md 里写了规则,AI 仍然会”忘记”,偶尔还是乱放文件。

我在准备做的事:写一个 Skill

打算写一个 OpenClaw Skill,核心功能:

  1. 自动检测项目状态:收到新任务时,先扫描 workspace 目录下是否已有相同的项目文件夹
  2. 未做过 → 自动创建 + 确认用户:如果没有做过这个项目,自动创建 project_项目名/ 文件夹,并告知用户”这个项目是新的,已为你创建文件夹,是否开始?”
  3. 已做过 :如果检测到相似项目,在原有基础上继续。

等测试完毕会开源出来。


五、总结

用 OpenClaw 这么长时间,最深的体会是:它很强大,但需要正确的”打开方式”,不然它可能很“笨”

几个关键配置做好,后面的麻烦会少很多:

问题
解决方案
熄屏/断开后运行
LaunchAgent + KeepAlive
远程重启失效
Hermes 双向守护
多智能体文件混乱
创建时指定独立 workspace
单智能体内部混乱
项目制文件夹 

有其他问题欢迎交流。