Castro‘s Tech Blog

Dein eigener KI-Assistent: Der ultimative Guide zur Installation und Konfiguration von OpenClaw

8. Juli 2026

Die Vorstellung eines eigenen, intelligenten Assistenten, der perfekt auf die eigenen Bedürfnisse zugeschnitten ist, ist keine Zukunftsmusik mehr. Mit OpenClaw kannst du dir genau das erschaffen: einen selbstgehosteten, mächtigen KI-Agenten, der mit deinen Systemen, Tools und Daten interagiert. In diesem Guide führen wir dich Schritt für Schritt durch die Installation und Konfiguration.

Voraussetzungen

  • Ein Server oder PC mit Docker und Docker Compose.
  • API-Keys von einem LLM-Anbieter (z.B. OpenAI, Google AI Studio, Anthropic).
  • Grundlegendes Verständnis der Kommandozeile.

Schritt 1: Installation mit Docker Compose

Die empfohlene Methode zur Installation von OpenClaw ist Docker. Es isoliert die Anwendung und vereinfacht die Verwaltung enorm.

1. Erstelle ein Verzeichnis für deine OpenClaw-Instanz:

mkdir -p /opt/openclaw/config
cd /opt/openclaw

2. Erstelle eine docker-compose.yml Datei mit folgendem Inhalt:

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    volumes:
      - ./config:/root/.openclaw/config
      - ./workspace:/root/.openclaw/workspace
      - ./secrets:/root/.openclaw/secrets
      - ./media:/root/.openclaw/media
    ports:
      - "7100:7100" # Gateway API Port

3. Starte den Container:

docker compose up -d

OpenClaw wird nun gestartet und erstellt automatisch eine Standard-Konfigurationsdatei.

Schritt 2: Grundkonfiguration

Nach dem ersten Start findest du im config-Ordner eine openclaw.json. Dies ist das Herzstück deiner Konfiguration.

Wichtiger Tipp: Lege API-Schlüssel und andere Geheimnisse niemals direkt in die openclaw.json! Speichere sie stattdessen in einfachen Textdateien im secrets-Verzeichnis. Zum Beispiel eine Datei namens secrets/google_api_key mit nichts als dem Key darin.

Hier ist ein Minimalbeispiel, um einen Google Gemini-Modell zu aktivieren:

{
  "llmProviders": {
    "google": {
      "apiKey": { "source": "file", "path": "/root/.openclaw/secrets/google_api_key" }
    }
  },
  "messaging": {
    // Hier wird die Verbindung zu Chat-Plattformen wie Telegram konfiguriert
  },
  "tools": {
    "exec": { "enabled": true },
    "web_search": { "enabled": true },
    "read": { "enabled": true },
    "write": { "enabled": true }
  }
}

Nach jeder Änderung an der Konfiguration muss der Container neu gestartet werden: docker compose restart.

Häufige Fehler und ihre Lösungen

  • Fehler: Container startet nicht/crasht sofort wieder.
    Lösung:     Meistens ein Syntaxfehler in deiner openclaw.json. Kopiere den Inhalt und überprüfe ihn mit einem Online JSON-Validator.
  • Fehler: "API key is invalid".
    Lösung:     Überprüfe, ob der Pfad in der Konfiguration ("path": "...") korrekt ist und ob die Secret-Datei nur den reinen API-Key ohne Leerzeichen oder Zeilenumbrüche enthält.
  • Fehler: "Permission denied" bei Schreibvorgängen.
    Lösung:     Der Docker-Daemon hat keine Berechtigung, in die von dir gemappten Ordner auf dem Host-System zu schreiben. Stelle sicher, dass die Verzeichnisse die richtigen Berechtigungen haben (z.B. mit sudo chown -R 1000:1000 . im OpenClaw-Verzeichnis).

Fazit

Mit diesen Schritten hast du eine funktionierende Basis für deinen eigenen, mächtigen KI-Assistenten geschaffen. Der nächste Schritt ist die Personalisierung über die Workspace-Dateien (AGENTS.md, SOUL.md), die Anbindung an Messaging-Plattformen und die Aktivierung weiterer Tools und Skills. Willkommen in der Welt der digitalen Souveränität!

Dennis