Containers

ClawDock

ClawDock ist eine kleine Shell-Hilfsschicht für Docker-basierte OpenClaw-Installationen.

Sie bietet Ihnen kurze Befehle wie clawdock-start, clawdock-dashboard und clawdock-fix-token anstelle längerer docker compose ...-Aufrufe.

Wenn Sie Docker noch nicht eingerichtet haben, beginnen Sie mit Docker.

Installation

bash
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.shecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc

Wenn Sie ClawDock zuvor über scripts/shell-helpers/clawdock-helpers.sh installiert haben, installieren Sie es erneut über den aktuellen Pfad scripts/clawdock/clawdock-helpers.sh; der alte GitHub-Raw-Pfad wurde entfernt.

Die Hilfsfunktionen erkennen beim ersten Aufruf automatisch Ihr OpenClaw-Checkout (indem sie gängige Pfade wie ~/openclaw und ~/projects/openclaw prüfen) und speichern das Ergebnis in ~/.clawdock/config. Legen Sie CLAWDOCK_DIR selbst fest, wenn sich Ihr Checkout an einem anderen Ort befindet.

Funktionsumfang

Grundlegende Vorgänge

Befehl Beschreibung
clawdock-start Gateway starten
clawdock-stop Gateway stoppen
clawdock-restart Gateway neu starten
clawdock-status Containerstatus prüfen
clawdock-logs Gateway-Protokolle verfolgen

Containerzugriff

Befehl Beschreibung
clawdock-shell Eine Shell im Gateway-Container öffnen
clawdock-cli <command> OpenClaw-CLI-Befehle in Docker ausführen
clawdock-exec <command> Einen beliebigen Befehl im Container ausführen

Weboberfläche und Kopplung

Befehl Beschreibung
clawdock-dashboard URL der Bedienoberfläche öffnen
clawdock-devices Ausstehende Gerätekopplungen auflisten
clawdock-approve <id> Eine Kopplungsanfrage genehmigen

Einrichtung und Wartung

Befehl Beschreibung
clawdock-fix-token Gateway-Token in die Containerkonfiguration schreiben
clawdock-update Abrufen, neu erstellen und neu starten
clawdock-rebuild Nur das Docker-Image neu erstellen
clawdock-clean Container und Volumes entfernen

Hilfsprogramme

Befehl Beschreibung
clawdock-health Zustandsprüfung des Gateways ausführen
clawdock-token Gateway-Token ausgeben
clawdock-cd Zum OpenClaw-Projektverzeichnis wechseln
clawdock-config ~/.openclaw öffnen
clawdock-show-config Konfigurationsdateien mit geschwärzten Werten ausgeben
clawdock-workspace Arbeitsbereichsverzeichnis öffnen
clawdock-help Alle ClawDock-Befehle auflisten

Ablauf bei der ersten Verwendung

bash
clawdock-startclawdock-fix-tokenclawdock-dashboard

Wenn der Browser meldet, dass eine Kopplung erforderlich ist:

bash
clawdock-devicesclawdock-approve <request-id>

Konfiguration und Geheimnisse

ClawDock liest zwei separate .env-Dateien, entsprechend der unter Docker beschriebenen Aufteilung:

  • Die .env-Datei des Projekts neben docker-compose.yml: Docker-spezifische Werte wie Image-Name, Ports und OPENCLAW_GATEWAY_TOKEN. clawdock-token liest das Token aus dieser Datei.
  • ~/.openclaw/.env (in den Container eingebunden): Umgebungsvariablenbasierte Geheimnisse, die OpenClaw selbst verwaltet, zusammen mit openclaw.json und agents/<agentId>/agent/auth-profiles.json.

clawdock-fix-token kopiert das Token aus der .env-Datei des Projekts in die Containerkonfigurationswerte gateway.remote.token und gateway.auth.token und startet den Gateway neu.

Verwenden Sie clawdock-show-config, um openclaw.json und beide .env-Dateien schnell zu prüfen; in der Ausgabe werden die Werte der .env-Dateien geschwärzt.

Verwandte Themen

Was this useful?
On this page

On this page