OpenClaw Setup: So bringst du dein System an den Start

Kennst du das? Du willst ein neues Tool ausprobieren, aber die Konfiguration verteilt sich über das gesamte System. Sobald das nächste Update kommt, überschreibt es deine mühsam angepassten Prompts oder API-Keys. Das nervt und hält dich vom eigentlichen Coden ab.

Diese Anleitung zeigt dir, wie du OpenClaw so aufsetzt, dass deine Anpassungen sicher bleiben und du trotzdem immer die neuesten Features nutzen kannst. Wir trennen deine persönlichen Daten strikt vom Tool-Code, damit Updates keinen Stress verursachen.

Voraussetzungen

Bevor du startest, stelle sicher, dass diese Tools installiert sind:

• Node.js (Version >=22)
• pnpm
• Docker (optional, nur für Container-Setups oder e2e-Tests)

Quick Start (5 Minuten)

Der schnellste Weg für einen stabilen Workflow führt über die macOS App.

1. Installation: Lade die OpenClaw.app herunter, installiere sie und starte sie über die Menüleiste.
2. Berechtigungen: Gehe die Onboarding-Checkliste durch und bestätige die TCC-Prompts für die nötigen Systemzugriffe.
3. Gateway prüfen: Stelle sicher, dass das Gateway auf Local steht und läuft (die App verwaltet das automatisch).
4. Kanäle verknüpfen: Logge dich in deine Dienste ein (Beispiel WhatsApp):

   openclaw channels login

5. Health Check: Überprüfe, ob alles korrekt konfiguriert ist:

   openclaw health

Hinweis: Falls das Onboarding in deinem Build nicht verfügbar ist, führe zuerst openclaw setup aus, logge dich ein und starte das Gateway manuell mit openclaw gateway.

Tailoring: Deine Anpassungen sichern

Damit deine Konfigurationen Updates überleben, speichert OpenClaw alles Wichtige außerhalb des Repositories. Nutze diese Pfade für deine Anpassungen:

• Config: ~/.openclaw/openclaw.json (JSON oder JSON5)
• Workspace: ~/.openclaw/workspace (Hier liegen deine Skills, Prompts und Memories. Tipp: Mach daraus ein privates Git-Repo.)

Initialisiere das Setup mit:

openclaw setup

Bleeding Edge Workflow

Wenn du direkt am TypeScript Gateway arbeitest und Hot Reload nutzen möchtest, während die macOS App als UI dient, folge diesen Schritten:

1. Dev Gateway starten

pnpm install
pnpm gateway:watch

gateway:watch startet das Gateway neu, sobald du Änderungen am Code vornimmst.

2. macOS App verbinden

Stelle in der OpenClaw.app den Connection Mode auf Local. Die App verbindet sich nun mit dem Gateway, das in deinem Terminal läuft.

3. Verifizieren

In der App sollte der Status “Using existing gateway …” erscheinen. Alternativ prüfst du es über das CLI:

openclaw health

Fehlerbehebung

Hier sind Lösungen für häufige Probleme, die beim Setup auftreten können:

• Falscher Port: Das Gateway nutzt standardmäßig ws://127.0.0.1:18789. Wenn die Verbindung fehlschlägt, prüfe, ob App und CLI denselben Port verwenden.
• Linux Service stoppt: Auf Linux beendet systemd User-Services oft beim Logout. Aktiviere das “Lingering”, damit das Gateway weiterläuft:

  sudo loginctl enable-linger $USER

• Fehlende Credentials: Wenn Logins nicht funktionieren, prüfe die Pfade unter ~/.openclaw/credentials/.
• Status-Check: Nutze immer openclaw health, um die Verbindung zwischen CLI und Gateway zu validieren.

Hängst du fest? Frag den AI Setup Assistant.

Nächste Schritte

• Gateway runbook: Details zu Flags und Ports.
• Gateway configuration: Alle Optionen für deine Config-Datei.
• Discord Setup: Spezifische Einstellungen für Discord-Bots.
• macOS App: Details zum Lifecycle des Gateways.