OpenClaw Browser-Automation auf Fern-Mac mit CDP- und Gateway-Healthchecks

Einen OpenClaw-Browser-Agenten auf einem 24/7- oder kurz- bis mittelfristig gemieteten Bare-Metal-Fern-Mac zu betreiben, ist 2026 typisch für Growth-, QA- und RPA-Teams: Ihr Laptop orchestriert, während gateway und ein verwaltetes Chromium-Profil im Rechenzentrum laufen. Stabile Linie: 2026.5.2 laut Browser-Dokumentation auf docs.openclaw.ai. Dieser Beitrag behandelt Greenfield-Deploy, CDP/attachOnly-Fehlersuche, TCC-Abnahme und Miet-/Hardware-Entscheidungen — nicht Loopback-Token-Verdrahtung (siehe Loopback-Token mit doctor und probe kreuzen) noch Gateway-Kurzmiete-Basics (Fern-Gateway-Mac Kurz- und Mittelfristmiete).

1. Abgrenzung: verwaltetes Profil vs. attachOnly vs. Remote CDP

Modus Wer startet den Browser Typische Config Fern-Mac-Fit
Verwaltetes openclaw-ProfilOpenClaw startet isoliertes Chromiumbrowser.profiles.openclawStandard — isolierter Login-Zustand
attachOnlyBrowser läuft bereits (Sie oder Drittanbieter)attachOnly: true + cdpUrlBrowserless, Loopback-Debug-Ports
Remote CDPChromium woanderscdpUrl: wss://...Node-Host-Relay oder SSH-Tunnel

Wann attachOnly am Tag 1 weglassen: Seit 2026.3.22 ist das Chrome-Extension-Relay entfernt — existing-session funktioniert nicht über reine SSH-Headless-Sitzung; nutzen Sie Node host oder Remote CDP. Brauchen Sie nur isolierte Automation, hängen Sie kein persönliches Chrome-Profil an.

2. Greenfield auf US-Ost-/APAC-Fern-Mac (2026.5.x)

  1. Node 22 oder 24 mit einem globalen npm-Prefix.
  2. Installation: curl -fsSL https://openclaw.ai/install.sh | bash oder npm i -g openclaw@latest.
  3. openclaw onboard: browser.enabled setzen; tools.alsoAllow: ["browser"] für Agenten mit Browser-Tool.
  4. launchd für dauerhaftes Gateway (Standard 18789); Browser-Control-Service etwa gateway.port + 2.
  5. openclaw gateway probe für Liveness.
  6. openclaw browser --browser-profile openclaw doctorstartstatus --json.
Nach Upgrades: openclaw backup createopenclaw doctor --fixopenclaw gateway restart, danach Browser-doctor pro Profil. Siehe auch 2026.5.x-Upgrade mit Gateway probe und doctor.

3. browser.profiles und CDP-Portplan pro Profil

Profil cdpPort Hinweise
openclaw18800Standard verwaltet
work18801Optionale Headless-Batch-Spur
browserlesscdpUrl + attachOnly: true

Lokale Pools nutzen 18800–18899. Mehrere Gateways auf einem Host müssen Ports staffeln. Bei stale cdpUrl nach Neustarts: abgelaufene WebSocket-URLs aus der Config entfernen, gateway restart, dann browser start. Loopback-Browserless auf demselben Host braucht attachOnly: true, sonst kann OpenClaw den Port als verwaltetes Profil interpretieren und Eigentümerkonflikte melden.

4. TCC und Bildschirmaufnahme: nur SSH vs. VNC

Berechtigung Nur SSH VNC
Automation / BedienungshilfenErstvergabe nicht möglichSystemeinstellungen → Datenschutz
BildschirmaufnahmeSnapshots ggf. schwarzErlauben, dann snapshot erneut testen

Siehe macOS TCC, Node 24 und Fern-Gateway-Workflow; SSH/VNC-Lieferung im Hilfezentrum.

5. doctor / status / probe und CDP-Fehlerbaum

  • L0 Gateway: openclaw doctorgateway statusgateway status --require-rpcgateway probe
  • L1 Browser: openclaw browser --browser-profile <name> doctor [--deep]status --json
  • L2 CDP HTTP: curl -s http://127.0.0.1:<cdpPort>/json/version
Symptom Maßnahme
profile not runningBei attachOnly Chromium zuerst starten; oder verwaltetes Profil
cdpReady falsePort freimachen; localCdpReadyTimeoutMs auf langsamen Hosts erhöhen
stale cdpUrlConfig leeren → gateway restartbrowser start
Token / Auth-Mismatchgateway.auth.token mit Client-Headern angleichen; Loopback-Artikel oben

6. Referenz-Workflows (nur Architektur)

  • Wettbewerbsmonitoring: verwaltetes Profil + Cron → snapshot → Object Storage; große Artefakte nicht auf den Operator-Laptop ziehen.
  • Formular-QA: separates work-Profil; bei Fehlern headed per VNC reproduzieren.
  • Skill-Batch: horizontal auf mehrere Maschinen skalieren — nicht viele Profile auf einem Host um Port 18800 konkurrieren lassen.

7. Host-Aufteilung: Browser-Agent vs. Xcode / Runner

Browser-Agenten auf niedrigerer M4-Stufe mit großer SSD; xcodebuild Archive und schwere Compiles auf Hoch-RAM-Knoten auslagern. Muss es auf einem Host liegen: getrennte User-Data-Verzeichnisse und gestaffelte launchd-Zeitpläne. Festplatten-Warteschlangen: Mac-CI-Cache-Partitionen und NVMe-FAQ.

8. US-Ost vs. APAC: Latenz und Screenshot/PDF-Egress

Operatoren in Bevorzugter Knoten Typische RTT
Festlandchina / SüdostasienSingapur, Hongkong, Tokio~30–80 ms
NordamerikaUS-West-Einstieg~60–90 ms quer durch USA
Harte interkontinentale PaarungWenn möglich vermeiden130–190 ms+

Große PDF- oder Screenshot-Downloads leiden unter hoher RTT — Speicher nah am Browser-Host, nicht am Laptop.

9. Drei M4-Stufen + 1 TB/2 TB parallel vs. einzelner M4 Pro

Dimension Stufe A + 1 TB Zwei Stufe-A + 2 TB Einzelner M4 Pro
Cache / SnapshotsEin Profil, wöchentliche BereinigungProfil-Isolation pro HostMehr RAM, weniger Swap
Kurz-/MittelfristkostenNiedrigere Wochen-/MonatsmieteBurst mit Tages-Add-on-HostsTeuer im Leerlauf
Wann nicht wählenViele Profile kämpfen um RAMMulti-Port-Betrieb störtNur ein leichtes Profil

Preise und Verfügbarkeit: Preisseite und Checkout — Zahlen hier sind Entscheidungsrahmen, keine Angebote.

10. SSH-Tunnel vs. Tailscale Serve (Browser-Sicht)

SSH -L für 18789 und 18800 lässt Laptop lokal Gateway/CDP ansprechen; Gateway-Token auf jedem Client mitschicken. Tailscale Serve eignet sich für stabile Team-Einstiegspunkte. Die eigenständige Loopback-Browser-HTTP-API wertet keine Tailscale-Identity-Header aus — Shared-Secret-Auth bleibt nötig (Tailscale-Install-Artikel auf der Site; hier nur Browser-Zugriffsmuster). CDP-Ports nicht ins öffentliche Internet legen.

11. Upgrade und Rollback

  1. openclaw updatebackup createdoctor --fixgateway restart
  2. Pro Profil: browser stopstart
  3. Rollback: Backup wiederherstellen und Version pinnen; Profil-Verzeichnisse nicht blind über Major-Versionen kopieren

Blue/Green bei Langzeitmiete: Fern-Mac Blue-Green Rolling auf Port 18789. Mehrteam-Isolation: gemeinsamer Fern-Mac: Gateway-Grenzen.

12. FAQ

  • Reicht eine Woche zur Validierung? Ja, wenn Onboard + Einzelprofil-snapshot doctor und probe bestehen.
  • attachOnly sagt nicht aktiv? Zuerst curl /json/version; auf 2026.5.2+ upgraden; stale cdpUrl leeren.
  • VNC überspringen? Gateway kann CLI-only bleiben; erste TCC-Vergaben brauchen Grafik.
  • Mehrere Profile parallel? Durch RAM und tabCleanup begrenzt — lieber getrennte Hosts.
  • Headless auf Fern-Mac? Ohne DISPLAY können verwaltete Profile auto-headless laufen; Screenshots brauchen weiter Bildschirmaufnahme.
  • Mit Runner koexistieren? Getrennte User oder Maschinen; Disk nicht mit DerivedData teilen.
  • US-Ost oder APAC? Abschnitt 8; Festland/SEA-Teams meist APAC.
  • 1 TB vs. 2 TB? 2 TB bei 30+ Tagen Snapshot-Aufbewahrung.
  • openclaw browser fehlt? plugins.allow inkl. browser und browser.enabled prüfen.
  • Nach Upgrade totales CDP-Aus? doctor --fix, Gateway-Neustart, Profile einzeln neu aufbauen.
  • Wann keine zwei Stufe-A-Hosts? Ein leichtes Profil, kein Compile-Spill — ein M4 Pro ist einfacher, im Leerlauf teurer.

Warum ein Fern-Mac mini für dauerhafte Browser-Agenten passt

Apple Silicon Unified Memory hilft bei vielen Chromium-Tabs; Mac mini-Verbrauch passt zu 24/7-Gateway; macOS hält TCC und VNC-Lieferung konsistent. Sie brauchen isolierte Profile plus Plattenreserve für Cache und Snapshots, keinen zweiten offenen Laptop.

US-West- und APAC-Knoten, drei M4-Stufen und 1 TB/2 TB-Erweiterung auf der Macstripe-Startseite; Listenpreise auf der Preisseite; SSH/VNC im Hilfezentrum.