📄 Guide

OpenClaw docker-compose.yml – Kopieren & Starten

Die offizielle Docker-Compose-Konfiguration für OpenClaw. Code kopieren, einen Befehl ausführen – in 5 Minuten live.

⌨️ Schnellstart: 3 Befehle

# 1. Verzeichnis erstellen
mkdir ~/openclaw && cd ~/openclaw

# 2. docker-compose.yml herunterladen
curl -O https://raw.githubusercontent.com/openclaw/openclaw/main/docker-compose.yml

# 3. Container starten
docker compose up -d

Nach dem Start ist OpenClaw unter http://localhost:3000 erreichbar.

⬇️ Offizielle docker-compose.yml

docker-compose.yml
version: '3.8'

services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "3000:8080"
    volumes:
      - openclaw-data:/app/backend/data
    environment:
      - WEBUI_SECRET_KEY=${WEBUI_SECRET_KEY}
    restart: unless-stopped

volumes:
  openclaw-data:

Konfiguration erklärt

image

Das offizielle OpenClaw Docker-Image von GitHub Container Registry. Wird bei "docker compose pull" automatisch aktualisiert.

ports: "3000:8080"

Mappt den internen Port 8080 auf externen Port 3000. Ändern Sie 3000 auf einen anderen Port, falls belegt.

volumes: openclaw-data

Persistenter Speicher für Chats, Einstellungen und Uploads. Überlebt Container-Neustarts und Updates.

WEBUI_SECRET_KEY

Geheimer Schlüssel für Session-Verschlüsselung. Generieren Sie einen mit: openssl rand -hex 32

restart: unless-stopped

Container startet automatisch nach Server-Neustart, außer Sie stoppen ihn manuell.

Docker Compose Befehle

Befehl Beschreibung
docker compose up -d Container im Hintergrund starten
docker compose down Container stoppen und entfernen
docker compose pull Neuestes Image herunterladen
docker compose logs -f Live-Logs anzeigen
docker compose restart Container neustarten
docker compose ps Status aller Container prüfen

Häufige Fragen

Wo finde ich die offizielle docker-compose.yml für OpenClaw?

Die offizielle docker-compose.yml liegt auf GitHub unter raw.githubusercontent.com/openclaw/openclaw/main/docker-compose.yml. Sie können sie mit curl -O herunterladen.

Welche Docker-Version brauche ich für OpenClaw?

Sie benötigen Docker 20.10+ und das Docker Compose Plugin (V2). Prüfen Sie mit 'docker compose version'.

Kann ich die docker-compose.yml anpassen?

Ja, Sie können Ports, Volumes und Umgebungsvariablen frei anpassen. Die wichtigsten Optionen sind der externe Port (Standard: 3000) und der WEBUI_SECRET_KEY.

Wie aktualisiere ich OpenClaw mit Docker Compose?

Führen Sie 'docker compose pull' aus, um das neueste Image zu laden, dann 'docker compose up -d' zum Neustarten. Ihre Daten bleiben im Volume erhalten.

Was tun wenn Port 3000 bereits belegt ist?

Ändern Sie in der docker-compose.yml die Port-Zuordnung, z.B. von '3000:8080' auf '8080:8080' oder einen anderen freien Port.

Weiterführende Links