OpenProse

适用范围

在以下情况使用此页面：

• 你想运行或编写 .prose 工作流程
• 你想启用 OpenProse 插件
• 你需要了解状态存储

OpenProse 是一种可移植的、markdown 优先的工作流程格式，用于编排 AI 会话。在 Clawdbot 中，它作为一个插件提供，安装 OpenProse 技能包 plus 一个 /prose 斜杠命令。程序生活在 .prose 文件中，可以生成多个具有明确控制流的子智能体。

官方网站：https://www.prose.md

它可以做什么

• 具有明确并行性的多智能体研究 + 综合。
• 可重复的审批安全工作流程（代码审查、事件分类、内容管道）。
• 可重用的 .prose 程序，你可以在支持的智能体运行时中运行。

安装 + 启用

捆绑的插件默认禁用。启用 OpenProse：

clawdbot plugins enable open-prose

启用插件后重启网关。

开发/本地结账：clawdbot plugins install ./extensions/open-prose

相关文档：插件、插件清单、技能。

斜杠命令

OpenProse 将 /prose 注册为用户可调用的技能命令。它路由到 OpenProse VM 指令，并在底层使用 Clawdbot 工具。

常用命令：

/prose help
/prose run <file.prose>
/prose run <handle/slug>
/prose run <https://example.com/file.prose>
/prose compile <file.prose>
/prose examples
/prose update

示例：一个简单的 .prose 文件

# 使用两个并行运行的智能体进行研究 + 综合。

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/ 下保持状态：

.prose/
├── .env
├── runs/
│   └── {YYYYMMDD}-{HHMMSS}-{random}/
│       ├── program.prose
│       ├── state.md
│       ├── bindings/
│       └── agents/
└── agents/

用户级持久化智能体位于：

~/.prose/agents/

状态模式

OpenProse 支持多个状态后端：

• filesystem（默认）：.prose/runs/...
• in-context：瞬态，用于小程序
• sqlite（实验性）：需要 sqlite3 二进制文件
• postgres（实验性）：需要 psql 和连接字符串

注意事项：

• sqlite/postgres 是可选的和实验性的。
• postgres 凭据流入子智能体日志；使用专用的、最小权限的数据库。

远程程序

/prose run <handle/slug> 解析为 https://p.prose.md/<handle>/<slug>。 直接 URL 按原样获取。这使用 web_fetch 工具（或用于 POST 的 exec）。

Clawdbot 运行时映射

OpenProse 程序映射到 Clawdbot 基元：

如果你的工具允许列表阻止了这些工具，OpenProse 程序将失败。请参阅 技能配置。

安全 + 审批

将 .prose 文件视为代码。运行前检查。使用 Clawdbot 工具允许列表和审批门来控制副作用。

对于确定性、审批门控的工作流程，请与 Lobster 进行比较。