Remote OpenClaw: Dein macOS als Fernsteuerung nutzen

Du kennst das Problem: Dein Haupt-Workflow läuft auf dem Mac, aber die rechenintensive Last oder spezifische Hardware-Anbindungen liegen auf einem entfernten Server oder einem Desktop-Rechner im Büro. Ständig zwischen Terminals und verschiedenen Geräten zu springen, bricht den Flow und nervt im Entwickler-Alltag. Du willst die gewohnte UI auf deinem MacBook, während die eigentliche Arbeit woanders passiert.

Hier kommt der Remote over SSH Modus ins Spiel. Damit agiert deine macOS App als vollständige Fernsteuerung für ein OpenClaw Gateway, das auf einem anderen Host läuft. Sämtliche Features wie Health Checks, Voice Wake Forwarding und der Web Chat nutzen dabei dieselbe SSH-Konfiguration.

Voraussetzungen

Bevor du startest, müssen auf dem Remote-Host folgende Voraussetzungen erfüllt sein:

• Node.js und pnpm sind installiert.
• Das OpenClaw CLI ist gebaut und global verlinkt (pnpm install && pnpm build && pnpm link --global).
• openclaw befindet sich im PATH für non-interactive Shells (nutze Symlinks nach /usr/local/bin oder /opt/homebrew/bin).
• SSH-Zugriff via Key-Auth ist aktiv (wir empfehlen Tailscale IPs für stabile Verbindungen außerhalb des lokalen Netzwerks).
• TCC-Berechtigungen (Automation, Accessibility, Screen Recording, Microphone, Speech Recognition, Notifications) wurden auf dem Remote-Host bereits einmalig durch das Onboarding erteilt.

Schnellstart

In weniger als fünf Minuten ist deine Remote-Verbindung aktiv:

1. Öffne die macOS App und gehe zu Settings → General.
2. Wähle unter OpenClaw runs die Option Remote over SSH.
3. Konfiguriere den Transport: Wähle SSH tunnel (Standard) oder Direct (ws/wss).
4. Gib dein SSH target ein (user@host). Falls das Gateway im selben LAN via Bonjour sichtbar ist, kannst du es einfach aus der Liste wählen.
5. Klicke auf Test remote.

Ein Erfolg bedeutet, dass openclaw status --json korrekt ausgeführt wurde. Falls du WhatsApp nutzt, führe einmalig openclaw channels login --verbose direkt auf dem Remote-Host aus, um den QR-Code zu scannen.

Remote Transports im Detail

Du hast die Wahl zwischen zwei Wegen, wie die App mit dem Gateway kommuniziert:

• SSH tunnel: Nutzt ssh -N -L, um den Gateway-Port auf deinen Localhost zu tunneln. Das Gateway sieht die IP des Nodes als 127.0.0.1.
• Direct (ws/wss): Die App verbindet sich direkt mit der Gateway URL (z. B. via Tailscale Serve). Hier sieht das Gateway die echte Client-IP.

Für Benachrichtigungen kannst du Sounds pro Request festlegen. Es gibt keinen globalen Schalter mehr; du steuerst das direkt über das CLI:

openclaw nodes notify --node \<id\> --title "Ping" --body "Remote gateway ready" --sound Glass

Fehlerbehebung

• exit 127 / not found: Das CLI liegt nicht im PATH für non-login Shells. Verlinke openclaw nach /usr/local/bin oder passe /etc/paths an.
• Health probe failed: Prüfe die SSH-Erreichbarkeit und stelle sicher, dass Baileys eingeloggt ist (openclaw status --json).
• Web Chat stuck: Stelle sicher, dass das Gateway remote läuft und der getunnelte Port mit dem Gateway WS Port übereinstimmt.
• Node IP zeigt 127.0.0.1: Das ist beim SSH-Tunnel normales Verhalten. Nutze Direct (ws/wss), wenn du die echte IP benötigst.

Hast du Fragen zur Einrichtung? Nutze unseren AI Setup Assistant.

Nächste Schritte

• Security Guide
• Tailscale Integration