Bring BMAD agents (Mary, John, Barry, and more) to life as real, persistent OpenClaw agents.
Freestyle-first personality. Workflows on demand. One-step setup.

Unofficial. Not affiliated with bmad-code-org.
BMAD-METHOD is MIT licensed. This plugin does not bundle BMAD content.

---

What Is This?

bmad-claw is an OpenClaw plugin that bridges BMAD-METHOD — an AI-driven agile development framework — with OpenClaw, a persistent AI agent runtime.

Without this plugin, BMAD agents live only as one-shot Claude Code skills. With it, Mary, John, Barry, and the rest become real OpenClaw agents: persistent identity, session memory, project-local BMAD context, and full workflow access — all while keeping their personality front and center.

---

Features

🧠 Persona-first agents	Each BMAD agent gets a handcrafted SOUL.md — character, communication style, principles. No menus until you ask.
📂 BMAD-aware sessions	Hook injects the module version banner when you're working inside a BMAD project directory.
🔧 Workflow on demand	Ask Mary for market research, John for a PRD — the bmad_workflow tool resolves it by code or name.
🌐 Works without BMAD	Agents load from a committed fallback snapshot. Full persona, no workflows until BMAD is installed.
🚀 One-step setup	openclaw plugins install @sphinxcode/bmad-claw → multiselect → done.
🔄 Drift detection	openclaw bmad sync re-checks each agent against the live manifest and regenerates only what changed.
📦 Fallback snapshot	Bundled agents.json + workflows-catalog.json — no BMAD repo needed to install.

---

Prerequisites

• OpenClaw >= 2026.3.24-beta.2
• Node.js >= 20
• BMAD-METHOD (optional — agents work without it in persona-only mode)

---

Quick Start

1 — Install the plugin

openclaw plugins install @sphinxcode/bmad-claw

The postinstall script runs openclaw bmad install automatically. You'll see a multiselect:

  1. ◉ Mary          Business Analyst        (bmm)
  2. ◉ John          Product Manager         (bmm)
  3. ◉ Barry         Solution Architect      (bmm)
  4. ◉ Bob           Scrum Master            (bmm)
  ...
Press Enter to install selected (default), or type numbers to toggle:

BMM + TEA agents are pre-selected. CIS is opt-in. Press Enter to accept.

2 — Start a session with Mary

openclaw agent mary

She introduces herself. No menus. Just conversation.

3 — Ask for a workflow

You: Can you do a competitive analysis for us?
Mary: On it. Let me pull up the market analysis workflow.
      [invokes bmad_workflow → bmad-market-research skill]

---

CLI Commands

openclaw bmad install          # Set up agents (multiselect, idempotent)
openclaw bmad install-bmad     # Install BMAD-METHOD if you don't have it yet
openclaw bmad sync             # Re-check agents for persona drift, regenerate if changed
openclaw bmad status           # Show BMAD home, mode, bound agents, skill count
openclaw bmad config set-home  # Manually set BMAD install path

---

How It Works

openclaw.json                     ~/.openclaw/
├── agents.list                   ├── identity/bmad/<agentId>/
│   └── { id, workspace, ... }   │   ├── SOUL.md          ← persona source
│                                 │   ├── AGENTS.md        ← behavior rules
plugins.entries.bmad-claw         │   └── .source.json     ← drift hash
└── config                        └── workspace-<agentId>/
    ├── bmadHome                      ├── SOUL.md          ← loaded by OpenClaw
    ├── boundAgents                   └── AGENTS.md
    └── defaultMode

Detection chain: stored bmadHome config → cwd/_bmad → ~/.openclaw/_bmad

Two modes:

Mode	Condition	Agents	Workflows
full	_bmad/_config/manifest.yaml found	Live manifest	Live module-help.csv
persona-only	No BMAD detected	Bundled snapshot	None (install guide offered)

---

Agents Included

Loaded from your live BMAD install, or from the bundled fallback snapshot.

Agent	Role	Module
📊 Mary	Business Analyst	BMM
📋 John	Product Manager	BMM
🏗 Barry	Solution Architect	BMM
🧠 Bob	Scrum Master	BMM
🛡 Winston	Security Engineer	BMM
✈ Amelia	DevOps Engineer	BMM
🧪 Quinn	QA Engineer	BMM
📝 Sally	Technical Writer	BMM
🎨 Paige	UI/UX Designer	BMM
📊 Murat	Data Analyst	BMM

---

Installing BMAD

If BMAD-METHOD isn't installed yet, agents will offer to walk you through it. Or run it yourself:

openclaw bmad install-bmad

You'll be asked two questions:

Include Game Development (GDS)? [Y/n]
Include Creative Intelligence (CIS)? [Y/n]

Core modules (BMM + BMB + TEA) install automatically. Answer N to both for a standard setup.

---

Refreshing the Fallback Snapshot

The assets/fallback/ directory is a committed snapshot of BMAD personas and workflows. To refresh it from a local BMAD-METHOD clone:

npm run snapshot
# or with a custom path:
node scripts/snapshot-bmad.mjs --bmad-repo /path/to/BMAD-METHOD

Commit the updated assets/fallback/ files.

---

Development

npm run build     # TypeScript check (zero errors expected)
npm test          # Run test suite
npm run snapshot  # Regenerate fallback assets

---

Attribution

BMAD-METHOD is created and maintained by bmad-code-org and is MIT licensed.

bmad-claw is an independent, unofficial plugin. It reads BMAD's published CSV interface (agent-manifest.csv, manifest.yaml, module-help.csv) and does not modify or bundle BMAD content.

---

License

MIT © sphinx-codes

---

_{Built with OpenClaw · Powered by BMAD-METHOD}