navigateur

openclaw browser

Gérer le serveur de contrôle de navigateur de OpenClaw et exécuter des actions de navigateur (onglets, instantanés, captures d’écran, navigation, clics, saisie).

Connexes :

• Outil de navigateur + API : Outil de navigateur

Drapeaux courants

• --url <gatewayWsUrl> : URL WebSocket de la passerelle (par défaut depuis la configuration).
• --token <token> : jeton de la passerelle (si requis).
• --timeout <ms> : délai d’expiration de la requête (ms).
• --browser-profile <name> : choisir un profil de navigateur (celui par défaut depuis la configuration).
• --json : sortie lisible par machine (lorsque pris en charge).

Démarrage rapide (local)

openclaw browser profiles
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

Si la commande est manquante

Si openclaw browser est une commande inconnue, vérifiez plugins.allow dans ~/.openclaw/openclaw.json.

Lorsque plugins.allow est présent, le plugin de navigateur intégré doit être listé explicitement :

{
  plugins: {
    allow: ["telegram", "browser"],
  },
}

browser.enabled=true ne restaure pas la sous-commande CLI lorsque la liste d’autorisation des plugins exclut browser.

Connexe : Outil de navigateur

Profils

Les profils sont des configurations de routage de navigateur nommées. En pratique :

• openclaw : lance ou se connecte à une instance Chrome gérée dédiée par OpenClaw (répertoire de données utilisateur isolé).
• user : contrôle votre session Chrome existante connectée via Chrome DevTools MCP.
• profils CDP personnalisés : pointent vers un point de terminaison CDP local ou distant.

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser delete-profile --name work

Utiliser un profil spécifique :

openclaw browser --browser-profile work tabs

Onglets

openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

Instantané / capture d’écran / actions

Instantané :

openclaw browser snapshot

Capture d’écran :

openclaw browser screenshot

Navigation / clic / saisie (automatisation de l’interface utilisateur basée sur des références) :

openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"

Chrome existant via MCP

Utilisez le profil intégré user, ou créez votre propre profil existing-session :

openclaw browser --browser-profile user tabs
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"
openclaw browser --browser-profile chrome-live tabs

Ce chemin est réservé à l’hôte. Pour Docker, les serveurs sans interface, Browserless ou d’autres configurations distantes, utilisez plutôt un profil CDP.

Contrôle distant du navigateur (proxy d’hôte de nœud)

Si la passerelle s’exécute sur une machine différente de celle du navigateur, exécutez un hôte de nœud sur la machine qui dispose de Chrome/Brave/Edge/Chromium. La passerelle proxiera les actions du navigateur vers ce nœud (aucun serveur de contrôle de navigateur séparé requis).

Utilisez gateway.nodes.browser.mode pour contrôler le routage automatique et gateway.nodes.browser.node pour épingler un nœud spécifique si plusieurs sont connectés.

Sécurité + configuration à distance : Browser tool, Remote access, Tailscale, Security