MCP

• exécuter OpenClaw comme serveur MCP avec openclaw mcp serve
• gérer les définitions de serveurs MCP sortants administrées par OpenClaw avec list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload et unset

​

Choisir le parcours MCP approprié

​

OpenClaw comme serveur MCP

​

Quand utiliser serve

• Codex, Claude Code ou un autre client MCP doit communiquer directement avec des conversations de canaux adossées à OpenClaw
• vous disposez déjà d’un Gateway OpenClaw local ou distant avec des sessions acheminées
• vous souhaitez un serveur MCP unique fonctionnant avec tous les backends de canaux d’OpenClaw, au lieu d’exécuter des passerelles distinctes pour chaque canal

​

Fonctionnement

​

Choisir un mode client

​

Ce qu’expose serve

• channel
• les métadonnées du destinataire ou de la destination
• accountId facultatif
• threadId facultatif

• répertorier les conversations acheminées récentes
• lire l’historique récent des transcriptions
• attendre de nouveaux événements entrants
• renvoyer une réponse via la même route
• voir les demandes d’approbation reçues pendant que la passerelle est connectée

​

Utilisation

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

​

Outils de la passerelle

​

Modèle d’événements

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

​

Notifications de canal Claude

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

• les messages de transcription user entrants sont transférés en tant que notifications/claude/channel
• les demandes d’autorisation Claude reçues via MCP sont suivies en mémoire
• si le propriétaire de la commande dans la conversation liée envoie ensuite yes <id> ou no <id> (<id> est l’identifiant de demande à 5 lettres, sans l), la passerelle le convertit en notifications/claude/channel/permission
• ces notifications sont limitées à la session active ; si le client MCP se déconnecte, aucune cible push n’est disponible

​

Configuration du client MCP

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

​

Options

​

Sécurité et limite de confiance

• les listes d’autorisation des expéditeurs, l’appairage et la confiance au niveau du canal relèvent toujours de la configuration du canal OpenClaw sous-jacent
• messages_send peut uniquement répondre par l’intermédiaire d’une route existante enregistrée
• l’état des approbations est actif et conservé uniquement en mémoire pour la session actuelle du pont
• l’authentification du pont doit utiliser les mêmes contrôles de jeton ou de mot de passe du Gateway que ceux auxquels vous feriez confiance pour tout autre client Gateway distant

​

Tests

pnpm test:docker:mcp-channels

​

Résolution des problèmes

​

OpenClaw comme registre de clients MCP

​

Définitions de serveurs MCP enregistrées

• 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 trie les noms de serveurs.
• show sans nom affiche l’objet complet du serveur MCP configuré.
• status classe les transports configurés sans établir de connexion. --verbose inclut les détails résolus concernant le lancement, les délais d’expiration, OAuth, les filtres et les appels parallèles.
• doctor effectue des vérifications statiques sans établir de connexion. Ajoutez --probe lorsque la commande doit également vérifier que les serveurs activés se connectent.
• probe se connecte et signale le nombre d’outils, la prise en charge des ressources et invites, la prise en charge des modifications de liste et les diagnostics.
• add accepte des options stdio telles que --command, --arg, --env et --cwd, ou des options HTTP telles que --url, --transport, --header, --auth oauth, ainsi que des options TLS, de délai d’expiration et de sélection des outils.
• set attend une valeur d’objet JSON sur la ligne de commande.
• configure met à jour l’activation, les filtres d’outils, les délais d’expiration, OAuth, TLS et les indications relatives aux appels d’outils parallèles sans remplacer l’intégralité de la définition du serveur. Ajoutez --probe pour vérifier le serveur mis à jour avant l’enregistrement.
• tools met à jour les filtres d’outils propres à chaque serveur. Les entrées d’inclusion et d’exclusion sont des noms d’outils MCP et des motifs glob simples *.
• login exécute le flux OAuth pour les serveurs HTTP configurés avec auth: "oauth". La première exécution affiche une URL d’autorisation ; exécutez de nouveau la commande avec --code après l’approbation.
• logout efface les identifiants OAuth enregistrés pour le serveur nommé sans supprimer la définition de serveur enregistrée.
• reload libère les environnements d’exécution MCP en cours de processus mis en cache pour le processus CLI actuel uniquement. Les processus Gateway ou d’agent exécutés dans un autre processus nécessitent toujours leur propre mécanisme de rechargement ou de redémarrage.
• Utilisez transport: "streamable-http" pour les serveurs MCP HTTP diffusables. openclaw mcp set normalise également le type: "http" natif de la CLI vers la même forme de configuration canonique à des fins de compatibilité.
• unset échoue si le serveur nommé n’existe pas.

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

​

Recettes courantes pour les serveurs

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,observe,click,type'
openclaw mcp doctor cua-driver --probe

​

Structures de sortie JSON

{
  "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,
        "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": "Les identifiants OAuth ne sont pas autorisés ; exécutez openclaw mcp login docs"
        }
      ]
    }
  ]
}

{
  "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",
        "timeout": 20,
        "connectTimeout": 5,
        "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_*"]
        }
      }
    }
  }
}

​

Transport Stdio

​

Transport SSE / HTTP

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

​

Processus OAuth

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

​

Transport HTTP avec diffusion en continu

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

​

Interface de contrôle

1. Ouvrez l’interface de contrôle et choisissez MCP.
2. Consultez les cartes récapitulatives indiquant le nombre total de serveurs, ainsi que les serveurs activés, OAuth et filtrés.
3. Utilisez chaque ligne de serveur pour obtenir des indications sur le transport, l’authentification, le filtre, le délai d’expiration et les commandes.
4. Basculez l’activation lorsque vous souhaitez conserver une définition tout en l’excluant de la découverte à l’exécution.
5. Modifiez la section de configuration mcp concernée pour apporter des changements structurels, tels que de nouveaux serveurs, des en-têtes, TLS, des métadonnées OAuth ou des filtres d’outils.
6. Choisissez Enregistrer pour conserver uniquement la configuration, ou Enregistrer et publier pour l’appliquer par l’intermédiaire du chemin de configuration du Gateway.
7. Exécutez openclaw mcp doctor --probe lorsqu’il est nécessaire de vérifier en direct que le serveur modifié démarre et répertorie les outils.

• les extraits de commande placent les noms de serveurs entre guillemets afin que les noms inhabituels restent copiables dans un shell
• les valeurs affichées ressemblant à des URL sont expurgées avant le rendu lorsqu’elles contiennent des identifiants intégrés
• la page ne démarre pas elle-même les transports MCP
• les environnements d’exécution actifs peuvent nécessiter openclaw mcp reload, la publication de la configuration du Gateway ou le redémarrage du processus, selon le processus qui possède les clients MCP

​

Applications MCP

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 annonce l’extension io.modelcontextprotocol/ui uniquement lorsque les applications sont activées.
• Seules les ressources ui:// dont le type MIME correspond exactement à text/html;profile=mcp-app sont affichées.
• Les ressources d’interface utilisateur sont limitées à 2 Mio, placées derrière un proxy à double iframe sur une origine externe dédiée, chargées dans une origine d’application interne opaque et soumises à une CSP dérivée des métadonnées de la ressource.
• Les outils réservés aux applications (_meta.ui.visibility: ["app"]) restent exclus des listes d’outils du modèle. Les applications peuvent appeler uniquement les outils visibles par les applications sur leur serveur propriétaire qui respectent également la politique d’outils OpenClaw effective pour l’exécution ayant créé la vue.
• Les autorisations d’application liées à l’origine, telles que l’accès à la caméra, au microphone et à la géolocalisation, ne sont pas accordées tant que les documents internes des applications utilisent des origines opaques pour assurer l’isolation entre les applications.
• Le code HTML de l’application, les arguments complets des outils et les résultats bruts résident dans un bail de vue en mémoire limité à dix minutes et ne sont ni écrits sur le disque ni copiés dans les métadonnées d’aperçu de la transcription. La transcription stocke uniquement un descripteur limité de serveur, d’outil et de ressource lié à l’identifiant d’origine de l’appel d’outil. Après le redémarrage d’un Gateway, l’interface de contrôle peut vérifier ce descripteur par rapport à la transcription de la session authentifiée et récupérer de nouveau la ressource ui:// ; les vues reconstruites sont en lecture seule jusqu’à ce qu’une nouvelle exécution établisse les autorisations d’outils actuelles.
• openclaw security audit affiche un avertissement tant que le pont est activé. Désactivez-le avec openclaw config set mcp.apps.enabled false --strict-json lorsqu’il n’est pas nécessaire.

​

Limites actuelles

• la découverte des conversations dépend des métadonnées existantes des routes de session du Gateway
• aucun protocole d’envoi générique au-delà de l’adaptateur propre à Claude
• aucun outil de modification de message ou de réaction pour le moment
• le transport HTTP/SSE/streamable-http se connecte à un seul serveur distant ; aucun multiplexage en amont pour le moment
• permissions_list_open inclut uniquement les approbations observées pendant que le pont est connecté

​

Pages connexes

• Référence de la CLI
• Plugins