openclaw / docs /prose.md
SaylorTwift's picture
SaylorTwift HF Staff
Add files using upload-large-folder tool
63e0fa3 verified
|
Raw History Blame Contribute Delete
2.13 kB
metadata
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. The v2026.8.1 release removed both. 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:

    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:

    npx skills add openprose/prose --skill open-prose --agent codex --copy -y
    

    skills is a third-party CLI from npm, not an OpenClaw command. Keep --agent codex: that value writes the shared .agents/skills layout, which OpenClaw reads even though the flag names another agent.

    The command 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:

    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