Containers
ClawDock
ClawDock ist eine kleine Shell-Hilfsschicht für Docker-basierte OpenClaw-Installationen.
Damit stehen Ihnen kurze Befehle wie clawdock-start, clawdock-dashboard und clawdock-fix-token anstelle längerer docker compose ...-Aufrufe zur Verfügung.
Falls Sie Docker noch nicht eingerichtet haben, beginnen Sie mit Docker.
Installation
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 ~/.zshrcFalls Sie ClawDock zuvor über scripts/shell-helpers/clawdock-helpers.sh installiert haben, installieren Sie es erneut über den aktuellen scripts/clawdock/clawdock-helpers.sh-Pfad; der alte GitHub-Rohdatenpfad wurde entfernt.
Die Hilfsfunktionen erkennen Ihr OpenClaw-Checkout bei der ersten Verwendung automatisch (dabei werden gängige Pfade wie ~/openclaw und ~/projects/openclaw geprüft) und speichern das Ergebnis in ~/.clawdock/config zwischen. 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 live 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 Steuerungsoberflä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 bauen und neu starten |
clawdock-rebuild |
Nur das Docker-Image neu bauen |
clawdock-clean |
Container und Volumes entfernen |
Dienstprogramme
| 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
clawdock-startclawdock-fix-tokenclawdock-dashboardFalls der Browser meldet, dass eine Kopplung erforderlich ist:
clawdock-devicesclawdock-approve <request-id>Konfiguration und Geheimnisse
ClawDock liest zwei separate .env-Dateien entsprechend der unter Docker beschriebenen Aufteilung:
- Die Projektdatei
.envnebendocker-compose.yml: Docker-spezifische Werte wie Image-Name, Ports undOPENCLAW_GATEWAY_TOKEN.clawdock-tokenliest das Token daraus. ~/.openclaw/.env(in den Container eingebunden): umgebungsvariablenbasierte Geheimnisse, die OpenClaw selbst verwaltet, zusammen mitopenclaw.jsonundagents/<agentId>/agent/auth-profiles.json.
clawdock-fix-token kopiert das Token aus der Projektdatei .env in die Konfigurationswerte gateway.remote.token und gateway.auth.token des Containers und startet das Gateway neu.
Verwenden Sie clawdock-show-config, um openclaw.json und beide .env-Dateien schnell zu prüfen; in der ausgegebenen Darstellung werden .env-Werte geschwärzt.
