OmeniaClaw browser

Gérez la surface de contrôle du navigateur d’OmeniaClaw et exécutez des actions de navigateur (cycle de vie, profils, onglets, instantanés, captures d’écran, navigation, saisie, émulation d’état et débogage).

Associé :

• Outil de navigateur + API : Outil de navigateur

Options courantes

• --url <gatewayWsUrl> : URL WebSocket du Gateway (valeur par défaut issue de la configuration).
• --token <token> : jeton du Gateway (si requis).
• --timeout <ms> : délai d’expiration de la requête (ms).
• --expect-final : attendre une réponse finale du Gateway.
• --browser-profile <name> : choisir un profil de navigateur (valeur par défaut issue de la configuration).
• --json : sortie lisible par machine (lorsque pris en charge).

Démarrage rapide (local)

OmeniaClaw browser profilesOmeniaClaw browser --browser-profile OmeniaClaw startOmeniaClaw browser --browser-profile OmeniaClaw open https://example.comOmeniaClaw browser --browser-profile OmeniaClaw snapshot

Les agents peuvent exécuter la même vérification de disponibilité avec browser({ action: "doctor" }).

Dépannage rapide

Si start échoue avec not reachable after start, commencez par dépanner la disponibilité CDP. Si start et tabs réussissent, mais que open ou navigate échoue, le plan de contrôle du navigateur est sain et l’échec provient généralement de la stratégie SSRF de navigation.

Séquence minimale :

OmeniaClaw browser --browser-profile OmeniaClaw doctorOmeniaClaw browser --browser-profile OmeniaClaw startOmeniaClaw browser --browser-profile OmeniaClaw tabsOmeniaClaw browser --browser-profile OmeniaClaw open https://example.com

Guide détaillé : Dépannage du navigateur

Cycle de vie

OmeniaClaw browser statusOmeniaClaw browser doctorOmeniaClaw browser doctor --deepOmeniaClaw browser startOmeniaClaw browser start --headlessOmeniaClaw browser stopOmeniaClaw browser --browser-profile OmeniaClaw reset-profile

Notes :

• doctor --deep ajoute une sonde d’instantané en direct. C’est utile lorsque la disponibilité CDP de base est verte, mais que vous voulez prouver que l’onglet actuel peut être inspecté.
• Pour les profils attachOnly et CDP distants, OmeniaClaw browser stop ferme la session de contrôle active et efface les remplacements temporaires d’émulation, même lorsque OmeniaClaw n’a pas lancé lui-même le processus de navigateur.
• Pour les profils locaux gérés, OmeniaClaw browser stop arrête le processus de navigateur lancé.
• OmeniaClaw browser start --headless ne s’applique qu’à cette requête de démarrage et seulement lorsque OmeniaClaw lance un navigateur local géré. Cela ne réécrit pas browser.headless ni la configuration du profil, et n’a aucun effet pour un navigateur déjà en cours d’exécution.
• Sur les hôtes Linux sans DISPLAY ni WAYLAND_DISPLAY, les profils locaux gérés s’exécutent automatiquement en mode headless, sauf si OmeniaClaw_BROWSER_HEADLESS=0, browser.headless=false ou browser.profiles.<name>.headless=false demande explicitement un navigateur visible.

Si la commande est absente

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

Lorsque plugins.allow est présent, listez explicitement le Plugin de navigateur intégré, sauf si la configuration possède déjà un bloc racine browser :

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

Un bloc racine browser explicite, par exemple browser.enabled=true ou browser.profiles.<name>, active également le Plugin de navigateur intégré sous une liste d’autorisation de Plugins restrictive.

Associé : Outil de navigateur

Profils

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

• OmeniaClaw : lance une instance Chrome dédiée gérée par OmeniaClaw ou s’y attache (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.

OmeniaClaw browser profilesOmeniaClaw browser create-profile --name work --color "#FF5A36"OmeniaClaw browser create-profile --name chrome-live --driver existing-sessionOmeniaClaw browser create-profile --name remote --cdp-url https://browser-host.example.comOmeniaClaw browser delete-profile --name work

Utilisez un profil spécifique :

OmeniaClaw browser --browser-profile work tabs

Onglets

OmeniaClaw browser tabsOmeniaClaw browser tab new --label docsOmeniaClaw browser tab label t1 docsOmeniaClaw browser tab select 2OmeniaClaw browser tab close 2OmeniaClaw browser open https://omeniaclaw.com --label docsOmeniaClaw browser focus docsOmeniaClaw browser close t1

tabs renvoie d’abord suggestedTargetId, puis le tabId stable comme t1, le libellé facultatif et le targetId brut. Les agents doivent retransmettre suggestedTargetId à focus, close, aux instantanés et aux actions. Vous pouvez attribuer un libellé avec open --label, tab new --label ou tab label ; les libellés, identifiants d’onglet, identifiants de cible bruts et préfixes uniques d’identifiant de cible sont tous acceptés. Lorsque Chromium remplace la cible brute sous-jacente pendant une navigation ou l’envoi d’un formulaire, OmeniaClaw conserve le tabId stable/libellé attaché à l’onglet de remplacement lorsqu’il peut prouver la correspondance. Les identifiants de cible bruts restent volatils ; préférez suggestedTargetId.

Instantané / capture d’écran / actions

Instantané :

OmeniaClaw browser snapshotOmeniaClaw browser snapshot --urls

Capture d’écran :

OmeniaClaw browser screenshotOmeniaClaw browser screenshot --full-pageOmeniaClaw browser screenshot --ref e12OmeniaClaw browser screenshot --labels

Notes :

• --full-page est destiné uniquement aux captures de page ; il ne peut pas être combiné avec --ref ou --element.
• Les profils existing-session / user prennent en charge les captures d’écran de page et les captures d’écran --ref issues de la sortie d’instantané, mais pas les captures d’écran CSS --element.
• --labels superpose les références d’instantané actuelles sur la capture d’écran.
• snapshot --urls ajoute les destinations de liens découvertes aux instantanés IA afin que les agents puissent choisir des cibles de navigation directes au lieu de deviner uniquement à partir du texte des liens.

Naviguer/cliquer/saisir (automatisation de l’interface fondée sur les références) :

OmeniaClaw browser navigate https://example.comOmeniaClaw browser click <ref>OmeniaClaw browser click-coords 120 340OmeniaClaw browser type <ref> "hello"OmeniaClaw browser press EnterOmeniaClaw browser hover <ref>OmeniaClaw browser scrollintoview <ref>OmeniaClaw browser drag <startRef> <endRef>OmeniaClaw browser select <ref> OptionA OptionBOmeniaClaw browser fill --fields '[{"ref":"1","value":"Ada"}]'OmeniaClaw browser wait --text "Done"OmeniaClaw browser evaluate --fn '(el) => el.textContent' --ref <ref>

Les réponses d’action renvoient le targetId brut actuel après un remplacement de page déclenché par une action lorsque OmeniaClaw peut prouver l’onglet de remplacement. Les scripts doivent tout de même stocker et transmettre suggestedTargetId/les libellés pour les workflows de longue durée.

Assistants de fichiers + boîtes de dialogue :

OmeniaClaw browser upload /tmp/OmeniaClaw/uploads/file.pdf --ref <ref>OmeniaClaw browser waitfordownloadOmeniaClaw browser download <ref> report.pdfOmeniaClaw browser dialog --accept

Les profils Chrome gérés enregistrent les téléchargements ordinaires déclenchés par clic dans le répertoire de téléchargements OmeniaClaw (/tmp/OmeniaClaw/downloads par défaut, ou la racine temporaire configurée). Utilisez waitfordownload ou download lorsque l’agent doit attendre un fichier spécifique et renvoyer son chemin ; ces attentes explicites possèdent le prochain téléchargement.

État et stockage

Fenêtre d’affichage + émulation :

OmeniaClaw browser resize 1280 720OmeniaClaw browser set viewport 1280 720OmeniaClaw browser set offline onOmeniaClaw browser set media darkOmeniaClaw browser set timezone Europe/LondonOmeniaClaw browser set locale en-GBOmeniaClaw browser set geo 51.5074 -0.1278 --accuracy 25OmeniaClaw browser set device "iPhone 14"OmeniaClaw browser set headers '{"x-test":"1"}'OmeniaClaw browser set credentials myuser mypass

Cookies + stockage :

OmeniaClaw browser cookiesOmeniaClaw browser cookies set session abc123 --url https://example.comOmeniaClaw browser cookies clearOmeniaClaw browser storage local getOmeniaClaw browser storage local set token abc123OmeniaClaw browser storage session clear

Débogage

OmeniaClaw browser console --level errorOmeniaClaw browser pdfOmeniaClaw browser responsebody "**/api"OmeniaClaw browser highlight <ref>OmeniaClaw browser errors --clearOmeniaClaw browser requests --filter apiOmeniaClaw browser trace startOmeniaClaw browser trace stop --out trace.zip

Chrome existant via MCP

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

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

Ce chemin fonctionne uniquement sur l’hôte. Pour Docker, les serveurs headless, Browserless ou d’autres configurations distantes, utilisez plutôt un profil CDP.

Limites actuelles d’existing-session :

• les actions pilotées par instantané utilisent des références, pas des sélecteurs CSS
• browser.actionTimeoutMs définit par défaut les requêtes act prises en charge à 60000 ms lorsque les appelants omettent timeoutMs ; le timeoutMs par appel reste prioritaire.
• click est uniquement un clic gauche
• type ne prend pas en charge slowly=true
• press ne prend pas en charge delayMs
• hover, scrollintoview, drag, select, fill et evaluate rejettent les remplacements de délai d’expiration par appel
• select ne prend en charge qu’une seule valeur
• wait --load networkidle n’est pas pris en charge
• les téléversements de fichiers nécessitent --ref / --input-ref, ne prennent pas en charge --element CSS et ne prennent actuellement en charge qu’un seul fichier à la fois
• les hooks de boîte de dialogue ne prennent pas en charge --timeout
• les captures d’écran prennent en charge les captures de page et --ref, mais pas --element CSS
• responsebody, l’interception des téléchargements, l’export PDF et les actions par lot nécessitent toujours un navigateur géré ou un profil CDP brut

Contrôle de navigateur distant (proxy d’hôte Node)

Si le Gateway s’exécute sur une machine différente du navigateur, exécutez un hôte Node sur la machine qui possède Chrome/Brave/Edge/Chromium. Le Gateway relaiera les actions du navigateur vers ce Node (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 Node spécifique si plusieurs sont connectés.

Sécurité + configuration distante : Outil de navigateur, Accès distant, Tailscale, Sécurité

Associé

• Référence CLI
• Navigateur