Zielgruppe: Teams, die ein OpenClaw-Gateway auf einem gemieteten Mac betreiben und Anrufer jenseits von 127.0.0.1 bedienen — etwa CI-Agenten, VPN-Peers oder einen lokalen TLS-Reverse-Proxy. Sie erhalten eine kopierbare Reihenfolge: Node 22+, Installationspfad (Skript oder npm -g), SecretRef-ähnliche Token-Verdrahtung, Validierungsbefehle und eine kompakte Tabelle typischer Abbrüche, abgestimmt mit dem offiziellen Troubleshooting (siehe docs.openclaw.ai). Kanonische URL: dieser Artikel auf macpull.com/de. Vertiefung: Gateway-Härtung, Config-Validate als CI-Gate, Nicht-interaktives Onboarding & Umgebungs-Merge.

Warum reine Loopback-Defaults Remote-Mac-Automation brechen

Auf dem Entwicklerrechner wirkt 127.0.0.1 harmlos — auf einem Remote-Mac teilen sich Gateway, npm-/PyPI-Spiegel und Webhook-Ziele oft dieselbe Netzwerk- und APFS-Umgebung. Sobald Caller von außen kommen, trennen sich interaktive Shell und launchd: ein in der SSH-Session exportiertes Token existiert für den Daemon nicht.

  1. PATH-Drift: nvm-Shims in der CI-Shell, feste Pfade in der LaunchAgent-Plist — openclaw findet unterschiedliche Binaries.
  2. Erweiterte Bind-Fläche: Nicht-Loopback ohne Leitplanken aus der offiziellen Security-Dokumentation erhöht die Angriffsfläche; ein leeres OPENCLAW_GATEWAY_TOKEN führt häufig zum sofortigen Prozessende.
  3. Proxy-Kopplung: Fällt das Gateway aus, leiden Prefetch-Webhooks und Registry-Pulls auf demselben Runner unter Timeouts, bevor der eigentliche Build beginnt.

Matrix: Listen-Bereich versus Auth-Tiefe

Listen-Muster Typischer Einsatz Token- und Netz-Hinweis
127.0.0.1 nur Lokale doctor-Schleifen und Sidecar-Reverse-Proxy auf demselben Mac Setzen Sie OPENCLAW_GATEWAY_TOKEN, wenn die Doku eingehende HTTP-Auth für Tool-Clients vorschreibt.
Site-local / VPN-Schnittstelle CI-Agenten im selben Tailnet rufen das Gateway ohne öffentliches Internet Firewall-Regeln ergänzen; Token rotieren, wenn sich die Tailnet-Mitgliedschaft ändert.
LAN-IP (nicht Loopback) Webhook-Ingress aus angrenzenden Build-Subnetzen Pflicht-Bearer-Prüfungen; interne Runbooks an offizielle Rate-Limits und Exposure-Hinweise spiegeln.

Minimale, reproduzierbare Schritte

Schritt 1. Node 22.14 LTS oder Node 24 pinnen. Schreiben Sie node -v in die erste Log-Zeile jedes Jobs, damit Image-Drift sofort sichtbar wird.

Schritt 2. Offiziellen OpenClaw-Installer (Einzeiler per curl aus der Amtsdoku) oder ein von der Security freigegebenes npm install -g "openclaw@^…" verwenden. Direkt danach command -v openclaw und openclaw --version ausgeben. Homebrew-Interaktion auf goldenen Images dokumentieren — siehe HowTo zum nicht-interaktiven Onboard.

node -v
npm install -g "openclaw@^2026.3.0"
command -v openclaw
openclaw --version

Schritt 3. Pro Job oder Daemon eindeutige OPENCLAW_HOME- und OPENCLAW_CONFIG_HOME-Pfade; Verzeichnisse mit chmod 700 anlegen.

Schritt 4. Geheimnisse wie bei einem Kubernetes SecretRef in die Prozessumgebung legen — ohne echo in die Pipeline: GitHub Actions env:, Azure-DevOps-Geheimvariablen, macOS-EnvironmentVariables in der Plist. Standardname für eingehende HTTP-Auth: OPENCLAW_GATEWAY_TOKEN. Nie in PR-Kommentaren oder Build-Summaries einfügen.

Schritt 5. Listen-Adresse nur nach Lesen der offiziellen Abschnitte zu Gateway-Listen, TLS und Exposure ändern. Wenn nginx oder Caddy TLS beendet, kann der OpenClaw-Prozess auf Loopback bleiben und authentifizierten Traffic weiterleiten. Bei verbindlicher LAN-IP: Token gesetzt halten, Plist nach atomaren Änderungen unload/load.

Schritt 6. openclaw doctor und anschließend openclaw config validate — ideal in einem gemeinsamen Log wie im Artikel Config-Validate CI-Gate.

export OPENCLAW_GATEWAY_TOKEN="$(cat "$RUNNER_TEMP/gw.token")"
openclaw doctor
openclaw config validate --config "$OPENCLAW_CONFIG_HOME/openclaw.json"

curl -fsS -o /dev/null -w "%{http_code}" \
  -H "Authorization: Bearer $OPENCLAW_GATEWAY_TOKEN" \
  "http://127.0.0.1:18789/v1/health"

Häufige Meldungen: Start wird ohne Authentifizierung verweigert

Upstream behandelt unsichere Kombinationen absichtlich strikt: Meldungen zu fehlenden Credentials oder verbotenen Bind-Profilen sind Leitplanken, keine Regressionen. Gleichen Sie exakte Formulierungen mit der Dokumentation zu Ihrer installierten Semver-Minor und den Security-/Troubleshooting-Kapiteln auf docs.openclaw.ai ab — Wortlaut kann zwischen Minors wechseln.

Symptom oder Log-Hinweis Wahrscheinliche Ursache Amtsdoku-orientierter Fix
Prozess endet direkt nach Wechsel auf Nicht-Loopback OPENCLAW_GATEWAY_TOKEN leer bei exponiertem Listen Token aus Secret-Store injizieren, Job oder launchd neu laden, Security-Abschnitt erneut lesen.
HTTP 401 auf Health- oder Tool-Routen aus der CI Authorization fehlt, falsch geschrieben oder mit Zeilenende im Wert Bearer-Schema laut Doku angleichen; Token neu erzeugen, wenn Copy-Paste-Zeilenumbruch entstand.
doctor in der Shell grün, Daemon weiterhin rot LaunchAgent-Plist ohne neue Variable EnvironmentVariables diffen, einmal unload/load pro Änderung.
validate meldet ungültige JSON-Pfade Handeditierte Config driftet Vor Merge validate erzwingen; Tarball-Checkpoints wie im Validate-Gate-Artikel nutzen.

Zusätzliche Härtung: Gateway-Security auf Remote-Mac. Release-Notes Ihrer CLI-Version mit den Security-Paragraphen der Online-Doku vergleichen.

Preflight-Checkliste vor Produktion

  • Node 22.14+ oder 24 im Job-Log nachweisbar.
  • openclaw-Pfad identisch in CI und launchd, falls daemonisiert.
  • OPENCLAW_GATEWAY_TOKEN im Listen-Kontext gesetzt und nirgends ausgegeben.
  • Firewall erlaubt nur dokumentierte Subnetze oder Tailnet-Hosts.
  • Kombiniertes doctor- plus validate-Log grün archiviert.
  • curl-Health: 200 mit Bearer, ohne Header erwartetes 401 oder dokumentierter Fehlercode.

Nutzen: dasselbe Remote-Mac für CI-, Proxy-Pulls und Gateway

Wer Gateway und npm-/PyPI-/OCI-Prefetch auf einem Apple-Silicon-Host bündelt, profitiert von gemeinsam warmen TLS-Sessions, DNS-Caches und APFS-Metadaten: Webhooks und Registry-Pulls sparen Roundtrips gegenüber einem separaten Linux-VM-Sprung. Ein fehlschlagender Bearer-Health-Check fällt vor teuren Installationswellen auf — das senkt verbrannte Minuten in der Pipeline.

Kombinieren Sie dieses HowTo mit dem Status-/Port-Gate aus Gateway-Status-JSON & doctor, um Listener auf 18789 und Auth konsistent zu belegen, bevor Proxy-Jobs loslaufen.

Kurzfassung und nächste Schritte

Kernpunkte: Node 22+, Installer oder globales npm, SecretRef-ähnliches OPENCLAW_GATEWAY_TOKEN, dokumentierte Nicht-Loopback-Politik, Abgleich von Abbruchmeldungen mit docs.openclaw.ai, doctor und config validate. Für dauerhaftes Apple Silicon als Gateway- plus CI-Pull-Host stehen öffentliche Seiten bereit: Preise, Jetzt kaufen, Hilfe, Konsole und der Technik-Blog — ohne Paywall.

Remote-Mac für token-gestütztes OpenClaw und CI-Pulls

Dediziertes Apple Silicon mit planbarem Netz für Gateway, Registry-Spiegel und Webhook-Automation. Nur öffentliche MacPull-Seiten — unten verlinkt.

Konsole Preise Jetzt kaufen Blog