# 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

```bash
# 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):

```json
{
  "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

```bash
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