So installieren Sie OpenClaw 2026

Bevor Sie OpenClaw installieren, stellen Sie sicher, dass Ihr Server die Mindestanforderungen erfüllt. Wer darunter bleibt, riskiert langsame Antworten, abgestürzte Prozesse und frustrierte Nutzer.

Außerdem benötigen Sie

• SSH-Zugriff auf Ihren Server. Wenn Sie ssh root@ihre-server-ip ausführen können, sind Sie bereit.
• Einen API-Schlüssel für ein KI-Modell von Anthropic, OpenAI, Google oder einem lokalen Modell via Ollama. Besorgen Sie sich einen, bevor Sie starten.
• Einen Domainnamen (optional). Nicht erforderlich, aber empfohlen für SSL und saubere Webhook-URLs.

Der schnellste Weg, OpenClaw zu installieren. Ein einziger Befehl erledigt alles: Abhängigkeitsprüfung, Downloads, Konfigurationsassistent und Service-Setup. Funktioniert auf Ubuntu, Debian, CentOS, Fedora, Arch und macOS.

curl -fsSL https://openclaw.sh | bash

Was der Installer macht

Erwartete Ausgabe

[info] Detecting OS... Ubuntu 22.04 (x86_64)
[info] Node.js v20.18.1 found
[info] Installing pnpm...
[info] Downloading OpenClaw v2026.3.8...
[info] Running configuration wizard...
   → AI Provider: anthropic
   → Model: claude-sonnet-4-5
   → Port: 3100
[ok]   OpenClaw is running at http://localhost:3100
       Dashboard: http://localhost:3100/dashboard

Benutzerdefinierte Flags

Übergeben Sie Flags, um die Installation ohne interaktiven Assistenten anzupassen.

# Skip the wizard with pre-set values
curl -fsSL https://openclaw.sh | bash -s -- \
  --provider anthropic \
  --model claude-sonnet-4-5 \
  --port 3100 \
  --no-systemd

Ideal für Entwickler, die volle Kontrolle über jeden Schritt wollen. Diese Methode macht jeden Schritt explizit sichtbar.

Schritt 1 — Node.js 20+ installieren

OpenClaw benötigt Node.js 20 oder höher. Prüfen Sie zuerst Ihre Version.

node --version
# If below v20, install via nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

Schritt 2 — pnpm installieren

npm install -g pnpm

Schritt 3 — OpenClaw global installieren

pnpm install -g openclaw
# Or with npm:
npm install -g openclaw

Schritt 4 — Konfiguration initialisieren

Der init-Befehl erstellt eine .env-Datei und ein data/-Verzeichnis im aktuellen Ordner.

mkdir ~/openclaw && cd ~/openclaw
openclaw init

Schritt 5 — .env-Datei bearbeiten

# ~/openclaw/.env
OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
# Or for OpenAI:
# AI_PROVIDER=openai
# AI_MODEL=gpt-5
# OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

Schritt 6 — OpenClaw starten

openclaw start
# Or run in background:
openclaw start --daemon

Docker isoliert OpenClaw vom Hostsystem. Updates sind einfach: neues Image pullen und neu starten. Diese Methode ist ideal für Produktionsserver und Teams.

Schritt 1 — Docker installieren

# Ubuntu / Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in for group changes to take effect

Schritt 2 — docker-compose.yml erstellen

version: "3.8"

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3100:3100"
    volumes:
      - ./data:/app/data        # Persistent memory & databases
      - ./config:/app/config    # Configuration files
      - ./.env:/app/.env        # Environment variables
    environment:
      - NODE_ENV=production
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3100/health"]
      interval: 30s
      timeout: 10s
      retries: 3

Schritt 3 — .env-Datei erstellen

OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Optional: Enable persistent memory
MEMORY_ENABLED=true
MEMORY_PROVIDER=sqlite

# Optional: WhatsApp channel
WHATSAPP_ENABLED=false
WHATSAPP_PHONE_ID=
WHATSAPP_TOKEN=

Schritt 4 — Container starten

docker compose up -d

# Check the logs
docker compose logs -f openclaw

Aktualisieren mit Docker

docker compose pull
docker compose up -d

Bauen Sie aus dem Quellcode, wenn Sie Kernverhalten anpassen, Upstream beitragen oder einen Pre-Release-Branch laufen lassen möchten. Dieser Weg setzt Entwicklererfahrung voraus.

Schritt 1 — Repository klonen

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Schritt 2 — Abhängigkeiten installieren

# Requires Node.js 20+ and pnpm
pnpm install

Schritt 3 — Umgebungsdatei kopieren und bearbeiten

cp .env.example .env
nano .env
# Set your AI_PROVIDER, API keys, and port

Schritt 4 — Bauen und starten

pnpm build
pnpm start

# For development with hot reload:
pnpm dev

Aus dem Quellcode aktualisieren

git pull origin main
pnpm install
pnpm build
# Restart your OpenClaw process or service

OpenClaw läuft. Konfigurieren Sie jetzt Ihr KI-Modell, verbinden Sie einen Messaging-Kanal und prüfen Sie, dass alles funktioniert.

Ihr KI-Modell konfigurieren

OpenClaw unterstützt mehrere KI-Anbieter. Legen Sie Ihr bevorzugtes Modell in der .env-Datei oder über das Dashboard fest.

# Example: Switch to Claude Opus 4.6
AI_PROVIDER=anthropic
AI_MODEL=claude-opus-4-6
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Example: Use a local model via Ollama
AI_PROVIDER=ollama
AI_MODEL=llama4:8b
OLLAMA_HOST=http://localhost:11434

Ihren ersten Kanal einrichten (Beispiel: WhatsApp)

OpenClaw unterstützt 191+ Integrationen. WhatsApp ist der beliebteste Einstieg. So verbinden Sie ihn.

WHATSAPP_ENABLED=true
WHATSAPP_PHONE_ID=123456789012345
WHATSAPP_TOKEN=EAAxxxxxxxxxxxxxxxx
WHATSAPP_VERIFY_TOKEN=your-random-verify-string

openclaw restart
# Or with Docker:
docker compose restart openclaw

Ihre erste Nachricht senden

Öffnen Sie WhatsApp und senden Sie „Hallo" an Ihre verbundene Nummer. Sie sollten innerhalb von 2 bis 5 Sekunden eine Antwort erhalten. Falls WhatsApp nicht konfiguriert ist, testen Sie über das Dashboard.

# Quick test via CLI
curl -X POST http://localhost:3100/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, what can you do?"}'

Eine erfolgreiche Antwort liefert JSON mit der Antwort der KI. Falls ein Fehler auftritt, prüfen Sie den Abschnitt zur Fehlerbehebung unten.

Die meisten Installationsprobleme fallen in fünf Kategorien. So beheben Sie jede davon.

# Find what is using port 3100
sudo lsof -i :3100

# Option A: Kill the process
sudo kill -9 <PID>

# Option B: Change OpenClaw's port
# In .env, set:
OPENCLAW_PORT=3200

# Check your current version
node --version

# If below v20, upgrade with nvm:
nvm install 20
nvm alias default 20
nvm use 20

# Verify
node --version  # Should show v20.x.x or higher

# Add your user to the docker group
sudo usermod -aG docker $USER

# Log out and back in, then verify:
docker ps
# If you still get errors, restart the Docker service:
sudo systemctl restart docker

# Install Certbot and get a free Let's Encrypt certificate
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com

# Auto-renewal is configured automatically
# Test renewal:
sudo certbot renew --dry-run

# Check available memory
free -h

# Option A: Add swap space (quick fix)
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Option B: Upgrade your VPS to 4+ GB RAM

# Option C: Use a lighter AI model
# In .env, switch from Opus to Haiku:
AI_MODEL=claude-haiku-4-5

Eine laufende OpenClaw-Instanz ohne Sicherheit ist ein Risiko. Studien zeigen, dass 93,4 % der öffentlichen Instanzen keine grundlegende Authentifizierung haben und 42.665 offen im Internet stehen. Werden Sie keine Statistik.

# Quick firewall setup (Ubuntu/Debian)
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp    # SSH
sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw enable

# Verify
sudo ufw status