OpenClaw auf deinem System einrichten

Kennst du das? Du willst nur kurz ein neues Tool aufsetzen, aber die Hintergrundprozesse machen Probleme oder die Konfiguration ist unnötig kompliziert. Man verbringt oft mehr Zeit mit dem Debugging der Umgebung als mit dem eigentlichen Projekt.

Besonders bei Services, die stabil im Hintergrund laufen müssen, nervt manuelles Gefrickel. OpenClaw macht das einfacher, solange du dich an die richtigen Tools hältst.

Voraussetzungen

Bevor du startest, stelle sicher, dass du die Voraussetzungen erfüllst:

• Node.js: Das ist das empfohlene Runtime. (Nutze kein Bun für das Gateway, da es dort Bugs mit WhatsApp und Telegram gibt).
• Ein unterstütztes OS: macOS, Linux, Windows (via WSL2), iOS oder Android.
• CLI Zugriff: Du solltest mit dem Terminal vertraut sein.

Schnellstart

OpenClaw core ist in TypeScript geschrieben. Ich empfehle dir Node.js als Runtime für die stabilste Erfahrung. Für das Gateway ist der Wizard der schnellste Weg.

1. Gateway Service installieren

Nutze am besten den Wizard, er nimmt dir die Arbeit ab:

openclaw onboard --install-daemon

Falls du lieber direkt arbeitest, kannst du diesen Befehl nutzen:

openclaw gateway install

2. Status prüfen

Nach der Installation kannst du jederzeit checken, ob alles läuft:

openclaw gateway status

3. Alternative Wege

Wenn du eine bestehende Installation anpassen willst, hast du zwei Optionen:

• openclaw configure ausführen und Gateway service auswählen.
• openclaw doctor nutzen, um den Service zu reparieren oder zu migrieren.

Fehlerbehebung

Falls etwas nicht wie geplant funktioniert, sind hier die Lösungen aus der Dokumentation:

• Probleme mit WhatsApp oder Telegram: Wenn du Bun verwendest, wechsle zu Node.js. Bun wird für das Gateway aktuell nicht empfohlen.
• Service startet nicht: Führe openclaw doctor aus. Das Tool erkennt fehlerhafte Installationen und bietet eine Reparatur an.
• Windows Support: Native Apps für Windows sind in Arbeit. Nutze für das Gateway aktuell am besten WSL2.
• Service Namen finden:
  • Unter macOS findest du den LaunchAgent unter bot.molt.gateway oder bot.molt.<profile>.
  • Unter Linux/WSL2 läuft es als systemd user service unter openclaw-gateway[-<profile>].service.

Hast du spezifische Fragen zu deiner Umgebung? Frag den AI Setup Assistant.

Nächste Schritte

• Getting Started Guide
• Gateway Konfiguration
• Hosting auf Fly.io
• Docker Setup auf Hetzner