OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Extension Chrome

Extension Chrome

L’extension Chrome d’OpenClaw permet à un agent de contrôler vos onglets Chrome connectés sans lancer de navigateur géré distinct et sans l’invite bloquante « Allow remote debugging? » de Chrome.

C’est important lorsque vous pilotez OpenClaw depuis un téléphone (Telegram, WhatsApp, etc.) : le profil user se connecte au port de débogage distant de Chrome, ce qui affiche une boîte de dialogue de consentement sur l’ordinateur sur laquelle personne ne peut cliquer en votre absence. L’extension utilise plutôt l’API chrome.debugger ; le seul indice visible dans la page est donc la bannière révocable « OpenClaw started debugging this browser » de Chrome.

Cette architecture est également utilisée par les extensions Chrome Claude d’Anthropic et Codex d’OpenAI.

Fonctionnement

Trois composants :

  • Service de contrôle du navigateur (Gateway ou hôte Node) : l’API appelée par l’outil browser.
  • Relais de l’extension (WebSocket local loopback) : un petit serveur lancé sur 127.0.0.1 par le service de contrôle. Il fournit à OpenClaw un point de terminaison Chrome DevTools Protocol et communique avec l’extension. Les deux parties s’authentifient avec un jeton local à l’hôte (voir ci-dessous).
  • Extension Chrome OpenClaw (MV3) : se connecte aux onglets avec chrome.debugger, transfère le trafic CDP et gère le groupe d’onglets OpenClaw.

OpenClaw ne voit et ne contrôle que les onglets appartenant au groupe d’onglets OpenClaw. Le groupe constitue la limite de consentement : faites-y glisser un onglet pour le partager, puis faites-le glisser hors du groupe (ou cliquez sur le bouton de la barre d’outils) pour révoquer immédiatement l’accès.

Installation et association

  1. Affichez le chemin de l’extension décompressée :

    bash
    openclaw browser extension path

  2. Ouvrez chrome://extensions, activez Developer mode, cliquez sur Load unpacked, puis sélectionnez le répertoire affiché.

  3. Affichez la chaîne d’association :

    bash
    openclaw browser extension pair

  4. Cliquez sur l’icône OpenClaw dans la barre d’outils et collez la chaîne d’association dans la fenêtre contextuelle. Le badge passe à ON lorsque l’extension se connecte au relais.

Le jeton d’association est un secret local à l’hôte, créé lors de la première utilisation et stocké sous credentials/ dans le répertoire d’état (mode 0600). Chaque machine exécutant un navigateur — l’hôte du Gateway et chaque hôte Node de navigateur — possède son propre jeton ; aucun identifiant n’a donc besoin de transiter entre les machines. Pour le renouveler, supprimez le fichier browser-extension-relay.secret, puis recommencez l’association.

Utilisation

Sélectionnez le profil intégré chrome dans un appel à l’outil browser, ou définissez-le comme profil par défaut :

bash
openclaw config set browser.defaultProfile chrome
json5
{  browser: {    profiles: {      chrome: { driver: "extension", color: "#FF4500" },    },  },}
  • Partager un onglet : cliquez sur le bouton OpenClaw de la barre d’outils dans cet onglet (il rejoint le groupe d’onglets OpenClaw), ou faites glisser n’importe quel onglet dans le groupe.
  • L’agent peut également ouvrir de nouveaux onglets ; ceux-ci rejoignent automatiquement le groupe.
  • Révoquer l’accès : cliquez à nouveau sur le bouton, faites glisser l’onglet hors du groupe ou fermez la bannière de débogage de Chrome. L’agent perd immédiatement l’accès à cet onglet.

Accès distant / entre machines

Chrome n’a pas besoin de s’exécuter sur l’hôte du Gateway. Trois topologies sont prises en charge :

  • Même hôte (Gateway et Chrome sur une même machine) : effectuez l’association sur cette machine avec openclaw browser extension pair. Le relais est accessible uniquement en local loopback.
  • Connexion directe à un Gateway distant (Chrome sur votre ordinateur portable, Gateway sur un VPS et rien d’autre sur l’ordinateur portable) : sur le Gateway, exécutez openclaw browser extension pair --gateway-url wss://your-gateway.example.com. Cette commande affiche une chaîne wss://…/browser/extension#<secret> ; chargez l’extension sur l’ordinateur portable et associez-la. L’extension se connecte directement au Gateway via wss:// — aucune installation d’OpenClaw, aucun Node, aucune CLI et aucun port entrant ouvert ne sont nécessaires sur l’ordinateur portable. Il s’agit du mode d’hébergement géré.
  • Via un hôte Node de navigateur (Chrome sur une machine qui exécute déjà un Node OpenClaw) : exécutez pair sur le Node et effectuez l’association localement ; le Gateway transmet les actions du navigateur au Node via sa liaison Node authentifiée existante.

Le secret d’association est propre à chaque hôte (celui du Gateway dans le cas d’une connexion directe) et est validé par la route /browser/extension du Gateway. Pour la connexion directe, exposez le Gateway via TLS (wss://) afin de chiffrer le secret d’association et le trafic CDP. Le secret reste dans le fragment d’URL de la chaîne d’association et est présenté lors de la négociation WebSocket comme identifiant de sous-protocole ; les journaux d’accès habituels du proxy ne le reçoivent donc pas dans l’URL de la requête. Vérifiez que tout proxy inverse conserve l’en-tête standard Sec-WebSocket-Protocol.

Diagnostic

bash
openclaw browser status --browser-profile chromeopenclaw browser doctor --browser-profile chrome

doctor indique que la vérification du relais de l’extension Chrome échoue jusqu’à ce que la fenêtre contextuelle de l’extension affiche Connected.

Modèle de sécurité

  • Le relais se lie uniquement à l’interface locale loopback ; les deux côtés de la connexion WebSocket sont authentifiés avec le jeton dérivé, et l’origine du côté de l’extension est vérifiée comme étant chrome-extension://.
  • L’association directe au Gateway n’accepte pas le jeton du relais dans l’URL de la requête ; l’extension intégrée le transmet plutôt dans la liste des sous-protocoles WebSocket.
  • L’agent ne peut voir et contrôler que les onglets du groupe d’onglets OpenClaw. Vos autres onglets restent privés.
  • Contrairement au profil user (Chrome MCP), qui expose l’intégralité de votre navigateur connecté une fois l’invite de débogage distant approuvée, l’extension limite la surface partagée à un groupe d’onglets que vous pouvez contrôler d’un coup d’œil.

Voir aussi : Navigateur pour découvrir le modèle complet des profils ainsi que les profils gérés openclaw et user de Chrome MCP.

Was this useful?
On this page

On this page