ClawMCP 🦞⚒️

Created by Ageborn dev

MCP server that forges complete OpenClaw environments from natural language.

Tell ClawMCP what you want to automate. You describe your intent, the AI decomposes it into isolated sandboxed tasks, generates all OpenClaw configuration files, and prepares everything for review and deploy.

---

What it does

• Intent-driven — describe in natural language what you want to automate
• Sandboxed environments — each task runs in complete isolation, no context collisions
• Full file generation — SOUL.md, MEMORY.md, HEARTBEAT.md, AGENTS.md, and skill files per sandbox; one global openclaw.json gateway config
• Spec-compliant output — exports the exact file layout expected by OpenClaw 2026 (~/.openclaw/openclaw.json + ~/openclaw/{agent}/)
• Import existing projects — load an already-deployed OpenClaw workspace back into ClawMCP to modify it
• Human review first — validate and inspect before exporting anything to disk
• Any level — beginner gets plain-language setup guides, expert gets raw files and CLI instructions

---

Installation

git clone https://github.com/ageborn-dev/clawmcp
cd clawmcp
npm install
npm run build

---

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "clawmcp": {
      "command": "node",
      "args": ["/path/to/clawmcp/dist/index.js"]
    }
  }
}

Usage with Cursor / VS Code

Add to your MCP settings:

{
  "clawmcp": {
    "command": "node",
    "args": ["/path/to/clawmcp/dist/index.js"]
  }
}

---

Tools

Tool	Description
clawmcp_create_environment	Create a new environment session to hold sandboxes
clawmcp_list_environments	List all active environments with expiry countdowns
clawmcp_delete_environment	Permanently delete an environment and all its sandboxes
clawmcp_import_environment	Import an existing on-disk OpenClaw workspace into a new session
clawmcp_add_sandbox	Add a fully isolated agent sandbox to an environment
clawmcp_update_sandbox	Replace all files in an existing sandbox with new content
clawmcp_remove_sandbox	Remove a specific sandbox from an environment
clawmcp_list_sandboxes	List all sandboxes in an environment with their IDs and file lists
clawmcp_validate_environment	Check environment consistency before exporting
clawmcp_export_environment	Get the full file tree ready to write to disk
clawmcp_get_setup_instructions	Get a deploy guide in beginner or expert mode

---

Exported file structure

~/.openclaw/openclaw.json       ← global gateway config (gateway, channels, models, crons)

~/openclaw/
├── {agent-name}/
│   ├── SOUL.md                 ← agent identity, personality, rules
│   ├── MEMORY.md               ← persistent context stubs
│   ├── HEARTBEAT.md            ← natural language periodic tasks
│   ├── AGENTS.md               ← workflow instructions for this agent
│   └── skills/
│       └── {skill-name}/
│           └── SKILL.md        ← YAML frontmatter + instructions
└── README.md                   ← deployment summary

---

Typical workflow

1. clawmcp_create_environment    →  creates a session, returns env_id
2. clawmcp_add_sandbox           →  AI generates and adds each agent (call once per task)
3. clawmcp_list_sandboxes        →  review what was added
4. clawmcp_update_sandbox        →  refine a specific sandbox if needed
5. clawmcp_validate_environment  →  check all files are consistent
6. clawmcp_export_environment    →  get the full file tree
7. clawmcp_get_setup_instructions → beginner or expert deploy guide

To modify an existing deployment:

1. clawmcp_import_environment    →  load an on-disk OpenClaw workspace
2. clawmcp_update_sandbox        →  make targeted changes
3. clawmcp_export_environment    →  re-export updated files

---

Sessions

Environments are stored locally at ~/.clawmcp/sessions/ and expire 24 hours after last update.

---

Requirements

• Node.js 20+
• OpenClaw installed on target machine (curl -fsSL https://openclaw.ai/install.sh | bash)
• An MCP-capable AI client (Claude Desktop, Cursor, VS Code, or any MCP-compatible host)

---

License

MIT