OmeniaClaw browser

OmeniaClaw'ın tarayıcı kontrol yüzeyini yönetin ve tarayıcı eylemlerini çalıştırın (yaşam döngüsü, profiller, sekmeler, anlık görüntüler, ekran görüntüleri, gezinme, giriş, durum emülasyonu ve hata ayıklama).

İlgili:

• Tarayıcı aracı + API: Tarayıcı aracı

Yaygın bayraklar

• --url <gatewayWsUrl>: Gateway WebSocket URL'si (varsayılan olarak yapılandırmadan alınır).
• --token <token>: Gateway belirteci (gerekliyse).
• --timeout <ms>: istek zaman aşımı (ms).
• --expect-final: nihai bir Gateway yanıtını bekle.
• --browser-profile <name>: bir tarayıcı profili seç (varsayılan yapılandırmadan alınır).
• --json: makine tarafından okunabilir çıktı (desteklendiği yerlerde).

Hızlı başlangıç (yerel)

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

Ajanlar aynı hazır olma denetimini browser({ action: "doctor" }) ile çalıştırabilir.

Hızlı sorun giderme

start, not reachable after start ile başarısız olursa önce CDP hazır olma durumunu giderin. start ve tabs başarılı oluyor ancak open veya navigate başarısız oluyorsa, tarayıcı kontrol düzlemi sağlıklıdır ve hata genellikle gezinme SSRF ilkesinden kaynaklanır.

En küçük sıra:

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

Ayrıntılı kılavuz: Tarayıcı sorun giderme

Yaşam döngüsü

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

Notlar:

• doctor --deep canlı bir anlık görüntü yoklaması ekler. Temel CDP hazır olma durumu yeşilken ancak geçerli sekmenin incelenebildiğine dair kanıt istediğinizde kullanışlıdır.
• attachOnly ve uzak CDP profilleri için OmeniaClaw browser stop, OmeniaClaw tarayıcı sürecini kendisi başlatmamış olsa bile etkin kontrol oturumunu kapatır ve geçici emülasyon geçersiz kılmalarını temizler.
• Yerel yönetilen profiller için OmeniaClaw browser stop, oluşturulan tarayıcı sürecini durdurur.
• OmeniaClaw browser start --headless yalnızca o başlatma isteğine ve yalnızca OmeniaClaw yerel yönetilen bir tarayıcı başlattığında uygulanır. browser.headless ya da profil yapılandırmasını yeniden yazmaz ve zaten çalışan bir tarayıcı için etkisizdir.
• DISPLAY veya WAYLAND_DISPLAY olmayan Linux ana makinelerinde, yerel yönetilen profiller OmeniaClaw_BROWSER_HEADLESS=0, browser.headless=false veya browser.profiles.<name>.headless=false görünür bir tarayıcıyı açıkça istemediği sürece otomatik olarak başsız çalışır.

Komut eksikse

OmeniaClaw browser bilinmeyen bir komutsa, ~/.OmeniaClaw/OmeniaClaw.json içindeki plugins.allow ayarını kontrol edin.

plugins.allow mevcut olduğunda, yapılandırmada zaten kök düzeyinde bir browser bloğu yoksa paketlenmiş tarayıcı Plugin'ini açıkça listeleyin:

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

Örneğin browser.enabled=true veya browser.profiles.<name> gibi açık bir kök browser bloğu da kısıtlayıcı bir Plugin izin listesi altında paketlenmiş tarayıcı Plugin'ini etkinleştirir.

İlgili: Tarayıcı aracı

Profiller

Profiller adlandırılmış tarayıcı yönlendirme yapılandırmalarıdır. Pratikte:

• OmeniaClaw: özel bir OmeniaClaw tarafından yönetilen Chrome örneği başlatır veya ona bağlanır (yalıtılmış kullanıcı veri dizini).
• user: Chrome DevTools MCP aracılığıyla mevcut oturum açılmış Chrome oturumunuzu kontrol eder.
• özel CDP profilleri: yerel veya uzak bir CDP uç noktasını gösterir.

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

Belirli bir profil kullanın:

OmeniaClaw browser --browser-profile work tabs

Sekmeler

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 önce suggestedTargetId değerini, ardından t1 gibi kararlı tabId değerini, isteğe bağlı etiketi ve ham targetId değerini döndürür. Ajanlar suggestedTargetId değerini focus, close, anlık görüntüler ve eylemlere geri iletmelidir. open --label, tab new --label veya tab label ile bir etiket atayabilirsiniz; etiketler, sekme kimlikleri, ham hedef kimlikleri ve benzersiz hedef kimliği öneklerinin tümü kabul edilir. Chromium, gezinme veya form gönderimi sırasında alttaki ham hedefi değiştirdiğinde, OmeniaClaw eşleşmeyi kanıtlayabildiğinde kararlı tabId/etiket değerini yedek sekmeye bağlı tutar. Ham hedef kimlikleri değişkendir; suggestedTargetId tercih edin.

Anlık görüntü / ekran görüntüsü / eylemler

Anlık görüntü:

OmeniaClaw browser snapshotOmeniaClaw browser snapshot --urls

Ekran görüntüsü:

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

Notlar:

• --full-page yalnızca sayfa yakalamaları içindir; --ref veya --element ile birleştirilemez.
• existing-session / user profilleri sayfa ekran görüntülerini ve anlık görüntü çıktısından --ref ekran görüntülerini destekler, ancak CSS --element ekran görüntülerini desteklemez.
• --labels, geçerli anlık görüntü başvurularını ekran görüntüsünün üzerine yerleştirir.
• snapshot --urls, keşfedilen bağlantı hedeflerini AI anlık görüntülerine ekler; böylece ajanlar yalnızca bağlantı metninden tahmin etmek yerine doğrudan gezinme hedefleri seçebilir.

Gezinme/tıklama/yazma (başvuru tabanlı UI otomasyonu):

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>

Eylem yanıtları, OmeniaClaw yedek sekmeyi kanıtlayabildiğinde eylemle tetiklenen sayfa değişiminden sonra geçerli ham targetId değerini döndürür. Betikler yine de uzun ömürlü iş akışları için suggestedTargetId/etiket değerlerini saklayıp iletmelidir.

Dosya + iletişim kutusu yardımcıları:

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

Yönetilen Chrome profilleri, sıradan tıklamayla tetiklenen indirmeleri OmeniaClaw indirmeler dizinine kaydeder (varsayılan olarak /tmp/OmeniaClaw/downloads veya yapılandırılmış geçici kök). Ajanın belirli bir dosyayı bekleyip yolunu döndürmesi gerektiğinde waitfordownload veya download kullanın; bu açık bekleyiciler bir sonraki indirmeyi sahiplenir.

Durum ve depolama

Görüntü alanı + emülasyon:

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

Çerezler + depolama:

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

Hata ayıklama

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

MCP üzerinden mevcut Chrome

Yerleşik user profilini kullanın veya kendi existing-session profilinizi oluşturun:

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

Bu yol yalnızca ana makine içindir. Docker, başsız sunucular, Browserless veya diğer uzak kurulumlar için bunun yerine bir CDP profili kullanın.

Geçerli existing-session sınırları:

• anlık görüntü odaklı eylemler CSS seçicileri değil, başvurular kullanır
• çağıranlar timeoutMs atladığında browser.actionTimeoutMs, desteklenen act istekleri için varsayılan olarak 60000 ms kullanır; çağrı başına timeoutMs yine önceliklidir.
• click yalnızca sol tıklamadır
• type, slowly=true desteklemez
• press, delayMs desteklemez
• hover, scrollintoview, drag, select, fill ve evaluate çağrı başına zaman aşımı geçersiz kılmalarını reddeder
• select yalnızca bir değeri destekler
• wait --load networkidle desteklenmez
• dosya yüklemeleri --ref / --input-ref gerektirir, CSS --element desteklemez ve şu anda aynı anda bir dosyayı destekler
• iletişim kutusu kancaları --timeout desteklemez
• ekran görüntüleri sayfa yakalamalarını ve --ref değerini destekler, ancak CSS --element desteklemez
• responsebody, indirme yakalama, PDF dışa aktarma ve toplu eylemler hâlâ yönetilen bir tarayıcı veya ham CDP profili gerektirir

Uzak tarayıcı kontrolü (node ana makine vekili)

Gateway tarayıcıdan farklı bir makinede çalışıyorsa, Chrome/Brave/Edge/Chromium bulunan makinede bir node ana makinesi çalıştırın. Gateway, tarayıcı eylemlerini o node'a vekil olarak iletir (ayrı bir tarayıcı kontrol sunucusu gerekmez).

Otomatik yönlendirmeyi kontrol etmek için gateway.nodes.browser.mode, birden fazla node bağlıysa belirli bir node'u sabitlemek için gateway.nodes.browser.node kullanın.

Güvenlik + uzak kurulum: Tarayıcı aracı, Uzak erişim, Tailscale, Güvenlik

İlgili

• CLI başvurusu
• Tarayıcı