OpenClaw 从0到1实战剖析(05):TOOLS.md 该怎么用
昨天我们讲 USER.md:让 Agent 理解你的协作偏好。
今天接着讲 TOOLS.md:让 Agent 在你的环境里稳定执行。
一句话:
USER.md解决“怎么配合你”TOOLS.md解决“怎么把事做完”
1. 一、为什么讲完 USER.md,下一步一定是 TOOLS.md
很多任务失败,不是模型不会思考,而是缺少执行说明。
常见情况:
知道要跑日报脚本,但不知道脚本在什么路径 知道要连浏览器自动化,但不知道用哪个 profile 知道要导出文件,但不知道保存目录和命名规则
这不是“智力问题”,是“环境信息缺失”。
2. 二、TOOLS.md 只写三类信息
2.1 1) 固定常量
例如:
固定目录: reports/daily/固定 profile: work_chrome固定命名: 日报-YYYY-MM-DD.md
2.2 2) 固定动作顺序
例如“生成销售日报”:
拉取 CRM 数据 清洗并汇总 输出到指定目录 发送到团队群
2.3 3) 易错细节
例如:
哪些命令必须在项目根目录执行 哪个参数不能省略 哪一步失败后必须重试而不是跳过
3. 三、一个可直接复用的片段(非公众号场景)
md
### Daily Report Pipeline
- 数据源:crm_export.csv(路径:data/crm/)
- 输出目录:reports/daily/
- 文件命名:sales-daily-YYYY-MM-DD.md
- 执行顺序:extract -> summarize -> publish
- 失败重试:publish 失败最多重试 2 次
### Browser Automation
- 统一使用 pinchtab
- 工作账号 profile:work_chrome
- 常用动作:nav / snap / click / fill / press
原则只有一条:只写可执行信息,不写背景解释。
4. 四、怎么判断 TOOLS.md 是否合格
用 3 个问题自测:
新开会话,不补充口头背景,Agent 能跑通吗? 一周后重跑,结果会不会因为信息过期而漂移? 同一任务连跑两次,结果是否一致?
只要有一个“不能”,就继续精简和补全。
5. 五、和昨天的关系
USER.md决定“你要什么结果”TOOLS.md决定“怎么稳定交付结果”
前者是协作层,后者是执行层。 两者接上,Agent 才从“会聊天”变成“能交付”。
下一篇继续:
《OpenClaw 从0到1实战剖析(06):memory/ 与 MEMORY.md 怎么分工,Agent 才会越用越懂你》
夜雨聆风