OmeniaClaw browser

Beheer het browserbesturingsoppervlak van OmeniaClaw en voer browseracties uit (levenscyclus, profielen, tabbladen, snapshots, screenshots, navigatie, invoer, status-emulatie en foutopsporing).

Gerelateerd:

• Browsertool + API: Browsertool

Algemene vlaggen

• --url <gatewayWsUrl>: Gateway WebSocket-URL (standaard uit configuratie).
• --token <token>: Gateway-token (indien vereist).
• --timeout <ms>: time-out voor verzoek (ms).
• --expect-final: wacht op een definitieve Gateway-respons.
• --browser-profile <name>: kies een browserprofiel (standaard uit configuratie).
• --json: machineleesbare uitvoer (waar ondersteund).

Snel starten (lokaal)

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

Agents kunnen dezelfde gereedheidscontrole uitvoeren met browser({ action: "doctor" }).

Snelle probleemoplossing

Als start mislukt met not reachable after start, los dan eerst de CDP-gereedheid op. Als start en tabs slagen maar open of navigate mislukt, is het browserbesturingsvlak gezond en is de fout meestal het SSRF-beleid voor navigatie.

Minimale reeks:

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

Gedetailleerde richtlijnen: Browserprobleemoplossing

Levenscyclus

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

Opmerkingen:

• doctor --deep voegt een live snapshot-probe toe. Dit is nuttig wanneer de basis-CDP-gereedheid groen is, maar je bewijs wilt dat het huidige tabblad kan worden geïnspecteerd.
• Voor attachOnly en externe CDP-profielen sluit OmeniaClaw browser stop de actieve besturingssessie en wist tijdelijke emulatie-overschrijvingen, zelfs wanneer OmeniaClaw het browserproces niet zelf heeft gestart.
• Voor lokaal beheerde profielen stopt OmeniaClaw browser stop het gestarte browserproces.
• OmeniaClaw browser start --headless geldt alleen voor dat startverzoek en alleen wanneer OmeniaClaw een lokaal beheerde browser start. Het herschrijft browser.headless of de profielconfiguratie niet, en doet niets voor een browser die al actief is.
• Op Linux-hosts zonder DISPLAY of WAYLAND_DISPLAY draaien lokaal beheerde profielen automatisch headless, tenzij OmeniaClaw_BROWSER_HEADLESS=0, browser.headless=false of browser.profiles.<name>.headless=false expliciet om een zichtbare browser vraagt.

Als de opdracht ontbreekt

Als OmeniaClaw browser een onbekende opdracht is, controleer dan plugins.allow in ~/.OmeniaClaw/OmeniaClaw.json.

Wanneer plugins.allow aanwezig is, vermeld dan de meegeleverde browser-Plugin expliciet, tenzij de configuratie al een hoofdblok browser heeft:

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

Een expliciet hoofdblok browser, bijvoorbeeld browser.enabled=true of browser.profiles.<name>, activeert ook de meegeleverde browser-Plugin onder een beperkende allowlist voor plugins.

Gerelateerd: Browsertool

Profielen

Profielen zijn benoemde browserrouteringsconfiguraties. In de praktijk:

• OmeniaClaw: start of koppelt aan een dedicated door OmeniaClaw beheerde Chrome-instantie (geïsoleerde gebruikersgegevensmap).
• user: bestuurt je bestaande aangemelde Chrome-sessie via Chrome DevTools MCP.
• aangepaste CDP-profielen: wijzen naar een lokaal of extern CDP-eindpunt.

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

Gebruik een specifiek profiel:

OmeniaClaw browser --browser-profile work tabs

Tabbladen

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 retourneert eerst suggestedTargetId, daarna de stabiele tabId zoals t1, het optionele label en de ruwe targetId. Agents moeten suggestedTargetId teruggeven aan focus, close, snapshots en acties. Je kunt een label toewijzen met open --label, tab new --label of tab label; labels, tabblad-id's, ruwe target-id's en unieke target-id-voorvoegsels worden allemaal geaccepteerd. Wanneer Chromium het onderliggende ruwe target tijdens navigatie of het verzenden van een formulier vervangt, houdt OmeniaClaw de stabiele tabId/het label gekoppeld aan het vervangende tabblad wanneer het de overeenkomst kan bewijzen. Ruwe target-id's blijven vluchtig; gebruik bij voorkeur suggestedTargetId.

Snapshot / screenshot / acties

Snapshot:

OmeniaClaw browser snapshotOmeniaClaw browser snapshot --urls

Screenshot:

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

Opmerkingen:

• --full-page is alleen voor pagina-opnamen; het kan niet worden gecombineerd met --ref of --element.
• existing-session- / user-profielen ondersteunen paginascreenshots en --ref-screenshots uit snapshot-uitvoer, maar geen CSS---element-screenshots.
• --labels legt huidige snapshotrefs over de screenshot heen.
• snapshot --urls voegt gevonden linkbestemmingen toe aan AI-snapshots, zodat agents directe navigatiedoelen kunnen kiezen in plaats van alleen op basis van linktekst te gokken.

Navigeren/klikken/typen (op refs gebaseerde UI-automatisering):

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>

Actieresponsen retourneren de huidige ruwe targetId na door een actie getriggerde paginavervanging wanneer OmeniaClaw het vervangende tabblad kan bewijzen. Scripts moeten nog steeds suggestedTargetId/labels opslaan en doorgeven voor langlopende workflows.

Bestands- en dialooghulpen:

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

Beheerde Chrome-profielen slaan gewone door klikken getriggerde downloads op in de OmeniaClaw-downloadmap (/tmp/OmeniaClaw/downloads standaard, of de geconfigureerde tijdelijke root). Gebruik waitfordownload of download wanneer de agent op een specifiek bestand moet wachten en het pad moet teruggeven; die expliciete wachters bezitten de volgende download.

Status en opslag

Viewport + emulatie:

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 + opslag:

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

Foutopsporing

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

Bestaande Chrome via MCP

Gebruik het ingebouwde user-profiel, of maak je eigen existing-session-profiel:

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

Dit pad is alleen voor de host. Gebruik in plaats daarvan een CDP-profiel voor Docker, headless servers, Browserless of andere externe opstellingen.

Huidige beperkingen van existing-session:

• door snapshots gestuurde acties gebruiken refs, geen CSS-selectors
• browser.actionTimeoutMs zet ondersteunde act-verzoeken standaard op 60000 ms wanneer aanroepers timeoutMs weglaten; timeoutMs per aanroep heeft nog steeds voorrang.
• click is alleen linksklikken
• type ondersteunt slowly=true niet
• press ondersteunt delayMs niet
• hover, scrollintoview, drag, select, fill en evaluate weigeren time-outoverschrijvingen per aanroep
• select ondersteunt slechts één waarde
• wait --load networkidle wordt niet ondersteund
• bestandsuploads vereisen --ref / --input-ref, ondersteunen geen CSS---element en ondersteunen momenteel één bestand tegelijk
• dialooghaken ondersteunen --timeout niet
• screenshots ondersteunen pagina-opnamen en --ref, maar geen CSS---element
• responsebody, downloadonderschepping, PDF-export en batchacties vereisen nog steeds een beheerde browser of een ruw CDP-profiel

Externe browserbesturing (node-hostproxy)

Als de Gateway op een andere machine draait dan de browser, voer dan een node-host uit op de machine met Chrome/Brave/Edge/Chromium. De Gateway proxyt browseracties naar die node (geen afzonderlijke browserbesturingsserver vereist).

Gebruik gateway.nodes.browser.mode om automatische routering te beheren en gateway.nodes.browser.node om een specifieke node vast te zetten als er meerdere zijn verbonden.

Beveiliging + externe installatie: Browsertool, Externe toegang, Tailscale, Beveiliging

Gerelateerd

• CLI-referentie
• Browser