OmeniaClaw browser

Kelola permukaan kontrol peramban OmeniaClaw dan jalankan aksi peramban (siklus hidup, profil, tab, snapshot, tangkapan layar, navigasi, input, emulasi status, dan debugging).

Terkait:

• Alat peramban + API: Alat peramban

Flag umum

• --url <gatewayWsUrl>: URL WebSocket Gateway (default dari konfigurasi).
• --token <token>: token Gateway (jika diperlukan).
• --timeout <ms>: batas waktu permintaan (ms).
• --expect-final: tunggu respons final Gateway.
• --browser-profile <name>: pilih profil peramban (default dari konfigurasi).
• --json: output yang dapat dibaca mesin (jika didukung).

Mulai cepat (lokal)

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

Agent dapat menjalankan pemeriksaan kesiapan yang sama dengan browser({ action: "doctor" }).

Pemecahan masalah cepat

Jika start gagal dengan not reachable after start, pecahkan masalah kesiapan CDP terlebih dahulu. Jika start dan tabs berhasil tetapi open atau navigate gagal, control plane peramban sehat dan kegagalan biasanya berasal dari kebijakan SSRF navigasi.

Urutan minimal:

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

Panduan terperinci: Pemecahan masalah peramban

Siklus hidup

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

Catatan:

• doctor --deep menambahkan probe snapshot langsung. Ini berguna saat kesiapan CDP dasar sudah hijau tetapi Anda ingin bukti bahwa tab saat ini dapat diperiksa.
• Untuk profil attachOnly dan CDP jarak jauh, OmeniaClaw browser stop menutup sesi kontrol aktif dan menghapus override emulasi sementara meskipun OmeniaClaw tidak meluncurkan proses peramban itu sendiri.
• Untuk profil lokal terkelola, OmeniaClaw browser stop menghentikan proses peramban yang dibuat.
• OmeniaClaw browser start --headless hanya berlaku untuk permintaan start tersebut dan hanya saat OmeniaClaw meluncurkan peramban lokal terkelola. Ini tidak menulis ulang browser.headless atau konfigurasi profil, dan tidak berdampak untuk peramban yang sudah berjalan.
• Pada host Linux tanpa DISPLAY atau WAYLAND_DISPLAY, profil lokal terkelola berjalan headless secara otomatis kecuali OmeniaClaw_BROWSER_HEADLESS=0, browser.headless=false, atau browser.profiles.<name>.headless=false secara eksplisit meminta peramban yang terlihat.

Jika perintah tidak ada

Jika OmeniaClaw browser adalah perintah yang tidak dikenal, periksa plugins.allow di ~/.OmeniaClaw/OmeniaClaw.json.

Saat plugins.allow ada, cantumkan Plugin peramban bawaan secara eksplisit kecuali konfigurasi sudah memiliki blok akar browser:

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

Blok akar browser eksplisit, misalnya browser.enabled=true atau browser.profiles.<name>, juga mengaktifkan Plugin peramban bawaan di bawah allowlist Plugin yang restriktif.

Terkait: Alat peramban

Profil

Profil adalah konfigurasi perutean peramban bernama. Dalam praktiknya:

• OmeniaClaw: meluncurkan atau melampirkan ke instance Chrome khusus yang dikelola OmeniaClaw (direktori data pengguna terisolasi).
• user: mengontrol sesi Chrome Anda yang sudah masuk melalui Chrome DevTools MCP.
• profil CDP khusus: mengarah ke endpoint CDP lokal atau jarak jauh.

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

Gunakan profil tertentu:

OmeniaClaw browser --browser-profile work tabs

Tab

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 mengembalikan suggestedTargetId terlebih dahulu, lalu tabId stabil seperti t1, label opsional, dan targetId mentah. Agent harus meneruskan suggestedTargetId kembali ke focus, close, snapshot, dan aksi. Anda dapat menetapkan label dengan open --label, tab new --label, atau tab label; label, id tab, id target mentah, dan prefiks id target unik semuanya diterima. Saat Chromium mengganti target mentah yang mendasari selama navigasi atau pengiriman formulir, OmeniaClaw mempertahankan tabId/label stabil yang terpasang pada tab pengganti saat dapat membuktikan kecocokannya. Id target mentah tetap volatil; utamakan suggestedTargetId.

Snapshot / tangkapan layar / aksi

Snapshot:

OmeniaClaw browser snapshotOmeniaClaw browser snapshot --urls

Tangkapan layar:

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

Catatan:

• --full-page hanya untuk tangkapan halaman; tidak dapat digabungkan dengan --ref atau --element.
• Profil existing-session / user mendukung tangkapan layar halaman dan tangkapan layar --ref dari output snapshot, tetapi tidak mendukung tangkapan layar CSS --element.
• --labels menimpa ref snapshot saat ini pada tangkapan layar.
• snapshot --urls menambahkan tujuan tautan yang ditemukan ke snapshot AI sehingga agent dapat memilih target navigasi langsung tanpa menebak hanya dari teks tautan.

Navigasi/klik/ketik (otomasi UI berbasis 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>

Respons aksi mengembalikan targetId mentah saat ini setelah penggantian halaman yang dipicu aksi ketika OmeniaClaw dapat membuktikan tab pengganti. Skrip tetap harus menyimpan dan meneruskan suggestedTargetId/label untuk alur kerja jangka panjang.

Pembantu file + dialog:

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

Profil Chrome terkelola menyimpan unduhan biasa yang dipicu klik ke direktori unduhan OmeniaClaw (/tmp/OmeniaClaw/downloads secara default, atau root sementara yang dikonfigurasi). Gunakan waitfordownload atau download saat agent perlu menunggu file tertentu dan mengembalikan jalurnya; penunggu eksplisit tersebut memiliki unduhan berikutnya.

Status dan penyimpanan

Viewport + emulasi:

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

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

Debugging

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 yang ada melalui MCP

Gunakan profil user bawaan, atau buat profil existing-session Anda sendiri:

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

Jalur ini hanya untuk host. Untuk Docker, server headless, Browserless, atau penyiapan jarak jauh lainnya, gunakan profil CDP sebagai gantinya.

Batasan existing-session saat ini:

• aksi berbasis snapshot menggunakan ref, bukan selector CSS
• browser.actionTimeoutMs menetapkan default permintaan act yang didukung ke 60000 ms saat pemanggil menghilangkan timeoutMs; timeoutMs per panggilan tetap menang.
• click hanya klik kiri
• type tidak mendukung slowly=true
• press tidak mendukung delayMs
• hover, scrollintoview, drag, select, fill, dan evaluate menolak override batas waktu per panggilan
• select hanya mendukung satu nilai
• wait --load networkidle tidak didukung
• unggahan file memerlukan --ref / --input-ref, tidak mendukung CSS --element, dan saat ini mendukung satu file pada satu waktu
• hook dialog tidak mendukung --timeout
• tangkapan layar mendukung tangkapan halaman dan --ref, tetapi tidak mendukung CSS --element
• responsebody, intersepsi unduhan, ekspor PDF, dan aksi batch tetap memerlukan peramban terkelola atau profil CDP mentah

Kontrol peramban jarak jauh (proksi host node)

Jika Gateway berjalan pada mesin yang berbeda dari peramban, jalankan host node pada mesin yang memiliki Chrome/Brave/Edge/Chromium. Gateway akan memproksikan aksi peramban ke node tersebut (tidak perlu server kontrol peramban terpisah).

Gunakan gateway.nodes.browser.mode untuk mengontrol perutean otomatis dan gateway.nodes.browser.node untuk menetapkan node tertentu jika beberapa node terhubung.

Keamanan + penyiapan jarak jauh: Alat peramban, Akses jarak jauh, Tailscale, Keamanan

Terkait

• Referensi CLI
• Peramban