Files
openclaw/docs/prose.md
Ayaan Zaidi ca6fea301b refactor(plugins)!: remove OpenProse (#128494)
Remove the bundled OpenProse plugin and /prose command now that upstream owns the maintained Agent Skill. Preserve /prose as migration documentation and let Doctor clean stale plugin configuration.

BREAKING CHANGE: The bundled OpenProse plugin and /prose command are removed.

Co-authored-by: Ayaan Zaidi <hi@obviy.us>
2026-08-24 10:39:46 +05:30

54 lines
1.8 KiB
Markdown

---
title: "OpenProse removal and migration"
sidebarTitle: "OpenProse migration"
summary: "OpenClaw no longer bundles OpenProse or the /prose command. Move to the maintained upstream Agent Skill and clean stale plugin configuration."
read_when:
- You used the bundled OpenProse plugin or /prose command
- You need to clean OpenProse configuration after upgrading OpenClaw
- You want to install the maintained upstream OpenProse Agent Skill
---
OpenClaw no longer bundles the OpenProse plugin or its `/prose` command. OpenProse
continues as a maintained upstream Agent Skill. Existing `.prose` source files
remain yours; the removed plugin did not store state in OpenClaw's SQLite database.
## Migrate
1. Clean stale bundled-plugin configuration:
```bash
openclaw doctor --fix
```
Doctor removes `open-prose` from plugin allowlists, denylists, and plugin
entries. No OpenClaw database migration is required.
2. From your workspace root, install the upstream skill:
```bash
npx skills add openprose/prose --skill open-prose --agent codex --copy -y
```
This copies the skill to `.agents/skills/open-prose`, which OpenClaw loads as
a project Agent Skill. It does not restore the removed bundled plugin or the
`/prose` command.
3. If you are upgrading older OpenProse source, start a new OpenClaw agent
session in the workspace and send:
```text
prose upgrade --dry-run
```
This is an Agent Skill command, not a shell executable. Review the plan, then
send `prose upgrade` in the same session. The upstream upgrade does not
migrate old runtime ledgers or state, so retain your source files and begin
with a clean state directory.
## Related
- [Skills](/tools/skills)
- [Slash commands](/tools/slash-commands)
- [Lobster workflows](/tools/lobster)
- [OpenProse upstream](https://github.com/openprose/prose)