OpenClaw einrichten: Schritt-für-Schritt Anleitung

Überblick: Was du brauchst

OpenClaw ist ein selbst gehosteter KI-Assistent, der auf deinem eigenen Server läuft. Für die Einrichtung brauchst du einen VPS (ab €5/Monat), einen API-Key von Anthropic oder OpenAI und grundlegende Terminal-Kenntnisse. Die gesamte Installation dauert 2–8 Stunden, abhängig von deiner Erfahrung.

Falls du noch nicht sicher bist, ob OpenClaw das Richtige für dich ist, lies zuerst unseren Artikel Was ist OpenClaw? Für einen Kostenüberblick: Was kostet OpenClaw?

Schritt 1: Server mieten

Du brauchst einen Linux-Server mit mindestens 2 vCPU-Kernen und 4 GB RAM. Hetzner ist der beliebteste Anbieter in der OpenClaw-Community: günstig, schnell, Rechenzentren in Deutschland.

Empfohlene Anbieter

Unsere Empfehlung: Hetzner CX22. Bestes Preis-Leistungs-Verhältnis, Rechenzentren in Falkenstein und Nürnberg (Deutschland), schnelle Bereitstellung.

1. Gehe auf hetzner.com/cloud und erstelle einen Account
2. Erstelle ein neues Projekt (z.B. "OpenClaw")
3. Klicke auf Server hinzufügen
4. Wähle: Standort: Falkenstein oder Nürnberg • Image: Ubuntu 24.04 • Typ: CX22
5. Füge deinen SSH-Key hinzu (oder notiere das Root-Passwort)
6. Klicke auf Server erstellen

Dein Server ist in ca. 30 Sekunden bereit. Notiere die IP-Adresse — du brauchst sie im nächsten Schritt.

Schritt 2: SSH-Zugang einrichten

SSH (Secure Shell) ist die sichere Verbindung zu deinem Server. Du brauchst es für die gesamte Installation. Auf macOS und Linux ist SSH vorinstalliert, auf Windows nutzt du PowerShell oder PuTTY.

Verbindung herstellen

Öffne dein Terminal (macOS: Terminal.app, Windows: PowerShell) und tippe:

ssh root@DEINE_SERVER_IP

Ersetze DEINE_SERVER_IP durch die IP-Adresse aus Schritt 1. Beim ersten Verbinden wirst du gefragt, ob du dem Server vertraust — tippe yes.

Sicheren Benutzer anlegen

Arbeite nicht dauerhaft als root. Erstelle einen eigenen Benutzer:

# Benutzer anlegen
adduser openclaw
usermod -aG sudo openclaw

# SSH-Key für neuen Benutzer kopieren
mkdir -p /home/openclaw/.ssh
cp ~/.ssh/authorized_keys /home/openclaw/.ssh/
chown -R openclaw:openclaw /home/openclaw/.ssh

# Ab jetzt als openclaw einloggen:
ssh openclaw@DEINE_SERVER_IP

Schritt 3: OpenClaw installieren

Die Installation von OpenClaw erfolgt über npm (Node Package Manager). Du installierst zuerst Node.js, dann OpenClaw selbst. Der gesamte Prozess dauert ca. 5 Minuten.

Node.js installieren

# System aktualisieren
sudo apt update && sudo apt upgrade -y

# Node.js 22 LTS installieren (empfohlen)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Prüfen
node --version   # sollte v22.x.x zeigen
npm --version    # sollte 10.x.x zeigen

OpenClaw installieren

# OpenClaw global installieren
sudo npm install -g openclaw

# Prüfen
openclaw --version

Als Dienst einrichten (systemd)

Damit OpenClaw automatisch startet und nach Crashes neustartet:

# OpenClaw als Gateway-Dienst starten
openclaw gateway start

# Status prüfen
openclaw gateway status

# Logs anschauen
openclaw gateway logs

Schritt 4: API-Key einrichten

OpenClaw braucht einen API-Key, um mit KI-Modellen zu kommunizieren. Wir empfehlen Claude von Anthropic — Stand 2026 das beste Modell für agentenbasierte Aufgaben. Die Registrierung ist kostenlos, du zahlst nur nach Verbrauch.

Anthropic API-Key erstellen

1. Gehe auf console.anthropic.com
2. Erstelle einen Account (E-Mail + Verifizierung)
3. Klicke auf API Keys → Create Key
4. Kopiere den Key — er wird nur einmal angezeigt!
5. Hinterlege eine Zahlungsmethode (Kreditkarte)
6. Setze ein Budget-Limit (z.B. €30/Monat) unter Billing → Limits

Alternative: OpenAI (GPT-4)

Wenn du lieber GPT-4 nutzen willst:

1. Gehe auf platform.openai.com
2. Erstelle einen Account und hinterlege eine Zahlungsmethode
3. Unter API Keys → Create new secret key
4. Kopiere den Key

Schritt 5: Konfiguration (config.yaml)

Die config.yaml ist das Herzstück deiner OpenClaw-Installation. Hier definierst du welches KI-Modell genutzt wird, welche Messaging-Kanäle aktiv sind und wie sich dein Assistent verhält. OpenClaw erstellt beim ersten Start eine Vorlage, die du anpasst.

# Konfiguration öffnen
openclaw config edit

# Oder direkt die Datei bearbeiten:
nano ~/.openclaw/config.yaml

Minimale Konfiguration

# ~/.openclaw/config.yaml

# KI-Modell
ai:
  provider: anthropic
  model: claude-sonnet-4-20250514
  apiKey: sk-ant-DEIN_API_KEY_HIER

# Gateway
gateway:
  token: DEIN_SICHERES_TOKEN    # Wähle ein langes, zufälliges Passwort

# Messaging (WhatsApp Beispiel — Details in Schritt 7)
channels:
  whatsapp:
    enabled: true

Schritt 6: Persönlichkeit definieren (SOUL.md)

Die SOUL.md ist das Besondere an OpenClaw: Hier definierst du, wer dein Assistent ist. Name, Tonfall, Verhaltensregeln, Grenzen — alles in einer Markdown-Datei. Das macht OpenClaw einzigartig: Dein Assistent wird über Zeit zu deinem Assistenten.

# SOUL.md — Wer bist du?

## Name
Mein Name ist Atlas.

## Persönlichkeit
- Freundlich, aber direkt
- Duzt den Nutzer
- Antwortet auf Deutsch
- Kurz und knapp, außer wenn Details gefragt sind

## Aufgaben
- E-Mails zusammenfassen und priorisieren
- An Termine erinnern
- Web-Recherchen durchführen
- Proaktiv morgens ein Briefing senden

## Grenzen
- Keine E-Mails ohne Bestätigung senden
- Keine Käufe tätigen
- Private Inhalte nicht in Gruppen teilen

Schritt 7: WhatsApp anbinden

WhatsApp ist der beliebteste Messaging-Kanal für OpenClaw. Die Anbindung funktioniert über WhatsApp Web — du scannst einen QR-Code, genau wie auf deinem Desktop. Ab dann ist dein Assistent per WhatsApp erreichbar. Mehr Details in unserem WhatsApp-Guide.

1. Stelle sicher, dass WhatsApp in der config.yaml aktiviert ist
2. Starte OpenClaw: openclaw gateway start
3. OpenClaw zeigt einen QR-Code im Terminal
4. Öffne WhatsApp auf deinem Smartphone → Verknüpfte Geräte → Gerät verknüpfen
5. Scanne den QR-Code
6. Fertig! Schreib dir selbst eine Nachricht — dein Assistent antwortet

Schritt 8: Telegram anbinden (Alternative)

Telegram ist die stabilste Messaging-Option für OpenClaw. Im Gegensatz zu WhatsApp nutzt Telegram eine offizielle Bot-API — keine QR-Code-Scans, keine Verbindungsabbrüche. Ausführlicher Guide: OpenClaw mit Telegram.

1. Öffne Telegram und suche nach @BotFather
2. Schreibe /newbot und folge den Anweisungen
3. Du bekommst einen Bot-Token (Format: 123456789:ABCdef...)
4. Füge den Token in deine config.yaml ein:

channels:
  telegram:
    enabled: true
    token: "DEIN_BOT_TOKEN"
    allowFrom:
      - DEINE_TELEGRAM_USER_ID

Telegram User ID finden: Schreibe /start an den Bot @userinfobot — er antwortet mit deiner ID.

Schritt 9: Skills aktivieren

Skills erweitern deinen Assistenten um konkrete Fähigkeiten: E-Mail lesen, Kalender verwalten, im Web suchen, Code ausführen. Eine Übersicht aller verfügbaren Skills findest du unter OpenClaw Skills.

Basis-Skills (sofort verfügbar)

• Web-Suche — Recherchiert im Internet (Brave Search)
• Web-Fetch — Liest Webseiten und extrahiert Inhalte
• Code-Ausführung — Führt Skripte und Befehle aus
• Dateisystem — Liest und schreibt Dateien
• Cron/Timer — Geplante Aufgaben und Erinnerungen

Erweiterte Skills (Konfiguration nötig)

• Gmail/Outlook — E-Mail-Zugriff (OAuth-Setup nötig)
• Google Calendar — Termine verwalten
• Browser — Webseiten wie ein Mensch bedienen
• TTS (Text-to-Speech) — Sprachnachrichten senden
• Smart Home — Home Assistant Integration

# Skills werden in der config.yaml aktiviert:
skills:
  web_search:
    enabled: true
    braveApiKey: "DEIN_BRAVE_API_KEY"    # Kostenlos bei brave.com/search/api
  gmail:
    enabled: true
    # OAuth-Setup über: openclaw skill setup gmail

Schritt 10: Server absichern

Dein OpenClaw-Server hat Zugang zu deinen E-Mails, Kalendern und möglicherweise deinem Smart Home. Sicherheit ist kein optionaler Schritt — sie ist Pflicht. Ausführlicher Guide: OpenClaw Sicherheit.

Minimale Absicherung (Pflicht!)

# 1. Firewall aktivieren (nur SSH + HTTPS)
sudo ufw allow OpenSSH
sudo ufw allow 443/tcp
sudo ufw enable

# 2. SSH absichern: Root-Login deaktivieren
sudo sed -i 's/PermitRootLogin yes/PermitRootLogin no/' /etc/ssh/sshd_config
sudo systemctl restart sshd

# 3. Automatische Sicherheitsupdates aktivieren
sudo apt install unattended-upgrades -y
sudo dpkg-reconfigure -plow unattended-upgrades

# 4. Fail2Ban installieren (blockiert Brute-Force-Angriffe)
sudo apt install fail2ban -y
sudo systemctl enable fail2ban

Schritt 11: Der erste Chat

Alles eingerichtet? Dann schreib deinem Assistenten die erste Nachricht! OpenClaw startet automatisch ein Onboarding-Gespräch, in dem ihr gemeinsam Name, Persönlichkeit und Aufgaben festlegt.

Öffne WhatsApp (oder Telegram) und schreibe:

Dein Assistent wird sich vorstellen und dich durch das Setup führen:

• Name wählen — Wie soll der Assistent heißen?
• Sprache & Tonfall — Deutsch, Du/Sie, formal/locker?
• Aufgaben definieren — Wofür brauchst du ihn?
• Grenzen setzen — Was darf er nicht tun?

Häufige Probleme & Lösungen

Die OpenClaw-Einrichtung läuft nicht immer glatt. Hier sind die häufigsten Probleme und wie du sie löst. Ausführlicher Troubleshooting-Guide: OpenClaw Probleme & Lösungen.

❌ "npm install -g openclaw" schlägt fehl

# Häufigste Ursache: Berechtigungen
sudo chown -R $(whoami) ~/.npm
npm install -g openclaw

# Oder mit sudo:
sudo npm install -g openclaw

❌ WhatsApp QR-Code wird nicht angezeigt

# Prüfe ob OpenClaw läuft:
openclaw gateway status

# Logs anschauen:
openclaw gateway logs

# Neustart:
openclaw gateway restart

❌ API-Key wird nicht akzeptiert

• Prüfe ob der Key korrekt kopiert wurde (keine Leerzeichen am Anfang/Ende)
• Prüfe ob eine Zahlungsmethode hinterlegt ist (Anthropic erfordert das)
• Prüfe ob das Budget-Limit nicht bereits erreicht ist

❌ Assistent antwortet nicht

• Logs prüfen: openclaw gateway logs
• allowFrom checken: Ist deine Telefonnummer/User-ID in der config.yaml eingetragen?
• API-Limit: Wurde das monatliche Budget überschritten?
• Neustart: openclaw gateway restart

❌ Hohe API-Kosten

• Modell wechseln: Claude Haiku ist 10x günstiger als Opus
• Heartbeat-Frequenz senken: Weniger proaktive Checks = weniger Kosten
• Budget-Limit setzen: Bei Anthropic und OpenAI möglich

Profi-Tipps zur Optimierung

OpenClaw läuft? Hier sind Tipps, um das Maximum rauszuholen.

🧠 Memory richtig nutzen

OpenClaw hat ein Langzeitgedächtnis (MEMORY.md). Je besser du es pflegst, desto nützlicher wird dein Assistent:

• Sag deinem Assistenten wichtige Dinge: "Merk dir: Mein Steuerberater heißt Schmidt, Tel. 0711-123456"
• Er speichert das automatisch und erinnert sich in zukünftigen Gesprächen
• Regelmäßig aufräumen: "Welche Erinnerungen hast du über mich? Lösch die veralteten."

⚡ Modell-Mix für Kostenersparnis

Nutze verschiedene Modelle für verschiedene Aufgaben:

• Claude Haiku für einfache Aufgaben (Erinnerungen, kurze Antworten) — günstig
• Claude Sonnet für Standardaufgaben — bestes Preis-Leistungs-Verhältnis
• Claude Opus für komplexe Aufgaben (Analyse, Code-Review) — teuer, aber top

🔄 Heartbeats einrichten

Heartbeats lassen deinen Assistenten proaktiv arbeiten — auch wenn du nicht chattest:

• Morgens E-Mail-Zusammenfassung senden
• Termine für den Tag ankündigen
• Wetter checken, wenn du Außentermine hast

📱 Zweite Nummer für den Assistenten

Eine eigene Telefonnummer für deinen Assistenten (Prepaid-SIM für ~€5) macht die Nutzung natürlicher: Du schreibst ihm wie einem Kontakt, statt dir selbst. Bonus: Andere können deinem Assistenten auch schreiben (wenn du das willst).

Alternative: GermanClaw — sofort einsatzbereit

Kein Bock auf Server-Admin? Wir machen das. GermanClaw ist der Managed OpenClaw Service für den DACH-Raum: Wir übernehmen Setup, Hosting, Sicherheit, Updates und Support — du chattest einfach los.

Häufige Fragen zur Einrichtung