Clawdbot Docker-Installation

Clawdbot Docker Übersicht

Docker ist optional für Clawdbot. Verwenden Sie es nur, wenn Sie ein containerisiertes Gateway möchten oder den Docker-Ablauf validieren wollen.

Ist Docker das Richtige für Mich?

Hinweis: Agent-Sandboxing verwendet ebenfalls Docker, erfordert aber nicht, dass das vollständige Gateway in Docker läuft.

Anforderungen

• Docker Desktop (oder Docker Engine) + Docker Compose v2
• Ausreichend Speicherplatz für Images + Logs

Containerisiertes Gateway (Docker Compose)

Schnellstart (Empfohlen)

Vom Repository-Stammverzeichnis:

./docker-setup.sh

Dieses Skript:

1. Erstellt das Gateway-Image
2. Führt den Onboarding-Assistenten aus
3. Zeigt optionale Provider-Setup-Hinweise an
4. Startet das Gateway über Docker Compose
5. Generiert ein Gateway-Token und schreibt es in .env

Optionale Umgebungsvariablen:

Nach Abschluss:

1. Öffnen Sie http://127.0.0.1:18789/ in Ihrem Browser
2. Fügen Sie das Token in die Control-UI ein (Einstellungen → Token)

Benötigen Sie die tokenisierte URL erneut?

docker compose run --rm clawdbot-cli dashboard --no-open

Manueller Ablauf (Compose)

docker build -t clawdbot:local -f Dockerfile .
docker compose run --rm clawdbot-cli onboard
docker compose up -d clawdbot-gateway

Control-UI-Token + Kopplung (Docker)

Wenn Sie "nicht autorisiert" oder "getrennt (1008): Kopplung erforderlich" sehen:

docker compose run --rm clawdbot-cli dashboard --no-open
docker compose run --rm clawdbot-cli devices list
docker compose run --rm clawdbot-cli devices approve <requestId>

Zusätzliche Mounts (Optional)

Zusätzliche Host-Verzeichnisse in Container mounten:

export CLAWDBOT_EXTRA_MOUNTS="$HOME/.codex:/home/node/.codex:ro,$HOME/github:/home/node/github:rw"
./docker-setup.sh

Container-Home persistieren (Optional)

/home/node über Container-Neuerstellung hinweg persistieren:

export CLAWDBOT_HOME_VOLUME="clawdbot_home"
./docker-setup.sh

Zusätzliche Pakete installieren (Optional)

Systempakete im Image installieren:

export CLAWDBOT_DOCKER_APT_PACKAGES="ffmpeg build-essential"
./docker-setup.sh

Agent-Sandbox (Docker-Tools)

Clawdbot kann Docker für Agent-Sandboxing verwenden und Agent-Tools in Containern isolieren.

Was es macht

• Führt Agent-Tools (exec, browser, usw.) in isolierten Docker-Containern aus
• Bietet Sicherheitsgrenzen zwischen Agents
• Ermöglicht Sandbox-Profile pro Agent

Sandboxing aktivieren

In Ihrer clawdbot.json:

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

Sandbox-Image erstellen

clawdbot sandbox build

Sandbox-Profile pro Agent

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/.clawdbot/workspace",
        "sandbox": {
          "mode": "off"
        }
      },
      "untrusted": {
        "sandbox": {
          "mode": "always"
        }
      }
    }
  }
}

Gesundheitsprüfung

docker compose run --rm clawdbot-cli health
docker compose run --rm clawdbot-cli status

Fehlerbehebung

Berechtigungsfehler (EACCES)

Wenn Sie Berechtigungsfehler sehen, prüfen Sie, ob die gemounteten Verzeichnisse die richtigen Berechtigungen haben.

Container startet nicht

1. Docker-Logs prüfen: docker compose logs clawdbot-gateway
2. Überprüfen Sie, dass Port 18789 nicht belegt ist
3. Stellen Sie sicher, dass Docker genügend Ressourcen hat

Token-Probleme

Gateway-Token neu generieren:

docker compose run --rm clawdbot-cli configure --reset-token

Nächste Schritte

• Clawdbot Installation - Andere Installationsmethoden
• Clawdbot Gateway - Gateway-Konfiguration
• Clawdbot Setup - Vollständige Einrichtungsanleitung