OC
OpenClaw 中文解释版

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

简要总结

Agent Loop

这页说明书讲的是一个叫“智能助手”的小机器人是怎么工作的。就像你让一个小机器人帮你画画或者找东西,它会先听清楚你的话,然后自己想一想,再用它的工具去做事,最后把结果告诉你。这一页就是告诉你,这个小机器人从收到你的话到回答你,中间都悄悄做了哪些事情。如果你想知道小机器人是怎么“动起来”的,就可以看这一页。

五岁小孩版解释

这个“智能助手循环”就是小机器人一次完整的工作过程。它从收到你的消息开始,到把最后的回答送给你结束。整个过程就像一条不能乱跑的专用小路,保证小机器人不会迷路,也不会把不同小朋友的事情搞混。

怎么启动小机器人? 有两种主要方法可以叫小机器人开始工作:

  1. 通过一个叫“网关”的通道,使用 agentagent.wait 这两个指令。
  2. 在电脑的命令行里,直接输入 agent 这个命令。

小机器人工作的主要步骤(简化版)

  1. 开始任务:首先,检查你给的任务是不是合格的,找到属于你的对话房间,然后立刻告诉你:“任务收到啦,这是你的任务编号”。
  2. 执行任务:小机器人开始真正干活。它会决定用哪个“大脑”(模型)来思考,准备好它能用的所有“技能包”,然后进入核心工作区。
  3. 核心工作:在工作区里,它会排队工作,防止混乱。它会连接好“大脑”,认真思考你的问题,使用工具,并且一边做一边把想到的、做到的事情“直播”出来。如果工作太久超时了,它就会停下来。
  4. 直播过程:小机器人会把核心工作区的“直播”信号转成我们能看懂的消息,比如“工具开始用了”、“小机器人说话了”、“任务开始或结束了”。
  5. 等待结果:如果你用了 agent.wait 指令,它会一直等着,直到小机器人发出“任务结束”或“出错了”的信号,然后告诉你最终的结果。

一些重要的规则和提醒

  • 排队不打架:同一个小朋友的对话,小机器人会一件一件按顺序做,不会同时做两件事,这样它的记忆就不会乱。
  • 准备工作:小机器人工作前,会准备好它的“小书房”(工作区),拿出所有它能用的“技能卡片”,还会锁上“书房门”,防止别人打扰。
  • 怎么跟“大脑”说话:小机器人会把它的基本规则、你的要求、还有技能说明,一起打包成一段很长的话,告诉它的“大脑”。这段话不能太长,有字数限制。
  • 你可以中途“喊停”或“加话”:在小机器人工作的好几个地方,你都可以通过“钩子”来插手。比如,在它准备和“大脑”说话前,你可以偷偷加一句提醒;或者在它用完工具后,你可以看看工具的结果。
  • “直播”和最后回答:小机器人思考的话和工具工作的过程,都会像直播一样一点点发出来。最后,它会把所有有用的结果拼成最终的回答给你。如果它什么都没说(发出了 NO_REPLY 这个安静信号),就不会打扰你。
  • 节省“大脑”空间:如果对话太长了,“大脑”记不住,小机器人会自动把旧的、不重要的聊天整理压缩,腾出空间,有时候这会让它重新思考一次。
  • 时间限制:小机器人自己干活最多有 600秒(10分钟)的时间。而等待结果(agent.wait)默认只等 30秒,你可以告诉它多等一会儿。
  • 可能提前结束:如果小机器人干活超时了、你取消了任务、或者网络断开了,它的工作都会提前停下来。