openclaw
MCP server that exposes OpenClaw assistants via Streamable HTTP transport
claude mcp add --transport stdio rodgco-openclaw-mcp-server node path/to/server.js \ --env PORT="3721" \ --env BOT_NAME="Your bot name (e.g., MyAssistant)" \ --env BIND_ADDRESS="0.0.0.0" \ --env MCP_SERVER_API_KEY="Your generated API key" \ --env OPENCLAW_WORKSPACE="$HOME/.openclaw/workspace" \ --env OPENCLAW_SESSION_LABEL="Your OpenClaw session label (e.g., main)"
How to use
OpenClaw MCP Server exposes your OpenClaw assistant to Claude Desktop and other MCP clients using the Streamable HTTP transport. Once running, you connect Claude Desktop to the server via a configured MCP endpoint and authenticate with your API key. The server supports server-sent events (SSE) for streaming responses, so conversations with your OpenClaw assistant can unfold in real time. Tools available to Claude Desktop include asking the assistant, querying long-term memory with memory_search, and checking session status with sessions_status. The system is designed to be configurable, with options to set the bot name, session label, port, host binding, and OpenClaw workspace, and it can be set to start automatically via systemd for reliability in production environments.
How to install
Prerequisites:
- Node.js v18+ installed on the host
- Git installed
- OpenClaw installed on the host (as per its own installation docs)
- Optional: Systemd for auto-start
Installation steps:
-
Clone the repository: git clone https://github.com/rodgco/openclaw-mcp-server.git cd openclaw-mcp-server
-
Run the installer script (recommended): ./install.sh
- The installer checks Node.js 18+ and OpenClaw, installs dependencies, generates an API key, prompts for bot name and session label, and optionally creates a systemd service. It also outputs a Claude Desktop configuration snippet for easy setup.
-
If you prefer manual setup:
Clone and install
git clone https://github.com/rodgco/openclaw-mcp-server.git cd openclaw-mcp-server npm install
Configure environment
cp .env.example .env
Edit .env with your settings (BOT_NAME, OPENCLAW_SESSION_LABEL, MCP_SERVER_API_KEY, PORT, BIND_ADDRESS, OPENCLAW_WORKSPACE)
Start the server
npm start
-
Optional systemd service (if you want auto-start):
- Use the installer’s option to create the service, or manually create a unit file at /etc/systemd/system/openclaw-mcp-server.service with the appropriate ExecStart invoking npm start in the repository directory, then enable and start the service: sudo systemctl enable openclaw-mcp-server sudo systemctl start openclaw-mcp-server
Additional notes
Security and networking tips:
- The server requires an API key for all MCP requests. Keep this key secret and rotate periodically.
- Consider using a reverse proxy (nginx or Caddy) with HTTPS in production to protect traffic.
- If exposing the MCP endpoint over the internet, consider enabling additional authentication layers or network access controls (e.g., VPN, SSH tunnel, or a firewall).
- The MCP server uses port 3721 by default; adjust PORT in .env if needed, and ensure firewall rules allow incoming traffic on that port.
- For local development or testing, you can curl the health and basic info endpoints to verify the server, and test MCP endpoints with an authorized request as shown in the readme.
- If you run into issues with OpenClaw workspace paths or API keys, verify that OPENCLAW_WORKSPACE exists and that BOT_NAME and OPENCLAW_SESSION_LABEL match your OpenClaw setup.
Related MCP Servers
zen
Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage
MCP -Deepseek_R1
A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)
mcp-fhir
A Model Context Protocol implementation for FHIR
mcp
Inkdrop Model Context Protocol Server
mcp-appium-gestures
This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..
dubco -npm
The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.