使用 OpenProse 實現 AI 任務自動化與多 Agent 協作

你是不是也覺得，每次要 AI 處理複雜任務時，總是在手動複製貼上？當任務需要多個步驟，或者需要不同的模型分工合作時，純對話介面就顯得力不從心。

我們都希望 AI 能像寫程式一樣，有明確的控制流程、可以並行處理任務，而且寫完一次就能重複執行。這就是 OpenProse 派上用場的地方。它讓你用 Markdown 格式來定義 AI 工作流，把複雜的協作過程變得像跑腳本一樣簡單。

需要準備的東西

在開始之前，請確保你已經準備好：

已安裝並運行中的 OpenClaw 環境
對基本 Markdown 語法有初步了解

快速開始

OpenProse 是 OpenClaw 的內置插件，但預設是關閉的。跟著下面步驟快速啟動：

啟用插件：在你的終端機執行：
Terminal window
```
openclaw plugins enable open-prose
```
重啟 Gateway：啟用後，請務必重啟你的 Gateway 服務讓設定生效。
執行你的第一個程式：你可以直接使用 /prose 指令來跑一個遠端或本地的 .prose 檔案：
```
/prose run https://example.com/file.prose
```

如果你是在本地開發，也可以使用 openclaw plugins install ./extensions/open-prose 來安裝開發版本。

`/prose` 指令集

OpenProse 會在 OpenClaw 中註冊 /prose 指令。這是一個用戶可以直接呼叫的 Skill，底層會驅動 OpenProse VM 並調用 OpenClaw 的工具。

常用指令如下：

/prose help：查看幫助手冊
/prose run <file.prose>：執行本地檔案
/prose run <handle/slug>：執行來自 p.prose.md 的程式
/prose examples：查看範例
/prose update：更新組件

程式碼範例：多 Agent 並行研究

這是一個典型的 .prose 檔案內容。它展示了如何同時啟動兩個不同的模型（Sonnet 和 Opus）來分工，最後再將結果彙整。

# 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/ 資料夾來儲存執行狀態。預設使用 filesystem 模式，路徑如下：

執行紀錄：.prose/runs/{時間戳記}-{隨機碼}/
持久化 Agent（用戶等級）：~/.prose/agents/

除了檔案系統，它也支援其他實驗性的狀態後端：

in-context：適用於小型程式，不產生持久檔案。
sqlite：需要 sqlite3 二進制檔案。
postgres：需要 psql 與連線字串。注意：Postgres 的憑證可能會出現在子 Agent 的日誌中，建議使用低權限的專用資料庫。

運行原理與安全

OpenProse 的指令會對應到 OpenClaw 的底層工具：

OpenProse 概念	OpenClaw 工具
Spawn session / Task tool	`sessions_spawn`
File read/write	`read` / `write`
Web fetch	`web_fetch`

安全提醒：請把 .prose 檔案當作程式碼來看待。在執行不明來源的檔案前務必先行檢查。如果你的 OpenClaw 工具白名單限制了上述工具，OpenProse 將無法正常運作。

疑難排解

程式執行失敗：檢查你的 Skills config 是否封鎖了 sessions_spawn 或 web_fetch 等必要工具。
遠端檔案抓不到：/prose run <handle/slug> 會解析為 https://p.prose.md/<handle>/<slug>。確保你的網路環境可以存取該網域，或檢查 web_fetch 工具是否正常。

如果你在設定過程中遇到任何問題，可以詢問 AI Setup Assistant 獲取即時協助。

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。