Gilt für OpenClaw v2026.2 | Dieser Artikel setzt eine Node.js >= 22 Umgebung und einen AI API Key (empfohlen: Anthropic Claude) voraus.

TL;DR: OpenClaw-Installation in 5 Minuten. Unterstützt npm/pnpm/bun/Docker — empfohlen: npm install -g openclaw@latest && openclaw onboard. Die Konfigurationsdatei befindet sich unter ~/.openclaw/openclaw.json, Start über openclaw gateway. Deckt Docker-Deployment, Konfigurationsdateistruktur und häufige Fehlerbehebung ab.

Voraussetzungen

Erforderliche Umgebung

Empfohlene Umgebung

AI API Key

OpenClaw benötigt eine Verbindung zu einem KI-Modell. Empfohlene Anbieter:

💡 Empfehlung: Anthropic Claude Opus 4.6 bietet die beste Langkontext-Verarbeitung und Prompt-Injection-Abwehr.

Umgebungsprüfung

# Node.js-Version prüfen
node --version
# Beispielausgabe: v22.12.0

# npm-Version prüfen
npm --version
# Beispielausgabe: 10.9.0

# Systeminformationen prüfen
uname -a  # Linux/macOS
# oder
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"  # Windows

Installationsmethoden im Vergleich

flowchart TB
    A[Installationsmethode wählen] --> B{Anwendungsfall?}
    B -->|Schnellstart| C[npm globale Installation]
    B -->|Tägliche Nutzung| D[pnpm/bun Installation]
    B -->|Produktions-Deployment| E[Docker Deployment]
    B -->|Entwicklung/Beitrag| F[Aus Quellcode bauen]
    
    C --> G[In 5 Minuten fertig]
    D --> H[Schnellere Paketverwaltung]
    E --> I[Isolierte reproduzierbare Umgebung]
    F --> J[Anpassbar, an Entwicklung teilnehmen]

Methodenvergleich

Methode 1: npm globale Installation (empfohlen für Einsteiger)

Installationsschritte

# 1. Neueste stabile Version installieren
npm install -g openclaw@latest

# 2. Installation überprüfen
openclaw --version
# Beispielausgabe: 2026.2.26

# 3. Hilfe anzeigen
openclaw --help

Verzeichnisstruktur nach Installation

/usr/local/lib/node_modules/openclaw/  # Globales Installationsverzeichnis
├── bin/
│   └── openclaw                        # Ausführbare Datei
├── lib/
│   └── ...                             # Kernbibliotheken
└── package.json

~/.openclaw/                            # Benutzerdatenverzeichnis (beim ersten Start erstellt)
├── openclaw.json                       # Hauptkonfigurationsdatei
├── credentials/                       # Kanal-Anmeldedaten
├── workspace/                          # Agent-Arbeitsbereich
│   ├── AGENTS.md                      # Agent-Verhaltensrichtlinien
│   ├── SOUL.md                        # Agent-Persönlichkeit
│   └── skills/                        # Benutzerdefinierte Skills
└── logs/                              # Protokollverzeichnis

Einrichtungsassistent ausführen

# Interaktiven Konfigurationsassistenten starten
openclaw onboard --install-daemon

Der Assistent führt dich durch:

sequenceDiagram
    participant U as Benutzer
    participant W as Assistent
    participant S as System
    
    U->>W: Onboarding starten
    W->>U: Modellanbieter wählen
    U->>W: Anthropic auswählen
    W->>U: API Key eingeben
    U->>W: Key einfügen
    W->>U: Gateway-Port wählen
    U->>W: 18789 (Standard)
    W->>U: Daemon installieren?
    U->>W: Ja
    W->>S: systemd/launchd-Dienst erstellen
    S-->>W: Installation erfolgreich
    W-->>U: Konfiguration abgeschlossen!

Methode 2: pnpm Installation (empfohlen für den Alltag)

pnpm installieren

# pnpm über npm installieren
npm install -g pnpm

# Oder mit eigenständigem Skript
curl -fsSL https://get.pnpm.io/install.sh | sh -

OpenClaw installieren

# Mit pnpm installieren
pnpm add -g openclaw@latest

# Überprüfen
openclaw --version

Vorteile von pnpm

Methode 3: bun Installation (für maximale Geschwindigkeit)

bun installieren

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Oder über npm
npm install -g bun

OpenClaw installieren

# Mit bun installieren
bun add -g openclaw@latest

# Überprüfen
openclaw --version

Vorteile von bun

Methode 4: Docker Deployment (empfohlen für Produktion)

Image herunterladen

# Neuestes Image herunterladen
docker pull openclaw/openclaw:latest

# Oder bestimmte Version
docker pull openclaw/openclaw:2026.2

Einfacher Start

# Minimaler Start
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e ANTHROPIC_API_KEY=your_key_here \
  openclaw/openclaw:latest

# Logs anzeigen
docker logs -f openclaw

Docker Compose Konfiguration

Erstelle docker-compose.yml:

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ./openclaw-data:/root/.openclaw
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      # Oder Konfigurationsdatei verwenden
      # - OPENCLAW_CONFIG=/root/.openclaw/openclaw.json
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Dienst starten:

# .env-Datei erstellen
echo "ANTHROPIC_API_KEY=your_key_here" > .env

# Starten
docker-compose up -d

# Status anzeigen
docker-compose ps

# Logs anzeigen
docker-compose logs -f

Docker-Netzwerkkonfiguration

# docker-compose.yml erweiterte Konfiguration
services:
  openclaw:
    # ... andere Konfiguration
    networks:
      - openclaw-net

  # Optional: Reverse Proxy
  caddy:
    image: caddy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
    networks:
      - openclaw-net

networks:
  openclaw-net:
    driver: bridge

Methode 5: Aus Quellcode bauen (für Entwickler)

Repository klonen

# Haupt-Repository klonen
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Abhängigkeiten installieren (pnpm empfohlen)
pnpm install

# Bauen
pnpm build

# Ausführen
pnpm openclaw onboard

Entwicklungsmodus

# Entwicklungsmodus (automatisches Neuladen)
pnpm gateway:watch

# Tests ausführen
pnpm test

# Code-Prüfung
pnpm lint

Konfigurationsdatei im Detail

Konfigurationspriorität

CLI-Parameter > Umgebungsvariablen > Konfigurationsdatei > Standardwerte

Verzeichnisstruktur

~/.openclaw/
├── openclaw.json           # Hauptkonfigurationsdatei
├── openclaw.json.backup    # Automatisches Backup
├── credentials/            # Sensible Anmeldedaten (automatisch verschlüsselt)
│   ├── telegram.json
│   ├── whatsapp.json
│   └── discord.json
├── workspace/              # Agent-Arbeitsbereich
│   ├── AGENTS.md          # Globale Verhaltensrichtlinien
│   ├── SOUL.md            # Agent-Persönlichkeit
│   ├── TOOLS.md           # Benutzerdefinierte Tool-Beschreibung
│   ├── USER.md            # Benutzerinformationen
│   └── skills/            # Skill-Verzeichnis
│       ├── gmail/
│       │   └── SKILL.md
│       └── calendar/
│           └── SKILL.md
├── sessions/              # Sitzungsdaten
├── logs/                  # Protokolldateien
│   ├── gateway.log
│   └── agent.log
└── cache/                 # Cache-Daten

Minimale Konfiguration

~/.openclaw/openclaw.json:

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

Vollständiges Konfigurationsbeispiel

{
  "agent": {
    "model": "anthropic/claude-opus-4-6",
    "thinkingLevel": "high",
    "verboseLevel": "normal"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "host": "127.0.0.1"
  },
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN",
      "dmPolicy": "pairing",
      "allowFrom": []
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "discord": {
      "token": "YOUR_DISCORD_TOKEN",
      "guilds": {}
    }
  },
  "agents": {
    "defaults": {
      "workspace": "~/.openclaw/workspace",
      "sandbox": {
        "mode": "off"
      }
    }
  },
  "models": {
    "fallback": [
      {
        "model": "anthropic/claude-sonnet-4",
        "condition": "rate_limit"
      }
    ]
  },
  "webhooks": [],
  "cron": []
}

Konfigurationsoptionen

Umgebungsvariablen

OpenClaw unterstützt das Überschreiben der Konfiguration über Umgebungsvariablen:

# API Keys
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

# Kanalkonfiguration
export TELEGRAM_BOT_TOKEN="123456:ABC..."
export DISCORD_BOT_TOKEN="..."

# Gateway-Konfiguration
export OPENCLAW_PORT=18789
export OPENCLAW_BIND="loopback"

Starten und Überprüfen

Gateway starten

# Im Vordergrund (Debug-Modus)
openclaw gateway --verbose

# Im Hintergrund (Daemon)
openclaw gateway --daemon

# Bestimmten Port verwenden
openclaw gateway --port 18790

Betriebsstatus überprüfen

# Gesundheitsstatus prüfen
openclaw doctor

# Beispielausgabe:
# ✓ Node.js version: v22.12.0
# ✓ OpenClaw version: 2026.2.26
# ✓ Gateway running on port 18789
# ✓ API key configured
# ✓ Workspace directory exists

Web-Konsole aufrufen

Nach dem Start des Gateways öffne im Browser:

http://127.0.0.1:18789

Du siehst die Web Control UI:

Dialog testen

# Kommandozeilentest
openclaw agent --message "Hallo, bitte stell dich vor"

# Beispielausgabe:
# Hallo! Ich bin dein OpenClaw-Assistent. Ich kann dir helfen bei...

Häufige Fehlerbehebung

Problem 1: Port bereits belegt

Symptom:

Error: EADDRINUSE: address already in use 127.0.0.1:18789

Lösung:

# Prozess finden, der den Port belegt
lsof -i :18789
# oder
netstat -tlnp | grep 18789

# Prozess beenden
kill -9 <PID>

# Oder anderen Port verwenden
openclaw gateway --port 18790

Problem 2: Ungültiger API Key

Symptom:

Error: Invalid API key

Lösung:

# Konfiguration überprüfen
openclaw config get agent.model

# Umgebungsvariable prüfen
echo $ANTHROPIC_API_KEY

# Neu konfigurieren
openclaw onboard

Problem 3: Node-Version zu niedrig

Symptom:

Error: OpenClaw requires Node.js >= 22.0.0

Lösung:

# Version mit nvm wechseln
nvm install 22
nvm use 22
nvm alias default 22

# Überprüfen
node --version

Problem 4: Berechtigungsproblem

Symptom:

Error: EACCES: permission denied

Lösung:

# npm-Berechtigungen korrigieren
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.openclaw

# Oder nvm für die Node.js-Verwaltung verwenden (empfohlen)

Problem 5: Docker-Netzwerkproblem

Symptom:

Error: Cannot connect to Gateway from container

Lösung:

# Netzwerk prüfen
docker network ls
docker network inspect bridge

# Host-Netzwerk verwenden
docker run --network host ...

# Oder Ports korrekt mappen
docker run -p 127.0.0.1:18789:18789 ...

Problem 6: Verlorene Anmeldedaten

Symptom:

Warning: Telegram credentials not found

Lösung:

# Kanal erneut anmelden
openclaw channels login telegram

# Anmeldedateien prüfen
ls ~/.openclaw/credentials/

# Anmeldedaten sichern
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Problem 7: Nicht genügend Arbeitsspeicher

Symptom:

Error: JavaScript heap out of memory

Lösung:

# Node.js Speicherlimit erhöhen
export NODE_OPTIONS="--max-old-space-size=8192"
openclaw gateway

# Oder in Docker
docker run -e NODE_OPTIONS="--max-old-space-size=8192" ...

Update und Wartung

OpenClaw aktualisieren

# npm Update
npm update -g openclaw@latest

# pnpm Update
pnpm update -g openclaw@latest

# Docker Update
docker pull openclaw/openclaw:latest
docker-compose up -d

# Version prüfen
openclaw --version

Release-Kanal wechseln

# Stabile Version (empfohlen)
openclaw update --channel stable

# Beta-Version
openclaw update --channel beta

# Entwicklerversion (neueste Funktionen, möglicherweise instabil)
openclaw update --channel dev

Sicherung und Wiederherstellung

# Konfiguration sichern
tar -czvf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# Konfiguration wiederherstellen
tar -xzvf openclaw-backup-20260226.tar.gz -C ~/

# Nur wichtige Dateien sichern
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Nächste Schritte

Herzlichen Glückwunsch! Du hast die OpenClaw-Umgebung erfolgreich eingerichtet. Als Nächstes:

1. Ersten Kanal konfigurieren → Nächster Artikel: Kanalkonfiguration
2. Ersten Skill installieren → In der Web UI suchen und installieren
3. Agent-Persönlichkeit anpassen → ~/.openclaw/workspace/SOUL.md bearbeiten

Zusammenfassung dieses Artikels:

• Fünf Installationsmethoden und ihre Anwendungsszenarien beherrscht
• Konfigurationsdateistruktur und -priorität verstanden
• Start-Überprüfung und häufige Fehlerbehebung erlernt
• Grundlegende Update- und Wartungsoperationen kennengelernt

Änderungsprotokoll:

• 2026-02-26: Erstveröffentlichung, basierend auf OpenClaw v2026.2

Seriennavigation:

• ← Vorheriger Artikel: OpenClaw Einführung
• → Nächster Artikel: Kanalkonfiguration: Starten mit Telegram