openclaw node: Headless Node Hosts einrichten

Du willst einen Befehl auf einem entfernten Server ausführen, hast aber keine Lust auf komplexe Setups oder schwere Apps auf jeder Maschine. Oft ist es mühsam, den Zugriff zwischen verschiedenen Umgebungen wie Build-Servern oder NAS-Systemen zu koordinieren, ohne die Sicherheit zu opfern.

Ich empfehle dir für dieses Szenario einen headless node host. Er ist die beste Wahl, wenn du Agents auf anderen Maschinen in deinem Netzwerk arbeiten lassen willst, ohne dort eine vollständige macOS Companion App zu installieren.

Voraussetzungen

• Ein laufendes Gateway
• Zugriff auf die Kommandozeile der Zielmaschine

Schnellstart

In weniger als fünf Minuten ist dein Node einsatzbereit. Folge diesen Schritten, um einen Node im Vordergrund zu starten:

1. Node starten: Verbinde dich mit deinem Gateway (Standard-Port ist 18789).

   openclaw node run --host \<gateway-host\> --port 18789

2. Pairing bestätigen: Die erste Verbindung erstellt eine Anfrage auf dem Gateway. Öffne ein neues Terminal auf dem Gateway-Rechner und gib Folgendes ein:

   openclaw nodes pending
   openclaw nodes approve \<requestId\>

Sobald die Freigabe erfolgt ist, kann der Node system.run und system.which auf dieser Maschine ausführen.

Node als Hintergrund-Service

Wenn der Node dauerhaft laufen soll, installiere ihn als Service. Das ist für Server die stabilere Lösung.

openclaw node install --host \<gateway-host\> --port 18789

Du kannst den Service mit diesen Befehlen verwalten:

• openclaw node status
• openclaw node stop
• openclaw node restart
• openclaw node uninstall

Browser-Proxy (Zero-Config)

Ein praktisches Feature: Node hosts bewerben automatisch einen Browser-Proxy, sofern browser.enabled auf dem Node aktiv ist. Dein Agent kann so ohne zusätzliche Konfiguration Browser-Automatisierung auf diesem Node nutzen. Falls du das nicht möchtest, kannst du es in der Konfiguration deaktivieren:

{
  nodeHost: {
    browserProxy: {
      enabled: false,
    },
  },
}

Fehlerbehebung

Verbindung wird nicht hergestellt

Prüfe, ob die Firewall den Port 18789 blockiert oder ob das Gateway erreichbar ist. Falls du TLS nutzt, stelle sicher, dass der Fingerprint korrekt ist:

openclaw node run --host \<gateway-host\> --tls --tls-fingerprint \<sha256\>

Befehle werden abgelehnt

Die Ausführung von system.run wird durch lokale Exec-Freigaben geschützt. Wenn ein Befehl fehlschlägt, prüfe die Berechtigungen in ~/.openclaw/exec-approvals.json oder verwalte sie direkt vom Gateway aus:

openclaw approvals --node <id|name|ip>

Die Konfigurationsdaten des Nodes findest du lokal unter ~/.openclaw/node.json.

---

Du hast spezifische Fragen zu deinem Setup? Nutze den AI Setup Assistant.

Nächste Schritte

• Exec approvals
• Gateway-Konfiguration