openclaw-mcp

openclaw-mcp

A Claude Code MCP server that lets you talk to your OpenClaw bot through Matrix.

How it works

Claude Code (your terminal)
  └── MCP server (this package)
        └── Matrix API
              └── Your shared Matrix room
                    └── OpenClaw bot reads and replies

Claude Code gets two tools:

• openclaw_send — send a message to your bot and wait for the reply
• openclaw_read — read recent messages from the room

Setup

1. Prerequisites

• An OpenClaw instance with Matrix channel enabled
• A Matrix account for Claude Code (e.g. create @yourclaude:matrix.org on Element)
• A Matrix room with both your bot and the Claude Code account invited

2. Install

npm install -g openclaw-mcp

Or clone and build:

git clone https://github.com/elkimek/openclaw-mcp.git
cd openclaw-mcp
npm install && npm run build

3. Configure Claude Code

Run the setup script — it prompts for your credentials, verifies them, and writes the MCP config to ~/.claude/settings.json automatically:

openclaw-mcp-setup

If installed from source:

node dist/setup.js

You'll need:

• Your Matrix access token (Element: Settings > Help & About > Access Token)
• The room ID (Element: Room Settings > Advanced > Internal room ID)
• Your OpenClaw bot's Matrix user ID (e.g. @zofka:matrix.org)

The script validates your token and room access before writing the config.

4. Restart Claude Code

After setup, restart Claude Code to activate the MCP server.

Manual configuration

If you prefer to configure manually, add to ~/.claude/settings.json:

{
  "mcpServers": {
    "openclaw": {
      "command": "openclaw-mcp",
      "env": {
        "OPENCLAW_MATRIX_TOKEN": "your-matrix-access-token",
        "OPENCLAW_MATRIX_ROOM": "!roomid:matrix.org",
        "OPENCLAW_BOT_USER_ID": "@yourbot:matrix.org"
      }
    }
  }
}

Environment variables

| Variable | Required | Description | |---|---|---| | OPENCLAW_MATRIX_TOKEN | Yes | Matrix access token for the Claude Code account | | OPENCLAW_MATRIX_ROOM | Yes | Matrix room ID (e.g. !abc123:matrix.org) | | OPENCLAW_BOT_USER_ID | Yes | Your OpenClaw bot's Matrix user ID (e.g. @zofka:matrix.org) | | OPENCLAW_MATRIX_HOMESERVER | No | Matrix homeserver URL (default: https://matrix.org) |

Usage

Once configured, just talk naturally in Claude Code:

"Ask my OpenClaw bot what my vitamin D levels are" "Message Žofka about my latest lab results" "Read the last messages from my bot"

Note on encryption

This MCP server uses the Matrix HTTP API directly without E2E encryption support. For encrypted rooms, use matrix-e2ee-bridge instead.

License

GPL-3.0