openclaw-mcp

MCP server for Claude Code to talk to OpenClaw AI agents (Daemon, Soren, Ash, etc.) via the gateway API.

What it does

Gives Claude Code three tools:

• ask_agent — Send a message to any OpenClaw agent and get their response inline
• list_agents — Discover all available agents on the gateway
• agent_status — Check if a specific agent is active

Quick Setup

# Install globally
npm install -g openclaw-mcp

# Add to Claude Code (simplest)
claude mcp add openclaw -- npx openclaw-mcp

# Or with explicit config
claude mcp add openclaw \
  --env OPENCLAW_GATEWAY_URL=http://172.16.24.250:18789 \
  --env OPENCLAW_GATEWAY_TOKEN=your_token \
  -- npx openclaw-mcp

Manual Setup

Add to your .claude/settings.json (or ~/.claude.json for global):

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": ["openclaw-mcp"],
      "env": {
        "OPENCLAW_GATEWAY_URL": "http://172.16.24.250:18789",
        "OPENCLAW_GATEWAY_TOKEN": "your_token"
      }
    }
  }
}

Configuration

Variable	Default	Description
OPENCLAW_GATEWAY_URL	http://localhost:18789	OpenClaw gateway URL
OPENCLAW_GATEWAY_TOKEN	(required)	Auth token from your OpenClaw config

Find your token in ~/.openclaw/openclaw.json under gateway.token.

Usage in Claude Code

Once configured, just talk to Claude Code naturally:

• "Ask Daemon about the ClawPort architecture"
• "Check which agents are available"
• "Ask Soren to review this code approach"
• "What's the status of the Ash agent?"

Tools Reference

ask_agent

Sends a message to an OpenClaw agent and returns their response.

agent: "daemon" | "soren" | "ash" | "mira" | "jace" | "pip" | ...
message: "Your question or request"

Uses session key agent:{name}:mcp so MCP conversations are isolated from Discord/ClawPort sessions.

list_agents

No params. Returns all models/agents registered on the gateway.

agent_status

agent: "ash"

Returns the agent's name, model ID, and availability status.

Local Development

git clone https://github.com/Codename-11/openclaw-mcp
cd openclaw-mcp
npm install
npm run build

# Test
OPENCLAW_GATEWAY_URL=http://localhost:18789 \
OPENCLAW_GATEWAY_TOKEN=your_token \
node dist/index.js

License

MIT