Clawforge

ClawForge v3.1 — Fleet Forge for OpenClaw

Overview

ClawForge is a single Go binary for managing fleets of OpenClaw agents. No dependencies required.

Install: brew install cyperx84/tap/clawforge

Fleet Commands

# Create agent from archetype
clawforge create <id> --from coder --name "Name" --role "Role" --emoji 🔧

# One-shot: create + bind + activate + gateway restart
clawforge deploy <id> --from coder --name "Name" --role "Role" --channel <discord-channel-id>

# List all agents
clawforge list
clawforge list --json

# Deep inspect
clawforge inspect <id>
clawforge inspect <id> --json

# Edit workspace files in $EDITOR
clawforge edit <id> --soul
clawforge edit <id> --agents
clawforge edit <id> --tools

# Duplicate an agent
clawforge clone <src> <dst>

# Remove agent
clawforge destroy <id>

# Activate/deactivate in OpenClaw config
clawforge activate <id>
clawforge deactivate <id>

# Bind to Discord channel
clawforge bind <id> <channel-id>
clawforge unbind <id>

# Export/import agents
clawforge export <id>
clawforge import <file.clawforge>

Observability

# Fleet status dashboard
clawforge status
clawforge status <id>
clawforge status --json

# Live agent health (sessions, heartbeat, errors)
clawforge health
clawforge health <id>
clawforge health --json

# Cost tracking
clawforge cost
clawforge cost --today
clawforge cost --week

# View logs
clawforge logs <id>
clawforge logs <id> --tail 50
clawforge logs <id> --follow

Fleet Maintenance

# Detect drift between disk agents and openclaw.json
clawforge sync
clawforge sync --fix        # Auto-add disk agents to config
clawforge sync --json

# Compare two agents
clawforge diff <id1> <id2>
clawforge diff <id1> <id2> --files   # Include workspace file diffs

# System health check
clawforge doctor

# Remote fleet management (SSH)
clawforge remote add prod user@host
clawforge remote list
clawforge remote status prod

Templates

clawforge template list
clawforge template show coder
clawforge template create my-template --from builder
clawforge template delete my-template

Built-in archetypes: generalist, coder, monitor, researcher, communicator

Config

clawforge config                    # Show all config
clawforge config key value          # Set a value

Config file: ~/.clawforge/config.json

MCP Server (for Claude Code / AI clients)

ClawForge exposes an MCP server so AI coding agents can manage fleets as tools.

Configure in Claude Code

Add to ~/.claude/mcp_servers.json:

{
  "clawforge": {
    "command": "clawforge",
    "args": ["mcp"],
    "description": "Fleet management for OpenClaw agents"
  }
}

Available MCP Tools

Example MCP usage (from Claude Code)

Use the clawforge MCP to deploy a new researcher agent:
- id: science-scout
- from: researcher
- name: Science Scout
- role: Track scientific papers and breakthroughs
- emoji: 🔬

OpenClaw Paths

Key Constraints

• deploy/create never write role or emoji to openclaw.json (causes validation errors)
• Role/emoji live in workspace SOUL.md only
• destroy removes from config AND deletes workspace directory
• sync --fix adds disk agents to config but does NOT restart gateway (run openclaw gateway restart manually)