OmeniaClaw browser

Gestisci la superficie di controllo del browser di OmeniaClaw ed esegui azioni del browser (ciclo di vita, profili, schede, snapshot, screenshot, navigazione, input, emulazione dello stato e debug).

Correlati:

• Strumento browser + API: Strumento browser

Flag comuni

• --url <gatewayWsUrl>: URL WebSocket del Gateway (predefinito dalla configurazione).
• --token <token>: token del Gateway (se richiesto).
• --timeout <ms>: timeout della richiesta (ms).
• --expect-final: attende una risposta finale del Gateway.
• --browser-profile <name>: sceglie un profilo del browser (predefinito dalla configurazione).
• --json: output leggibile da macchina (dove supportato).

Avvio rapido (locale)

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

Gli agenti possono eseguire lo stesso controllo di prontezza con browser({ action: "doctor" }).

Risoluzione rapida dei problemi

Se start fallisce con not reachable after start, diagnostica prima la prontezza CDP. Se start e tabs riescono ma open o navigate fallisce, il piano di controllo del browser è integro e l'errore è di solito dovuto alla policy SSRF di navigazione.

Sequenza minima:

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

Indicazioni dettagliate: Risoluzione dei problemi del browser

Ciclo di vita

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

Note:

• doctor --deep aggiunge una prova snapshot live. È utile quando la prontezza CDP di base è verde ma vuoi una prova che la scheda corrente possa essere ispezionata.
• Per profili attachOnly e CDP remoti, OmeniaClaw browser stop chiude la sessione di controllo attiva e cancella gli override temporanei di emulazione anche quando OmeniaClaw non ha avviato direttamente il processo del browser.
• Per i profili locali gestiti, OmeniaClaw browser stop arresta il processo del browser generato.
• OmeniaClaw browser start --headless si applica solo a quella richiesta di avvio e solo quando OmeniaClaw avvia un browser locale gestito. Non riscrive browser.headless o la configurazione del profilo, ed è un no-op per un browser già in esecuzione.
• Sugli host Linux senza DISPLAY o WAYLAND_DISPLAY, i profili locali gestiti vengono eseguiti automaticamente in modalità headless a meno che OmeniaClaw_BROWSER_HEADLESS=0, browser.headless=false o browser.profiles.<name>.headless=false richieda esplicitamente un browser visibile.

Se il comando manca

Se OmeniaClaw browser è un comando sconosciuto, controlla plugins.allow in ~/.OmeniaClaw/OmeniaClaw.json.

Quando plugins.allow è presente, elenca esplicitamente il Plugin browser incluso a meno che la configurazione non abbia già un blocco radice browser:

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

Un blocco radice browser esplicito, per esempio browser.enabled=true o browser.profiles.<name>, attiva anche il Plugin browser incluso sotto una allowlist restrittiva dei Plugin.

Correlato: Strumento browser

Profili

I profili sono configurazioni denominate di instradamento del browser. In pratica:

• OmeniaClaw: avvia o si collega a un'istanza Chrome dedicata gestita da OmeniaClaw (directory dati utente isolata).
• user: controlla la tua sessione Chrome esistente con accesso già effettuato tramite Chrome DevTools MCP.
• profili CDP personalizzati: puntano a un endpoint CDP locale o remoto.

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

Usa un profilo specifico:

OmeniaClaw browser --browser-profile work tabs

Schede

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 restituisce prima suggestedTargetId, poi il tabId stabile come t1, l'etichetta opzionale e il targetId grezzo. Gli agenti devono passare suggestedTargetId di nuovo a focus, close, snapshot e azioni. Puoi assegnare un'etichetta con open --label, tab new --label o tab label; etichette, ID scheda, ID target grezzi e prefissi univoci degli ID target sono tutti accettati. Quando Chromium sostituisce il target grezzo sottostante durante una navigazione o l'invio di un modulo, OmeniaClaw mantiene il tabId/l'etichetta stabile collegati alla scheda sostitutiva quando può dimostrare la corrispondenza. Gli ID target grezzi restano volatili; preferisci suggestedTargetId.

Snapshot / screenshot / azioni

Snapshot:

OmeniaClaw browser snapshotOmeniaClaw browser snapshot --urls

Screenshot:

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

Note:

• --full-page è solo per acquisizioni di pagina; non può essere combinato con --ref o --element.
• I profili existing-session / user supportano screenshot di pagina e screenshot --ref dall'output snapshot, ma non screenshot CSS --element.
• --labels sovrappone i riferimenti snapshot correnti allo screenshot.
• snapshot --urls aggiunge le destinazioni dei link rilevate agli snapshot AI così che gli agenti possano scegliere target di navigazione diretti invece di dedurli dal solo testo del link.

Naviga/fai clic/digita (automazione UI basata su ref):

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>

Le risposte delle azioni restituiscono il targetId grezzo corrente dopo la sostituzione della pagina innescata dall'azione quando OmeniaClaw può dimostrare la scheda sostitutiva. Gli script devono comunque memorizzare e passare suggestedTargetId/etichette per workflow di lunga durata.

Helper per file e finestre di dialogo:

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

I profili Chrome gestiti salvano i download ordinari attivati da clic nella directory dei download di OmeniaClaw (/tmp/OmeniaClaw/downloads per impostazione predefinita, o la radice temporanea configurata). Usa waitfordownload o download quando l'agente deve attendere un file specifico e restituirne il percorso; questi waiter espliciti possiedono il download successivo.

Stato e archiviazione

Viewport + emulazione:

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

Cookie + archiviazione:

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

Debug

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 esistente tramite MCP

Usa il profilo user integrato, oppure crea un tuo profilo 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

Questo percorso è solo host. Per Docker, server headless, Browserless o altre configurazioni remote, usa invece un profilo CDP.

Limiti attuali di existing-session:

• le azioni guidate da snapshot usano ref, non selettori CSS
• browser.actionTimeoutMs imposta per impostazione predefinita le richieste act supportate a 60000 ms quando i chiamanti omettono timeoutMs; timeoutMs per chiamata ha comunque la precedenza.
• click è solo clic sinistro
• type non supporta slowly=true
• press non supporta delayMs
• hover, scrollintoview, drag, select, fill e evaluate rifiutano override di timeout per chiamata
• select supporta un solo valore
• wait --load networkidle non è supportato
• i caricamenti di file richiedono --ref / --input-ref, non supportano CSS --element e attualmente supportano un file alla volta
• gli hook delle finestre di dialogo non supportano --timeout
• gli screenshot supportano acquisizioni di pagina e --ref, ma non CSS --element
• responsebody, l'intercettazione dei download, l'esportazione PDF e le azioni batch richiedono ancora un browser gestito o un profilo CDP grezzo

Controllo browser remoto (proxy host del node)

Se il Gateway viene eseguito su una macchina diversa dal browser, esegui un host node sulla macchina che ha Chrome/Brave/Edge/Chromium. Il Gateway inoltrerà le azioni del browser a quel node (non è richiesto un server di controllo browser separato).

Usa gateway.nodes.browser.mode per controllare l'instradamento automatico e gateway.nodes.browser.node per fissare un node specifico se ne sono connessi più di uno.

Sicurezza + configurazione remota: Strumento browser, Accesso remoto, Tailscale, Sicurezza

Correlati

• Riferimento CLI
• Browser