Zum Inhalt

OpenClaw

Einleitung und Rolle

OpenClaw ist der zweite Agent auf dem VPS. Er läuft neben Hermes als eigener User-Service unter marco und stellt einen Gateway-Prozess bereit. In der Selfhost-Struktur ist OpenClaw außerdem eng mit dem Tailnet-Zugriffsmuster verbunden: Die Route openclaw.marcosudau.com dient als Tailnet-Einstieg beziehungsweise als harmlose Hinweisseite für Besucher außerhalb des Tailnets.

Persistente Daten und Backup-Relevanz

Pfad Bedeutung Backup-Relevanz
/home/marco/.npm-global/lib/node_modules/openclaw/ installierte OpenClaw-Anwendung mittel
/home/marco/.config/systemd/user/openclaw-gateway.service systemd-User-Service hoch
/opt/selfhost/generated/openclaw-error/ statische Hinweis-/Fallback-Seite für Nicht-Tailnet-Zugriffe mittel

Laufzeit, Prozesse und Ports

Unit Prozess Zweck
openclaw-gateway.service node .../openclaw/dist/index.js gateway --port 18789 OpenClaw Gateway
Port Bindung Zweck
127.0.0.1:18789 lokal OpenClaw Gateway
127.0.0.1:18791 lokal ergänzender OpenClaw-Port
100.75.175.62:18789 Tailscale-Adresse Tailnet-Zugriff

Route und Tailnet-Verhalten

Registry-ID Hostname Typ Inhalt
openclaw-tailnet-dashboard openclaw.marcosudau.com static mit Tailnet-Redirect /opt/selfhost/generated/openclaw-error
Besucher Verhalten
aus dem Tailnet temporärer Redirect auf https://dashboard.marcosudau.com{uri}
außerhalb des Tailnets statische OpenClaw-Hinweisseite

Die gleiche Fallback-Seite wird auch für andere Tailnet-only-Routen verwendet.

Zugehörige Dienste und Abhängigkeiten

Abhängigkeit Rolle
systemd --user Prozessverwaltung
Node.js Laufzeit
Tailscale Zugriffserkennung über Quell-IP-Bereiche
Caddy HTTPS-Routen und Tailnet-Logik

Secrets und Umgebungsvariablen

Variable Bedeutung
OPENCLAW_GATEWAY_PORT Gateway-Port 18789
OPENCLAW_SYSTEMD_UNIT Unit-Name
OPENCLAW_SERVICE_VERSION dokumentierte Service-Version

Secret-Werte werden nicht dokumentiert.

Betrieb und Prüfung

systemctl --user status openclaw-gateway.service
ss -tulpn | grep -E ':(18789|18791)'
curl -I https://openclaw.marcosudau.com