Concepts 导读

系统提示词由OpenClaw全权组装,provider只能插片,不能换芯

每个agent运行时,OpenClaw都会生成一份专属的系统提示词,且不使用pi-coding-agent的默认提示词。Provider插件只能通过替换命名核心段(如interaction_style)、注入稳定前缀或动态后缀来影响提示词,但无法替换整个OpenClaw拥有的提示词主体。最容易搞错的是:provider的修改范围是受限的,并非所有部分都可替换。

先讲这一页到底在解决什么

系统提示词由OpenClaw全权组装,provider只能插片,不能换芯

每个agent运行时,OpenClaw都会生成一份专属的系统提示词,且不使用pi-coding-agent的默认提示词。Provider插件只能通过替换命名核心段(如interaction_style)、注入稳定前缀或动态后缀来影响提示词,但无法替换整个OpenClaw拥有的提示词主体。最容易搞错的是:provider的修改范围是受限的,并非所有部分都可替换。

原文共 9 节,先看 Start Here 路径:/concepts/system-prompt 查看官方原文

第一眼

🧾 它不是“单独一句话”,而是一整套折好的小卡片

官方把结构写得很清楚。System prompt 不是一坨混在一起的泥,而是一叠固定分区的小卡片。

🧰

Tooling

像先告诉它手边现在有哪些工具,每把工具大概是干嘛的。

🛡

Safety

像开工前的提醒卡:别乱来越权,别偷偷绕开监督。

🏠

Workspace / Runtime

像告诉它今天在哪张桌子干活、这台机器是什么系统、现在用的是什么模型。

📚

Docs / Skills / Files

像告诉它去哪里翻文档、哪里有技能册、桌上已经摊开了哪些基础纸条。

最核心的事

🦞 官方特地强调:这张总说明卡是 OpenClaw 自己写的

这句话非常重要。它不是直接套 pi-coding-agent 的默认 prompt,而是 OpenClaw 自己拥有、自己组装、自己注入。

OpenClaw-owned

像这份上岗手册是 OpenClaw 自己编的,不是借别人家门卫的旧手册来顶替。

每次 run 都会组装

像每次开工前,值班台都会按今天的情况重新把卡片叠一遍。

按区块拼起来

不是随便把信息倒成一锅粥,而是按固定区块摆放,让小工人更容易抓重点。

📌 一句话

这张卡是“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

像抽屉里按日期存的日记本。平时不自动摊开,要用工具去翻。

✂️

Truncation

太长会被剪短,并留下标记。像桌子太小,长卷轴只能先卷掉一截。

🎈

一句话

上桌的记忆要精,抽屉里的记忆可以全。

Prompt modes

🪶 子代理为什么会拿到更瘦的说明卡?因为它们只带轻装包

官方这里讲了 fullminimalnone 三种模式。最容易懂的办法,就是把它看成三种出门背包大小。

full

像主工人背大包。工具、技能、工作区、时间、心跳、用户身份这些卡都尽量带上。

minimal

像子代理背轻装包。够用的基本卡带上,太重的说明册先不带,免得它跑慢。

none

像只给一张最基础的“你是谁”小条子,其它都不多说。

Subagent Context

官方说 minimal 模式下,额外上下文会改叫 Subagent Context。这像标签换了,但背包变轻才是真重点。

时间、文档、技能

🕰 这些区块像“小贴纸”,看着不起眼,实际很救命

System prompt 不只告诉它“你是谁”,还会顺手把现在的时间、技能目录、文档位置贴上去。

Current Date & Time

像墙上的时钟贴纸。现在官方为了缓存稳定,只重点放时区,不每次塞个跳动秒针进去。

Skills

像一张可用技能小册子的目录卡,告诉模型去哪读真正的 SKILL.md

Documentation

像在卡片上写:“遇到 OpenClaw 行为、命令、配置问题,先去本地 docs 书架查。”

/context list / /context detail

这俩像透明秤。你可以拿它们看桌上到底摊了哪些卡、每张卡吃了多少上下文空间。

最容易误会

🛡 Safety 写在 system prompt 里,不等于它自己就是铁门

官方这一句很重要,也很诚实。Safety guardrails 是提醒卡,不是最终硬锁。

📝

Prompt 里的安全提醒

像门口贴的注意事项:请别乱闯、请别越权、请别偷偷抄近路。

🔒

真正硬锁

要靠 tool policy、审批、sandbox、channel allowlist 这些真门锁来管。

📌

一句话

墙上海报会提醒你别乱来,但真正能拦住你的还是门锁。

🎈

这页真正的态度

OpenClaw 没装神秘感,它把“哪些是提醒,哪些是硬约束”讲得很清楚。

最后总结

🎈 把这页压成一句最短的话

System prompt 就是每轮开工前发给小工人的总说明卡:工具、工作区、文档、技能、时间、桌上便签和安全提醒,全都由 OpenClaw 亲手拼好再塞进去。

如果你想看“这张说明卡是怎么被放进更大一轮工作流程里的”,下一页就去 /concepts/agent-loop