11---
2-summary: "OpenProse: .prose workflows, slash commands, and state in OpenClaw"
2+title: "OpenProse"
3+sidebarTitle: "OpenProse"
4+summary: "OpenProse is a markdown-first workflow format for multi-agent AI sessions. In OpenClaw it ships as a plugin with a /prose slash command and a skill pack."
35read_when:
4- - You want to run or write .prose workflows
6+ - You want to run or write .prose workflow files
57 - You want to enable the OpenProse plugin
6- - You need to understand state storage
7-title: "OpenProse"
8+ - You need to understand how OpenProse maps to OpenClaw primitives
89---
91010-OpenProse is a portable, markdown-first workflow format for orchestrating AI sessions. In OpenClaw it ships as a plugin that installs an OpenProse skill pack plus a `/prose` slash command. Programs live in `.prose` files and can spawn multiple sub-agents with explicit control flow.
11-12-Official site: [https://www.prose.md](https://www.prose.md)
13-14-## What it can do
15-16-- Multi-agent research + synthesis with explicit parallelism.
17-- Repeatable approval-safe workflows (code review, incident triage, content pipelines).
18-- Reusable `.prose` programs you can run across supported agent runtimes.
19-20-## Install + enable
21-22-Bundled plugins are disabled by default. Enable OpenProse:
23-24-```bash
25-openclaw plugins enable open-prose
26-```
27-28-Restart the Gateway after enabling the plugin.
29-30-Dev/local checkout: `openclaw plugins install ./path/to/local/open-prose-plugin`
31-32-Related docs: [Plugins](/tools/plugin), [Plugin manifest](/plugins/manifest), [Skills](/tools/skills).
11+OpenProse is a portable, markdown-first workflow format for orchestrating AI
12+sessions. In OpenClaw it ships as a plugin that installs an OpenProse skill
13+pack and a `/prose` slash command. Programs live in `.prose` files and can
14+spawn multiple sub-agents with explicit control flow.
15+16+<CardGroup cols={3}>
17+ <Card title="Install" icon="download" href="#install">
18+Enable the OpenProse plugin and restart the Gateway.
19+ </Card>
20+ <Card title="Run a program" icon="play" href="#slash-command">
21+Use `/prose run` to execute a `.prose` file or remote program.
22+ </Card>
23+ <Card title="Write programs" icon="pencil" href="#example">
24+Author multi-agent workflows with parallel and sequential steps.
25+ </Card>
26+</CardGroup>
27+28+## Install
29+30+<Steps>
31+ <Step title="Enable the plugin">
32+Bundled plugins are disabled by default. Enable OpenProse:
33+34+```bash
35+openclaw plugins enable open-prose
36+```
37+38+ </Step>
39+ <Step title="Restart the Gateway">
40+```bash
41+openclaw gateway restart
42+```
43+ </Step>
44+ <Step title="Verify">
45+```bash
46+openclaw plugins list | grep prose
47+```
48+49+You should see `open-prose` as enabled. The `/prose` skill command is now
50+available in chat.
51+52+ </Step>
53+</Steps>
54+55+For a local checkout: `openclaw plugins install ./path/to/local/open-prose-plugin`
33563457## Slash command
355836-OpenProse registers `/prose` as a user-invocable skill command. It routes to the OpenProse VM instructions and uses OpenClaw tools under the hood.
59+OpenProse registers `/prose` as a user-invocable skill command:
376038-Common commands:
39-40-```
61+```text
4162/prose help
4263/prose run <file.prose>
4364/prose run <handle/slug>
@@ -47,7 +68,16 @@ Common commands:
4768/prose update
4869```
497050-## Example: a simple `.prose` file
71+`/prose run <handle/slug>` resolves to `https://p.prose.md/<handle>/<slug>`.
72+Direct URLs are fetched as-is using the `web_fetch` tool.
73+74+## What it can do
75+76+- Multi-agent research and synthesis with explicit parallelism.
77+- Repeatable, approval-safe workflows (code review, incident triage, content pipelines).
78+- Reusable `.prose` programs you can run across supported agent runtimes.
79+80+## Example: parallel research and synthesis
51815282```prose
5383# Research + synthesis with two agents running in parallel.
@@ -72,11 +102,27 @@ session "Merge the findings + draft into a final answer."
72102context: { findings, draft }
73103```
74104105+## OpenClaw runtime mapping
106+107+OpenProse programs map to OpenClaw primitives:
108+109+| OpenProse concept | OpenClaw tool |
110+| ------------------------- | ---------------- |
111+| Spawn session / Task tool | `sessions_spawn` |
112+| File read / write | `read` / `write` |
113+| Web fetch | `web_fetch` |
114+115+<Warning>
116+ If your tool allowlist blocks `sessions_spawn`, `read`, `write`, or
117+`web_fetch`, OpenProse programs will fail. Check your
118+[tools allowlist config](/gateway/config-tools).
119+</Warning>
120+75121## File locations
7612277123OpenProse keeps state under `.prose/` in your workspace:
7812479-```
125+```text
80126.prose/
81127├── .env
82128├── runs/
@@ -90,48 +136,56 @@ OpenProse keeps state under `.prose/` in your workspace:
9013691137User-level persistent agents live at:
9213893-```
139+```text
94140~/.prose/agents/
95141```
9614297-## State modes
98-99-OpenProse supports multiple state backends:
100-101-- **filesystem** (default): `.prose/runs/...`
102-- **in-context**: transient, for small programs
103-- **sqlite** (experimental): requires `sqlite3` binary
104-- **postgres** (experimental): requires `psql` and a connection string
105-106-Notes:
107-108-- sqlite/postgres are opt-in and experimental.
109-- postgres credentials flow into subagent logs; use a dedicated, least-privileged DB.
110-111-## Remote programs
112-113-`/prose run <handle/slug>` resolves to `https://p.prose.md/<handle>/<slug>`.
114-Direct URLs are fetched as-is. This uses the `web_fetch` tool (or `exec` for POST).
115-116-## OpenClaw runtime mapping
117-118-OpenProse programs map to OpenClaw primitives:
119-120-| OpenProse concept | OpenClaw tool |
121-| ------------------------- | ---------------- |
122-| Spawn session / Task tool | `sessions_spawn` |
123-| File read/write | `read` / `write` |
124-| Web fetch | `web_fetch` |
125-126-If your tool allowlist blocks these tools, OpenProse programs will fail. See [Skills config](/tools/skills-config).
127-128-## Security + approvals
129-130-Treat `.prose` files like code. Review before running. Use OpenClaw tool allowlists and approval gates to control side effects.
131-132-For deterministic, approval-gated workflows, compare with [Lobster](/tools/lobster).
143+## State backends
144+145+<AccordionGroup>
146+ <Accordion title="filesystem (default)">
147+State is written to `.prose/runs/...` in the workspace. No extra
148+dependencies required.
149+ </Accordion>
150+ <Accordion title="in-context">
151+Transient state kept in the context window. Suitable for small, short-lived
152+programs.
153+ </Accordion>
154+ <Accordion title="sqlite (experimental)">
155+Requires the `sqlite3` binary on `PATH`.
156+ </Accordion>
157+ <Accordion title="postgres (experimental)">
158+Requires `psql` and a connection string.
159+160+<Warning>
161+ Postgres credentials flow into sub-agent logs. Use a dedicated,
162+ least-privileged database.
163+</Warning>
164+165+ </Accordion>
166+</AccordionGroup>
167+168+## Security
169+170+Treat `.prose` files like code. Review them before running. Use OpenClaw tool
171+allowlists and approval gates to control side effects. For deterministic,
172+approval-gated workflows, compare with [Lobster](/tools/lobster).
133173134174## Related
135175136-- [Text-to-speech](/tools/tts)
137-- [Markdown formatting](/concepts/markdown-formatting)
176+<CardGroup cols={2}>
177+ <Card title="Skills reference" href="/tools/skills" icon="puzzle-piece">
178+How OpenProse's skill pack loads and what gates apply.
179+ </Card>
180+ <Card title="Subagents" href="/tools/subagents" icon="users">
181+OpenClaw's native multi-agent coordination layer.
182+ </Card>
183+ <Card title="Text-to-speech" href="/tools/tts" icon="volume-high">
184+Add audio output to your workflows.
185+ </Card>
186+ <Card title="Slash commands" href="/tools/slash-commands" icon="terminal">
187+All available chat commands including /prose.
188+ </Card>
189+</CardGroup>
190+191+Official site: [https://www.prose.md](https://www.prose.md)
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。