简要总结
Agent Runtime
这页说明书在讲一个叫“Agent Runtime”的机器人小管家是怎么工作的。它就像你给一个聪明的机器人朋友准备一个专属的小房间,里面放好了它需要记住的规则、它喜欢的说话方式,还有它能用的各种小工具。我们来看看怎么帮它布置好这个小房间,让它能开心地帮你做事。
五岁小孩版解释
这个叫 OpenClaw 的系统,里面住着一个机器人小管家。它需要一个自己的小房间来工作和存放东西,这个小房间就是一个文件夹。
第一步:准备小房间(Workspace) 这个小房间是必须的,机器人只能在这个文件夹里使用工具和看东西。你可以把它想成是机器人的专属游戏桌。
- 要做什么:告诉机器人它的房间在哪里。
- 怎么做:在设置里找到
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)系统自带的,(2)你电脑上
~/.openclaw/skills文件夹里的,(3)机器人小房间里的skills文件夹里的。如果名字一样,小房间里的技能优先。 - 要小心:
TOOLS.md文件只是你写的使用建议,并不能决定机器人有哪些工具。
第四步:会话与实时指导(Sessions & Steering) 机器人和你的每次聊天都是一次“会话”,记录会保存下来。
- 会话怎么工作:当机器人正在说话(“流式输出”)时,你可以打断它给它新的指令。这取决于“队列模式”:
- 如果模式是
steer:你一发新消息,机器人会立刻停下当前动作,处理你的新指令。 - 如果模式是
followup或collect:你的新消息会等机器人说完当前的话,再开始新的一轮聊天。
- 如果模式是
- 关于“分块流式输出”:默认是关闭的 (
blockStreamingDefault: "off")。如果打开,机器人会说完一小段话就立刻发出来,而不是等全部说完。
第五步:选择机器人的大脑(Model refs) 你需要告诉机器人用哪个“大脑”(AI模型)来思考。
- 要做什么:在设置里指定模型,格式是
提供者/模型名。 - 怎么做:比如写
openai/gpt-4。如果模型名自己就带/(比如openrouter/moonshotai/kimi-k2),也要把前面的提供者(openrouter)写上。如果不写提供者,系统会把它当成默认提供者的模型。
最后,必须的配置 为了让机器人最基本地工作起来,你至少需要设置两样东西:
agents.defaults.workspace:机器人的小房间路径。(必须)channels.whatsapp.allowFrom:允许谁通过WhatsApp联系机器人。(强烈建议设置)