Erste Schritte

Ziel: von null zum ersten funktionierenden Chat mit minimalem Aufwand.

Info: Schnellster Weg zum Chat: Offne die Control UI (kein Channel-Setup notig). Fuhre openclaw dashboard aus und chatte im Browser, oder offne http://127.0.0.1:18789/ auf dem Gateway-Host (die Maschine, auf der der OpenClaw-Gateway-Service lauft). Docs: Dashboard und Control UI.

Voraussetzungen

Node 24 empfohlen (Node 22 LTS, aktuell 22.16+, wird aus Kompatibilitatsgrunden weiterhin unterstutzt)

Tipp: Prufe deine Node-Version mit node --version, falls du dir unsicher bist.

Quick Setup (CLI)

Schritt 1: OpenClaw installieren (empfohlen)

  #### macOS/Linux
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img

src=“https://cdn.openclaws.io/public/docs/assets/install-script.svg” alt=“Install Script Process” class=“rounded-lg” />

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



> **Hinweis:** Weitere Installationsmethoden und Anforderungen: [Installieren](/docs/install).

Schritt 2: Den Onboarding-Wizard starten

```bash
openclaw onboard --install-daemon
```

Der Wizard konfiguriert Auth, Gateway-Einstellungen und optionale Channels.
Details findest du unter [Onboarding-Wizard](/docs/start/wizard).

Schritt 3: Gateway prufen

Wenn du den Service installiert hast, sollte er bereits laufen:

```bash
openclaw gateway status
```

Schritt 4: Control UI offnen

```bash
openclaw dashboard
```

Check: Wenn die Control UI ladt, ist dein Gateway einsatzbereit.

Optionale Prufungen und Extras

Gateway im Vordergrund starten

Praktisch fur schnelle Tests oder Troubleshooting.

```bash
openclaw gateway --port 18789
```

Testnachricht senden

Setzt einen konfigurierten Channel voraus.

```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```

Nutzliche Umgebungsvariablen

Wenn du OpenClaw als Service-Account betreibst oder eigene Config-/State-Pfade verwenden willst:

OPENCLAW_HOME setzt das Home-Verzeichnis fur die interne Pfadauflosung.
OPENCLAW_STATE_DIR uberschreibt das State-Verzeichnis.
OPENCLAW_CONFIG_PATH uberschreibt den Pfad zur Config-Datei.

Vollstandige Referenz der Umgebungsvariablen: Umgebungsvariablen.

Tiefer einsteigen

Onboarding-Wizard (Details) — Vollstandige CLI-Wizard-Referenz und erweiterte Optionen.
macOS-App-Onboarding — First-Run-Flow fur die macOS-App.

Was du danach hast

Ein laufendes Gateway
Auth konfiguriert
Zugang zur Control UI oder ein verbundener Channel

Nachste Schritte

DM-Sicherheit und Freigaben: Pairing
Weitere Channels anbinden: Channels
Erweiterte Workflows und From-Source-Setup: Setup