MCP

openclaw mcp heeft twee taken:

• OpenClaw uitvoeren als een MCP-server met openclaw mcp serve
• door OpenClaw beheerde uitgaande MCP-serverdefinities beheren met list, show, set en unset

Met andere woorden:

• serve is OpenClaw dat optreedt als MCP-server
• list / show / set / unset is OpenClaw dat optreedt als MCP-clientzijdig register voor andere MCP-servers die de runtimes later kunnen gebruiken

Gebruik openclaw acp wanneer OpenClaw zelf een codeerharness-sessie moet hosten en die runtime via ACP moet routeren.

# OpenClaw als MCP-server

Dit is het openclaw mcp serve-pad.

# Wanneer serve gebruiken

Gebruik openclaw mcp serve wanneer:

• Codex, Claude Code of een andere MCP-client rechtstreeks moet praten met door OpenClaw ondersteunde kanaalgesprekken
• je al een lokale of externe OpenClaw Gateway met gerouteerde sessies hebt
• je één MCP-server wilt die werkt over de kanaalbackends van OpenClaw heen in plaats van afzonderlijke bruggen per kanaal uit te voeren

Gebruik in plaats daarvan openclaw acp wanneer OpenClaw zelf de codeerruntime moet hosten en de agentsessie binnen OpenClaw moet houden.

# Hoe het werkt

openclaw mcp serve start een stdio MCP-server. De MCP-client is eigenaar van dat proces. Zolang de client de stdio-sessie openhoudt, maakt de brug verbinding met een lokale of externe OpenClaw Gateway via WebSocket en stelt gerouteerde kanaalgesprekken beschikbaar via MCP.

# Kies een clientmodus

Gebruik dezelfde brug op twee verschillende manieren:

# Wat serve beschikbaar stelt

De brug gebruikt bestaande Gateway-sessieroutemetadata om kanaalondersteunde gesprekken beschikbaar te stellen. Een gesprek verschijnt wanneer OpenClaw al sessiestatus heeft met een bekende route zoals:

• channel
• metadata van ontvanger of bestemming
• optionele accountId
• optionele threadId

Dit geeft MCP-clients één plek om:

• recente gerouteerde gesprekken te tonen
• recente transcriptgeschiedenis te lezen
• te wachten op nieuwe inkomende gebeurtenissen
• een antwoord terug te sturen via dezelfde route
• goedkeuringsverzoeken te zien die binnenkomen terwijl de brug verbonden is

# Gebruik

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

# Brugtools

De huidige brug stelt deze MCP-tools beschikbaar:

# Gebeurtenismodel

De brug houdt een gebeurteniswachtrij in het geheugen bij terwijl deze verbonden is.

Huidige gebeurtenistypen:

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

# Claude-kanaalmeldingen

De brug kan ook Claude-specifieke kanaalmeldingen beschikbaar stellen. Dit is het OpenClaw-equivalent van een Claude Code-kanaaladapter: standaard MCP-tools blijven beschikbaar, maar live inkomende berichten kunnen ook aankomen als Claude-specifieke MCP-meldingen.

Wanneer de Claude-kanaalmodus is ingeschakeld, adverteert de server experimentele Claude-capaciteiten en kan deze uitzenden:

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

Huidig bruggedrag:

• inkomende user-transcriptberichten worden doorgestuurd als notifications/claude/channel
• Claude-toestemmingsverzoeken die via MCP worden ontvangen, worden in het geheugen bijgehouden
• als het gekoppelde gesprek later yes abcde of no abcde verzendt, zet de brug dat om naar notifications/claude/channel/permission
• deze meldingen zijn alleen voor live sessies; als de MCP-client de verbinding verbreekt, is er geen pushdoel

Dit is bewust clientspecifiek. Algemene MCP-clients moeten vertrouwen op de standaard pollingtools.

# MCP-clientconfiguratie

Voorbeeld van stdio-clientconfiguratie:

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

Voor de meeste algemene MCP-clients begin je met het standaard tooloppervlak en negeer je de Claude-modus. Zet de Claude-modus alleen aan voor clients die de Claude-specifieke meldingsmethoden daadwerkelijk begrijpen.

# Opties

openclaw mcp serve ondersteunt:

# Beveiligings- en vertrouwensgrens

De brug verzint geen routering. Deze stelt alleen gesprekken beschikbaar waarvan de Gateway al weet hoe ze moeten worden gerouteerd.

Dat betekent:

• afzender-allowlists, pairing en vertrouwen op kanaalniveau blijven onderdeel van de onderliggende OpenClaw-kanaalconfiguratie
• messages_send kan alleen antwoorden via een bestaande opgeslagen route
• goedkeuringsstatus is alleen live/in-memory voor de huidige brugsessie
• brugauthenticatie moet dezelfde Gateway-token- of wachtwoordcontroles gebruiken die je zou vertrouwen voor elke andere externe Gateway-client

Als een gesprek ontbreekt in conversations_list, is de gebruikelijke oorzaak niet de MCP-configuratie. Het gaat dan om ontbrekende of onvolledige routemetadata in de onderliggende Gateway-sessie.

# Testen

OpenClaw levert een deterministische Docker-smoke voor deze brug:

pnpm test:docker:mcp-channels

Die smoke:

• start een vooraf gevulde Gateway-container
• start een tweede container die openclaw mcp serve start
• verifieert gespreksdetectie, transcriptleesacties, metadata-leesacties voor bijlagen, gedrag van de livegebeurteniswachtrij en routering van uitgaande verzendingen
• valideert Claude-achtige kanaal- en toestemmingsmeldingen via de echte stdio MCP-brug

Dit is de snelste manier om te bewijzen dat de brug werkt zonder een echt Telegram-, Discord- of iMessage-account aan de testrun te koppelen.

Zie Testen voor bredere testcontext.

# Probleemoplossing

# OpenClaw als MCP-clientregister

Dit is het pad voor openclaw mcp list, show, set en unset.

Deze opdrachten stellen OpenClaw niet beschikbaar via MCP. Ze beheren MCP-serverdefinities die eigendom zijn van OpenClaw onder mcp.servers in de OpenClaw-configuratie.

Die opgeslagen definities zijn bedoeld voor runtimes die OpenClaw later start of configureert, zoals ingebedde Pi en andere runtime-adapters. OpenClaw slaat de definities centraal op, zodat die runtimes geen eigen dubbele MCP-serverlijsten hoeven bij te houden.

Runtime-adapters kunnen dit gedeelde register normaliseren naar de vorm die hun downstreamclient verwacht. Ingebedde Pi gebruikt bijvoorbeeld OpenClaw-waarden voor transport direct, terwijl Claude Code en Gemini CLI-native type-waarden ontvangen zoals http, sse of stdio.

# Opgeslagen MCP-serverdefinities

OpenClaw slaat ook een lichtgewicht MCP-serverregister op in de configuratie voor oppervlakken die door OpenClaw beheerde MCP-definities willen gebruiken.

Opdrachten:

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp set <name> <json>
• openclaw mcp unset <name>

Opmerkingen:

• list sorteert servernamen.
• show zonder naam print het volledige geconfigureerde MCP-serverobject.
• set verwacht één JSON-objectwaarde op de opdrachtregel.
• Gebruik transport: "streamable-http" voor Streamable HTTP MCP-servers. openclaw mcp set normaliseert ook CLI-native type: "http" naar dezelfde canonieke configuratievorm voor compatibiliteit.
• unset mislukt als de genoemde server niet bestaat.

Voorbeelden:

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'
openclaw mcp unset context7

Voorbeeldconfiguratievorm:

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com",
        "transport": "streamable-http"
      }
    }
  }
}

# Stdio-transport

Start een lokaal childproces en communiceert via stdin/stdout.

# SSE- / HTTP-transport

Maakt verbinding met een externe MCP-server via HTTP Server-Sent Events.

Voorbeeld:

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

Gevoelige waarden in url (userinfo) en headers worden geredigeerd in logs en statusuitvoer.

# Streamable HTTP-transport

streamable-http is een aanvullende transportoptie naast sse en stdio. Het gebruikt HTTP-streaming voor bidirectionele communicatie met externe MCP-servers.

OpenClaw-configuratie gebruikt transport: "streamable-http" als de canonieke spelling. CLI-native MCP-waarden voor type: "http" worden geaccepteerd wanneer ze via openclaw mcp set worden opgeslagen en gerepareerd door openclaw doctor --fix in bestaande configuratie, maar transport is wat ingebedde Pi direct gebruikt.

Voorbeeld:

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

# Huidige limieten

Deze pagina documenteert de bridge zoals die vandaag is geleverd.

Huidige limieten:

• gespreksdetectie hangt af van bestaande routemetadata van Gateway-sessies
• geen generiek pushprotocol buiten de Claude-specifieke adapter
• nog geen tools voor berichtbewerking of reacties
• HTTP/SSE/streamable-http-transport maakt verbinding met één externe server; nog geen gemultiplexte upstream
• permissions_list_open bevat alleen goedkeuringen die zijn waargenomen terwijl de bridge verbonden is

# Gerelateerd

• CLI-referentie
• Plugins