OC
OpenClaw 中文解释版

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

简要总结

OpenProse

这页说明书在讲一个叫 OpenProse 的玩具。它就像一个能让好几个小机器人一起帮你干活的“说明书”。你可以写一个特别的 .prose 文件,告诉小机器人谁先干活、谁后干活,然后它们就会听话地帮你做研究、写总结或者检查代码。这页会告诉你怎么打开这个玩具,还有怎么用它。

五岁小孩版解释

OpenProse 是一个特别的“说明书”格式,专门用来指挥 AI 小机器人干活。你可以把它想成给机器人看的乐高图纸。这个图纸是 .prose 文件,里面可以安排好几个小机器人,让它们同时或者一个接一个地工作。

它能做什么? 它可以做好几件很酷的事情:

  1. 多机器人一起研究:让好几个小机器人像赛跑一样同时去找资料,然后把找到的东西拼起来。
  2. 安全重复的工作:比如检查代码有没有错误,或者处理一些紧急的事情,每次都能用同样的安全方法再做一遍。
  3. 可以重复用的程序:你写好的 .prose 图纸,可以在其他支持的地方再使用。

怎么安装和打开它? 在 OpenClaw 里,OpenProse 是一个默认关着的“插件”,就像玩具里一个还没装上电池的部件。你需要先打开它。

  1. 打开插件:你需要告诉电脑一个“咒语”:openclaw plugins enable open-prose。这就像说“芝麻开门”,让电脑知道你要用这个玩具了。
  2. 重启网关:做完上一步后,你需要重启一下“网关”(Gateway)。这就像把玩具的总开关关掉再打开,让它能认识新装好的部件。
    • 注意:如果你是自己从别的地方拿到的这个插件,安装的“咒语”会不一样,是 openclaw plugins install ./extensions/open-prose

怎么使用它? 打开后,你就可以用一个简单的命令 /prose 来玩啦!就像在聊天框里输入一样。

  • /prose help:说“帮帮我”,它会告诉你怎么用。
  • /prose run <文件.prose>:说“运行这个图纸”,后面加上你的 .prose 文件名字。
  • /prose run <名字>:可以直接运行网上别人分享的图纸。
  • /prose compile <文件.prose>:可以先检查一下你的图纸写得对不对,但不真的运行。
  • /prose examples:看看别人写的例子图纸。
  • /prose update:更新这个玩具到最新版本。

一个简单的小图纸例子 下面是一个让两个小机器人一起工作的图纸例子,一个负责研究,一个负责写总结:

# 让两个小机器人一起工作。
input topic: “我们要研究什么?” # 这里你告诉它们要研究什么题目

agent researcher: # 第一个机器人叫“研究员”
  model: sonnet # 它用的脑子型号
  prompt: “你要仔细研究,并且告诉我是从哪里找到的。” # 给它的指令

agent writer: # 第二个机器人叫“作家”
  model: opus # 它用的脑子型号
  prompt: “你要写一个简短的小总结。” # 给它的指令

parallel: # “同时开始!”让两个机器人一起干活
  findings = session: researcher # 让“研究员”去干活,结果叫“发现”
    prompt: “研究一下{topic}。” # 给它的具体任务
  draft = session: writer # 让“作家”去干活,结果叫“草稿”
    prompt: “总结一下{topic}。” # 给它的具体任务

session “把发现和草稿合并成最终答案。” # 最后,再让一个机器人(默认的)做合并
context: { findings, draft } # 告诉它,这是“研究员”和“作家”的成果

重要的事情和要注意的地方

  • 文件放在哪:OpenProse 会在你的工作文件夹里创建一个 .prose/ 小房子,里面放着它运行时的所有记录和小机器人的信息。
  • 记住事情的方式:默认它会把事情记在文件夹里(filesystem)。还有其他实验性的方法,比如记在数据库里(sqlite或postgres),但那些需要额外的东西,还不稳定。
  • 运行网上的图纸:你可以直接用 /prose run 后面加一个网址,来运行别人放在网上的图纸。
  • 它怎么工作的:在 OpenClaw 里面,OpenProse 的指令(比如让机器人干活、读文件、上网)其实是用 OpenClaw 自己的工具来完成的。如果你的 OpenClaw 设置不允许使用这些工具,OpenProse 就会失败。
  • 安全第一.prose 文件就像真正的程序代码,运行前一定要检查一下里面写了什么。可以用 OpenClaw 的“工具允许名单”和“批准关卡”来控制,防止它做不好的事情。如果你想要一个每一步都需要你点头同意才能继续的、更确定的工作流程,可以看看另一个叫 Lobster 的工具。