openclaw-mcp
MCP (Model Context Protocol) server that bridges AI assistants with OpenClaw Gateway.
This lets AI assistants like Cursor and Claude Desktop talk directly to your OpenClaw agent through MCP tools.
Features
| Tool | Description | |------|-------------| | openclaw_chat | Send a message to OpenClaw agent and get the response | | openclaw_history | Read recent chat history from the current session | | openclaw_sessions | List all OpenClaw sessions | | openclaw_read_file | Read agent workspace files (SOUL.md, MEMORY.md, etc.) | | openclaw_list_files | List files in the agent workspace directory |
Prerequisites
- OpenClaw installed and configured (source checkout with
pnpm install) - OpenClaw Gateway running (
openclaw gateway runor systemd service) - Node.js 22+
Install
git clone https://github.com/YOUR_USERNAME/openclaw-mcp.git
cd openclaw-mcp
npm installConfigure Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"openclaw": {
"command": "npx",
"args": ["tsx", "/path/to/openclaw-mcp/server.ts"],
"env": {
"OPENCLAW_DIR": "/path/to/openclaw",
"OPENCLAW_AGENT_WORKSPACE": "/path/to/clawd"
}
}
}
}Configure Claude Desktop
Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"openclaw": {
"command": "npx",
"args": ["tsx", "/path/to/openclaw-mcp/server.ts"],
"env": {
"OPENCLAW_DIR": "/path/to/openclaw",
"OPENCLAW_AGENT_WORKSPACE": "/path/to/clawd"
}
}
}
}Environment Variables
| Variable | Default | Description | |----------|---------|-------------| | OPENCLAW_DIR | ~/openclaw | Path to OpenClaw source checkout | | OPENCLAW_AGENTS_DIR | ~/.openclaw/agents | Path to agent sessions directory | | OPENCLAW_AGENT_WORKSPACE | ~/clawd | Path to agent workspace (SOUL.md, etc.) |
How It Works
Cursor/Claude ──MCP──> openclaw-mcp ──CLI──> pnpm openclaw agent ──> OpenClaw Gateway ──> AI ModelThe MCP server calls pnpm openclaw agent --message "..." --json under the hood, which communicates with the OpenClaw Gateway via WebSocket. This ensures all OpenClaw skills, tools, and agent capabilities are available.
License
MIT
