Die Local Agent Browser CLI ist jetzt Teil der Agent Browser CLI. Das npm-Paket
gologin-local-agent-browser-cli ist veraltet: Installieren Sie gologin-agent-browser-cli und verwenden Sie --runtime local. Skripte, die gologin-local-agent-browser aufrufen, funktionieren weiterhin, siehe Von der Local Agent Browser CLI migrieren.cloud führt Sessions in Gologin Cloud Browser aus. Die Runtime local führt sie in Orbita, dem Gologin-Browser, auf Ihrem eigenen Rechner aus. Diese Seite behandelt die lokale Runtime. Snapshots, Refs und die übrigen Befehle funktionieren wie auf der Seite Agent Browser CLI beschrieben.
Wann lokal, wann Cloud?
Voraussetzungen
- Node.js 20 oder höher. Die lokale Runtime startet Orbita über das Gologin Node.js SDK, das Node.js 20 benötigt.
- Ein Gologin-API-Token in
GOLOGIN_TOKEN. Siehe Token abrufen. - Eine Profil-ID für jede Session. Anders als die Cloud-Runtime erstellt die lokale Runtime keine temporären Profile.
- Orbita. Ist es noch nicht installiert, lädt das Gologin SDK es beim ersten Start nach
~/.gologin/browserherunter. Befindet sich Orbita an einem anderen Ort, setzen SieGOLOGIN_EXECUTABLE_PATH.
Installation
gologin-agent-browserführt Browser-Sessions in der Cloud aus, sofern Sie nicht die lokale Runtime wählen.gologin-local-agent-browserist ein Kompatibilitäts-Alias, der Befehle in der lokalen Runtime ausführt.
Lokale Runtime wählen
Übergeben Sie--runtime local an einen Befehl oder legen Sie die Runtime einmal für die gesamte Shell fest:
--local und ein vorangestelltes local funktionieren ebenfalls: gologin-agent-browser local open https://example.com --profile your_profile_id.
Gologin-API-Befehle wie
api, browser und proxy rufen unabhängig von der Runtime immer direkt die API auf.
Umgebungsvariablen
Die lokale Runtime speichert ihre Konfiguration, die Profilliste und den Job-Verlauf in
~/.gologin-local-agent-browser/, demselben Ordner, den auch die alte CLI verwendet hat.
Schnellstart
--visible (oder --headed) und --headless (oder --background) legen den Fenstermodus für ein einzelnes open fest. open-visible und open-background sind Kurzformen dafür.
Browserbefehle
Die Session-Befehle sind dieselben wie in der Cloud-Runtime:snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload und weitere. Siehe die Befehlsreferenz. back, forward und reload funktionieren derzeit nur in der Cloud-Runtime.
find sucht ein Element auf der aktuellen Seite und führt in einem Schritt eine Aktion darauf aus. Nutzen Sie es, wenn Refs auf dynamischen Seiten veralten:
Profilbefehle
Diese Befehle laufen auch ohne--runtime local in der lokalen Runtime:
profile-create und profile-update akzeptieren eine Vorlage für einen Anwendungsfall und einen Proxy. --proxy-country us fügt einen Gologin-Proxy hinzu, --proxy-host zusammen mit --proxy-port legt Ihren eigenen fest.
Runbooks und Batch-Jobs
Ein Runbook ist eine JSON-Datei mit einer Liste von CLI-Schritten:targets.json listet die Profile auf:
jobs und job <jobId>. --status akzeptiert running, ok, partial oder failed:
Von der Local Agent Browser CLI migrieren
- Skripte, die
gologin-local-agent-browseraufrufen, funktionieren weiterhin. Der Befehl stammt jetzt ausgologin-agent-browser-cli. - Profile, Konfiguration und Job-Verlauf in
~/.gologin-local-agent-browser/bleiben an ihrem Platz. - Für KI-Agenten installieren Sie den Agent Browser Skill. Er deckt beide Runtimes ab, der separate Local-Agent-Browser-Skill ist veraltet.
Verwandte Themen
- Agent Browser CLI — vollständige Befehlsreferenz und die Cloud-Runtime
- Gologin Web Access CLI — Scraping- und Browserbefehle in einer CLI
- AI Skills — Skills für Claude Code und andere Agenten
- Node.js SDK — Profile aus Ihrem eigenen Code ausführen
npm-Paket
gologin-agent-browser-cli
Quellcode
GologinLabs/agent-browser