Rozszerzenie Chrome

Rozszerzenie OpenClaw dla Chrome umożliwia agentowi sterowanie kartami Chrome, w których jesteś zalogowany, bez uruchamiania oddzielnej zarządzanej przeglądarki i bez blokującego monitu Chrome „Allow remote debugging?”.

Ma to znaczenie, gdy sterujesz OpenClaw z telefonu (Telegram, WhatsApp itp.): profil user łączy się przez port zdalnego debugowania Chrome, co powoduje wyświetlenie na komputerze okna dialogowego zgody, którego nikt nie może kliknąć podczas Twojej nieobecności. Zamiast tego rozszerzenie używa API chrome.debugger, więc jedyną wskazówką na stronie jest możliwy do zamknięcia baner Chrome „OpenClaw started debugging this browser”.

Takie samo rozwiązanie stosują rozszerzenia Anthropic Claude in Chrome i OpenAI Codex dla Chrome.

Jak to działa

Trzy elementy:

• Usługa sterowania przeglądarką (Gateway lub host węzła): API wywoływane przez narzędzie browser.
• Przekaźnik rozszerzenia (WebSocket w local loopback): mały serwer uruchamiany przez usługę sterowania pod adresem 127.0.0.1. Udostępnia OpenClaw punkt końcowy protokołu Chrome DevTools Protocol i komunikuje się z rozszerzeniem. Obie strony uwierzytelniają się tokenem lokalnym dla hosta (patrz niżej).
• Rozszerzenie OpenClaw dla Chrome (MV3): dołącza do kart za pomocą chrome.debugger, przekazuje ruch CDP i zarządza grupą kart OpenClaw.

OpenClaw widzi i kontroluje tylko karty znajdujące się w grupie kart OpenClaw. Grupa stanowi granicę zgody: przeciągnij do niej kartę, aby ją udostępnić, albo przeciągnij ją poza grupę (lub kliknij przycisk na pasku narzędzi), aby natychmiast cofnąć dostęp.

Instalowanie i parowanie

1. Wyświetl ścieżkę do rozpakowanego rozszerzenia:

   openclaw browser extension path

2. Otwórz chrome://extensions, włącz Developer mode, kliknij Load unpacked i wybierz wyświetlony katalog.

3. Wyświetl ciąg parowania:

   openclaw browser extension pair

4. Kliknij ikonę OpenClaw na pasku narzędzi i wklej ciąg parowania do wyskakującego okna. Gdy rozszerzenie połączy się z przekaźnikiem, plakietka zmieni stan na ON.

Token parowania jest sekretem lokalnym dla hosta, tworzonym przy pierwszym użyciu i przechowywanym w katalogu credentials/ w katalogu stanu (tryb 0600). Każdy komputer, na którym działa przeglądarka — host Gateway i każdy host węzła przeglądarki — ma własny token, dzięki czemu żadne dane uwierzytelniające nie muszą być przesyłane między komputerami. Aby go zmienić, usuń plik browser-extension-relay.secret i ponownie przeprowadź parowanie.

Używanie

Wybierz wbudowany profil chrome w wywołaniu narzędzia browser lub ustaw go jako domyślny:

openclaw config set browser.defaultProfile chrome

{  browser: {    profiles: {      chrome: { driver: "extension", color: "#FF4500" },    },  },}

• Aby udostępnić kartę, kliknij na niej przycisk OpenClaw na pasku narzędzi (karta dołączy do grupy kart OpenClaw) lub przeciągnij dowolną kartę do tej grupy.
• Agent może również otwierać nowe karty, które automatycznie trafiają do grupy.
• Aby cofnąć dostęp, ponownie kliknij przycisk, przeciągnij kartę poza grupę lub zamknij baner debugowania Chrome. Agent natychmiast utraci dostęp do tej karty.

Zdalnie / między komputerami

Chrome nie musi działać na hoście Gateway. Obsługiwane są trzy topologie:

• Ten sam host (Gateway i Chrome na jednym komputerze): przeprowadź parowanie na tym komputerze za pomocą polecenia openclaw browser extension pair. Przekaźnik jest dostępny wyłącznie przez local loopback.
• Bezpośrednio ze zdalnym Gateway (Chrome na laptopie, Gateway na VPS-ie i nic więcej na laptopie): na hoście Gateway uruchom openclaw browser extension pair --gateway-url wss://your-gateway.example.com. Polecenie wyświetli ciąg wss://…/browser/extension#<secret>; załaduj rozszerzenie na laptopie i przeprowadź parowanie. Rozszerzenie łączy się bezpośrednio z Gateway przez wss:// — na laptopie nie jest wymagana instalacja OpenClaw, Node ani CLI ani otwarty port przychodzący. Jest to ścieżka dla hostingu zarządzanego.
• Przez host węzła przeglądarki (Chrome na komputerze, na którym działa już węzeł OpenClaw): uruchom polecenie pair na węźle i przeprowadź parowanie lokalnie; Gateway przekazuje działania przeglądarki do węzła za pośrednictwem istniejącego, uwierzytelnionego połączenia węzła.

Sekret parowania jest przypisany do hosta (w przypadku połączenia bezpośredniego — do Gateway) i weryfikowany przez trasę Gateway /browser/extension. W przypadku ścieżki bezpośredniej udostępniaj Gateway przez TLS (wss://), aby sekret parowania i ruch CDP były szyfrowane. Sekret pozostaje we fragmencie adresu URL ciągu parowania i jest przekazywany podczas uzgadniania połączenia WebSocket jako dane uwierzytelniające podprotokołu, dlatego standardowe dzienniki dostępu serwera proxy nie otrzymują go w adresie URL żądania. Upewnij się, że odwrotny serwer proxy zachowuje standardowy nagłówek Sec-WebSocket-Protocol.

Diagnostyka

openclaw browser status --browser-profile chromeopenclaw browser doctor --browser-profile chrome

Polecenie doctor zgłasza niepowodzenie kontroli przekaźnika rozszerzenia Chrome, dopóki wyskakujące okno rozszerzenia nie wyświetli stanu Connected.

Model bezpieczeństwa

• Przekaźnik nasłuchuje wyłącznie w local loopback; obie strony WebSocket są uwierzytelniane za pomocą tokenu pochodnego, a pochodzenie strony rozszerzenia jest sprawdzane względem chrome-extension://.
• Bezpośrednie parowanie z Gateway nie akceptuje tokenu przekaźnika w adresie URL żądania; dołączone rozszerzenie przekazuje go zamiast tego na liście podprotokołów WebSocket.
• Agent może widzieć i obsługiwać wyłącznie karty w grupie kart OpenClaw. Pozostałe karty pozostają prywatne.
• W porównaniu z profilem user (Chrome MCP), który po zatwierdzeniu monitu zdalnego debugowania udostępnia całą przeglądarkę z aktywnym logowaniem, rozszerzenie ogranicza udostępniany obszar do grupy kart, którą można łatwo kontrolować.

Zobacz również: Przeglądarka, aby poznać pełny model profili oraz zarządzany profil openclaw i profil user Chrome MCP.