OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

System Prompt

这页说明书在讲一个叫“系统提示”的小秘密。它就像是每次你的智能小助手开始工作时,我们悄悄塞给它的一张“工作小纸条”。这张纸条上写好了小助手需要知道的所有重要事情:比如它可以用哪些小工具、要注意哪些安全规则、现在的时间、以及它在哪里工作等等。这样,小助手一拿到纸条,就知道该怎么好好为你干活啦!

五岁小孩版解释

每次你让OpenClaw的小助手(我们叫它“智能体”)开始工作时,OpenClaw都会为它准备一张特别的“工作小纸条”,这叫做“系统提示”。这张纸条是OpenClaw自己写的,不是用别人现成的。它会悄悄地把这张纸条塞给小助手,告诉它这次工作需要注意什么。

这张纸条写得又清楚又简短,分成好几个固定的小部分,就像你书包里不同的小口袋:

  1. 工具清单:告诉小助手现在有哪些小工具可以用,每个工具是干什么的。
  2. 安全提醒:提醒小助手要乖乖的,不能做危险的事情,也不能绕过我们的看管。
  3. 技能库(如果有的话):告诉小助手,如果需要学习新本领,可以去哪里找说明书。
  4. 自我更新说明:教小助手怎么使用 config.applyupdate.run 这两个命令来给自己升级。
  5. 工作间:告诉小助手它的工作文件夹在哪里(就是 agents.defaults.workspace 设置的地方)。
  6. 说明书:告诉小助手,OpenClaw的使用说明书放在电脑的哪个地方,什么时候应该去读一读。
  7. 工作间文件:这里会直接放一些重要的启动文件内容,小助手不用自己去找就能看到。
  8. 沙箱(如果打开了的话):告诉小助手它是在一个安全的“沙箱”里工作,能接触到哪些路径,能不能运行一些特别的命令。
  9. 当前日期和时间:告诉你所在地方的时间和时区。
  10. 回复标签:如果支持的话,告诉小助手可以用一些特殊的标签来回复。
  11. 心跳:告诉小助手要定期“心跳”,让我们知道它还在正常工作。
  12. 运行环境:用一行字告诉小助手,它在什么样的电脑、系统、模型下工作。
  13. 思考过程:告诉小助手现在别人能不能看到它的思考,以及怎么切换。

要记住哦:纸条上的安全提醒只是建议,是告诉小助手应该怎么做,但不能硬性阻止它。真正的安全要靠工具策略、命令批准、沙箱这些“硬”规定来保证。

有时候,OpenClaw会给小助手的小帮手(叫“子智能体”)准备更短的纸条,这有三种模式:

  • full(默认):就是上面说的完整纸条。
  • minimal(精简版):给小帮手用的,省略了很多部分,只留下最重要的工具、安全、工作间等信息。
  • none(没有):只给一行最基本的介绍。

为了让小助手更快认识你和工作,OpenClaw会把一些重要的启动文件内容直接写在纸条的“工作间文件”部分。这些文件有 AGENTS.md, SOUL.md 等等。小助手一拿到纸条就能看到,不用再去翻文件了。

这里要小心:把这些内容都写在纸条上会占用“位置”,如果内容太长,纸条可能就写不下了,或者需要经常压缩。所以这些文件要写得简短,特别是 MEMORY.md,它会越变越长。

如果文件太大,会被截断一部分。管理员可以通过设置 agents.defaults.bootstrapMaxChars(默认20000)和 agents.defaults.bootstrapTotalMaxChars(默认150000)来控制每个文件和所有文件的总长度。

当OpenClaw知道你的时区时,纸条上会有一个“当前日期和时间”部分。但为了稳定,上面只写时区,不写动态变化的钟点。如果小助手需要知道现在几点几分,它可以去查看 session_status 状态卡。

如果小助手有可以学习的“技能”,纸条上会列一个简单的技能清单,告诉小助手每个技能的说明书放在哪里(location)。小助手需要用 read 命令去读那个地方的 SKILL.md 文件才能学会。如果没技能,这部分就不写。

最后,如果本地有OpenClaw的说明书文件夹,纸条上也会指出来,告诉小助手有问题先查本地说明书,或者自己运行 openclaw status 命令看看。