MCP

• OpenClaw mit openclaw mcp serve als MCP-Server ausführen
• von OpenClaw verwaltete Definitionen ausgehender MCP-Server mit list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload und unset verwalten

​

Den richtigen MCP-Pfad auswählen

​

OpenClaw als MCP-Server

​

Wann serve verwendet werden sollte

• Codex, Claude Code oder ein anderer MCP-Client direkt mit von OpenClaw gestützten Kanalunterhaltungen kommunizieren soll
• bereits ein lokales oder entferntes OpenClaw Gateway mit weitergeleiteten Sitzungen vorhanden ist
• Sie einen MCP-Server wünschen, der über die Kanal-Backends von OpenClaw hinweg funktioniert, anstatt separate Bridges für jeden Kanal auszuführen

​

Funktionsweise

​

Clientmodus auswählen

​

Von serve bereitgestellte Funktionen

• channel
• Empfänger- oder Zielmetadaten
• optional accountId
• optional threadId

• kürzlich weitergeleitete Unterhaltungen aufzulisten
• den aktuellen Transkriptverlauf zu lesen
• auf neue eingehende Ereignisse zu warten
• eine Antwort über dieselbe Route zurückzusenden
• Genehmigungsanfragen zu sehen, die eintreffen, während die Bridge verbunden ist

​

Verwendung

openclaw mcp serve

openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password

openclaw mcp serve --verbose
openclaw mcp serve --claude-channel-mode off

​

Bridge-Werkzeuge

​

Ereignismodell

• message
• exec_approval_requested
• exec_approval_resolved
• plugin_approval_requested
• plugin_approval_resolved
• claude_permission_request

​

Claude-Kanalbenachrichtigungen

• notifications/claude/channel
• notifications/claude/channel/permission

• eingehende user-Transkriptnachrichten werden als notifications/claude/channel weitergeleitet
• über MCP empfangene Claude-Berechtigungsanfragen werden im Arbeitsspeicher nachverfolgt
• wenn der Befehlseigentümer in der verknüpften Unterhaltung später yes <id> oder no <id> sendet (<id> ist die fünfstellige Anfrage-ID ohne l), wandelt die Bridge dies in notifications/claude/channel/permission um
• diese Benachrichtigungen sind ausschließlich für die Live-Sitzung bestimmt; wenn der MCP-Client die Verbindung trennt, gibt es kein Push-Ziel

​

MCP-Client-Konfiguration

{
  "mcpServers": {
    "openclaw": {
      "command": "openclaw",
      "args": [
        "mcp",
        "serve",
        "--url",
        "wss://gateway-host:18789",
        "--token-file",
        "/path/to/gateway.token"
      ]
    }
  }
}

​

Optionen

​

Sicherheits- und Vertrauensgrenze

• Absender-Zulassungslisten, Kopplung und Vertrauen auf Kanalebene gehören weiterhin zur zugrunde liegenden OpenClaw-Kanalkonfiguration
• messages_send kann nur über eine vorhandene gespeicherte Route antworten
• der Genehmigungsstatus ist nur live/im Arbeitsspeicher für die aktuelle Bridge-Sitzung verfügbar
• die Bridge-Authentifizierung sollte dieselben Gateway-Token- oder Passwortkontrollen verwenden, denen Sie auch bei jedem anderen entfernten Gateway-Client vertrauen würden

​

Tests

pnpm test:docker:mcp-channels

​

Fehlerbehebung

​

OpenClaw als MCP-Client-Registrierung

​

Gespeicherte MCP-Serverdefinitionen

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp status [--verbose]
• openclaw mcp doctor [name] [--probe]
• openclaw mcp probe [name]
• openclaw mcp add <name> [flags]
• openclaw mcp set <name> <json>
• openclaw mcp configure <name> [flags]
• openclaw mcp tools <name> [--include csv] [--exclude csv] [--clear]
• openclaw mcp login <name> [--code code]
• openclaw mcp logout <name>
• openclaw mcp reload
• openclaw mcp unset <name>

• list sortiert Servernamen.
• show ohne Namen gibt das vollständige konfigurierte MCP-Serverobjekt aus.
• status klassifiziert konfigurierte Transporte, ohne eine Verbindung herzustellen. --verbose enthält aufgelöste Details zu Start, Zeitüberschreitung, OAuth, Filter und parallelen Aufrufen, einschließlich der Fälle, in denen gespeicherte OAuth-Token eine zusätzliche Autorisierung erfordern. stdio-Argumente, die Anmeldedaten enthalten, werden in der Text- und JSON-Ausgabe geschwärzt.
• doctor führt statische Prüfungen durch, ohne eine Verbindung herzustellen. Fügen Sie --probe hinzu, wenn der Befehl zusätzlich überprüfen soll, ob aktivierte Server eine Verbindung herstellen können.
• probe stellt eine Verbindung her und meldet die Anzahl der Tools, die Unterstützung von Ressourcen/Prompts, die Unterstützung von Listenänderungen und Diagnosen.
• add akzeptiert stdio-Flags wie --command, --arg, --env und --cwd oder HTTP-Flags wie --url, --transport, --header, --auth oauth sowie Flags für TLS, Zeitüberschreitung und Tool-Auswahl.
• set erwartet einen einzelnen JSON-Objektwert in der Befehlszeile.
• configure aktualisiert Aktivierung, Tool-Filter, Zeitüberschreitungen, OAuth, TLS und Hinweise zu parallelen Tool-Aufrufen, ohne die gesamte Serverdefinition zu ersetzen. Fügen Sie --probe hinzu, um den aktualisierten Server vor dem Speichern zu überprüfen.
• tools aktualisiert Tool-Filter pro Server. Einschluss-/Ausschlusseinträge sind MCP-Tool-Namen und einfache *-Globs.
• login führt den OAuth-Ablauf für HTTP-Server aus, die mit auth: "oauth" konfiguriert sind. Der erste Durchlauf gibt eine Autorisierungs-URL aus; führen Sie den Befehl nach der Genehmigung erneut mit --code aus.
• logout löscht gespeicherte OAuth-Anmeldedaten für den benannten Server, ohne die gespeicherte Serverdefinition zu entfernen.
• reload verwirft zwischengespeicherte prozessinterne MCP-Laufzeitumgebungen ausschließlich für den aktuellen CLI-Prozess. Gateway- oder Agentenprozesse in einem anderen Prozess benötigen weiterhin einen eigenen Neu-Lade- oder Neustartpfad.
• Verwenden Sie transport: "streamable-http" für Streamable-HTTP-MCP-Server. openclaw mcp set normalisiert außerdem das CLI-native type: "http" aus Kompatibilitätsgründen in dieselbe kanonische Konfigurationsform.
• unset schlägt fehl, wenn der benannte Server nicht existiert.

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp status --verbose
openclaw mcp doctor --probe
openclaw mcp probe context7 --json
openclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memory
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp tools context7 --include 'resolve-library-id,get-library-docs'
openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'
openclaw mcp configure docs --timeout 20 --connect-timeout 5 --include 'search,read_*'
openclaw mcp configure docs --auth oauth --oauth-scope 'docs.read'
openclaw mcp login docs
openclaw mcp logout docs
openclaw mcp unset context7

​

Gängige Serverkonfigurationen

openclaw mcp add files \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-filesystem \
  --arg "$HOME/Documents" \
  --include 'read_file,list_directory,search_files'
openclaw mcp doctor files --probe

openclaw mcp add memory \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-memory
openclaw mcp probe memory --json

openclaw mcp add local-tools \
  --command node \
  --arg ./dist/mcp-server.js \
  --cwd /srv/openclaw-tools \
  --env API_BASE=https://internal.example
openclaw mcp status --verbose

openclaw mcp add docs \
  --url https://mcp.example.com/mcp \
  --transport streamable-http \
  --auth oauth \
  --oauth-scope docs.read \
  --timeout 20 \
  --connect-timeout 5 \
  --include 'search,read_*'
openclaw mcp doctor docs --probe

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
openclaw mcp tools cua-driver --include 'list_apps,get_window_state,click,type_text'
openclaw mcp doctor cua-driver --probe

​

JSON-Ausgabeformate

{
  "path": "/home/user/.openclaw/openclaw.json",
  "servers": [
    {
      "name": "docs",
      "configured": true,
      "enabled": true,
      "ok": true,
      "transport": "streamable-http",
      "launch": "streamable-http https://mcp.example.com/mcp",
      "auth": "oauth",
      "authStatus": {
        "hasTokens": true,
        "requiresAuthorization": false,
        "hasClientInformation": true,
        "hasCodeVerifier": false,
        "hasDiscoveryState": true,
        "hasLastAuthorizationUrl": false
      },
      "requestTimeoutMs": 20000,
      "connectionTimeoutMs": 5000,
      "toolFilter": {
        "include": ["search", "read_*"],
        "exclude": []
      },
      "supportsParallelToolCalls": true
    }
  ]
}

{
  "ok": true,
  "path": "/home/user/.openclaw/openclaw.json",
  "servers": [
    {
      "name": "docs",
      "ok": true,
      "issues": [
        {
          "level": "warning",
          "message": "OAuth-Anmeldedaten sind nicht autorisiert; führen Sie openclaw mcp login docs aus"
        }
      ]
    }
  ]
}

{
  "generatedAt": "2026-05-31T09:00:00.000Z",
  "servers": {
    "docs": {
      "launch": "streamable-http https://mcp.example.com/mcp",
      "tools": 2,
      "resources": true,
      "listChanged": {
        "tools": true,
        "resources": false,
        "prompts": false
      }
    }
  },
  "tools": ["docs__read_page", "docs__search"],
  "diagnostics": []
}

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com",
        "transport": "streamable-http",
        "requestTimeoutMs": 20000,
        "connectionTimeoutMs": 5000,
        "supportsParallelToolCalls": true,
        "auth": "oauth",
        "oauth": {
          "scope": "docs.read"
        },
        "sslVerify": true,
        "clientCert": "/path/to/client.crt",
        "clientKey": "/path/to/client.key",
        "toolFilter": {
          "include": ["search_*"],
          "exclude": ["admin_*"]
        }
      }
    }
  }
}

​

Stdio-Transport

​

SSE-/HTTP-Transport

{
  "mcp": {
    "servers": {
      "remote-tools": {
        "url": "https://mcp.example.com",
        "auth": "oauth",
        "requestTimeoutMs": 20000,
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

​

OAuth-Ablauf

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"docs.read"}}'

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"authProfileId":"docs:mcp"}}'

openclaw mcp login docs

openclaw mcp login docs --code abc123

openclaw mcp status --verbose
openclaw mcp doctor docs --probe

openclaw mcp logout docs

​

Streamable-HTTP-Transport

{
  "mcp": {
    "servers": {
      "streaming-tools": {
        "url": "https://mcp.example.com/stream",
        "transport": "streamable-http",
        "connectionTimeoutMs": 10000,
        "requestTimeoutMs": 30000,
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

​

Control UI

1. Öffnen Sie die Control UI und wählen Sie MCP.
2. Prüfen Sie die Übersichtskarten für alle, aktivierte, OAuth- und gefilterte Server.
3. Verwenden Sie jede Serverzeile für Hinweise zu Transport, Authentifizierung, Filtern, Timeouts und Befehlen.
4. Schalten Sie die Aktivierung um, wenn Sie eine Definition beibehalten, sie jedoch von der Laufzeiterkennung ausschließen möchten.
5. Bearbeiten Sie den bereichsspezifischen Konfigurationsabschnitt mcp, um strukturelle Änderungen wie neue Server, Header, TLS, OAuth-Metadaten oder Toolfilter vorzunehmen.
6. Wählen Sie Save, um nur die Konfiguration dauerhaft zu speichern, oder Save & Publish, um sie über den Gateway-Konfigurationspfad anzuwenden.
7. Führen Sie openclaw mcp doctor --probe aus, wenn Sie einen Live-Nachweis benötigen, dass der bearbeitete Server startet und Tools auflistet.

• Befehlsausschnitte setzen Servernamen in Anführungszeichen, damit ungewöhnliche Namen in einer Shell weiterhin kopiert werden können
• angezeigte URL-ähnliche Werte werden vor der Darstellung geschwärzt, wenn sie eingebettete Anmeldedaten enthalten
• die Seite startet MCP-Transporte nicht selbst
• aktive Laufzeiten benötigen möglicherweise openclaw mcp reload, eine Veröffentlichung der Gateway-Konfiguration oder einen Prozessneustart, je nachdem, welcher Prozess die MCP-Clients verwaltet

​

MCP Apps

openclaw config set mcp.apps.enabled true --strict-json

{
  mcp: {
    apps: {
      enabled: true,
      sandboxOrigin: "https://mcp-apps.example.com",
      sandboxPort: 18790,
    },
  },
}

{
  mcp: {
    apps: { enabled: true },
    servers: {
      "basic-react": {
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-basic-react", "--stdio"],
      },
    },
  },
}

• OpenClaw kündigt die Erweiterung io.modelcontextprotocol/ui nur an, wenn Apps aktiviert sind.
• Nur Ressourcen vom Typ ui:// mit dem exakten MIME-Typ text/html;profile=mcp-app werden dargestellt.
• UI-Ressourcen sind auf 2 MiB begrenzt, werden hinter einem Doppel-Iframe-Proxy auf einem eigenen äußeren Origin platziert, in einen undurchsichtigen inneren App-Origin geladen und durch eine aus den Ressourcenmetadaten abgeleitete CSP eingeschränkt.
• Ausschließlich für Apps bestimmte Tools (_meta.ui.visibility: ["app"]) bleiben aus den Toollisten des Modells ausgeschlossen. Apps können nur für Apps sichtbare Tools auf ihrem zugehörigen Server aufrufen, die außerdem die wirksame OpenClaw-Toolrichtlinie für den Lauf erfüllen, der die Ansicht erstellt hat.
• An den Origin gebundene App-Berechtigungen wie Kamera, Mikrofon und Geolokalisierung werden nicht erteilt, solange innere App-Dokumente undurchsichtige Origins zur App-übergreifenden Isolation verwenden.
• App-HTML, vollständige Toolargumente und unverarbeitete Ergebnisse verbleiben in einem begrenzten, zehn Minuten gültigen In-Memory-Ansichts-Lease und werden weder auf den Datenträger geschrieben noch in die Vorschaumetadaten des Transkripts kopiert. Das Transkript speichert nur einen begrenzten Server-/Tool-/Ressourcendeskriptor, der an die ursprüngliche Toolaufruf-ID gebunden ist. Nach einem Gateway-Neustart kann die Control UI diesen Deskriptor anhand des Transkripts der authentifizierten Sitzung überprüfen und die Ressource ui:// erneut abrufen; wiederhergestellte Ansichten sind schreibgeschützt, bis ein neuer Lauf aktuelle Toolberechtigungen festlegt.
• In Kanalunterhaltungen fügt die letzte erfolgreiche App-Ansicht eines Durchgangs der abschließenden Assistentenantwort eine Aktion im Stil von App öffnen hinzu. Telegram-Direktnachrichten verwenden eine native Mini-App-Schaltfläche; Slack und Discord stellen dieselbe portable Aktion als Link dar. Andere Kanäle behalten den ursprünglichen Antworttext bei und hängen einen verständlichen HTTPS-Link an.
• Kanal-Startlinks sind nur verfügbar, wenn die Tailscale-Bereitstellung des Gateways einen veröffentlichten HTTPS-Origin vorbereitet hat. gateway.tailscale.mode: "serve" ist nur aus dem Tailnet erreichbar; "funnel" ist aus dem öffentlichen Internet erreichbar. Ein extern verwalteter Funnel, der durch gateway.tailscale.preserveFunnel beibehalten wird, gilt ebenfalls als über das Internet erreichbar. Siehe Tailscale.
• Starttickets sind undurchsichtig, werden ausschließlich beim Erstellen der abschließenden Kanalantwort ausgestellt und laufen nach höchstens zwei Minuten oder beim Ablauf des zugrunde liegenden Ansichts-Lease ab, je nachdem, was zuerst eintritt. Die URL enthält keine Gateway-Bearer-Anmeldedaten, Sitzungsschlüssel, Ansichtsmetadaten, App-HTML, Tooleingaben oder Toolergebnisse.
• Wenn kein veröffentlichter Origin oder keine Ticketkapazität verfügbar ist, die Ansicht oder das Ticket abgelaufen ist oder der Transport keine nativen Steuerelemente darstellen kann, bleibt der ursprüngliche Assistententext verfügbar. Die Control UI behält ihre vorhandene eingebettete App-Zeichenfläche bei und erhält keine doppelte Startaktion.
• openclaw security audit warnt, solange die Bridge aktiviert ist. Deaktivieren Sie sie mit openclaw config set mcp.apps.enabled false --strict-json, wenn sie nicht benötigt wird.

​

Aktuelle Einschränkungen

• die Unterhaltungserkennung hängt von vorhandenen Metadaten der Gateway-Sitzungsroute ab
• kein generisches Push-Protokoll über den Claude-spezifischen Adapter hinaus
• noch keine Tools zum Bearbeiten von Nachrichten oder Hinzufügen von Reaktionen
• der HTTP-/SSE-/Streamable-HTTP-Transport verbindet sich mit einem einzelnen entfernten Server; noch kein gebündelter Upstream
• permissions_list_open enthält nur Genehmigungen, die beobachtet wurden, während die Bridge verbunden war

​

Verwandte Themen

• CLI-Referenz
• Plugins