openspec-openclaw-plugin

openspec-openclaw-plugin

OpenClaw plugin that integrates OpenSpec (@fission-ai/openspec) for spec-driven development inside OpenClaw sessions.

The plugin exposes a normalized tool surface so OpenClaw agents can drive the OpenSpec workflow (propose → validate → apply → archive) without shelling out manually. It ships a bundled skill (openclaw-skills:openspec) so any provider-backed agent picks up the right behaviour.

Why this plugin

OpenSpec officially supports ~25 AI coding assistants (Claude Code, Cursor, OpenCode, …) but not OpenClaw. Wiring OpenSpec into OpenClaw at the plugin layer means the integration is provider-agnostic — swap the underlying CLI/model and the workflow keeps working.

Install

Requires:

• OpenClaw >= 2026.5.0
• Node.js 20.19.0+
• @fission-ai/openspec available on PATH (npm install -g @fission-ai/openspec@latest)

# from a built dist
openclaw plugins install clawhub:openspec-openclaw-plugin

# or from a local checkout
git clone https://github.com/jlivanmaseda-maker/openspec-openclaw-plugin
cd openspec-openclaw-plugin
npm install --omit=peer --omit=optional --ignore-scripts
npm run build
openclaw plugins install --link "$PWD"

Then restart the gateway: openclaw gateway restart.

Tools

| Tool | Wraps | | --- | --- | | openspec_init | openspec init [path] [--tools …] [--profile …] | | openspec_update | openspec update [path] | | openspec_list | openspec list [--specs] --json | | openspec_show | openspec show <name> (plus optional file contents) | | openspec_validate | openspec validate [name] | | openspec_archive | openspec archive <change-name> --yes | | openspec_status | openspec status [change-name] | | openspec_run | Escape hatch passthrough |

Config

openclaw.json → plugins.entries["openspec-openclaw-plugin"].config:

{
  "enabled": true,
  "command": "auto",
  "args": [],
  "env": {},
  "readOnly": false,
  "allowedRoots": [],
  "timeoutMs": 60000
}

| Key | Default | Notes | | --- | --- | --- | | enabled | true | Toggle the plugin without uninstalling. | | command | "auto" | Override the openspec binary path. | | args | [] | Extra default arguments prepended to every invocation. | | env | {} | Extra environment variables for the spawned process. | | readOnly | false | Block init, update, archive (and openspec_run mutators). | | allowedRoots | [] | If non-empty, restrict every operation to projects inside these absolute roots. | | timeoutMs | 60000 | Per-command timeout. |

Skill

The bundled skill (src/skill/SKILL.md) ships under openclaw-skills:openspec. It teaches the agent when to invoke OpenSpec, the core workflow, and anti-patterns. Extended patterns live in src/skill/references/workflow.md.

License

MIT