openclaw plugins install openclaw-swarm-layer

--- ## Features - **Spec-driven planning** — Markdown spec with goals and phased tasks → dependency-ordered task graph - **ACP-first execution** — ACP is the only default-capable automated runner; capability-aware `auto` resolution - **Supervised autopilot** — Deterministic control-plane tick, lease-backed service loop, and operator-visible start/pause/resume/stop controls - **Persistent sessions** — Reuse, thread binding, follow-up, steer, cancel, and close flows - **Review gates** — Explicit approve/reject with structured quality rubrics (weighted multi-dimension scoring) - **Sprint contracts** — Verifiable acceptance criteria per task with GAN-inspired evaluator injection - **Cross-session continuity** — Progress synthesis, bootstrap startup sequence, harness assumption tracking - **Automatic retry** — Configurable per-task retry policy with dead letter tracking and signal-based auto-retry - **Concurrency protection** — ACP session concurrency limits with queued task scheduling (FIFO) - **Reject-retry workflow** — Review rejections return tasks to ready for re-run; configurable retry limits - **Parallel dispatch** — `--parallel N` and `--all-ready` batch dispatch with concurrency-aware slot management - **Operator reporting** — Status snapshots, run/review logs, spec archives, completion summaries → local + Obsidian sync - **Runtime diagnostics** — `swarm doctor`, `swarm status`, and workflow reports surface ACP bridge-exit gate directly ## Prerequisites - **Node.js** >= 22 - **OpenClaw** >= 2026.3.22 (tested against `2026.4.8`) ## Installation ### From ClawHub (recommended) ```bash openclaw plugins install clawhub:openclaw-swarm-layer ``` ### Skill From ClawHub ```bash openclaw skills install swarm-layer ``` ### From npm ```bash npm install -g openclaw-swarm-layer openclaw plugins install openclaw-swarm-layer ``` ### From source ```bash git clone https://github.com/xucheng/openclaw-swarm-layer.git cd openclaw-swarm-layer npm install && npm run build openclaw plugins install -l /path/to/openclaw-swarm-layer ``` ## Quick Start ```bash # 1. Initialize a project openclaw swarm init --project /path/to/your/project # 2. Import a spec and build the workflow openclaw swarm plan --project /path/to/your/project --spec SPEC.md # 3. Inspect runtime posture before execution openclaw swarm doctor --json openclaw swarm status --project /path/to/your/project --json # 4. Dry-run with the resolved default runner openclaw swarm run --project /path/to/your/project --dry-run --json # 5. Execute openclaw swarm run --project /path/to/your/project --json # 6. Review and report openclaw swarm review --project /path/to/your/project --task --approve --json openclaw swarm report --project /path/to/your/project --json ``` ## CLI Commands ### Core Workflow | Command | Description | |---------|-------------| | `swarm init --project ` | Initialize swarm state for a project | | `swarm plan --project --spec ` | Import a spec and build task graph | | `swarm run --project [--runner acp\|manual] [--dry-run] [--parallel N] [--all-ready]` | Execute runnable tasks (single or batch) | | `swarm review --project --task --approve\|--reject [--retry-now]` | Approve or reject a task | | `swarm report --project ` | Generate a workflow report | | `swarm status --project ` | Show workflow status, runtime posture, and bridge-exit gate | | `swarm doctor` | Diagnose ACP readiness and bridge-exit gate status | | `swarm autopilot status --project ` | Inspect autopilot health, lease state, and last decision | | `swarm autopilot start/pause/resume/stop --project ` | Control the supervised autopilot service state | | `swarm autopilot tick --project [--dry-run]` | Sync active runs, review state, and queue pressure through the supervised control plane | ### Session Management | Command | Description | |---------|-------------| | `swarm session list --project ` | List known sessions | | `swarm session inspect --project --session ` | Inspect a session | | `swarm session status --project --run ` | Poll session status | | `swarm session cancel --project --run ` | Cancel an active session | | `swarm session close --project --run ` | Close a session | | `swarm session follow-up --project --session --task ` | Inject a follow-up task | | `swarm session steer --project --session --message ` | Send a steering message | | `swarm session cleanup --project [--stale-minutes ]` | Clean up orphaned sessions | ## Runner Model | Runner | Role | Default-capable | Requirements | |--------|------|-----------------|--------------| | `acp` | Primary automation path | Yes | ACP enabled, public control-plane available | | `manual` | Operator-driven safe fallback | Always available | None | `defaultRunner: "auto"` resolves to `acp` when ACP automation is available, otherwise falls back to `manual`. ## Development ```bash npm run build # TypeScript -> dist/ npm test # Unit + e2e tests npm run test:unit # Unit tests only (356 tests, 59 files) npm run test:e2e # E2E tests only (25 tests, 19 files) npm run test:watch # Watch mode npm run release:check # Build + full regression + npm pack dry-run + ClawHub package prep ``` ## Documentation **User Guides:** - [User Manual](docs/user-manual.md) — Install, configuration, daily workflow, and troubleshooting - [Configuration Reference](docs/configuration.md) — Config schema, defaults, examples, and journaling - [Skills Guide](docs/skills-guide.md) — Unified skill usage modules - [Release Runbook](docs/release-runbook.md) — npm, GitHub release, ClawHub package, and ClawHub skill publishing steps **Operations:** - [ACP Bridge Exit Gate](docs/acp-bridge-exit-gate.md) — Bridge-free ACP floor, live smoke matrix, artifact expectations - [Operator Runbook](docs/operator-runbook.md) — Install, smoke, upgrade, rollback, and ACP control-plane operations - [Migration Checklist](docs/migration-checklist.md) — Staged bridge replacement planning - [Testing Strategy](docs/testing-strategy.md) — Unit, e2e, and smoke verification rules **Project History:** - [Changelog](CHANGELOG.md) — Release notes - [Roadmap](docs/roadmap.md) — Milestone structure and delivery history - [Milestones](docs/milestones.md) — Definition of done per milestone ## License [MIT](LICENSE) ## Contributing See [CONTRIBUTING.md](CONTRIBUTING.md).