小龙虾(OpenClaw)源码分析8:AGENTS.md等工作空间文件,如何影响Agent行为
文章目录
很多同学会觉得“我明明改了提示词,为什么助手行为变化不稳定?”
这个问题通常和工作空间文件注入机制有关。
哪些文件最关键
在OpenClaw默认工作空间里,常见文件包括:
AGENTS.md:运行规则和长期记忆倾向SOUL.md:角色、语气、边界TOOLS.md:工具使用约定IDENTITY.md、USER.md:身份与用户偏好
这些不是“摆设文件”,它们会在会话初始阶段被注入到上下文。
注入机制的价值
它解决了两类问题:
- 让行为可配置,不用每次写死系统提示
- 把“长期规则”和“临时对话”分层管理
这对个人长期使用特别重要,否则每次重启都像换了一个人。
文件不是越长越好
文档里也提到:过大的文件会被裁剪。
所以建议:
AGENTS.md写原则,不写流水账SOUL.md写边界,不写冗余修辞TOOLS.md写工具约束,不写教程
一句话,高密度信息 > 大而全。
BOOTSTRAP.md的定位
BOOTSTRAP.md通常用于新工作空间初始引导。
它的特点是“偏一次性”,不是常驻记忆主文件。
所以长期维护时,真正要持续打磨的是AGENTS.md和SOUL.md。
实战维护建议
我建议把工作空间当成一个“私有知识库仓库”来维护:
- 用git做版本管理
- 每次改动写小commit
- 对行为变化做回归验证(同一问题多轮对比)
这样你就能追踪“哪条规则改变了助手行为”。
一个简单模板思路
# AGENTS.md
- 目标:优先给出可执行步骤
- 约束:不确定时先说明假设
- 风格:中文、简洁、工程化
真正高质量配置不是花哨,而是稳定、可复用、可迭代。
小结
这一篇重点:
- 工作空间文件是Agent行为的重要输入层
- 注入机制让“长期规则”有了工程化落地
- 文件维护需要像维护代码一样做版本控制
下一篇进入模型层:多Provider与上下文窗口是怎么在源码里被解析和决策的。
