OpenProse

OpenProse 是一種可攜式、以 Markdown 為核心的工作流程格式,用於編排 AI 工作階段。在 OpenClaw 中,它以外掛形式提供,安裝後會帶入 OpenProse 技能包和 /prose 斜線命令。程式寫在 .prose 檔案裡,可以產生多個子代理並明確控制流程。

官方網站:https://www.prose.md

能做什麼

  • 多 Agent 研究 + 綜合,支援明確的平行處理。
  • 可重複使用、核准安全的工作流程(程式碼審查、事件分級、內容產線)。
  • 可在支援的 Agent 執行環境之間通用的 .prose 程式。

安裝與啟用

內建外掛預設停用。啟用 OpenProse:

openclaw plugins enable open-prose

啟用後需重啟 Gateway。

本地開發版本:openclaw plugins install ./extensions/open-prose

相關文件:外掛外掛清單技能

斜線命令

OpenProse 註冊 /prose 作為使用者可呼叫的技能命令。它會路由到 OpenProse VM 指令,底層使用 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 檔案

# Research + synthesis with two agents running in parallel.

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 的憑證會流入子代理日誌;請使用專用的最低權限資料庫。

遠端程式

/prose run <handle/slug> 會解析為 https://p.prose.md/<handle>/<slug>。直接 URL 則原樣擷取。這會使用 web_fetch 工具(或 exec 來執行 POST)。

OpenClaw 執行階段對應

OpenProse 程式會對應到 OpenClaw 的基本元件:

OpenProse 概念OpenClaw 工具
產生工作階段 / Task 工具sessions_spawn
檔案讀寫read / write
網路擷取web_fetch

如果你的工具白名單阻擋了這些工具,OpenProse 程式會執行失敗。請參閱 技能設定

安全性與核准

請把 .prose 檔案當作程式碼看待。執行前先審查。使用 OpenClaw 的工具白名單和核准閘道來控制副作用。

如需確定性、需核准的工作流程,可與 Lobster 進行比較。