OpenProse

OpenProse 是一种以 Markdown 为核心的可移植工作流格式，用于编排 AI 会话。在 OpenClaw 中，它作为插件提供，安装后会添加 OpenProse skill 包以及 /prose 斜杠命令。程序存储为 .prose 文件，可以生成多个子 Agent 并实现显式控制流。

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

能做什么

• 带显式并行的多 Agent 研究与综合。
• 可重复的审批安全工作流（代码审查、故障处理、内容管道）。
• 可复用的 .prose 程序，可在支持的 Agent 运行时中跨平台运行。

安装与启用

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

openclaw plugins enable open-prose

启用插件后重启 Gateway。

本地开发检出：openclaw plugins install ./extensions/open-prose

相关文档：插件工具、插件 manifest、Skills。

斜杠命令

OpenProse 注册 /prose 作为用户可调用的 skill 命令。它路由到 OpenProse 虚拟机指令，底层使用 OpenClaw 工具。

常用命令：

/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 文件

让你的小龙虾同时跑两个 Agent 做研究，再合并结果：

# 两个 Agent 并行运行的研究与综合

input topic: "What should we research?"

agent researcher:
  model: sonnet
  prompt: "You research thoroughly and cite sources."

agent writer:
  model: opus
  prompt: "You write a concise summary."

parallel:
  findings = session: researcher
    prompt: "Research {topic}."
  draft = session: writer
    prompt: "Summarize {topic}."

session "Merge the findings + draft into a final answer."
context: { findings, draft }

文件位置

OpenProse 在你的工作空间下将状态保存在 .prose/ 目录：

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

用户级持久 Agent 存储在：

~/.prose/agents/

状态模式

OpenProse 支持多种状态后端：

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

注意：

• sqlite/postgres 为可选的实验性功能。
• postgres 凭据会流入子 Agent 日志；请使用专用的最小权限数据库。

远程程序

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

OpenClaw 运行时映射

OpenProse 程序映射到 OpenClaw 原语：

OpenProse 概念	OpenClaw 工具
Spawn session / Task 工具	sessions_spawn
文件读写	read / write
网页抓取	web_fetch

如果你的工具白名单阻止了这些工具，OpenProse 程序将失败。参见 Skills 配置。

安全与审批

将 .prose 文件视为代码。运行前请先审查。使用 OpenClaw 工具白名单和审批门控制副作用。

对于确定性的、需审批的工作流，可以对比 Lobster。