Server-Voraussetzungen

Bevor du mit dieser OpenClaw Anleitung startest, brauchst du einen Linux-Server. OpenClaw läuft auf jedem VPS, Root-Server oder sogar einem Raspberry Pi 4. Entscheidend ist, dass dein System die folgenden Mindestanforderungen erfüllt:

Minimum

✅ 1 CPU-Kern
✅ 1 GB RAM
✅ 10 GB Festplatte
✅ Ubuntu 22.04 / Debian 12
✅ Root- oder sudo-Zugang

Empfohlen

⭐ 2 CPU-Kerne
⭐ 2–4 GB RAM
⭐ 20 GB SSD
⭐ Ubuntu 24.04 LTS
⭐ Eigene Domain (optional)

OpenClaw selbst benötigt wenig Ressourcen — der Großteil der KI-Verarbeitung findet über API-Aufrufe bei Anthropic statt. Dein Server dient als Gateway, das Nachrichten empfängt, verarbeitet und Skills ausführt. Für die meisten Nutzer reicht ein günstiger VPS ab 5 € im Monat völlig aus. Mehr Details zu den Kosten findest du auf unserer Kostenübersicht.

Stelle sicher, dass dein Server eine stabile Internetverbindung hat und die Ports 443 (HTTPS) sowie 22 (SSH) erreichbar sind. Falls du einen Managed Server nutzt, prüfe, ob du Node.js selbst installieren darfst.

2

Node.js Installation

OpenClaw basiert auf Node.js und benötigt mindestens Version 18 (empfohlen: Version 22 LTS). Die sauberste Methode ist die Installation über den NodeSource-Repository:

      # System aktualisieren

      sudo apt update && sudo apt upgrade -y

      # Node.js 22.x LTS installieren

      curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

      sudo apt install -y nodejs

      # Version prüfen

      node --version  # → v22.x.x

      npm --version   # → 10.x.x

Alternativ kannst du nvm (Node Version Manager) verwenden, um mehrere Node.js-Versionen parallel zu verwalten. Das ist besonders nützlich, wenn auf dem Server noch andere Anwendungen laufen. Für eine detaillierte Installationsanleitung schau dir unser OpenClaw Tutorial an.

Zusätzlich empfehlen wir die Installation von git und build-essential, da einige npm-Pakete native Kompilierung benötigen:

sudo apt install -y git build-essential

3

OpenClaw Setup

Jetzt wird es spannend: In diesem Abschnitt der OpenClaw Anleitung installierst du die eigentliche Software. OpenClaw wird über npm global installiert:

      # OpenClaw global installieren

      npm install -g openclaw

      # Installation verifizieren

      openclaw --version

      # Workspace initialisieren

      openclaw init

Der Befehl openclaw init erstellt das Arbeitsverzeichnis unter ~/.openclaw/ mit der grundlegenden Ordnerstruktur: workspace/, config/ und logs/. Hier liegen später deine Skills, Konfigurationen und Protokolle.

Falls du die Installation lieber professionell durchführen lassen möchtest, bietet openclaw.jetzt einen Rundum-Service an — von der Servereinrichtung bis zur Messenger-Anbindung. Mehr dazu auf unserer Installationsseite.

Um OpenClaw als Hintergrunddienst laufen zu lassen, empfehlen wir die Einrichtung eines systemd-Services:

      # Gateway als Dienst starten

      openclaw gateway start

      # Status prüfen

      openclaw gateway status

4

Konfiguration (openclaw.json)

Das Herzstück jeder OpenClaw-Installation ist die Datei openclaw.json. Hier definierst du, welches KI-Modell verwendet wird, welche Messenger angebunden sind und welche Berechtigungen gelten. Öffne die Datei mit deinem bevorzugten Editor:

nano ~/.openclaw/openclaw.json

Die wichtigsten Konfigurationsfelder:

model Das KI-Modell (z.B. claude-sonnet-4-20250514). Bestimmt Qualität und Kosten der Antworten.

apiKey Dein Anthropic API-Key. Wird für alle KI-Anfragen benötigt.

channels Array der verbundenen Messenger (Telegram, Signal, WhatsApp).

allowedUsers Liste der berechtigten Nutzer-IDs. Wichtig für die Sicherheit!

skills Konfiguration der aktiven Skills und deren Berechtigungen.

Speichere die Datei und starte den Gateway-Dienst neu, damit die Änderungen wirksam werden. Achte darauf, den API-Key niemals in öffentlichen Repositories zu speichern — weitere Hinweise dazu in unserem Abschnitt Security Basics.

5

Messenger verbinden

Einer der größten Vorteile von OpenClaw: Du kommunizierst über die Messenger, die du ohnehin nutzt. Dieser Teil der OpenClaw Anleitung zeigt dir, wie du die drei wichtigsten Kanäle anbindest.

💬 Telegram

Der am einfachsten einzurichtende Kanal — perfekt für den Start.

Öffne Telegram und suche nach @BotFather
Sende /newbot und vergib einen Namen
Kopiere den Bot-Token
Trage den Token in openclaw.json unter channels.telegram.token ein
Starte den Gateway neu: openclaw gateway restart

🔒 Signal

Für maximale Privatsphäre — erfordert signal-cli als Brücke.

Installiere signal-cli auf deinem Server
Registriere eine Telefonnummer für den Bot
Konfiguriere den Signal-Kanal in openclaw.json
Aktiviere die REST-API von signal-cli

📱 WhatsApp

Über die WhatsApp Business API oder Drittanbieter-Bridges möglich.

Richte einen WhatsApp Business Account ein
Konfiguriere eine Bridge (z.B. über Baileys)
Verbinde die Bridge mit dem OpenClaw-Gateway
Teste die Verbindung mit einer Nachricht

Du kannst auch mehrere Messenger gleichzeitig nutzen — OpenClaw empfängt und beantwortet Nachrichten über alle konfigurierten Kanäle parallel.

6

Erste Skills einrichten

Skills machen OpenClaw mächtig. Sie erweitern die Fähigkeiten deines Assistenten über einfache Konversation hinaus — von der Kalender-Verwaltung über E-Mail-Checks bis hin zu Smart-Home-Steuerung.

In dieser OpenClaw Anleitung erstellen wir einen einfachen Beispiel-Skill. Skills bestehen aus Dateien im Workspace-Verzeichnis, die der KI als Kontext oder als ausführbare Werkzeuge zur Verfügung stehen:

      # Workspace-Verzeichnis

      cd ~/.openclaw/workspace

      # AGENTS.md definiert das Verhalten der KI

      nano AGENTS.md

      # Skill-Ordner erstellen

      mkdir -p skills/wetter

      nano skills/wetter/check-wetter.py

Die Datei AGENTS.md ist besonders wichtig: Sie definiert die Persönlichkeit, Regeln und Prioritäten deines Assistenten. Hier legst du fest, wie die KI auf bestimmte Anfragen reagiert, welche Tools sie nutzen darf und welche Grenzen gelten.

Beliebte Starter-Skills

📧 E-Mail-Benachrichtigungen

📅 Kalender & Termine

🌤 Wetter-Abfragen

📝 Notizen & To-Do-Listen

🏠 Smart-Home-Steuerung

🔍 Web-Recherche

📊 Server-Monitoring

🤖 Workflow-Automatisierung

Detaillierte Anleitungen für jeden Skill findest du in unserem Tutorial-Bereich.

7

Security Basics

Sicherheit ist kein optionaler Schritt — sie ist Pflicht. Da OpenClaw auf deinem eigenen Server läuft und Shell-Befehle ausführen kann, musst du dein System absichern. Diese OpenClaw Anleitung gibt dir die wichtigsten Grundregeln:

🔐 API-Keys schützen

Speichere API-Keys niemals in Git-Repositories. Nutze Umgebungsvariablen oder die verschlüsselte Konfiguration von OpenClaw.

👤 Nutzer einschränken

Konfiguriere allowedUsers in der openclaw.json, damit nur autorisierte Personen Befehle senden können.

🔥 Firewall konfigurieren

Nutze ufw und öffne nur die Ports, die du wirklich brauchst (22, 443). Blockiere alles andere.

🔄 Updates einspielen

Halte dein Betriebssystem, Node.js und OpenClaw aktuell. Sicherheitsupdates solltest du zeitnah installieren.

📋 Logs überwachen

Prüfe regelmäßig die OpenClaw-Logs unter ~/.openclaw/logs/ auf ungewöhnliche Aktivitäten.

Für eine umfassende Sicherheitsanalyse deiner OpenClaw-Installation empfehlen wir unsere Sicherheits-Checkliste. Dort findest du erweiterte Maßnahmen wie Fail2ban-Konfiguration, SSH-Key-only-Access und Container-Isolation.

8

Troubleshooting

Auch mit der besten OpenClaw Anleitung kann mal etwas schiefgehen. Hier sind die häufigsten Probleme und ihre Lösungen:

❌ „Gateway startet nicht"

Prüfe, ob Node.js korrekt installiert ist und der Port nicht belegt ist:

          openclaw gateway status

          lsof -i :3000  # Port-Konflikte prüfen

          journalctl -u openclaw -n 50  # Logs lesen

❌ „Telegram-Bot antwortet nicht"

Häufigste Ursache: Falscher Token oder Bot nicht gestartet.

          # Token verifizieren

          curl https://api.telegram.org/bot<TOKEN>/getMe

          # Gateway-Logs prüfen

          tail -f ~/.openclaw/logs/gateway.log

❌ „API-Fehler: 401 Unauthorized"

Dein Anthropic API-Key ist ungültig oder abgelaufen. Generiere einen neuen Key in der Anthropic Console und aktualisiere die openclaw.json.

❌ „Hoher Speicherverbrauch"

Prüfe mit htop, ob andere Prozesse den RAM belegen. OpenClaw selbst braucht selten mehr als 200 MB. Bei anhaltenden Problemen hilft ein Gateway-Neustart: openclaw gateway restart.

Wenn du trotz dieser Tipps nicht weiterkommst, kannst du die Community im OpenClaw-Forum oder auf GitHub um Hilfe bitten. Oder du nutzt den professionellen Support von openclaw.jetzt.

OpenClaw Anleitung
Vom Setup bis zum ersten Befehl

📋 Inhaltsverzeichnis