乐于分享
好东西不私藏

OpenClaw 从0到1实战剖析(05):TOOLS.md 该怎么用

OpenClaw 从0到1实战剖析(05):TOOLS.md 该怎么用

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) 固定动作顺序

例如“生成销售日报”:

  1. 拉取 CRM 数据
  2. 清洗并汇总
  3. 输出到指定目录
  4. 发送到团队群

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 个问题自测:

  1. 新开会话,不补充口头背景,Agent 能跑通吗?
  2. 一周后重跑,结果会不会因为信息过期而漂移?
  3. 同一任务连跑两次,结果是否一致?

只要有一个“不能”,就继续精简和补全。


5. 五、和昨天的关系

  • USER.md 决定“你要什么结果”
  • TOOLS.md 决定“怎么稳定交付结果”

前者是协作层,后者是执行层。 两者接上,Agent 才从“会聊天”变成“能交付”。


下一篇继续: 《OpenClaw 从0到1实战剖析(06):memory/MEMORY.md 怎么分工,Agent 才会越用越懂你》