openclaw-mcp | Bridge Claude.ai to OpenClaw

How it works

Request

Ask Claude.ai to perform a task using your private agent tools.

Authorize

One-time OAuth 2.1 handshake secures the bridge between platforms.

Execute

OpenClaw processes the task locally on your own infrastructure.

Resolve

Structured results flow back to Claude for immediate synthesis.

Core Capabilities

OAuth 2.1

Modern, secure authorization flow. Your credentials never touch the MCP bridge directly.

Async Queue

Handle long-running AI tasks without timeouts. Polling mechanisms built directly into the MCP tools.

Docker Ready

Official lightweight images for zero-fuss deployment in any containerized environment.

Two Transports

Supports both Stdio (for Desktop) and SSE (for remote hosting) transport layers out of the box.

Input Validation

Strict Zod-based schema validation ensures Claude provides the exact parameters your agent needs.

Zero Config

Auto-discovery of your OpenClaw agent tools. Just provide the host URL and start chatting.

Available Tools

Synchronous

Direct interaction

Tool Name	Function
openclaw_chat	Simple text inference
openclaw_status	Agent health check

Asynchronous

Background execution

Tool Name	Function
openclaw_chat_async	Queued chat execution
openclaw_task_status	Check specific task progress
openclaw_task_list	List all running tasks
openclaw_task_cancel	Kill a pending task

Quick Start

# Pre-built images published to GHCR on every release

# docker-compose.yml
services:
  openclaw-mcp:
    image: ghcr.io/freema/openclaw-mcp:latest
    environment:
      - OPENCLAW_URL=http://host.docker.internal:18789
      - OPENCLAW_GATEWAY_TOKEN=your-token
      - AUTH_ENABLED=true
      - MCP_CLIENT_ID=openclaw
      - MCP_CLIENT_SECRET=${MCP_CLIENT_SECRET}
    ports:
      - "3000:3000"

// Add this to your Claude Desktop config (claude_desktop_config.json)

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": ["openclaw-mcp"],
      "env": {
        "OPENCLAW_URL": "http://127.0.0.1:18789",
        "OPENCLAW_GATEWAY_TOKEN": "your-token"
      }
    }
  }
}

# Run with OAuth credentials for remote access

AUTH_ENABLED=true \
MCP_CLIENT_ID=openclaw \
MCP_CLIENT_SECRET=$MCP_CLIENT_SECRET \
MCP_ISSUER_URL=https://mcp.your-domain.com \
CORS_ORIGINS=https://claude.ai \
OPENCLAW_GATEWAY_TOKEN=your-token \
npx openclaw-mcp --transport sse --port 3000

Claude Code Plugin

This repo ships a marketplace plugin for Claude Code. Install it directly to get OpenClaw skills, commands, and agents wired into your Claude Code session.

Install via Claude Code CLI

$ claude plugin install github:freema/openclaw-mcp

Skills

Auto-triggers when you ask Claude to delegate tasks, chat with OpenClaw, or check gateway status.

Commands

/claw:chat and /claw:status for direct interaction from the CLI.

Agents

task-delegator agent for spawning long-running async operations with progress monitoring.