openclaw-mcp

Overview

OpenClaw MCP Server is a secure bridge between Claude.ai and self-hosted OpenClaw AI assistants, implementing OAuth2 authentication for secure communication. It provides both synchronous and asynchronous tools for interacting with OpenClaw instances, including chat functionality, health checks, and task management. The server supports multi-instance mode, allowing orchestration of multiple OpenClaw gateways from a single MCP server with per-instance isolation.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• openclaw_chat

  Send messages to OpenClaw and get responses

  Try:What's the weather like today?Try:Explain quantum computingTry:Write a Python function to calculate Fibonacci numbers
• openclaw_status

  Check OpenClaw gateway health

  Try:Is OpenClaw running?Try:Check the status of OpenClawTry:Verify OpenClaw health
• openclaw_instances

  List all configured OpenClaw instances

  Try:Show me all OpenClaw instancesTry:List configured gatewaysTry:What instances are available?
• openclaw_chat_async

  Queue a message, get task_id immediately

  Try:Process this request in the backgroundTry:Run a task asynchronouslyTry:Start a job for me
• openclaw_task_status

  Check task progress and get results

  Try:Check task progressTry:What's the status of my background task?Try:Get results from async job
• openclaw_task_list

  List all tasks with filtering

  Try:Show all my tasksTry:List running tasksTry:Filter tasks by status
• openclaw_task_cancel

  Cancel a pending task

  Try:Cancel that taskTry:Stop the background jobTry:Abort running task

Comparable tools

Installation

docker pull ghcr.io/freema/openclaw-mcp:latest

export MCP_CLIENT_SECRET=$(openssl rand -hex 32)
export OPENCLAW_GATEWAY_TOKEN=your-gateway-token
docker compose up -d

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

FAQ

How do I enable authentication in production?

Set AUTH_ENABLED=true and provide MCP_CLIENT_ID and MCP_CLIENT_SECRET when running the server.

Can I use multiple OpenClaw instances?

Yes, configure multiple instances with different names, URLs, and tokens using OPENCLAW_INSTANCES environment variable.

Compare openclaw-mcp with