Containers
ClawDock
ClawDock es una pequeña capa de funciones auxiliares de shell para instalaciones de OpenClaw basadas en Docker.
Proporciona comandos breves como clawdock-start, clawdock-dashboard y clawdock-fix-token en lugar de invocaciones más largas de docker compose ....
Si aún no has configurado Docker, comienza por Docker.
Instalación
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 anteriormente instalaste ClawDock desde scripts/shell-helpers/clawdock-helpers.sh, vuelve a instalarlo desde la ruta actual scripts/clawdock/clawdock-helpers.sh; la antigua ruta directa de GitHub se eliminó.
Las funciones auxiliares detectan automáticamente tu copia de trabajo de OpenClaw la primera vez que las usas (comprobando rutas habituales como ~/openclaw y ~/projects/openclaw) y almacenan el resultado en caché en ~/.clawdock/config. Define CLAWDOCK_DIR manualmente si tu copia de trabajo se encuentra en otra ubicación.
Funciones disponibles
Operaciones básicas
| Comando | Descripción |
|---|---|
clawdock-start |
Iniciar el Gateway |
clawdock-stop |
Detener el Gateway |
clawdock-restart |
Reiniciar el Gateway |
clawdock-status |
Comprobar el estado del contenedor |
clawdock-logs |
Seguir los registros del Gateway |
Acceso al contenedor
| Comando | Descripción |
|---|---|
clawdock-shell |
Abrir un shell dentro del contenedor del Gateway |
clawdock-cli <command> |
Ejecutar comandos de la CLI de OpenClaw en Docker |
clawdock-exec <command> |
Ejecutar un comando arbitrario dentro del contenedor |
Interfaz web y emparejamiento
| Comando | Descripción |
|---|---|
clawdock-dashboard |
Abrir la URL de la interfaz de control |
clawdock-devices |
Mostrar emparejamientos de dispositivos pendientes |
clawdock-approve <id> |
Aprobar una solicitud de emparejamiento |
Configuración y mantenimiento
| Comando | Descripción |
|---|---|
clawdock-fix-token |
Escribir el token del Gateway en la configuración del contenedor |
clawdock-update |
Descargar, recompilar y reiniciar |
clawdock-rebuild |
Recompilar únicamente la imagen de Docker |
clawdock-clean |
Eliminar contenedores y volúmenes |
Utilidades
| Comando | Descripción |
|---|---|
clawdock-health |
Ejecutar una comprobación de estado del Gateway |
clawdock-token |
Mostrar el token del Gateway |
clawdock-cd |
Ir al directorio del proyecto OpenClaw |
clawdock-config |
Abrir ~/.openclaw |
clawdock-show-config |
Mostrar los archivos de configuración con valores ocultos |
clawdock-workspace |
Abrir el directorio del espacio de trabajo |
clawdock-help |
Mostrar todos los comandos de ClawDock |
Flujo inicial
clawdock-startclawdock-fix-tokenclawdock-dashboardSi el navegador indica que se requiere emparejamiento:
clawdock-devicesclawdock-approve <request-id>Configuración y secretos
ClawDock lee dos archivos .env independientes, de acuerdo con la separación descrita en Docker:
- El archivo
.envdel proyecto junto adocker-compose.yml: valores específicos de Docker, como el nombre de la imagen, los puertos yOPENCLAW_GATEWAY_TOKEN.clawdock-tokenlee el token desde aquí. ~/.openclaw/.env(montado en el contenedor): secretos respaldados por variables de entorno que administra el propio OpenClaw, junto conopenclaw.jsonyagents/<agentId>/agent/auth-profiles.json.
clawdock-fix-token copia el token del archivo .env del proyecto en los valores de configuración gateway.remote.token y gateway.auth.token del contenedor y reinicia el Gateway.
Usa clawdock-show-config para inspeccionar rápidamente openclaw.json y ambos archivos .env; oculta los valores de .env en la salida mostrada.
