Skip to Content
👋 Willkommen bei HowToUseOpenClaw Schnellstart
Erste SchritteErste Schritte

Erste Schritte

Ziel: Dich so schnell wie möglich vom Start bis zum ersten funktionierenden Chat bringen. Wir halten es bewusst einfach.

Der schnellste Weg? Kanal-Setup ganz überspringen – einfach die Control-UI starten:

openclaw dashboard

Damit öffnet sich ein Chat im Browser unter http://127.0.0.1:18789/. Fertig. Du chattest.

Der empfohlene Weg? Den CLI-Onboarding-Assistenten nutzen (openclaw onboard). Er ist interaktiv und übernimmt alles:

  • Modell & Auth (OAuth ist einfacher)
  • Gateway-Konfiguration
  • Kanäle (WhatsApp, Telegram, Discord, was auch immer)
  • Sicherheits-Standards
  • Workspace-Setup + Skills
  • Hintergrunddienst (optional)

Brauchst du mehr Tiefe? Geh zu: Assistent, Setup, Pairing, Sicherheit.

Kurz zur Sandbox: Standardmäßig laufen Gruppenchats in einer Sandbox (sicherer). Soll dein Haupt-Agent auf dem Host laufen? Füge das hinzu:

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/clawd",
        "sandbox": { "mode": "off" }
      }
    }
  }
}

0) Was du brauchst

  • Node.js 22+ — Die einzige harte Voraussetzung
  • pnpm — Optional, aber empfohlen beim Bau aus dem Quellcode
  • Brave Search API-Key — Empfohlen für Websuche: 
    openclaw configure --section web
    Web-Tools-Doku

Plattform-Hinweise:

macOS: Node reicht für CLI + Gateway. Apps bauen? Xcode/CLT holen.

Windows: WSL2 nutzen (Ubuntu ist solide). Native Windows? Ungetestet, eher wackelig – besser WSL2, dann die Linux-Schritte darin. Windows-Anleitung

1) CLI installieren

Mac/Linux in einer Zeile:

curl -fsSL https://molt.bot/install.sh | bash

Windows (PowerShell):

iwr -useb https://molt.bot/install.ps1 | iex

Oder npm/pnpm:

npm install -g openclaw@latest
# oder
pnpm add -g openclaw@latest

Weitere Optionen: Installations-Doku

2) Setup-Assistenten ausführen

Hier läuft alles zusammen:

openclaw onboard --install-daemon

Der Assistent führt dich durch:

  • Gateway-Modus — Lokal oder Remote?
  • Auth — OAuth (einfacher) oder API-Keys. Für Anthropic funktionieren API-Keys am besten. Hast du Claude Code? claude setup-token nutzt dieselben Zugangsdaten.
  • Kanäle — WhatsApp-QR, Telegram-/Discord-Tokens, was du nutzt
  • Hintergrunddienst — Installation als launchd (Mac) oder systemd (Linux/WSL2)
  • Runtime — Node nutzen. Bun? Besser weglassen (bricht WhatsApp/Telegram)
  • Gateway-Token — Wird automatisch erzeugt und in gateway.auth.token gespeichert

Detaillierter Ablauf: Assistenten-Anleitung

Wo deine Auth landet

Deine Zugangsdaten landen hier:

  • Anthropic API-Key — Der Assistent speichert ihn. Oder: claude setup-token, um Claude Code wiederzuverwenden
  • OAuth (Legacy) — ~/.clawdbot/credentials/oauth.json
  • Auth-Profile — ~/.clawdbot/agents/<agentId>/agent/auth-profiles.json

Headless-Server? OAuth zuerst auf dem Laptop durchführen, dann oauth.json auf den Server kopieren. Deutlich einfacher als Browser-Weiterleitungen auf einer Headless-Box.

3) Gateway starten

Wenn der Assistent den Dienst installiert hat, läuft er vermutlich schon. Prüfen:

openclaw gateway status

Manuell starten?

openclaw gateway --port 18789 --verbose

Dashboard: http://127.0.0.1:18789/

Token vorhanden? In den Control-UI-Einstellungen einfügen (wird als connect.params.auth.token gespeichert).

⚠️ Bun + WhatsApp/Telegram = kaputt. Node verwenden.

3.5) Schneller Health-Check

openclaw status
openclaw health
openclaw security audit --deep

Alles grün? Passt. Warnungen? Die Ausgabe sagt dir, was Sache ist.

4) Ersten Kanal verbinden

WhatsApp (sehr einfach)

openclaw channels login

WhatsApp auf dem Handy öffnen → Einstellungen → Verknüpfte Geräte → scannen. Fertig.

WhatsApp-Vollanleitung

Telegram / Discord / andere

Der Assistent übernimmt die Konfiguration. Lieber manuell?

Hinweis Telegram: Die erste DM sendet einen Pairing-Code. Genehmige ihn (nächster Schritt), sonst werden Nachrichten ignoriert.

5) Neue Kontakte genehmigen

Sicherheit zuerst. Fremde können deinen Bot nicht einfach vollspammen. Sie bekommen einen Pairing-Code, du entscheidest:

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <code>

Nicht genehmigen:

openclaw pairing deny whatsapp <code>

Pairing im Detail

6) Aus dem Quellcode bauen?

Für alle, die es selbst machen wollen:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
openclaw onboard --install-daemon

7) Alles testen

Testnachricht senden:

openclaw message send --target +15555550123 --message "yo"

Oder einfach deinem Bot eine DM schicken – auf dem Kanal, den du eingerichtet hast. Er sollte antworten.

Was kommt als Nächstes?

Du bist am Start. Die meisten machen danach:

Fragen? Discord  oder Issue erstellen .

Einrichtungsanleitung