2026 OpenClaw Node (VS Code-Erweiterung) × exklusiver Fern-Mac: Installation, Workspace-Skills, Gateway- und ACP-Integration, SSH-Portweiterleitung — reproduzierbares Tutorial + FAQ

1. Ziele, Annahmen und was „reproduzierbar“ hier bedeutet

Am Ende haben Sie: VS Code (oder kompatibler Fork) mit OpenClaw Node, einen Workspace auf dem Fern-Mac (typischerweise per Remote-SSH), für die Node-Seite sichtbare Skills, ein Gateway auf vorhersagbaren Loopback-Ports und ACP-Sitzungen, die Neustarts überstehen — weil Tunnel und Bind-Adressen explizit und nicht geraten sind.

Annahmen: ssh user@mac-host läuft in Automatisierung ohne interaktive Abfragen, der Mac ist single-tenant für Ihr Team, Gateway-Pakete sind nach Herstellerdokumentation installiert. Wenn Sie öffentliche Exposition bewusst vermeiden und stattdessen Tailscale/Cloudflare-Tunnel evaluieren, lesen Sie ergänzend 2026 OpenClaw Gateway mit Null-Exposition: Tailscale Serve/Funnel vs. Cloudflare Tunnel (cloudflared) + reproduzierbare Fern-Mac-SSH-Schritte & FAQ.

2. OpenClaw Node installieren und den Extension-Host prüfen

1. Installieren Sie die OpenClaw-Node-Erweiterung aus dem Marketplace in VS Code auf Ihrem Laptop.
2. Verbinden Sie sich per Remote - SSH (oder Äquivalent) und Ordner erneut in Remote öffnen, damit der Extension-Host auf dem Mac läuft — nicht lokal. Lokal gehostete Extensions sehen keine macOS-Pfade und keine per launchd verwalteten Daemons.
3. Öffnen Sie die Ausgabe, Kanal OpenClaw Node, und prüfen Sie, dass das Log den Remote-OS-Build (Darwin) und denselben Benutzer wie die Gateway-Konfiguration zeigt.
4. Laden Sie das Fenster nach der Erstinstallation einmal neu, damit PATH-Änderungen aus Shell-Profilen im Extension-Host ankommen.

Ist der Marketplace blockiert, installieren Sie die .vsix per code --install-extension openclaw-node-*.vsix auf dem Remote-Host via SSH; versionieren Sie den Dateinamen in Ihrem internen Artefakt-Store.

3. Workspace-Layout und Skill-Auflösung

Skills sind keine magischen Globals: Sie werden aus Workspace-Wurzeln aufgelöst. Nutzen Sie möglichst eine einzige Repo-Wurzel; bei Multi-Root-Workspaces überschatten doppelte Skill-IDs leise einander.

• Gemeinsame Skills unter .openclaw/skills/<skill-id>/SKILL.md an der Repository-Wurzel ablegen, die Node öffnet.
• Lesbarkeit für den Remote-Benutzer prüfen (ls -l) und zu breite .gitignore-Regeln vermeiden, falls Ihre Pipeline auf Git-Checkouts basiert.
• Nach Änderungen die Befehlspalette-Aktion zum Aktualisieren der Skills (Formulierung je Release) ausführen oder das Fenster neu laden; im Output-Kanal auf Parse-Fehler achten.

Für Prioritätstabellen bei mehreren Wurzeln gelten dieselben Regeln wie im deutschsprachigen Artikel zu OpenClaw Skills, Multi-Workspace und SSH auf exklusivem Fern-Mac (Skill-Konflikte) — sobald Node remote gehostet ist, greift dieselbe Logik.

4. Node auf das Gateway ausrichten (Loopback, Tokens, TLS)

Binden Sie das Gateway an 127.0.0.1 auf dem Mac und behandeln Sie LAN-Freigabe als separates Härtungsprojekt. In den Node-Einstellungen (Remote-Scope):

• Basis-URL auf http://127.0.0.1:<port> (oder HTTPS bei lokalem TLS-Termination) setzen.
• Langlebigen Token oder API-Key über die Secret-Storage-API eintragen — keine Tokens in gemeinsam genutztes settings.json.
• Health-Check zuerst per curl --noproxy '*' in einer SSH-Shell; wenn curl scheitert, scheitert Node aus demselben Grund.

Wenn Policy node-Subbefehle standardmäßig sperrt, richten Sie Genehmigungen am deutschsprachigen Node-Pairing-/Gateway-SSH-Matrix-Artikel aus, damit Betrieb weiß, welche UI-Klicks zu welchen Audit-Events gehören.

5. ACP (Agent Client Protocol) — gemeinsame Checkliste

ACP ist die editorseitige Steuerungsebene: Node übersetzt VS Code-Aktionen in ACP-Nachrichten, das Gateway antwortet mit gestreamten Tool- oder Chat-Events. Behandeln Sie es wie jedes andere Localhost-Dienstpaar:

• ACP in Gateway-Policy und Node-Einstellungen aktivieren; Versions-Mismatch führt sofort zu protocol version-Fehlern — beide Seiten in einem Änderungsfenster aktualisieren.
• WebSocket- oder HTTP/2-Idle-Timeouts über Ihr längstes Tool-Run legen; bei Jobs über mehrere Stunden Gateway-Logs und Soak-Hinweise aus dem OpenClaw-v2026.4.15-Tahoe-Artikel im Blog konsultieren.
• Unternehmens-HTTP-Proxys für 127.0.0.1 deaktivieren; Proxys entfernen oft WebSocket-Upgrades und ACP wirkt „zufällig instabil“.

6. SSH-Portweiterleitung, die in echten Netzen hält

Wenn Operatoren vom Laptop arbeiten, das Gateway aber auf dem Fern-Mac bleibt, nutzen Sie explizite Forwards statt Ad-hoc-ssh -L-Einzeilern, die mit dem WLAN sterben.

LocalForward (häufigster Fall): Remote-127.0.0.1:18789 auf Laptop-127.0.0.1:18789 spiegeln:

Host mac-build-01
  HostName <ip-oder-dns>
  User <user>
  LocalForward 18789 127.0.0.1:18789
  ServerAliveInterval 30
  ServerAliveCountMax 4
  ExitOnForwardFailure yes

Symptommatrix

7. FAQ

F: Skills erscheinen in der CLI auf dem Mac, aber nicht in Node.
A: Prüfen Sie, dass das VS Code-Fenster remote-gehostet ist, die Workspace-Wurzel .openclaw/skills enthält und das Fenster nach git pull neu geladen wurde.

F: ACP verbindet und bricht mitten im Tool ab.
A: Gateway-Tool-Timeout und SSH-Keepalives angleichen; Gateway-Logs auf OOM oder Policy-Kills prüfen.

F: Können wir mehrere Ports in einer Sitzung weiterleiten?
A: Ja — mehrere LocalForward-Zeilen; jedes Paar im internen Runbook dokumentieren.

Warum Mac mini für Node plus Gateway-Sidecars weiterhin passt

VS Code Remote, ein Gateway und gelegentlich lokale Modelle auf derselben Maschine profitieren von der Unified-Memory-Bandbreite von Apple Silicon und der Stabilität von macOS: launchd liefert vorhersagbare Auto-Restart-Semantik, OpenSSH ist erstklassig integriert, Gatekeeper und SIP verkleinern die unbeaufsichtigte Malware-Oberfläche gegenüber vielen Standard-Windows-Images. Ein Mac mini der M4-Klasse bleibt dabei leise und verbraucht im Leerlauf nur wenige Watt — relevant, wenn der Rechner dauerhaft für ACP und Webhook-Callbacks online steht.

Wenn Sie diesen Editor-first-Workflow auf Hardware betreiben wollen, die sich leicht auditieren lässt, thermisch unkritisch ist und sich 24/7 wirtschaftlich betreiben lässt, ist Mac mini M4 2026 weiterhin ein starker Einstieg — öffnen Sie die Startseite, vergleichen Sie Pakete und rollen Sie dieselbe Checkliste teamweit aus.