OpenClaw MCP Server
Connect Claude.ai or Desktop to a self-hosted OpenClaw gateway for chat completions and agent routing over MCP with OAuth 2.1 bridging.
Overview
io.github.freema/openclaw-mcp is a Build-phase MCP server that bridges Claude.ai and Desktop to a self-hosted OpenClaw gateway using OAuth 2.1 and bearer-authenticated requests.
What is this MCP server?
- openclaw-mcp v1.5.0—stdio npm and OCI image ghcr.io/freema/openclaw-mcp:1.5.0
- OPENCLAW_URL (default http://127.0.0.1:18789) and OPENCLAW_GATEWAY_TOKEN required
- OPENCLAW_MODEL default openclaw; supports openclaw/<agentId> style routing
- OPENCLAW_TIMEOUT_MS default 120000 ms for long agent turns
- OAuth 2.1 bridge positioning for Claude.ai/Desktop toward self-hosted OpenClaw
- Version 1.5.0
- Default gateway URL http://127.0.0.1:18789
- Default OPENCLAW_TIMEOUT_MS 120000
What problem does it solve?
You run OpenClaw privately but Claude’s hosted apps cannot reach your gateway without a dedicated MCP and OAuth bridge.
Who is it for?
Advanced solo builders self-hosting OpenClaw who want Claude Desktop or Claude.ai sessions backed by their own gateway and agents.
Skip if: Builders with no OpenClaw deployment, or teams that only need cloud-only Claude Code without a private gateway.
What do I get? / Deliverables
Claude clients can call your OpenClaw gateway through MCP with configurable model routing and timeouts.
- MCP-mediated chat completions against your OpenClaw gateway
- Configurable model routing including openclaw/<agentId> patterns
Recommended MCP Servers
Journey fit
Self-hosted agent gateways are configured while you are assembling the agent stack, before production hardening. OpenClaw MCP is explicitly agent infrastructure—bridging hosted Claude clients to your local or private OpenClaw instance.
How it compares
Agent-gateway MCP bridge, not a general OAuth tutorial or cloud LLM proxy catalog entry.
Common Questions / FAQ
Who is io.github.freema/openclaw-mcp for?
Developers operating a self-hosted OpenClaw gateway who want MCP plus OAuth 2.1 connectivity from Claude.ai or Claude Desktop.
When should I use io.github.freema/openclaw-mcp?
Use it during Build when you are connecting private OpenClaw agents to hosted Claude clients and tuning model IDs and gateway timeouts.
How do I add io.github.freema/openclaw-mcp to my agent?
Run openclaw-mcp via npm stdio or the ghcr.io/freema/openclaw-mcp:1.5.0 image, set OPENCLAW_URL and OPENCLAW_GATEWAY_TOKEN, and register the server in your MCP client following OpenClaw OAuth setup.