Narzedzie przegladarki w OpenClaw

Wprowadzenie

OpenClaw zarzadza dedykowanym, izolowanym profilem przegladarki — calkowicie oddzielonym od Twojej osobistej przegladarki. System zapewnia deterministyczne sterowanie przegladarkami Chrome, Brave, Edge lub Chromium poprzez lokalna usluge kontrolna.

Izolacja i bezpieczenstwo

Agent korzysta z osobnej przegladarki posiadajacej wlasny katalog danych uzytkownika. Nie wchodzi w interakcje z Twoimi osobistymi profilami przegladarki. Agent moze otwierac zakladki, klikac, wpisywac tekst i wykonywac zrzuty ekranu — wszystko w izolowanym srodowisku.

Obsluga wielu profili

System wspiera nazwane profile przegladarki:

• openclaw — profil zarzadzany, izolowana instancja z niezaleznym katalogiem danych i portem CDP
• user — dolaczenie do istniejacej sesji Chrome z zachowaniem stanu logowania i otwartych zakladek
• Profile niestandardowe — mozliwosc tworzenia wlasnych profili z indywidualna konfiguracja

Lokalne profile zarzadzane uzywaja dedykowanych portow CDP z zakresu 18800–18899. Mozliwe jest takze polaczenie zdalne przez CDP do przegladarek hostowanych.

Szybki start

openclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw start
openclaw browser open https://example.com
openclaw browser snapshot

Konfiguracja

Ustawienia przegladarki znajduja sie w pliku ~/.openclaw/openclaw.json:

{
  browser: {
    enabled: true,
    defaultProfile: "openclaw",
    executablePath: "/sciezka/do/przegladarki",
    ssrfPolicy: {
      dangerouslyAllowPrivateNetwork: true,
    },
    profiles: {
      openclaw: { cdpPort: 18800, color: "#FF4500" },
      user: { driver: "existing-session", attachOnly: true }
    }
  }
}

Integracja z uslugami hostowanymi

Browserless

Zdalna usluga Chromium udostepniajaca CDP przez HTTPS/WebSocket. Idealna do uruchamiania przegladarki w chmurze bez potrzeby lokalnej instalacji.

Browserbase

Platforma chmurowa z rozwiazywaniem CAPTCHA i trybem stealth. Przydatna w scenariuszach wymagajacych omijania zabezpieczen antybotowych.

System snapshotow i akcji

Snapshoty AI

Domyslny format zwracajacy tekstowy snapshot z numerycznymi referencjami — np. click 12 klika element oznaczony numerem 12.

Snapshoty rolowe

Tryb interaktywny generujacy liste/drzewo oparte na rolach z referencjami w formacie [ref=e12], co pozwala na bardziej granularna kontrole.

Wzorzec dzialania

Najpierw wykonujesz snapshot, aby uzyskac referencje, a nastepnie uzywasz tych referencji w poleceniach click/type/select. Selektory CSS sa celowo nieobslugiwane — referencje sa bezpieczniejsze i bardziej deterministyczne.

Bezpieczenstwo

• Serwer kontrolny nasluchuje wylacznie na interfejsie loopback i wymaga uwierzytelnienia przez Gateway
• Uwierzytelnianie odbywa sie przez token shared-secret, naglowek x-openclaw-password lub HTTP Basic
• Polityka SSRF chroni nawigacje przegladarki przed i po przejsciach
• Tokeny zdalnego CDP traktowane sa jako sekrety — zalecane jest uzycie zmiennych srodowiskowych zamiast plikow konfiguracyjnych
• Funkcja evaluate wykonuje dowolny JavaScript — mozna ja wylaczyc ustawieniem browser.evaluateEnabled=false

Referencje CLI

Dostepne polecenia CLI obejmuja: inspekcje (screenshot, snapshot, console), cykl zycia (status, start, stop, tabs), nawigacje (navigate, open, wait), interakcje (click, type, press, hover, drag, select) oraz zarzadzanie stanem (cookies, storage, set headers, set geo).