OC
OpenClaw 中文解释版

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

简要总结

Agent Runtime

这页说明书在讲一个叫“Agent Runtime”的机器人小管家是怎么工作的。它就像你给一个聪明的机器人朋友准备一个专属的小房间,里面放好了它需要记住的规则、它喜欢的说话方式,还有它能用的各种小工具。我们来看看怎么帮它布置好这个小房间,让它能开心地帮你做事。

五岁小孩版解释

这个叫 OpenClaw 的系统,里面住着一个机器人小管家。它需要一个自己的小房间来工作和存放东西,这个小房间就是一个文件夹。

第一步:准备小房间(Workspace) 这个小房间是必须的,机器人只能在这个文件夹里使用工具和看东西。你可以把它想成是机器人的专属游戏桌。

  1. 要做什么:告诉机器人它的房间在哪里。
  2. 怎么做:在设置里找到 agents.defaults.workspace,填上文件夹的路径。最简单的办法是,在电脑上运行 openclaw setup 这个命令,它会帮你自动创建好房间和需要的文件。

第二步:放好启动文件(Bootstrap files) 在机器人的小房间里,需要提前放好一些写满字的文件,就像给机器人看的“说明书”和“记忆本”。第一次启动时,机器人会先读这些文件。 这些文件有:

  • AGENTS.md:操作指南和“记忆”。
  • SOUL.md:机器人的性格、不能做的事、说话的语气。
  • TOOLS.md:你写的工具使用笔记。
  • BOOTSTRAP.md:第一次启动时的欢迎仪式(完成后会自动删除)。
  • IDENTITY.md:机器人的名字和喜欢的表情符号。
  • USER.md:你的个人资料。 如果文件是空的,机器人就不看。如果文件太大,机器人只会看前面一部分。如果文件不见了,机器人会知道,并且 openclaw setup 命令可以帮你创建空白的模板。注意:BOOTSTRAP.md 这个文件只会在全新的、空荡荡的小房间里创建一次。

第三步:了解内置工具和技能(Built-in tools & Skills) 机器人有一些天生就会的工具,比如读文件、运行命令、编辑文字。它还能学习更多“技能”。

  1. 技能从哪里来:从三个地方找,按顺序是(1)系统自带的,(2)你电脑上 ~/.openclaw/skills 文件夹里的,(3)机器人小房间里的 skills 文件夹里的。如果名字一样,小房间里的技能优先。
  2. 要小心:TOOLS.md 文件只是你写的使用建议,并不能决定机器人有哪些工具。

第四步:会话与实时指导(Sessions & Steering) 机器人和你的每次聊天都是一次“会话”,记录会保存下来。

  1. 会话怎么工作:当机器人正在说话(“流式输出”)时,你可以打断它给它新的指令。这取决于“队列模式”:
    • 如果模式是 steer:你一发新消息,机器人会立刻停下当前动作,处理你的新指令。
    • 如果模式是 followupcollect:你的新消息会等机器人说完当前的话,再开始新的一轮聊天。
  2. 关于“分块流式输出”:默认是关闭的 (blockStreamingDefault: "off")。如果打开,机器人会说完一小段话就立刻发出来,而不是等全部说完。

第五步:选择机器人的大脑(Model refs) 你需要告诉机器人用哪个“大脑”(AI模型)来思考。

  1. 要做什么:在设置里指定模型,格式是 提供者/模型名
  2. 怎么做:比如写 openai/gpt-4。如果模型名自己就带 /(比如 openrouter/moonshotai/kimi-k2),也要把前面的提供者(openrouter)写上。如果不写提供者,系统会把它当成默认提供者的模型。

最后,必须的配置 为了让机器人最基本地工作起来,你至少需要设置两样东西:

  1. agents.defaults.workspace:机器人的小房间路径。(必须)
  2. channels.whatsapp.allowFrom:允许谁通过WhatsApp联系机器人。(强烈建议设置)