OpenClaw in 10 Minuten: Kompletter Setup-Guide

OpenClaw in 10 Minuten ⚡

OpenClaw ist eine self-hosted KI-Assistenten-Plattform die sich mit deinen Messaging-Apps verbindet. Ein Server, 20+ Kanäle, volle Kontrolle über deine Daten. Am Ende dieses Guides hast du einen funktionierenden KI-Assistenten den du vom Handy aus anschreiben kannst.

Voraussetzungen

Anforderung	Details
OS	macOS, Linux oder Windows (WSL2 stark empfohlen)
Node.js	v22 oder neuer (node --version zum Prüfen)
AI Provider Key	Anthropic, OpenAI, Google oder jeder OpenAI-kompatible Anbieter
10 Minuten	Das war’s

Tipp

Kein Node.js? Der Installer kümmert sich automatisch darum auf macOS und Linux. Unter Windows probiert er winget → Chocolatey → Scoop.

Schritt 1: OpenClaw installieren

import { Tabs, TabItem } from ‘@astrojs/starlight/components’;

```bash curl -fsSL https://openclaw.ai/install.sh | bash ``` Installiert Node.js wenn nötig (via Homebrew auf macOS, NodeSource auf Linux), Git wenn's fehlt, und macht einen globalen npm install von OpenClaw. ```powershell iwr -useb https://openclaw.ai/install.ps1 | iex ``` Braucht PowerShell 5+. Installiert Node via winget/Chocolatey/Scoop wenn nötig. ```bash curl -fsSL https://openclaw.ai/install-cli.sh | bash ``` Installiert alles unter `~/.openclaw` mit eigener Node-Runtime. Kein sudo nötig. ```bash npm install -g openclaw@latest ``` Wenn du schon Node 22+ hast und alles selbst managen willst.

Installation verifizieren

openclaw --version

openclaw: command not found?

Das bedeutet meistens, dass npms globales bin-Verzeichnis nicht in deinem PATH ist. Führe npm config get prefix aus — die Binary liegt unter <prefix>/bin/. Füg es zu deiner Shell-PATH hinzu:

# Zu ~/.zshrc oder ~/.bashrc hinzufügen
export PATH="$(npm config get prefix)/bin:$PATH"

Auf Linux, wenn du EACCES-Fehler bekommst, kann der Installer npms Prefix auf ~/.npm-global umstellen. Installer nochmal starten oder manuell:

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

Schritt 2: Onboarding-Wizard starten

openclaw onboard --install-daemon

Der Wizard führt dich durch alles:

1. Auth — Wähl deinen AI Provider und paste deinen API Key (oder OAuth für Anthropic). Unterstützt OpenAI, Anthropic, Google und jeden OpenAI-kompatiblen Endpoint.
2. Workspace — Richtet ~/.openclaw/workspace/ ein mit Starter-Dateien (SOUL.md, AGENTS.md, USER.md).
3. Gateway — Konfiguriert den lokalen Server (Standard-Port 18789).
4. Channels — WhatsApp, Telegram, Discord, Signal, Slack und mehr verbinden.
5. Daemon — Installiert einen LaunchAgent (macOS) oder systemd User Unit (Linux) damit OpenClaw automatisch startet.
6. Skills — Installiert empfohlene Skills und optionale Dependencies.

QuickStart vs Advanced

Der Wizard defaultet zu QuickStart mit vernünftigen Defaults (lokales Gateway, Token Auth, Standard-Ports). Wähl Advanced wenn du volle Kontrolle über jede Einstellung willst.

Modellauswahl ist wichtig

Nimm das stärkste verfügbare Modell für die beste Experience. Claude Opus oder GPT-4o sind empfohlen. Schwächere Modelle sind anfälliger für Prompt Injection bei externem Content (E-Mails, Webhooks).

Schritt 3: Gateway verifizieren

Wenn du --install-daemon benutzt hast, sollte das Gateway schon laufen:

openclaw gateway status

Du solltest das Gateway auf Port 18789 laufen sehen. Du kannst es auch sofort testen ohne Channel-Setup:

openclaw dashboard

Das öffnet die Control UI im Browser unter http://127.0.0.1:18789/ — du kannst dort direkt mit deinem Agent chatten.

Ohne Daemon laufen

Für schnelle Tests oder Troubleshooting, starte das Gateway im Vordergrund:

openclaw gateway --port 18789

Schritt 4: Channel verbinden

Telegram (am einfachsten)

1. Öffne @BotFather auf Telegram
2. Sende /newbot und folge den Anweisungen
3. Kopiere den Bot-Token (sieht aus wie 123456:ABC-DEF...)
4. Paste ihn wenn der Wizard fragt — oder füg ihn später hinzu:

   openclaw configure --section channels

5. Schreib deinem Bot auf Telegram

WhatsApp

1. Der Wizard (oder openclaw channels login --channel whatsapp) zeigt einen QR-Code
2. Öffne WhatsApp auf deinem Handy → Einstellungen → Verknüpfte Geräte → Gerät verknüpfen
3. QR-Code scannen
4. Fertig — dein Assistent ist live auf WhatsApp

Discord

1. Geh zu discord.com/developers → Neue Anwendung
2. Geh zu Bot → Token zurücksetzen → kopieren
3. Message Content Intent aktivieren unter Privileged Gateway Intents (erforderlich!)
4. Geh zu OAuth2 → URL Generator → bot Scope wählen → Berechtigungen wählen → auf deinen Server einladen
5. Token im Wizard einfügen

Andere Kanäle

OpenClaw unterstützt 20+ Kanäle: Signal, Slack, Google Chat, iMessage, Matrix, Mattermost, IRC, Line, Nostr und mehr. Führe openclaw configure --section channels aus um einen davon hinzuzufügen.

Schritt 5: Erste Nachricht senden

Öffne deine Messaging-App und schreib deinem Bot irgendwas:

“Hey, was kannst du?”

Dein KI-Assistent antwortet. Out of the box kann er:

• 🔍 Web durchsuchen (richte einen Brave Search API Key ein via openclaw configure --section web für beste Ergebnisse)
• 📁 Dateien lesen und schreiben auf deinem Rechner
• 🖥️ Shell-Commands ausführen
• ⏰ Erinnerungen und Cron Jobs setzen
• 🌐 Einen Webbrowser steuern
• 📷 Kameras nutzen (mit gepaarten Mobile Nodes)
• 🎤 Sprachgespräche (macOS/iOS/Android)
• 📊 Sessions managen und Sub-Agents spawnen

Schritt 6: Mach ihn zu deinem

Die echte Power steckt in den Workspace-Dateien unter ~/.openclaw/workspace/. Das sind nicht einfach Config-Dateien — das ist das Gehirn deines Agents.

SOUL.md — Persönlichkeit & Grenzen

Definiert wer dein Agent ist. Ton, Werte, was er tut und nicht tut.

# Wer du bist

Sei echt hilfreich, nicht performativ hilfreich.
Lass das "Gute Frage!" weg — hilf einfach.

Hab Meinungen. Ein Assistent ohne Persönlichkeit
ist nur eine Suchmaschine mit extra Schritten.

Sei einfallsreich bevor du fragst. Versuch es rauszufinden.
Lies die Datei. Such danach. Dann frag wenn du nicht weiterkommst.

👉 Ausführlicher Guide: Die perfekte SOUL.md

AGENTS.md — Arbeitsanweisungen

Wie dein Agent Tasks, Memory, Tools und Kommunikation handhabt. Das ist das Playbook.

USER.md — Wer du bist

Erzähl deinem Agent von dir, damit er kontextuell hilfreich sein kann:

# Über dich
- **Name:** Alex
- **Zeitzone:** Europe/Berlin
- **Notizen:** Führt ein Startup. Zeit ist knapp.
  Kurze Nachrichten = volle Erwartung.

IDENTITY.md — Name & Avatar

Name, Emoji und Vibe deines Agents. Wird während des Bootstrap-Rituals erstellt.

Troubleshooting

openclaw doctor

Starte das eingebaute Diagnose-Tool:

openclaw doctor

Prüft deine Installation, Config, Credentials und häufige Probleme.

Häufige Probleme

Problem	Lösung
openclaw: command not found	npm bin-Verzeichnis zum PATH hinzufügen (siehe Schritt 1)
Gateway startet nicht	Prüfen ob Port 18789 belegt ist: lsof -i :18789
WhatsApp QR-Code abgelaufen	openclaw channels login --channel whatsapp nochmal starten
spawn git ENOENT auf Windows	Git für Windows installieren, PowerShell neu öffnen
sharp/libvips Build-Fehler	SHARP_IGNORE_GLOBAL_LIBVIPS=1 setzen (Installer macht das standardmäßig)
Extra Workspace-Verzeichnisse	Nur ein aktives Workspace behalten. openclaw doctor warnt vor Extras. Alte mit trash ~/openclaw entfernen
EACCES bei npm install (Linux)	Installer kann das fixen. Oder manuell: npm config set prefix ~/.npm-global

Umgebungsvariablen

Falls du eigene Pfade brauchst:

• OPENCLAW_HOME — Home-Verzeichnis für interne Pfadauflösung
• OPENCLAW_STATE_DIR — State-Verzeichnis überschreiben
• OPENCLAW_CONFIG_PATH — Config-Dateipfad überschreiben

Wie weiter?

• Die perfekte SOUL.md — Gib deinem Agent echte Persönlichkeit
• 5 Automationen die Stunden sparen — Cron Jobs, Heartbeats, E-Mail-Monitoring
• Multi-Agent Routing — Ein Bot pro Kanal
• Starter Kits — Vorkonfigurierte Setups für spezifische Workflows

---

Probleme? Starte openclaw doctor um häufige Probleme zu diagnostizieren, oder schau in die OpenClaw Docs.

---

Willst du das komplette Setup?

Schau dir unsere Industry Playbooks an — schlüsselfertige Configs für Immobilien, IT Consulting und Freelancer.