Tarayıcı denetim API'si

Kurulum, yapılandırma ve sorun giderme için Tarayıcı bölümüne bakın. Bu sayfa, yerel denetim HTTP API'si, openclaw browser CLI ve betik oluşturma kalıpları (anlık görüntüler, referanslar, beklemeler, hata ayıklama akışları) için başvuru kaynağıdır.

Denetim API'si (isteğe bağlı)

Gateway, yalnızca yerel entegrasyonlar için küçük bir geri döngü HTTP API'si sunar. Bu bağımsız sunucu isteğe bağlıdır — gateway hizmeti ortamında OPENCLAW_EAGER_BROWSER_CONTROL_SERVER=1 ortam değişkenini ayarlayın ve HTTP uç noktalarının kullanılabilir hâle gelmesi için gateway'i yeniden başlatın. Bu değişken olmadan tarayıcı denetim çalışma zamanı CLI ve ajan araçları üzerinden çalışmaya devam eder, ancak geri döngü denetim bağlantı noktasında hiçbir şey dinlemez.

• Durum/başlatma/durdurma: GET /, GET /doctor, POST /start, POST /stop, POST /reset-profile
• Profiller: GET /profiles, POST /profiles/create, DELETE /profiles/:name
• Sekmeler: GET /tabs, POST /tabs/open, POST /tabs/focus, DELETE /tabs/:targetId, POST /tabs/action
• Anlık görüntü/ekran görüntüsü: GET /snapshot, POST /screenshot
• Eylemler: POST /navigate, POST /act
• Kancalar: POST /hooks/file-chooser, POST /hooks/dialog
• İndirmeler: POST /download, POST /wait/download
• İzinler: POST /permissions/grant
• Hata ayıklama: GET /console, POST /pdf
• Hata ayıklama: GET /errors, GET /requests, GET /dialogs, POST /trace/start, POST /trace/stop, POST /highlight
• Ağ: POST /response/body
• Durum: GET /cookies, POST /cookies/set, POST /cookies/clear
• Durum: GET /storage/:kind, POST /storage/:kind/set, POST /storage/:kind/clear
• Ayarlar: POST /set/offline, POST /set/headers, POST /set/credentials, POST /set/geolocation, POST /set/media, POST /set/timezone, POST /set/locale, POST /set/device

POST /tabs/action, CLI'ın browser tab alt komutları ({"action":"new"|"label"|"select"|"close"|"list", ...}) için dâhilî olarak kullandığı toplu biçimdir; doğrudan betik yazarken yukarıdaki tek amaçlı sekme rotalarını tercih edin.

Tüm uç noktalar ?profile=<name> kabul eder. POST /start?headless=true, kalıcı tarayıcı yapılandırmasını değiştirmeden yerel yönetilen profiller için tek seferlik başsız başlatma talep eder; yalnızca bağlanma, uzak CDP ve mevcut oturum profilleri bu geçersiz kılmayı reddeder çünkü OpenClaw bu tarayıcı süreçlerini başlatmaz.

Sekme uç noktalarında targetId, uyumluluk alanı adıdır. GET /tabs veya POST /tabs/open içinden suggestedTargetId iletmeyi tercih edin; etiketler ve t1 gibi tabId tanıtıcıları da kabul edilir. Ham CDP hedef kimlikleri ve benzersiz ham hedef kimliği önekleri çalışmaya devam eder, ancak bunlar değişken tanılama tanıtıcılarıdır.

Paylaşılan gizli anahtarlı gateway kimlik doğrulaması yapılandırılmışsa tarayıcı HTTP rotaları da kimlik doğrulaması gerektirir:

• Authorization: Bearer <gateway token>
• x-openclaw-password: <gateway password> veya bu parola ile HTTP Basic kimlik doğrulaması

Notlar:

• Bu bağımsız geri döngü tarayıcı API'si, güvenilir proxy veya Tailscale Serve kimlik üst bilgilerini kullanmaz.
• gateway.auth.mode, none veya trusted-proxy ise bu geri döngü tarayıcı rotaları, kimlik taşıyan bu modları devralmaz; bunları yalnızca geri döngüde tutun.

/act hata sözleşmesi

POST /act, rota düzeyindeki doğrulama ve politika hataları için yapılandırılmış bir hata yanıtı kullanır:

{ "error": "<message>", "code": "ACT_*" }

Geçerli code değerleri:

• ACT_KIND_REQUIRED (HTTP 400): kind eksik veya tanınmıyor.
• ACT_INVALID_REQUEST (HTTP 400): eylem yükü normalleştirme veya doğrulamadan geçemedi.
• ACT_SELECTOR_UNSUPPORTED (HTTP 400): selector desteklenmeyen bir eylem türüyle kullanıldı.
• ACT_EVALUATE_DISABLED (HTTP 403): evaluate (veya wait --fn) yapılandırma tarafından devre dışı bırakıldı.
• ACT_TARGET_ID_MISMATCH (HTTP 403): üst düzey veya toplu targetId, istek hedefiyle çakışıyor.
• ACT_EXISTING_SESSION_UNSUPPORTED (HTTP 501): eylem, mevcut oturum profilleri için desteklenmiyor.

Diğer çalışma zamanı hataları, code alanı olmadan da { "error": "<message>" } döndürebilir.

Playwright gereksinimi

Bazı özellikler (gezinme/eylem/AI anlık görüntüsü/rol anlık görüntüsü, öğe ekran görüntüleri, PDF) Playwright gerektirir. Playwright yüklü değilse bu uç noktalar açık bir 501 hatası döndürür.

Playwright olmadan çalışmaya devam edenler:

• ARIA anlık görüntüleri
• Sekme başına CDP WebSocket kullanılabilir olduğunda rol tarzı erişilebilirlik anlık görüntüleri (--interactive, --compact, --depth, --efficient). Bu, inceleme ve referans keşfi için bir geri dönüş seçeneğidir; Playwright birincil eylem motoru olmaya devam eder.
• Sekme başına CDP WebSocket kullanılabilir olduğunda yönetilen openclaw tarayıcısının sayfa ekran görüntüleri
• existing-session / Chrome MCP profillerinin sayfa ekran görüntüleri
• Anlık görüntü çıktısından existing-session referans tabanlı ekran görüntüleri (--ref)

Playwright gerektirmeye devam edenler:

• navigate
• act
• Playwright'ın yerel AI anlık görüntü biçimine bağlı AI anlık görüntüleri
• CSS seçicili öğe ekran görüntüleri (--element)
• tam tarayıcı PDF dışa aktarımı

Öğe ekran görüntüleri ayrıca --full-page değerini reddeder; rota fullPage is not supported for element screenshots döndürür.

Playwright is not available in this gateway build görürseniz paketlenmiş Gateway'de temel tarayıcı çalışma zamanı bağımlılığı eksiktir. OpenClaw'u yeniden yükleyin veya güncelleyin, ardından gateway'i yeniden başlatın. Docker için aşağıda gösterildiği gibi Chromium tarayıcı ikili dosyalarını da yükleyin.

Docker Playwright kurulumu

Gateway'iniz Docker'da çalışıyorsa npx playwright kullanmaktan kaçının (npm geçersiz kılma çakışmaları). Özel imajlarda Chromium'u imaja dâhil edin:

OPENCLAW_INSTALL_BROWSER=1 ./scripts/docker/setup.sh

Mevcut bir imajda ise bunun yerine paketle birlikte gelen CLI üzerinden yükleyin:

docker compose run --rm openclaw-cli \  node /app/node_modules/playwright-core/cli.js install chromium

Tarayıcı indirmelerini kalıcı hâle getirmek için PLAYWRIGHT_BROWSERS_PATH değerini (örneğin, /home/node/.cache/ms-playwright) ayarlayın ve /home/node konumunun OPENCLAW_HOME_VOLUME veya bir bağlama noktası aracılığıyla kalıcı olduğundan emin olun. OpenClaw, Linux'ta kalıcı Chromium'u otomatik olarak algılar. Docker bölümüne bakın.

Çalışma biçimi (dâhilî)

Küçük bir geri döngü denetim sunucusu HTTP isteklerini kabul eder ve CDP aracılığıyla Chromium tabanlı tarayıcılara bağlanır. Gelişmiş eylemler (tıklama/yazma/anlık görüntü/PDF), CDP üzerinde Playwright aracılığıyla gerçekleştirilir; Playwright eksik olduğunda yalnızca Playwright gerektirmeyen işlemler kullanılabilir. Yerel/uzak tarayıcılar ve profiller altta serbestçe değişirken ajan tek bir kararlı arayüz görür.

CLI hızlı başvuru

Tüm komutlar, belirli bir profili hedeflemek için --browser-profile <name> ve makine tarafından okunabilir çıktı için --json kabul eder.

openclaw browser statusopenclaw browser doctoropenclaw browser doctor --deep    # canlı bir anlık görüntü yoklaması ekleopenclaw browser startopenclaw browser start --headless # tek seferlik yerel yönetilen başsız başlatmaopenclaw browser stop            # yalnızca bağlanma/uzak CDP üzerinde öykünmeyi de temizleropenclaw browser reset-profile   # profilin tarayıcı verilerini Çöp Kutusu'na taşıropenclaw browser tabsopenclaw browser tab             # geçerli sekmenin kısayoluopenclaw browser tab newopenclaw browser tab new --label researchopenclaw browser tab label abcd1234 researchopenclaw browser tab select 2openclaw browser tab close 2openclaw browser open https://example.comopenclaw browser focus abcd1234openclaw browser close abcd1234

openclaw browser profilesopenclaw browser create-profile --name research --color "#0066CC"openclaw browser create-profile --name attach --driver existing-session --cdp-url http://127.0.0.1:9222openclaw browser delete-profile --name research

openclaw browser screenshotopenclaw browser screenshot --full-pageopenclaw browser screenshot --ref 12        # veya rol referansları için --ref e12openclaw browser screenshot --labelsopenclaw browser snapshotopenclaw browser snapshot --format aria --limit 200openclaw browser snapshot --interactive --compact --depth 6openclaw browser snapshot --efficientopenclaw browser snapshot --labelsopenclaw browser snapshot --urlsopenclaw browser snapshot --selector "#main" --interactiveopenclaw browser snapshot --frame "iframe#main" --interactiveopenclaw browser snapshot --out snapshot.txtopenclaw browser console --level erroropenclaw browser errors --clearopenclaw browser requests --filter api --clearopenclaw browser pdfopenclaw browser responsebody "**/api" --max-chars 5000

openclaw browser navigate https://example.comopenclaw browser resize 1280 720openclaw browser click 12 --double           # veya rol referansları için e12openclaw browser click-coords 120 340        # görüntü alanı koordinatlarıopenclaw browser type 23 "hello" --submitopenclaw browser press Enteropenclaw browser hover 44openclaw browser scrollintoview e12openclaw browser drag 10 11openclaw browser select 9 OptionA OptionBopenclaw browser download e12 report.pdfopenclaw browser waitfordownload report.pdfopenclaw browser upload /tmp/openclaw/uploads/file.pdfopenclaw browser upload /tmp/openclaw/uploads/file.pdf --ref e12openclaw browser upload media://inbound/file.pdfopenclaw browser fill --fields '[{"ref":"1","type":"text","value":"Ada"}]'openclaw browser dialog --acceptopenclaw browser dialog --dismiss --dialog-id d1openclaw browser wait --text "Done"openclaw browser wait "#main" --url "**/dash" --load networkidle --fn "window.ready===true"openclaw browser evaluate --fn '(el) => el.textContent' --ref 7openclaw browser evaluate --fn 'const title = document.title; return title;'openclaw browser evaluate --timeout-ms 30000 --fn 'async () => { await window.ready; return true; }'openclaw browser highlight e12openclaw browser trace startopenclaw browser trace stop

openclaw browser cookiesopenclaw browser cookies set session abc123 --url "https://example.com"openclaw browser cookies clearopenclaw browser storage local getopenclaw browser storage local set theme darkopenclaw browser storage session clearopenclaw browser set offline onopenclaw browser set headers --headers-json '{"X-Debug":"1"}'openclaw browser set credentials user pass            # kaldırmak için --clearopenclaw browser set geo 37.7749 -122.4194 --origin "https://example.com"openclaw browser set media darkopenclaw browser set timezone America/New_Yorkopenclaw browser set locale en-USopenclaw browser set device "iPhone 14"

Notlar:

• Aracıya yönelik browser aracı, action=download (gerekli ref ve path) ile action=waitfordownload (isteğe bağlı path) işlevlerini sunar. Her ikisi de kaydedilen indirme URL'sini, önerilen dosya adını ve korumalı yerel yolu döndürür. Yönetilen Playwright profilleri için açık indirme yakalama kullanılabilir; mevcut oturum profilleri desteklenmeyen işlem hatası döndürür.
• Atomik seçici yüklemelerini tercih edin: OpenClaw'ın tek bir istekte hazırlanıp tıklaması için yüklemeyle birlikte tetikleyici --ref değerini iletin. Daha sonraki bir tetikleyici kasıtlıysa yalnızca yolları içeren upload desteklenmeye devam eder. Bir dosya girişini doğrudan ayarlamak için --input-ref veya --element kullanın. dialog bir hazırlama çağrısıdır; iletişim kutusunu tetikleyen tıklama/tuşa basma işleminden önce çalıştırın. Bir eylem kalıcı iletişim kutusu açarsa eylem yanıtı blockedByDialog ve browserState.dialogs.pending içerir; doğrudan yanıt vermek için bu dialogId değerini iletin. OpenClaw dışında işlenen iletişim kutuları browserState.dialogs.recent altında görünür.
• click/type/vb., snapshot kaynağından bir ref gerektirir (sayısal 12, rol başvurusu e12 veya eyleme dönüştürülebilir ARIA başvurusu ax12). CSS seçicileri eylemler için kasıtlı olarak desteklenmez. Görünür görüntü alanı konumu tek güvenilir hedef olduğunda click-coords kullanın.
• İndirme ve iz yolları OpenClaw geçici kökleriyle sınırlandırılmıştır: /tmp/openclaw{,/downloads} (geri dönüş: ${os.tmpdir()}/openclaw/...).
• upload, OpenClaw geçici yüklemeler kökünden ve OpenClaw tarafından yönetilen gelen medyadan dosya kabul eder. Yönetilen gelen medyaya media://inbound/<id>, korumalı alanla göreli media/inbound/<id> veya yönetilen gelen medya dizini içinde çözümlenmiş bir yol olarak başvurulabilir. İç içe medya başvuruları, dizin geçişi, sembolik bağlantılar, sabit bağlantılar ve rastgele yerel yollar yine reddedilir.
• upload, dosya girişlerini --input-ref veya --element aracılığıyla doğrudan da ayarlayabilir.

OpenClaw aynı URL için benzersiz bir eski/yeni çift veya form gönderiminden sonra tek bir eski sekmenin tek bir yeni sekmeye dönüşmesi gibi durumlarda değiştirme sekmesini kanıtlayabildiğinde, kararlı sekme kimlikleri ve etiketleri Chromium ham hedef değişiminden etkilenmez. Aynı URL'yi taşıyan belirsiz değişimler yeni tanıtıcılar alır. Ham hedef kimlikleri yine geçicidir; betiklerde tabs kaynağındaki suggestedTargetId değerini tercih edin.

Anlık görüntü bayraklarına genel bakış:

• --format ai (Playwright ile varsayılan): sayısal başvurular içeren yapay zekâ anlık görüntüsü (aria-ref="<n>").
• --format aria: axN başvurularını içeren erişilebilirlik ağacı. Playwright kullanılabildiğinde OpenClaw, izleyen eylemlerin bunları kullanabilmesi için arka uç DOM kimliklerine sahip başvuruları canlı sayfaya bağlar; aksi durumda çıktıyı yalnızca inceleme amaçlı kabul edin.
• --efficient (veya --mode efficient): kompakt rol anlık görüntüsü ön ayarı. Bunu varsayılan yapmak için browser.snapshotDefaults.mode: "efficient" değerini ayarlayın (bkz. Gateway yapılandırması).
• --interactive, --compact, --depth, --selector, ref=e12 başvurularına sahip bir rol anlık görüntüsünü zorunlu kılar. --frame "<iframe>", rol anlık görüntülerini bir iframe ile sınırlar.
• Playwright ile --labels, üstüne başvuru etiketleri bindirilmiş bir ekran görüntüsü (MEDIA:<path> yazdırır) ve her başvurunun sınırlayıcı kutusunu içeren bir annotations dizisi ekler. screenshot üzerinde Playwright destekli etiketler --full-page, --ref ve --element ile çalışır; snapshot üzerinde eşlik eden ekran görüntüsü yalnızca görüntü alanını kapsar. Mevcut oturum/chrome-mcp profilleri, sayfa ekran görüntülerinde üst katman etiketlerini işler ancak annotations döndürmez veya Playwright'ın tam sayfa/başvuru/öğe izdüşüm yardımcısını kullanmaz. Playwright veya chrome-mcp olmadan etiketli ekran görüntüleri kullanılamaz.
• --urls, keşfedilen bağlantı hedeflerini yapay zekâ anlık görüntülerine ekler.

Anlık görüntüler ve başvurular

OpenClaw iki "anlık görüntü" biçimini destekler:

• Yapay zekâ anlık görüntüsü (sayısal başvurular): openclaw browser snapshot (varsayılan; --format ai)

  • Çıktı: sayısal başvurular içeren bir metin anlık görüntüsü.
  • Eylemler: openclaw browser click 12, openclaw browser type 23 "hello".
  • Başvuru, dahili olarak Playwright'ın aria-ref işlevi aracılığıyla çözümlenir.

• Rol anlık görüntüsü (e12 gibi rol başvuruları): openclaw browser snapshot --interactive (veya --compact, --depth, --selector, --frame)

  • Çıktı: [ref=e12] (ve isteğe bağlı [nth=1]) içeren rol tabanlı bir liste/ağaç.
  • Eylemler: openclaw browser click e12, openclaw browser highlight e12.
  • Başvuru, dahili olarak getByRole(...) aracılığıyla (yinelenenler için ayrıca nth()) çözümlenir.
  • Üstüne e12 etiketleri bindirilmiş bir ekran görüntüsü eklemek için --labels ekleyin. Playwright destekli profillerde bu işlem ayrıca başvuru başına sınırlayıcı kutu meta verilerini (annotations[]) döndürür.
  • Bağlantı metni belirsiz olduğunda ve aracı somut gezinme hedeflerine ihtiyaç duyduğunda --urls ekleyin.

• ARIA anlık görüntüsü (ax12 gibi ARIA başvuruları): openclaw browser snapshot --format aria

  • Çıktı: yapılandırılmış düğümler hâlinde erişilebilirlik ağacı.
  • Eylemler: anlık görüntü yolu, başvuruyu Playwright ve Chrome arka uç DOM kimlikleri üzerinden bağlayabildiğinde openclaw browser click ax12 çalışır.

• Playwright kullanılamıyorsa ARIA anlık görüntüleri inceleme için yine yararlı olabilir ancak başvurular eyleme dönüştürülemeyebilir. Eylem başvurularına ihtiyaç duyduğunuzda --format ai veya --interactive ile yeniden anlık görüntü alın.

• Ham CDP geri dönüş yolu için Docker kanıtı: pnpm test:docker:browser-cdp-snapshot, Chromium'u CDP ile başlatır, browser doctor --deep komutunu çalıştırır ve rol anlık görüntülerinin bağlantı URL'lerini, imleçle eyleme dönüştürülebilir hâle getirilen öğeleri ve iframe meta verilerini içerdiğini doğrular.

Başvuru davranışı:

• Başvurular gezinmeler arasında kararlı değildir; bir işlem başarısız olursa snapshot komutunu yeniden çalıştırın ve yeni bir başvuru kullanın.
• /act, değiştirme sekmesini kanıtlayabildiğinde eylemle tetiklenen değişimden sonra geçerli ham targetId değerini döndürür. İzleyen komutlar için kararlı sekme kimliklerini/etiketlerini kullanmaya devam edin.
• Rol anlık görüntüsü --frame ile alındıysa rol başvuruları bir sonraki rol anlık görüntüsüne kadar bu iframe ile sınırlıdır.
• Bilinmeyen veya eski axN başvuruları, Playwright'ın aria-ref seçicisine geçmek yerine hemen başarısız olur. Bu gerçekleştiğinde aynı sekmede yeni bir anlık görüntü alın.

Tarayıcı toplu işlem CLI'si

openclaw browser batch, tek bir /act çağrısında iç içe /act eylemlerinden oluşan bir dizi çalıştırır (aracı üzerinden erişilen aynı kind="batch" çalışma zamanı); böylece CLI kullanıcıları ve betikler wait, click, type ve evaluate gibi eylemleri, eylem başına gidiş dönüş olmadan yeniden yürütülebilir tek bir planda birleştirebilir. actions[] içindeki her girdi bir BrowserActRequest öğesidir; bu, /act yolunun kabul ettiği kapalı birleşimdir (click, clickCoords, type, press, hover, scrollIntoView, drag, select, fill, resize, wait, evaluate, close, batch); rastgele openclaw browser alt komutları değildir. batch, profile="user" ve diğer mevcut oturum (chrome-mcp) profillerinde desteklenmez; eylemleri bu profillere ayrı ayrı gönderin.

• CLI: JSON dizisini standart girdiden okumak için openclaw browser batch --actions '<json>', openclaw browser batch --actions-file plan.json veya openclaw browser batch --actions-file -. --continue, stopOnError=false değerini ayarlar; varsayılan davranış ilk hatada durmaktır. --target-id, toplu işlemin tamamını tek bir sekmeyle sınırlar.
• Başvuru yaşam döngüsü: başvurular, toplu işlemden önceki bir snapshot çalıştırmasından gelir (anlık görüntü iç içe bir eylem değildir). Gezinmeyi tetikleyen bir click veya DOM'u değiştiren bir evaluate gibi sayfa durumunu değiştiren iç içe bir eylem, toplu işlemin geri kalanı için önceki başvuruları geçersiz kılabilir. Durum değiştiren eylemleri önce yerleştirin veya yeniden anlık görüntü aldıktan sonra izleyen bir toplu işleme bölün. Gezinme ve yeniden anlık görüntü alma işlemleri toplu işlemin dışında gerçekleşir (openclaw browser navigate / snapshot); çünkü open, navigate ve snapshot, /act türleri değildir.
• Hedef kimliği çakışmaları: iç içe bir eylem targetId değerini atlayabilir veya istek düzeyindeki targetId değerini yineleyebilir; farklı bir sekmeye çözümlenen açık bir iç içe targetId, herhangi bir eylem çalışmadan önce ACT_TARGET_ID_MISMATCH ile reddedilir. Toplu eylemler tasarım gereği isteğin sekmesini paylaşır.
• Hata özeti: yanıt, sırasıyla her eylem için bir girdi içeren { "results": [{ "ok": true }, { "ok": false, "error": "<message>" }, ...] } değeridir. stopOnError varsayılan olduğunda dizi ilk hatada sona erer; --continue ile her eylemi kapsar. Başarısız olan herhangi bir girdi CLI'nin sıfır olmayan kodla çıkmasına neden olur; betikler için tam ve sıralı yanıtı korumak üzere --json iletin.

Gelişmiş bekleme seçenekleri

Yalnızca süreyi/metni değil, daha fazlasını bekleyebilirsiniz:

• URL'yi bekleme (Playwright tarafından glob kalıpları desteklenir):
  • openclaw browser wait --url "**/dash"
• Yükleme durumunu bekleme:
  • openclaw browser wait --load networkidle
  • Yönetilen openclaw ve ham/uzak CDP profillerinde desteklenir. existing-session sürücüsünü kullanan profiller (varsayılan user profili dâhil) networkidle değerini reddeder; bunlarda --url, --text, bir seçici veya --fn beklemelerini kullanın.
• Bir JS koşulunu bekleme:
  • openclaw browser wait --fn "window.ready===true"
• Bir seçicinin görünür hâle gelmesini bekleme:
  • openclaw browser wait "#main"

Bunlar birleştirilebilir:

openclaw browser wait "#main" \  --url "**/dash" \  --load networkidle \  --fn "window.ready===true" \  --timeout-ms 15000

Hata ayıklama iş akışları

Bir eylem başarısız olduğunda (ör. "görünür değil", "katı mod ihlali", "üstü kapalı"):

1. openclaw browser snapshot --interactive
2. click <ref> / type <ref> kullanın (etkileşimli modda rol başvurularını tercih edin)
3. Yine başarısız olursa Playwright'ın neyi hedeflediğini görmek için openclaw browser highlight <ref>
4. Sayfa olağan dışı davranıyorsa:
   • openclaw browser errors --clear
   • openclaw browser requests --filter api --clear
5. Ayrıntılı hata ayıklama için bir iz kaydedin:
   • openclaw browser trace start
   • sorunu yeniden oluşturun
   • openclaw browser trace stop (TRACE:<path> yazdırır)

JSON çıktısı

--json, betikler ve yapılandırılmış araçlar içindir.

Örnekler:

openclaw browser --json statusopenclaw browser --json snapshot --interactiveopenclaw browser --json requests --filter apiopenclaw browser --json cookies

JSON'daki rol anlık görüntüleri, araçların yük boyutu ve yoğunluğu hakkında değerlendirme yapabilmesi için refs ile küçük bir stats bloğu (satırlar/karakterler/başvurular/etkileşimli) içerir.

Durum ve ortam ayarları

Bunlar "siteyi X gibi davranacak şekilde ayarlama" iş akışlarında kullanışlıdır:

• Çerezler: cookies, cookies set, cookies clear
• Depolama: storage local|session get|set|clear
• Çevrimdışı: set offline on|off
• Üst bilgiler: set headers --headers-json '{"X-Debug":"1"}' (veya konumsal biçim set headers '{"X-Debug":"1"}')
• HTTP temel kimlik doğrulaması: set credentials user pass (veya --clear)
• Coğrafi konum: set geo <lat> <lon> --origin "https://example.com" (veya --clear)
• Medya: set media dark|light|no-preference|none
• Saat dilimi / yerel ayar: set timezone ..., set locale ...
• Cihaz / görüntü alanı:
  • set device "iPhone 14" (Playwright cihaz ön ayarları)
  • set viewport 1280 720

Güvenlik ve gizlilik

• openclaw tarayıcı profili, oturum açılmış oturumlar içerebilir; bunu hassas veri olarak değerlendirin.
• browser act kind=evaluate / openclaw browser evaluate ve wait --fn sayfa bağlamında rastgele JavaScript çalıştırır. İstem enjeksiyonu bunu yönlendirebilir. İhtiyacınız yoksa browser.evaluateEnabled=false ile devre dışı bırakın.
• openclaw browser evaluate --fn bir işlev kaynak kodunu, ifadeyi veya deyim gövdesini kabul eder. Deyim gövdeleri asenkron işlevler olarak sarmalanır; bu nedenle geri almak istediğiniz değer için return kullanın. Sayfa tarafındaki işlevin varsayılan değerlendirme zaman aşımından daha uzun sürmesi gerekebilirse --timeout-ms <ms> kullanın.
• Oturum açma ve bot karşıtı önlemlere ilişkin notlar (X/Twitter vb.) için Tarayıcıda oturum açma + X/Twitter'da gönderi yayımlama bölümüne bakın.
• Gateway/Node ana makinesini özel tutun (yalnızca geri döngü veya tailnet).
• Uzak CDP uç noktaları güçlüdür; bunları tünelleyin ve koruyun.

Katı mod örneği (özel/dahili hedefleri varsayılan olarak engeller):

{  browser: {    ssrfPolicy: {      dangerouslyAllowPrivateNetwork: false,      hostnameAllowlist: ["*.example.com", "example.com"],      allowedHostnames: ["localhost"], // isteğe bağlı tam eşleşme izni    },  },}

İlgili

• Tarayıcı - genel bakış, yapılandırma, profiller, güvenlik
• Tarayıcıda oturum açma - sitelerde oturum açma
• Tarayıcı Linux sorunlarını giderme
• Tarayıcı WSL2 sorunlarını giderme