OpenClaw MCP Server

MCP server bridging Claude.ai/Desktop with self-hosted OpenClaw via OAuth 2.1.

io.github.freema/openclaw-mcp · Repository · Website · version 1.7.0 · 182 stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

npx openclaw-mcp

Needs credentials: OPENCLAW_URL, OPENCLAW_GATEWAY_TOKEN. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.

Results by platform

Linux

needs credentials2026-08-16 · probed over npm

2 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
file:///tmp/does-it-install/dii-npm-EDlz0p/node_modules/openclaw-mcp/dist/index.js:389
          throw new Error(`Instance "${config.name}": invalid URL "${config.url}"`);
                ^

Error: Instance "default": invalid URL "DOES_IT_INSTALL_PLACEHOLDER"
    at new InstanceRegistry (file:///tmp/does-it-install/dii-npm-EDlz0p/node_modules/openclaw-mcp/dist/index.js:389:17)
    at file:///tmp/does-it-install/dii-npm-EDlz0p/node_modules/openclaw-mcp/dist/index.js:1676:16
    at ModuleJob.run (node:internal/modules/esm/module_job:343:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:681:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5)

Node.js v22.23.2

macOS

needs credentials2026-08-16 · probed over npm

2 recorded runs, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
file:///private/var/folders/df/djsxfhc17x95674wsm_g8s980000gn/T/does-it-install/dii-npm-6PofQa/node_modules/openclaw-mcp/dist/index.js:389
          throw new Error(`Instance "${config.name}": invalid URL "${config.url}"`);
                ^

Error: Instance "default": invalid URL "DOES_IT_INSTALL_PLACEHOLDER"
    at new InstanceRegistry (file:///private/var/folders/df/djsxfhc17x95674wsm_g8s980000gn/T/does-it-install/dii-npm-6PofQa/node_modules/openclaw-mcp/dist/index.js:389:17)
    at file:///private/var/folders/df/djsxfhc17x95674wsm_g8s980000gn/T/does-it-install/dii-npm-6PofQa/node_modules/openclaw-mcp/dist/index.js:1676:16
    at ModuleJob.run (node:internal/modules/esm/module_job:343:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:681:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5)

Node.js v22.23.1

Windows

needs credentials2026-08-16 · probed over npm

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
file:///C:/Users/RUNNER%7E1/AppData/Local/Temp/does-it-install/dii-npm-CrcZBb/node_modules/openclaw-mcp/dist/index.js:389
          throw new Error(`Instance "${config.name}": invalid URL "${config.url}"`);
                ^

Error: Instance "default": invalid URL "DOES_IT_INSTALL_PLACEHOLDER"
    at new InstanceRegistry (file:///C:/Users/RUNNER%7E1/AppData/Local/Temp/does-it-install/dii-npm-CrcZBb/node_modules/openclaw-mcp/dist/index.js:389:17)
    at file:///C:/Users/RUNNER%7E1/AppData/Local/Temp/does-it-install/dii-npm-CrcZBb/node_modules/openclaw-mcp/dist/index.js:1676:16
    at ModuleJob.run (node:internal/modules/esm/module_job:343:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:681:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5)

Node.js v22.23.2

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.freema__openclaw-mcp.json)](https://doesitinstall.com/s/io.github.freema__openclaw-mcp.html)