OpenClaw MCP-Server

npm version License: MIT GHCR Website

🦞 Model Context Protocol (MCP)-Server für die Integration des OpenClaw KI-Assistenten.

Demo

Warum ich das gebaut habe

Hallo! Ich habe diesen MCP-Server erstellt, weil ich mich nicht ausschließlich auf Messaging-Kanäle verlassen wollte, um mit OpenClaw zu kommunizieren. Was mich wirklich begeistert, ist die Möglichkeit, OpenClaw mit der Claude-Web-UI zu verbinden. Im Grunde kann mein Chat Aufgaben an meinen Claw-Bot delegieren, der dann alles Weitere erledigt – wie zum Beispiel das Starten von Claude Code, um Probleme für mich zu beheben.

Stellen Sie es sich als einen KI-Assistenten vor, der einen anderen KI-Assistenten orchestriert. Ziemlich cool, oder?

Schnellstart

Docker (Empfohlen)

Vorab erstellte Images werden bei jedem Release in der GitHub Container Registry veröffentlicht.

docker pull ghcr.io/freema/openclaw-mcp:latest

Erstellen Sie eine docker-compose.yml:

services:
  mcp-bridge:
    image: ghcr.io/freema/openclaw-mcp:latest
    container_name: openclaw-mcp
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - OPENCLAW_URL=http://host.docker.internal:18789
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - OPENCLAW_MODEL=openclaw
      - AUTH_ENABLED=true
      - MCP_CLIENT_ID=openclaw
      - MCP_CLIENT_SECRET=${MCP_CLIENT_SECRET}
      - MCP_ISSUER_URL=${MCP_ISSUER_URL:-}
      - CORS_ORIGINS=https://claude.ai
    extra_hosts:
      - "host.docker.internal:host-gateway"
    read_only: true
    security_opt:
      - no-new-privileges

Generieren Sie Secrets und starten Sie:

export MCP_CLIENT_SECRET=$(openssl rand -hex 32)
export OPENCLAW_GATEWAY_TOKEN=your-gateway-token
docker compose up -d

Fügen Sie dann in Claude.ai einen benutzerdefinierten MCP-Connector hinzu, der auf Ihren Server verweist, mit MCP_CLIENT_ID=openclaw und Ihrem MCP_CLIENT_SECRET.

Tipp: Verwenden Sie für die Produktion eine bestimmte Version anstelle von latest: ghcr.io/freema/openclaw-mcp:1.1.0

Lokal (Claude Desktop)

npx openclaw-mcp

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu:

{
  "mcpServers": {
    "openclaw": {
      "command": "npx",
      "args": ["openclaw-mcp"],
      "env": {
        "OPENCLAW_URL": "http://127.0.0.1:18789",
        "OPENCLAW_GATEWAY_TOKEN": "your-gateway-token",
        "OPENCLAW_MODEL": "openclaw",
        "OPENCLAW_TIMEOUT_MS": "300000"
      }
    }
  }
}

Remote (Claude.ai) ohne Docker

AUTH_ENABLED=true MCP_CLIENT_ID=openclaw MCP_CLIENT_SECRET=your-secret \
  MCP_ISSUER_URL=https://mcp.your-domain.com \
  CORS_ORIGINS=https://claude.ai OPENCLAW_GATEWAY_TOKEN=your-gateway-token \
  npx openclaw-mcp --transport sse --port 3000

Wichtig: Wenn Sie den Server hinter einem Reverse Proxy (Caddy, nginx, etc.) betreiben, müssen Sie MCP_ISSUER_URL (oder --issuer-url) auf Ihre öffentliche HTTPS-URL setzen. Ohne dies werden die OAuth-Metadaten http://localhost:3000 bewerben und Clients werden bei der Authentifizierung fehlschlagen.

Siehe Installationsanleitung für Details.

Architektur

┌─────────────────────────────────────────────────────────────────┐
│                         Your Server                             │
│                                                                 │
│  ┌─────────────────┐      ┌─────────────────────────┐          │
│  │   OpenClaw      │      │    OpenClaw MCP         │          │
│  │   Gateway       │◄────►│    Bridge Server        │          │
│  │   :18789        │      │    :3000                │          │
│  │                 │      │                         │          │
│  │  OpenAI-compat  │      │  - OAuth 2.1 auth       │          │
│  │  /v1/chat/...   │      │  - CORS protection      │          │
│  └─────────────────┘      │  - Input validation     │          │
│                           └──────────┬──────────────┘          │
│                                      │                          │
└──────────────────────────────────────┼──────────────────────────┘
                                       │ HTTPS + OAuth 2.1
                                       ▼
                              ┌─────────────────┐
                              │   Claude.ai     │
                              │   (MCP Client)  │
                              └─────────────────┘

Verfügbare Tools

Synchron-Tools

Tool	Beschreibung
`openclaw_chat`	Nachrichten an OpenClaw senden und Antworten erhalten
`openclaw_status`	Integrität des OpenClaw-Gateways prüfen
`openclaw_instances`	Alle konfigurierten OpenClaw-Instanzen auflisten

Asynchron-Tools (für lang laufende Vorgänge)

Tool	Beschreibung
`openclaw_chat_async`	Nachricht in die Warteschlange stellen, sofort `task_id` erhalten
`openclaw_task_status`	Aufgabenfortschritt prüfen und Ergebnisse abrufen
`openclaw_task_list`	Alle Aufgaben mit Filterung auflisten
`openclaw_task_cancel`	Eine ausstehende Aufgabe abbrechen

Multi-Instanz-Modus

Orchestrieren Sie mehrere OpenClaw-Gateways von einem einzigen MCP-Server aus. Eine Brücke, viele Claws – leiten Sie Anfragen an Produktion, Staging, Entwicklung oder wie auch immer Sie sie nennen (lobster-supreme und the-claw-abides sind absolut gültige Namen).

┌──────────────────────────────────────────────────────────────────────┐
│                        Claude.ai / Claude Desktop                    │
│                              (MCP Client)                            │
└──────────────────────┬───────────────────────────────────────────────┘
                       │
                       ▼
┌──────────────────────────────────────────────────────────────────────┐
│                     OpenClaw MCP Bridge Server                        │
│                                                                      │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐               │
│  │  Instance     │  │  Instance     │  │  Instance     │              │
│  │  Registry     │  │  Resolver     │  │  Validator    │              │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘               │
│         │                 │                  │                        │
│  ┌──────┴─────────────────┴──────────────────┴───────┐               │
│  │              Per-Instance OpenClaw Clients          │              │
│  │     (separate auth, timeout, URL per instance)     │              │
│  └────────┬──────────────┬──────────────┬────────────┘               │
└───────────┼──────────────┼──────────────┼────────────────────────────┘
            │              │              │
            ▼              ▼              ▼
   ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
   │  🦞 prod     │ │  🦞 staging  │ │  🦞 dev      │
   │  (default)   │ │              │ │              │
   │  :18789      │ │  :18789      │ │  :18789      │
   │  OpenClaw GW │ │  OpenClaw GW │ │  OpenClaw GW │
   └──────────────┘ └──────────────┘ └──────────────┘

Einrichtung

OPENCLAW_INSTANCES='[
  {"name": "prod", "url": "http://prod:18789", "token": "tok1", "default": true},
  {"name": "staging", "url": "http://staging:18789", "token": "tok2"},
  {"name": "dev", "url": "http://dev:18789", "token": "tok3"}
]'

Verwendung

Alle Tools akzeptieren einen optionalen instance-Parameter, um ein spezifisches Gateway anzusprechen:

# Chat with staging instance
openclaw_chat message="Deploy status?" instance="staging"

# Check health of prod
openclaw_status instance="prod"

# List all configured instances
openclaw_instances

# Async task targeting dev
openclaw_chat_async message="Run tests" instance="dev"

Wenn instance weggelassen wird, wird die Standardinstanz verwendet. Jede Instanz hat ihr eigenes Authentifizierungs-Token, Timeout und ihre eigene URL – vollständig isoliert.

Hauptmerkmale

Upgrade ohne Migration – bestehende Single-Instanz-Bereitstellungen funktionieren ohne Konfigurationsänderungen
Instanz-Isolation – separate Authentifizierungs-Token, Timeouts und URLs
Dynamisches Routing – Claude wählt die richtige Instanz pro Anfrage
Aufgabenverfolgung – asynchrone Aufgaben merken sich, welche Instanz sie ansprechen
Sicherheit – Token werden niemals über openclaw_instances offengelegt

Siehe Konfiguration – Multi-Instanz-Modus für die vollständige Referenz.

Dokumentation

Installation – Einrichtung für Claude Desktop & Claude.ai
Konfiguration – Umgebungsvariablen & Optionen
Bereitstellung – Docker & Produktions-Setup
Bedrohungsmodell – Was Claude auslösen kann/nicht kann, Vertrauensgrenzen & Angriffsflächen
Protokollierung – Was wird wo protokolliert und was wird niemals protokolliert
Entwicklung – Mitwirken & Tools hinzufügen
Sicherheit – Sicherheitsrichtlinie & Best Practices

Sicherheit

⚠️ Aktivieren Sie in der Produktion immer die Authentifizierung!

# Generate secure client secret
export MCP_CLIENT_SECRET=$(openssl rand -hex 32)

# Run with auth enabled
AUTH_ENABLED=true MCP_CLIENT_ID=openclaw MCP_CLIENT_SECRET=$MCP_CLIENT_SECRET \
  openclaw-mcp --transport sse

Konfigurieren Sie CORS, um den Zugriff einzuschränken:

CORS_ORIGINS=https://claude.ai,https://your-app.com

Siehe Konfiguration für alle Sicherheitsoptionen.

Anforderungen

Node.js ≥ 20

OpenClaw-Gateway läuft mit aktivierter HTTP-API:

// openclaw.json
{ "gateway": { "http": { "endpoints": { "chatCompletions": { "enabled": true } } } } }

Lizenz

MIT

Autor

Erstellt von Tomáš Grasl

openclaw-mcp