Saltar al contenido principal
ClawDock es una pequeña capa de ayudantes de shell para instalaciones de OpenClaw basadas en Docker. Te da comandos cortos 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, empieza con Docker.

​
Instalación

mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.sh
echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc
Si instalaste ClawDock anteriormente desde scripts/shell-helpers/clawdock-helpers.sh, reinstálalo desde la ruta actual scripts/clawdock/clawdock-helpers.sh; la antigua ruta sin procesar de GitHub se eliminó. Los ayudantes autodetectan tu checkout de OpenClaw en el primer uso (comprobando rutas comunes como ~/openclaw, ~/projects/openclaw) y almacenan el resultado en caché en ~/.clawdock/config. Define CLAWDOCK_DIR tú mismo si tu checkout está en otro lugar.

​
Qué obtienes

​
Operaciones básicas

ComandoDescripción
clawdock-startIniciar el Gateway
clawdock-stopDetener el Gateway
clawdock-restartReiniciar el Gateway
clawdock-statusComprobar el estado del contenedor
clawdock-logsSeguir los registros del Gateway

​
Acceso al contenedor

ComandoDescripción
clawdock-shellAbrir una 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 en el contenedor

​
Interfaz web y emparejamiento

ComandoDescripción
clawdock-dashboardAbrir la URL de la interfaz de control
clawdock-devicesEnumerar emparejamientos de dispositivos pendientes
clawdock-approve <id>Aprobar una solicitud de emparejamiento

​
Configuración y mantenimiento

ComandoDescripción
clawdock-fix-tokenEscribir el token del Gateway en la configuración del contenedor
clawdock-updateExtraer, reconstruir y reiniciar
clawdock-rebuildReconstruir solo la imagen de Docker
clawdock-cleanEliminar contenedores y volúmenes

​
Utilidades

ComandoDescripción
clawdock-healthEjecutar una comprobación de estado del Gateway
clawdock-tokenImprimir el token del Gateway
clawdock-cdIr al directorio del proyecto OpenClaw
clawdock-configAbrir ~/.openclaw
clawdock-show-configImprimir archivos de configuración con valores redactados
clawdock-workspaceAbrir el directorio del espacio de trabajo
clawdock-helpEnumerar todos los comandos de ClawDock

​
Flujo inicial

clawdock-start
clawdock-fix-token
clawdock-dashboard
Si el navegador indica que se requiere emparejamiento: 
clawdock-devices
clawdock-approve <request-id>

​
Configuración y secretos

ClawDock lee dos archivos .env separados, coincidiendo con la separación descrita en Docker:
  • El .env del proyecto junto a docker-compose.yml: valores específicos de Docker como el nombre de la imagen, los puertos y OPENCLAW_GATEWAY_TOKEN. clawdock-token lee el token desde aquí.
  • ~/.openclaw/.env (montado en el contenedor): secretos respaldados por variables de entorno que OpenClaw administra, junto con openclaw.json y agents/<agentId>/agent/auth-profiles.json.
clawdock-fix-token copia el token del .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; redacta los valores de .env en la salida impresa.

​
Relacionado

Docker

Instalación canónica de Docker para OpenClaw.

Tiempo de ejecución de VM de Docker

Tiempo de ejecución de VM administrado por Docker para aislamiento reforzado.

Actualización

Actualización del paquete OpenClaw y los servicios administrados.