Containers
ClawDock
ClawDock est une petite couche d’utilitaires shell pour les installations d’OpenClaw basées sur Docker.
Elle fournit des commandes courtes comme clawdock-start, clawdock-dashboard et clawdock-fix-token, au lieu d’invocations docker compose ... plus longues.
Si vous n’avez pas encore configuré Docker, commencez par 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 ~/.zshrcSi vous aviez précédemment installé ClawDock depuis scripts/shell-helpers/clawdock-helpers.sh, réinstallez-le depuis le chemin actuel scripts/clawdock/clawdock-helpers.sh ; l’ancien chemin brut GitHub a été supprimé.
Lors de la première utilisation, les utilitaires détectent automatiquement votre copie de travail d’OpenClaw en vérifiant des chemins courants comme ~/openclaw et ~/projects/openclaw, puis mettent le résultat en cache dans ~/.clawdock/config. Définissez vous-même CLAWDOCK_DIR si votre copie de travail se trouve ailleurs.
Fonctionnalités disponibles
Opérations de base
| Commande | Description |
|---|---|
clawdock-start |
Démarrer le Gateway |
clawdock-stop |
Arrêter le Gateway |
clawdock-restart |
Redémarrer le Gateway |
clawdock-status |
Vérifier l’état des conteneurs |
clawdock-logs |
Suivre les journaux du Gateway |
Accès au conteneur
| Commande | Description |
|---|---|
clawdock-shell |
Ouvrir un shell dans le conteneur du Gateway |
clawdock-cli <command> |
Exécuter des commandes de la CLI OpenClaw dans Docker |
clawdock-exec <command> |
Exécuter une commande arbitraire dans le conteneur |
Interface Web et appairage
| Commande | Description |
|---|---|
clawdock-dashboard |
Ouvrir l’URL de l’interface de contrôle |
clawdock-devices |
Répertorier les appairages d’appareils en attente |
clawdock-approve <id> |
Approuver une demande d’appairage |
Configuration et maintenance
| Commande | Description |
|---|---|
clawdock-fix-token |
Écrire le jeton du Gateway dans la configuration du conteneur |
clawdock-update |
Récupérer, reconstruire et redémarrer |
clawdock-rebuild |
Reconstruire uniquement l’image Docker |
clawdock-clean |
Supprimer les conteneurs et les volumes |
Utilitaires
| Commande | Description |
|---|---|
clawdock-health |
Exécuter une vérification de l’état du Gateway |
clawdock-token |
Afficher le jeton du Gateway |
clawdock-cd |
Accéder au répertoire du projet OpenClaw |
clawdock-config |
Ouvrir ~/.openclaw |
clawdock-show-config |
Afficher les fichiers de configuration avec les valeurs masquées |
clawdock-workspace |
Ouvrir le répertoire de l’espace de travail |
clawdock-help |
Répertorier toutes les commandes ClawDock |
Première utilisation
clawdock-startclawdock-fix-tokenclawdock-dashboardSi le navigateur indique qu’un appairage est requis :
clawdock-devicesclawdock-approve <request-id>Configuration et secrets
ClawDock lit deux fichiers .env distincts, conformément à la séparation décrite dans Docker :
- Le fichier
.envdu projet, à côté dedocker-compose.yml: les valeurs propres à Docker, comme le nom de l’image, les ports etOPENCLAW_GATEWAY_TOKEN.clawdock-tokenlit le jeton depuis ce fichier. ~/.openclaw/.env(monté dans le conteneur) : les secrets fournis par les variables d’environnement qu’OpenClaw gère lui-même, avecopenclaw.jsonetagents/<agentId>/agent/auth-profiles.json.
clawdock-fix-token copie le jeton du fichier .env du projet dans les valeurs de configuration gateway.remote.token et gateway.auth.token du conteneur, puis redémarre le Gateway.
Utilisez clawdock-show-config pour consulter rapidement openclaw.json et les deux fichiers .env ; les valeurs des fichiers .env sont masquées dans la sortie affichée.
