openclaw-mcp

MCP (Model Context Protocol) server that bridges AI assistants with OpenClaw Gateway.

This lets AI assistants like Cursor and Claude Desktop talk directly to your OpenClaw agent through MCP tools.

Features

Prerequisites

• OpenClaw installed and configured (source checkout with pnpm install)
• OpenClaw Gateway running (openclaw gateway run or systemd service)
• Node.js 22+

Install

git clone https://github.com/YOUR_USERNAME/openclaw-mcp.git
cd openclaw-mcp
npm install

Configure Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": ["tsx", "/path/to/openclaw-mcp/server.ts"],
      "env": {
        "OPENCLAW_DIR": "/path/to/openclaw",
        "OPENCLAW_AGENT_WORKSPACE": "/path/to/clawd"
      }
    }
  }
}

Configure Claude Desktop

Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": ["tsx", "/path/to/openclaw-mcp/server.ts"],
      "env": {
        "OPENCLAW_DIR": "/path/to/openclaw",
        "OPENCLAW_AGENT_WORKSPACE": "/path/to/clawd"
      }
    }
  }
}

Environment Variables

How It Works

Cursor/Claude ──MCP──> openclaw-mcp ──CLI──> pnpm openclaw agent ──> OpenClaw Gateway ──> AI Model

The MCP server calls pnpm openclaw agent --message "..." --json under the hood, which communicates with the OpenClaw Gateway via WebSocket. This ensures all OpenClaw skills, tools, and agent capabilities are available.

License

MIT