OpenClawDocs
En esta página

En esta página

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Comenzar

ClawDock

ClawDock es una pequeña capa de funciones auxiliares de shell para instalaciones de OpenClaw basadas en Docker.

Proporciona 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 se ha configurado Docker, se debe comenzar por Docker.

Instalación

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

Si ClawDock se instaló anteriormente desde scripts/shell-helpers/clawdock-helpers.sh, se debe reinstalar desde la ruta actual scripts/clawdock/clawdock-helpers.sh; la antigua ruta directa de GitHub se eliminó.

Las funciones auxiliares detectan automáticamente la copia de trabajo de OpenClaw la primera vez que se usan (comprobando rutas habituales como ~/openclaw y ~/projects/openclaw) y almacenan el resultado en caché en ~/.clawdock/config. Se debe definir CLAWDOCK_DIR manualmente si la 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 en el contenedor

Interfaz web y vinculación

Comando Descripción
clawdock-dashboard Abrir la URL de la interfaz de control
clawdock-devices Enumerar las vinculaciones de dispositivos pendientes
clawdock-approve <id> Aprobar una solicitud de vinculación

Configuración y mantenimiento

Comando Descripción
clawdock-fix-token Escribir el token del Gateway en la configuración del contenedor
clawdock-update Descargar, volver a compilar y reiniciar
clawdock-rebuild Volver a compilar ú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 los valores ocultos
clawdock-workspace Abrir el directorio del espacio de trabajo
clawdock-help Enumerar todos los comandos de ClawDock

Flujo inicial

bash
clawdock-startclawdock-fix-tokenclawdock-dashboard

Si el navegador indica que se requiere vinculación:

bash
clawdock-devicesclawdock-approve <request-id>

Configuración y secretos

ClawDock lee dos archivos .env independientes, de acuerdo con la división descrita en Docker:

  • El archivo .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 administra el propio OpenClaw, junto con openclaw.json y agents/<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.

Se puede usar clawdock-show-config para inspeccionar rápidamente openclaw.json y ambos archivos .env; oculta los valores de .env en la salida mostrada.

Contenido relacionado

Docker

Instalación canónica de Docker para OpenClaw.
Entorno de ejecución de máquina virtual de Docker

Entorno de ejecución de máquina virtual administrado por Docker para un aislamiento reforzado.
Actualización

Actualización del paquete de OpenClaw y de los servicios administrados.
Was this useful?