Autonomous Agents

OpenClaw Autonomer Agent Guide: Architektur, Docker & Kosten

2026-09-02·18 Min. Min. Lesezeit·LLMPodium Team

### Kurzantwort: Was ist OpenClaw und wie schlägt es sich im Vergleich?

OpenClaw ist ein quelloffener, autonomer persönlicher KI-Assistent mit entkoppelter Gateway-Architektur, Unterstützung für über 20 Messaging-Kanäle und isolierter Multi-Agenten-Sandbox. Im Gegensatz zu proprietären SaaS-Agenten für 20–50 $/Monat entfallen bei OpenClaw Abogebühren (0 $), bei durchschnittlichen Ausführungskosten von nur 0,003–0,042 $ über direkte Modell-APIs.

1. Übersicht: Was zeichnet OpenClaw im Jahr 2026 aus?

Die KI-Agenten-Landschaft hat 2026 einen grundlegenden Wendepunkt erreicht: weg von isolierten Einzelfragen im Chatfenster hin zu kontinuierlichen, ereignisgesteuerten autonomen Ausführungsschleifen. Während Claude Code und OpenAI Codex primär auf lokale CLI-Entwicklerumgebungen abzielen, hat sich OpenClaw (ehemals openclaw.ai) als führendes Open-Source-Framework für persönliche 24/7-KI-Assistenten über zahlreiche Kommunikationskanäle, Cron-Jobs und isolierte Workflows etabliert.

OpenClaw basiert auf drei architektonischen Säulen:

  1. Entkoppeltes Gateway-Protokoll: Ein zentraler Daemon auf Port 18789, der Kanal-Routing, Sitzungspersistenz, Cron-Scheduling und Webhook-Empfang steuert.
  2. Kanalunabhängiges Messaging: Native Integration für über 20 Chat-Netzwerke, darunter Telegram, WhatsApp (Baileys), Discord (Bot API + Gateway), Slack (Bolt SDK), Signal (signal-cli), iMessage, Matrix und WebChat.
  3. Modulare Skills und Sandbox-Agenten: Ein offener Markdown-Standard (SKILL.md) über das ClawHub-Repository in Kombination mit Docker- und POSIX-Rechtebeschränkung für sichere Shell-Ausführungen.

2. OpenClaw-Architektur: Gateway, Kanäle und Workspace

Das Herzstück von OpenClaw ist die getrennte Client-Server-Architektur. Der zentrale Hintergrunddienst (OpenClaw Gateway) kommuniziert über WebSockets und Unix Domain Sockets mit Benutzeroberflächen und externen Messaging-APIs. 

+-----------------------------------------------------------------------------------+
|                              Externe Messaging-Kanäle                             |
|   Telegram  |  WhatsApp  |  Discord  |  Slack  |  Signal  |  iMessage  |  Matrix  |
+-----------------------------------------------------------------------------------+
                                          | (Webhook / WebSocket / Bot API)
                                          v
+-----------------------------------------------------------------------------------+
|                            OpenClaw Gateway (Port 18789)                          |
|  - DM Pairing & Allowlist-Prüfung         - Sitzungs- und Kontextspeicher         |
|  - Cron-Scheduler (CronTab Engine)        - Webhook-Routing                       |
|  - Hot-Reload Konfiguration (Hybrid Watch)- Modell-Failover & Router-Switching    |
+-----------------------------------------------------------------------------------+
       |                                      |                              |
       v                                      v                              v
+------------------+                  +------------------+         +-------------------+
|  Agent: Home     |                  |  Agent: Work     |         |  Agent: DevOps    |
|  - Workspace-Home|                  |  - Workspace-Work|         |  - Workspace-Ops  |
|  - SOUL.md       |                  |  - SOUL.md       |         |  - SOUL.md        |
|  - Privat-CRM    |                  |  - Jira / Linear |         |  - CI/CD & SSH    |
+------------------+                  +------------------+         +-------------------+
       |                                      |                              |
       +--------------------------------------+------------------------------+
                                          |
                                          v
+-----------------------------------------------------------------------------------+
|                    Multi-Agenten Sandbox-Ausführungsschicht                       |
|  - Docker-Container-Isolation (`mode: non-main` / `mode: all`)                    |
|  - Entzug von POSIX-Rechten (`cap_drop: ALL`, unprivilegierter UID 10001)         |
|  - Schreibgeschützte Mounts (`:ro`) & Tmpfs-Speicher (`/tmp:noexec`)              |
|  - ClawHub Skills-Engine (`SKILL.md` Parser, dynamische Binärprüfungen)           |
+-----------------------------------------------------------------------------------+

Die Workspace-Verzeichnisstruktur

Jeder Agent operiert in einer klar definierten Verzeichnishierarchie unter ~/.openclaw/: 

~/.openclaw/
├── openclaw.json          # Deklarative Hauptkonfiguration (JSON5)
├── cron.json              # Persistierte Cron-Aufgaben und Zeitpläne
├── state/                 # SQLite-Sitzungsspeicher, Caches, Authentifizierungs-Token
├── skills/                # Global verwaltete Skills
└── workspace/             # Standard-Arbeitsverzeichnis
    ├── AGENTS.md          # Globale Verhaltensregeln und System-Prompts
    ├── SOUL.md            # Persona, Tonfall, Stil und Sicherheitsgrenzen
    ├── TOOLS.md           # Lokale Tool-Definitionen und Umgebungshinweise
    └── skills/            # Workspace-spezifische Skills
        └── repo-analyzer/
            └── SKILL.md   # Ausführbare Skill-Deklaration

Grundlegende Gateway-Befehle

# Gateway-Status, Port-Belegung und Speichernutzung prüfen
openclaw gateway status

# Gateway als Hintergrund-Daemon starten
openclaw gateway start

# Gateway im Vordergrund mit ausführlichen Debug-Logs starten
openclaw gateway --port 18789 --verbose

# Systemdiagnose und Konfigurationsaudit durchführen
openclaw doctor

# Fehlerhafte Berechtigungen und Pfade automatisch reparieren
openclaw doctor --fix

3. Selbstgehostetes Docker-Deployment: Vollständiger Leitfaden

Die Ausführung von KI-Agenten mit Terminalzugriff direkt auf dem Host-Betriebssystem birgt erhebliche Sicherheitsrisiken. Für den Produktionseinsatz empfiehlt sich ein gehärtetes Docker Compose Setup.

Produktions-docker-compose.yml

version: "3.9"

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    restart: unless-stopped
    user: "10001:10001"
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETUID
      - SETGID
    environment:
      - NODE_ENV=production
      - OPENCLAW_HOME=/home/openclaw/.openclaw
      - OPENCLAW_STATE_DIR=/home/openclaw/.openclaw/state
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - OPENCLAW_GATEWAY_PASSWORD=${OPENCLAW_GATEWAY_PASSWORD}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}
    volumes:
      - openclaw-config:/home/openclaw/.openclaw
      - openclaw-workspace:/home/openclaw/.openclaw/workspace
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - "127.0.0.1:18789:18789"
    networks:
      - openclaw-net
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 20s

  openclaw-sandbox:
    image: ghcr.io/openclaw/sandbox-runner:latest
    container_name: openclaw-sandbox
    restart: always
    network_mode: none
    read_only: true
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=256m
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    volumes:
      - openclaw-workspace:/workspace:rw
    environment:
      - RUNNER_UID=10001
      - RUNNER_GID=10001

volumes:
  openclaw-config:
    driver: local
  openclaw-workspace:
    driver: local

networks:
  openclaw-net:
    driver: bridge

Produktionskonfiguration openclaw.json

{
  agents: {
    defaults: {
      workspace: "/home/openclaw/.openclaw/workspace",
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["deepseek/deepseek-chat", "openai/gpt-5.4"],
      },
      thinking: "high",
      sandbox: {
        mode: "non-main", // off | non-main | all
        scope: "agent",   // session | agent | shared
        dockerImage: "ghcr.io/openclaw/sandbox-runner:latest",
        timeoutSeconds: 300,
        memoryLimitMb: 1024,
      },
    },
    list: [
      {
        id: "main",
        default: true,
        workspace: "/home/openclaw/.openclaw/workspace",
      },
      {
        id: "devops",
        workspace: "/home/openclaw/.openclaw/workspace-devops",
        sandbox: { mode: "all" },
      },
    ],
  },
  channels: {
    telegram: {
      enabled: true,
      botToken: "7123456789:AAFq_example_token_secret",
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["tg:987654321"],
    },
    discord: {
      enabled: true,
      botToken: "MTI4OTexampleDiscordBotToken",
      dmPolicy: "allowlist",
      allowFrom: ["dc:382910394857291029"],
    },
  },
  cron: {
    enabled: true,
    maxConcurrentRuns: 4,
  },
  hotReload: "hybrid",
}

4. Multi-Agenten-Orchestrierung & Sandbox-Sicherheit

Frühere Agenten-Frameworks führten Befehle oft ungeschützt in derselben Umgebung aus, in der API-Schlüssel hinterlegt waren. OpenClaw nutzt ein zweistufiges Sicherheitsmodell:

DM Policy & Sandbox-Modi

  1. Eingehende Berechtigungsprüfung (DM Policy):
  • pairing (Standard): Unbekannte Absender erhalten einen Einmal-Kopplungscode. Der Administrator muss diesen via openclaw pairing approve [CODE] freischalten.
  • allowlist: Nur explizit genannte IDs in allowFrom dürfen Befehle ausführen.
  • open: Für jedermann zugänglich (ausschließlich für öffentliche Support-Bots mit Sandbox all empfohlen).
  • disabled: Deaktiviert private Nachrichten komplett; beschränkt das System auf ausgehende Benachrichtigungen.
  1. Sandbox-Modi:
  • off: Direkte Ausführung auf dem Host (höchste Performance, jedoch hohes Risiko).
  • non-main (Empfohlen): Der Haupt-Agent läuft normal, während Sub-Agenten und Skripte in Docker isoliert werden.
  • all: Jeder Befehl wird in einem Container ohne Netzwerkzugriff (network_mode: none) ausgeführt.

5. Skills-Engine & ClawHub-Ökosystem

Fähigkeiten werden über Skills bereitgestellt, definiert in SKILL.md: 

---
name: github-pr-analyzer
description: Prüft Pull Requests, führt Tests aus und erstellt Review-Zusammenfassungen.
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["gh", "jq", "git"],
      "env": ["GITHUB_TOKEN"],
      "config": ["sandbox.enabled"]
    },
    "os": ["linux", "darwin"],
    "always": false,
    "primaryEnv": "GITHUB_TOKEN"
  }
}
---

# GitHub PR Analyzer Skill

Bei Benutzeraufruf oder Webhook-Ereignis:
1. PR-Diff über `gh pr diff <pr_number>` abrufen.
2. Geänderte Dateien analysieren und Testabdeckung prüfen.
3. Strukturierten Markdown-Bericht mit Code-Zitaten erstellen.

Skill-Management via ClawHub

# Verfügbare Skills anzeigen
openclaw skills list

# Offiziellen Skill aus ClawHub installieren
openclaw skills install web-researcher

# Skill direkt aus einem GitHub-Repository beziehen
openclaw skills install git:github.com/openclaw-community/postgres-inspector@v1.4.0

# Digitale Signatur und Berechtigungen verifizieren
openclaw skills verify web-researcher

# Alle installierten Skills aktualisieren
openclaw skills update --all

6. Benchmarks: SWE-bench, Latenz und Ressourceneffizienz

Bewertungsmetrik OpenClaw (Self-Hosted + Sonnet 4.6) Claude Code (Anthropic CLI) Devin (Enterprise) AutoGen v0.4 (Docker) SaaS-Agenten
SWE-bench Verified (Lösungsrate) 68,4 % 72,4 % 71,8 % 52,1 % 41,2 %
Tool-Call-Genauigkeit 94,6 % 96,8 % 95,2 % 84,3 % 79,5 %
Latenz bis zum ersten Token (TTFT) 0,42 s (Lokaler Gateway) 1,84 s 4,80 s (Cloud-VM-Start) 1,10 s 2,45 s
RAM-Verbrauch im Leerlauf 84 MB (Node/Rust Hybrid) N/A (Kurzlebige CLI) Cloud-gehostet 420 MB (Python Engine) Cloud-gehostet
Spitzen-RAM (5 gleichzeitige Tasks) 340 MB N/A (Einzelsitzung) Cloud-gehostet 1.840 MB Cloud-gehostet
Sandbox-Overhead 180 ms (Docker Runner) Keiner (Host Native) Hypervisor-Start 450 ms Proprietäre VM
Unterstützte Chat-Protokolle 20+ Kanäle Nur Terminal Web & Slack Nur Python API Web / Telegram
Datenhoheit & Datenschutz 100 % On-Premise Lokal / Cloud-API Geschlossene SaaS 100 % On-Premise Geschlossene SaaS

7. OpenClaw Preise & Kosten: Realer Kostenvergleich

Aufgrund des hohen Suchvolumens nach openclaw pricing fragen sich viele: Kostet OpenClaw Geld?

Die OpenClaw-Software selbst ist vollständig kostenlos und quelloffen (Apache 2.0 / MIT). Es gibt keine Lizenz- oder Sitzgebühren. Die Betriebskosten setzen sich ausschließlich zusammen aus:

  1. Server-Infrastruktur: VPS-Instanz (ca. 4–15 $/Monat).
  2. LLM-API-Tokens: Direkte Abrechnung nach Verbrauch bei den Modellanbietern.

Kostenvergleich bei 1.000 Produktivausführungen

Plattform Monatliche Plattformgebühr Abrechnungsmodell Kosten pro einfache Anfrage Kosten pro komplexem Task (Audit) Monatliche Gesamtkosten (500 Runs)
OpenClaw (DeepSeek V4) 0,00 $ Direkte API (0,14 $ / 0,28 $ pro 1M) 0,0008 $ 0,012 $ 6,40 $ (inkl. 5 $ VPS)
OpenClaw (Claude Sonnet 4.6) 0,00 $ Direkte API (3,00 $ / 15,00 $ pro 1M) 0,0042 $ 0,058 $ 29,50 $ (inkl. 5 $ VPS)
Claude Code (Anthropic) 0,00 $ (Erfordert Max Plan) 20 $/Mo + API-Gebühren 0,0042 $ 0,058 $ 45,00 – 80,00 $
Devin Enterprise 500,00 $ / Sitz / Monat Inkludierte ACUs + Add-ons Im Sitzpreis enthalten Im Sitzpreis enthalten 500,00 $+
Kommerzielle SaaS-Bots 20,00 – 50,00 $ / Monat Beschränkte Kontingente Im Kontingent Limit schnell erreicht 20,00 – 100,00 $

8. Betrieb, Monitoring & Fehlerbehebung

# Gateway- und Verbindungsstatus prüfen
openclaw gateway status

# Live-Logs überwachen
openclaw logs --follow --lines 50

# Konfigurationsdateien validieren
openclaw config validate

# Task mit vertieftem Denkmodus starten
openclaw agent --message "Führe Sicherheitsaudit für das Projekt durch" --thinking high

# Push-Nachricht via Telegram senden
openclaw message send --target "tg:987654321" --message "Deployment erfolgreich abgeschlossen."

Häufige Fehlerquellen

  1. Port belegt (EADDRINUSE 18789): Ein alter Daemon blockiert den Port. Beenden mit openclaw gateway stop oder kill -9 $(lsof -t -i :18789).
  2. Telegram-Konflikt (409 Conflict): Mehrere Instanzen nutzen dasselbe Bot-Token. Nur eine Instanz aktiv halten.
  3. Berechtigungsfehler (EACCES /workspace): UID-Konflikt mit dem Container-Benutzer. Beheben mit chown -R 10001:10001 ~/.openclaw/workspace.

9. Fazit & Empfehlung

OpenClaw schließt die Lücke zwischen einfachen Terminal-Tools und teuren, proprietären Cloud-Agenten. Mit nativer Multi-Channel-Unterstützung, Docker-Isolierung und unschlagbaren API-Direktkosten bietet es die ideale Lösung für alle, die Wert auf Datenhoheit und maximale Wirtschaftlichkeit legen.

← Alle Artikel
0 / 4
Jetzt vergleichen →