Tooling
像先告诉它手边现在有哪些工具,每把工具大概是干嘛的。
Concepts 导读
每个agent运行时,OpenClaw都会生成一份专属的系统提示词,且不使用pi-coding-agent的默认提示词。Provider插件只能通过替换命名核心段(如interaction_style)、注入稳定前缀或动态后缀来影响提示词,但无法替换整个OpenClaw拥有的提示词主体。最容易搞错的是:provider的修改范围是受限的,并非所有部分都可替换。
先讲这一页到底在解决什么
每个agent运行时,OpenClaw都会生成一份专属的系统提示词,且不使用pi-coding-agent的默认提示词。Provider插件只能通过替换命名核心段(如interaction_style)、注入稳定前缀或动态后缀来影响提示词,但无法替换整个OpenClaw拥有的提示词主体。最容易搞错的是:provider的修改范围是受限的,并非所有部分都可替换。
第一眼
官方把结构写得很清楚。System prompt 不是一坨混在一起的泥,而是一叠固定分区的小卡片。
像先告诉它手边现在有哪些工具,每把工具大概是干嘛的。
像开工前的提醒卡:别乱来越权,别偷偷绕开监督。
像告诉它今天在哪张桌子干活、这台机器是什么系统、现在用的是什么模型。
像告诉它去哪里翻文档、哪里有技能册、桌上已经摊开了哪些基础纸条。
最核心的事
这句话非常重要。它不是直接套 pi-coding-agent 的默认 prompt,而是 OpenClaw 自己拥有、自己组装、自己注入。
像这份上岗手册是 OpenClaw 自己编的,不是借别人家门卫的旧手册来顶替。
像每次开工前,值班台都会按今天的情况重新把卡片叠一遍。
不是随便把信息倒成一锅粥,而是按固定区块摆放,让小工人更容易抓重点。
这张卡是“OpenClaw 今天想让模型先知道什么”的正式版本。
命令与场景
官方把 bootstrap injection 讲得很细。换成画面看,它特别好懂。
AGENTS.md像“工作守则卡”。每轮开工前先让它看一眼怎么做事。
SOUL.md / IDENTITY.md像“我是谁、我怎么说话”的身份卡和气质卡。
TOOLS.md / USER.md一个像工具使用小贴士,一个像用户画像卡。让它少猜你,多知道。
BOOTSTRAP.md / MEMORY.md一个像新房第一次入住说明书,一个像长期记忆摘录卡。
因为它们不是摆设,而是每轮都会真正塞进上下文窗口里吃 token。写太胖,就像每次开工前都先背一整本厚词典,脑子很快就累了。
自动塞与按需读
MEMORY.md 会直接上桌,memory/*.md 则像抽屉里的日记本这块很容易读混。官方专门把“直接注入”和“按需读取”拆开讲,就是怕你把所有记忆都当成一回事。
MEMORY.md像一张精选版长期记忆卡,会被直接摊在桌上。
memory/*.md像抽屉里按日期存的日记本。平时不自动摊开,要用工具去翻。
太长会被剪短,并留下标记。像桌子太小,长卷轴只能先卷掉一截。
上桌的记忆要精,抽屉里的记忆可以全。
Prompt modes
官方这里讲了 full、minimal、none 三种模式。最容易懂的办法,就是把它看成三种出门背包大小。
full像主工人背大包。工具、技能、工作区、时间、心跳、用户身份这些卡都尽量带上。
minimal像子代理背轻装包。够用的基本卡带上,太重的说明册先不带,免得它跑慢。
none像只给一张最基础的“你是谁”小条子,其它都不多说。
官方说 minimal 模式下,额外上下文会改叫 Subagent Context。这像标签换了,但背包变轻才是真重点。
时间、文档、技能
System prompt 不只告诉它“你是谁”,还会顺手把现在的时间、技能目录、文档位置贴上去。
像墙上的时钟贴纸。现在官方为了缓存稳定,只重点放时区,不每次塞个跳动秒针进去。
像一张可用技能小册子的目录卡,告诉模型去哪读真正的 SKILL.md。
像在卡片上写:“遇到 OpenClaw 行为、命令、配置问题,先去本地 docs 书架查。”
/context list / /context detail这俩像透明秤。你可以拿它们看桌上到底摊了哪些卡、每张卡吃了多少上下文空间。
最容易误会
官方这一句很重要,也很诚实。Safety guardrails 是提醒卡,不是最终硬锁。
像门口贴的注意事项:请别乱闯、请别越权、请别偷偷抄近路。
要靠 tool policy、审批、sandbox、channel allowlist 这些真门锁来管。
墙上海报会提醒你别乱来,但真正能拦住你的还是门锁。
OpenClaw 没装神秘感,它把“哪些是提醒,哪些是硬约束”讲得很清楚。
最后总结
System prompt 就是每轮开工前发给小工人的总说明卡:工具、工作区、文档、技能、时间、桌上便签和安全提醒,全都由 OpenClaw 亲手拼好再塞进去。
如果你想看“这张说明卡是怎么被放进更大一轮工作流程里的”,下一页就去 /concepts/agent-loop。