openclaw-guide/
├── README.md # 本文件:10 件必做的事
├── templates/
│ ├── soul.md.template # 灵魂文件模板
│ ├── USER.md.template # 使用者档案模板
│ ├── AGENTS.md.template # 工作指南模板
│ ├── TOOLS.md.template # 工具配置模板
│ └── HEARTBEAT.md.template # 心跳任务模板
└── skills/
├── content-creation.md # 内容创作 Skill
├── decision-eval.md # 商务决策 Skill
├── deep-learning.md # 深度讲解 Skill
└── group-chat.md # 群聊行为 Skill
把 Claw 当一个刚入职的实习生来带:它比你懂得多,但它不认识你,也不知道要干嘛。 你的工作是告诉它你是谁、要干什么、边界在哪。
OpenClaw 的配置分三个层级,理解这个结构是一切的前提:
| 层级 | 文件 | 作用 | 修改频率 |
|---|---|---|---|
| 灵魂层 | soul.md |
性格、价值观、红线 | 极少改 |
| 身份层 | USER.md |
你是谁、你要干嘛 | 每季度 |
| 行为层 | AGENTS.md |
怎么干活 | 偶尔改 |
| 工具层 | TOOLS.md |
能用什么工具 | 按需改 |
| 自动化层 | HEARTBEAT.md |
主动干什么 | 稳定后改 |
| 记忆层 | memory.md |
对话中积累的记忆 | 每天更新 |
对应文件:soul.md
这是 Claw 的出厂设置,所有行为的底层逻辑。没有这个文件,后面的一切配置都是在沙上建楼。
必须写清楚的四件事:
- 性格与工作风格:它说话的方式、你喜欢什么样的沟通节奏
- 价值观优先级:遇到冲突时,它应该优先哪个原则(例:实事求是 > 迎合你)
- 隐私红线:手机号、银行卡、住址、密码,永远不给、永远不传
- 学习与反馈机制:说对了怎么强化,说错了怎么纠正
对应文件:USER.md
Claw 的所有判断都基于「它在帮谁」。这个文件越详细,它的决策就越贴合你的实际处境。
必须包含的内容:
- 你的职业背景和当前职位
- 当前最重要的 2-3 个工作目标
- 你的沟通风格偏好(结论先行?喜欢列表?)
- 你现在没有资源做的事(别让它提不切实际的建议)
常见错误:把工作流程写进 USER.md。USER.md 描述「你是谁」,AGENTS.md 描述「它怎么干活」,不要混。
对应文件:AGENTS.md
相当于员工手册。最重要的两块:
接任务时的标准动作(防止它「理解一半就开始干」):
第一步:复述理解 → 第二步:列出缺失信息 → 第三步:执行 → 第四步:交付+摘要
自主决策边界(防止它自作主张):
- 哪些事可以自己决定?
- 哪些事必须先问你?
- 遇到阻碍时找谁、怎么升级?
没有升级路径,Claw 会绕路解决然后告诉你;有了升级路径,它会停下来等你。
对应文件:TOOLS.md
很多人只写了「可以用浏览器」,没写「不能登录账号」,结果 Claw 代表你做了你不知道的事。
最小权限原则:只开放你真正需要用到的工具,每个工具同时写清楚「能做什么」和「不能做什么」。
四类工具的配置重点:
| 工具 | 最重要的限制 |
|---|---|
| 浏览器 | 禁止登录、填表、注册、发帖 |
| SSH | 必须有服务器白名单,危险命令必须先确认 |
| 语音 | 识别结果先给你看,有歧义先问 |
| 摄像头 | 未经指令不启动,不存储,不识别人脸 |
对应文件:memory.md(对话中触发)
这是最容易被忽略的一步,也是导致「养了虾但它一直忘事」的根本原因。
对话结束、上下文爆掉之后,Claw 会把没有显式存储的内容全部忘掉。说过不等于记住了。
每次聊完重要决定、偏好或规则之后,跟上这句话:
把我们刚才讨论的结论写进你的 memory.md。
格式:日期 + 一句话总结 + 执行要求。写完告诉我写了什么。
养成这个习惯之后,Claw 会越来越懂你,而不是每次都像第一次见面。
对应方式:对话中生成
如果你发现自己第三次在教 Claw 同样的事,那它就应该变成一个 Skill。
Skill 生成公式:
我要创建一个新的 Skill:
触发词:[以后我说什么就执行]
输入:[我给你什么]
输出格式:[你产出什么,格式要求]
质量标准:[什么叫做好了]
禁止事项:[什么不能出现]
常见的值得变成 Skill 的场景:内容脚本生成、商务合作判断、文件格式转换、特定风格写作。
操作原则(不需要投喂给 Claw)
OpenClaw 是开源软件,Skill 市场鱼龙混杂——就像当年找暴风影音能找到二十个假链接一样。
只去这些地方学 Skill:
- 字节官方:扣子(Coze)
- 腾讯官方:SkillHub — 全中文、已安全审核、国内高速下载
- 阿里官方:百炼平台 — 集成通义千问,支持一键部署
- OpenClaw 官方:ClawHub — 原版市场,3000+ Skill
- 进阶用户:awesome-openclaw-skills — GitHub,5400+
- OpenClaw 官方仓库和文档
- 你信任的、有技术背景的朋友分享的
识别风险 Skill 的信号:
- Skill 要求你提供 API Key 或账号密码
- Skill 的描述含糊,说不清它实际做什么
- 来源不明,没有维护者信息
操作原则(不需要投喂给 Claw)
云端部署的优势:
- 大厂帮你防黑客,有基础的安全保障
- 挂了自动修复,不需要你本人去「修服务器」
- 不会因为忘记隔离而在本地电脑上留下数据
如果你用的是飞书妙搭:天然云端部署,直接用,不需要额外配置。
对应文件:HEARTBEAT.md
HEARTBEAT 是让 Claw 从「你叫它才动」变成「它主动干活」的文件。删掉这个文件,Claw 变成纯被动工具。
但正因为它会自动执行,所以风险也最高。
上线顺序:
USER.md → AGENTS.md → TOOLS.md → [稳定运行1-2周] → HEARTBEAT.md
配置 HEARTBEAT 前必须问自己:如果这个自动任务出错了,后果是什么?后果不可接受的任务,加「执行前通知我确认」的保险。
三类心跳任务,复杂度从低到高:
- 定时任务:每天早报、每周周报素材整理
- 触发任务:舆情异常预警、Deadline 提醒
- 守护任务:每日自检、规则冲突检查
心态原则(最重要,也最容易忽略)
这件事不需要投喂给 Claw,需要你自己记住。
两个极端都要避免:
- 过度期待:以为装上就能无所不能,结果一天20小时在修虾
- 过早放弃:遇到一两次挫折就卸载,然后说「这东西没用」
持续养虾的用户反馈,能达到这个效果是因为他每天喂数据、每次纠错都让它记住、每个重复场景都变成 Skill,这是几个月积累的结果。
持续喂数据的几个习惯:
- 重要对话、会议录音 → 总结后喂给 Claw
- 你写过的文章、做过的演讲 → 让它学习你的表达风格
- 每次它做得好或做得差 → 立刻反馈,让它记住
「数据越多虾越懂你;跟虾沟通久了,你自己说话也会更有条理。」
| 文件 | 必填字段 | 更新频率 | 模板 |
|---|---|---|---|
soul.md |
性格、价值观、隐私红线、反馈机制 | 极少 | → |
USER.md |
职业背景、当前目标、沟通偏好 | 每季度 | → |
AGENTS.md |
任务流程、决策边界、升级路径 | 偶尔 | → |
TOOLS.md |
每个工具的允许/禁止操作 | 按需 | → |
HEARTBEAT.md |
定时任务、触发条件、自检规则 | 稳定后 | → |
综合自己及网友们的 OpenClaw 实际使用经验。
欢迎提 Issue 或 PR 补充你的使用心得。
OpenClaw 官方:github.com/OpenClaw