GCP

Instalar la CLI de gcloud (o usar Console)

Instálela desde cloud.google.com/sdk/docs/install y, a continuación, ejecute:

gcloud initgcloud auth login

Como alternativa, realice todos los pasos siguientes mediante la interfaz web de Cloud Console.

Crear un proyecto de GCP

gcloud projects create my-openclaw-project --name="OpenClaw Gateway"gcloud config set project my-openclaw-projectgcloud services enable compute.googleapis.com

Habilite la facturación en console.cloud.google.com/billing (es obligatoria para Compute Engine).

Equivalente en Console: IAM & Admin > Create Project, habilite la facturación y, a continuación, APIs & Services > Enable APIs > "Compute Engine API" > Enable.

Crear la VM

gcloud compute instances create openclaw-gateway \  --zone=us-central1-a \  --machine-type=e2-small \  --boot-disk-size=20GB \  --image-family=debian-12 \  --image-project=debian-cloud

Conectarse por SSH a la VM

gcloud compute ssh openclaw-gateway --zone=us-central1-a

Console: haga clic en "SSH" junto a la VM en el panel de Compute Engine.

La propagación de claves SSH puede tardar 1-2 minutos después de crear la VM; espere y vuelva a intentarlo si se rechaza la conexión.

Instalar Docker (en la VM)

sudo apt-get updatesudo apt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sudo shsudo usermod -aG docker $USER

Cierre la sesión y vuelva a iniciarla para que el cambio de grupo surta efecto; después, vuelva a conectarse por SSH:

exit

gcloud compute ssh openclaw-gateway --zone=us-central1-a

Compruebe la instalación:

docker --versiondocker compose version

Clonar el repositorio de OpenClaw

git clone https://github.com/openclaw/openclaw.gitcd openclaw

Esta guía compila una imagen personalizada para que los binarios integrados se conserven tras los reinicios.

Crear directorios persistentes en el host

Los contenedores de Docker son efímeros; todo el estado de larga duración debe residir en el host.

mkdir -p ~/.openclawmkdir -p ~/.openclaw/workspace

Configurar las variables de entorno

Cree .env en la raíz del repositorio:

OPENCLAW_IMAGE=openclaw:latestOPENCLAW_GATEWAY_TOKEN=OPENCLAW_GATEWAY_BIND=lanOPENCLAW_GATEWAY_PORT=18789 OPENCLAW_CONFIG_DIR=/home/$USER/.openclawOPENCLAW_WORKSPACE_DIR=/home/$USER/.openclaw/workspace GOG_KEYRING_PASSWORD=XDG_CONFIG_HOME=/home/node/.openclaw

Establezca OPENCLAW_GATEWAY_TOKEN para gestionar el token estable del Gateway mediante .env; de lo contrario, configure gateway.auth.token antes de depender de clientes entre reinicios. Si no se establece ninguno, OpenClaw utiliza un token exclusivo del tiempo de ejecución para ese inicio. Genere una contraseña para el almacén de claves de GOG_KEYRING_PASSWORD:

openssl rand -hex 32

No confirme este archivo en el repositorio. Contiene variables de entorno del contenedor y del tiempo de ejecución, como OPENCLAW_GATEWAY_TOKEN. La autenticación OAuth o mediante claves de API de los proveedores se almacena en el ~/.openclaw/agents/<agentId>/agent/auth-profiles.json montado.

Configuración de Docker Compose

Cree o actualice docker-compose.yml:

services:  openclaw-gateway:    image: ${OPENCLAW_IMAGE}    build: .    restart: unless-stopped    env_file:      - .env    environment:      - HOME=/home/node      - NODE_ENV=production      - TERM=xterm-256color      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin    volumes:      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace    ports:      # Recomendado: mantenga el Gateway accesible solo mediante la interfaz de bucle invertido en la VM; acceda mediante un túnel SSH.      # Para exponerlo públicamente, elimine el prefijo `127.0.0.1:` y configure el cortafuegos según corresponda.      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"    command:      [        "node",        "dist/index.js",        "gateway",        "--bind",        "${OPENCLAW_GATEWAY_BIND}",        "--port",        "${OPENCLAW_GATEWAY_PORT}",        "--allow-unconfigured",      ]

--allow-unconfigured solo facilita el arranque inicial; no sustituye a una configuración real del Gateway. Configure igualmente la autenticación (gateway.auth.token o una contraseña) y un modo de enlace seguro para su despliegue.

Pasos compartidos del tiempo de ejecución de una VM con Docker

Siga la guía compartida del tiempo de ejecución para aplicar el flujo común de hosts Docker:

• Integrar los binarios necesarios en la imagen
• Compilar e iniciar
• Qué persiste y dónde
• Actualizaciones

Notas de inicio específicas de GCP

Si la compilación falla con Killed o exit code 137 durante pnpm install --frozen-lockfile, la VM se ha quedado sin memoria. Utilice como mínimo e2-small o e2-medium para que las primeras compilaciones sean más fiables.

Al enlazar con la LAN (OPENCLAW_GATEWAY_BIND=lan), configure un origen de navegador de confianza antes de continuar:

docker compose run --rm openclaw-cli config set gateway.controlUi.allowedOrigins '["http://127.0.0.1:18789"]' --strict-json

Sustituya 18789 por el puerto configurado si lo ha cambiado.

Acceder desde su portátil

Cree un túnel SSH para reenviar el puerto del Gateway:

gcloud compute ssh openclaw-gateway --zone=us-central1-a -- -L 18789:127.0.0.1:18789

Abra http://127.0.0.1:18789/ en el navegador.

Vuelva a mostrar un enlace limpio al panel:

docker compose run --rm openclaw-cli dashboard --no-open

Si la interfaz solicita autenticación mediante secreto compartido, pegue el token o la contraseña configurados en los ajustes de Control UI (este flujo de Docker escribe un token de forma predeterminada; utilice la contraseña configurada si cambió a la autenticación mediante contraseña).

Si Control UI muestra unauthorized o disconnected (1008): pairing required, apruebe el dispositivo del navegador:

docker compose run --rm openclaw-cli devices listdocker compose run --rm openclaw-cli devices approve <requestId>

Consulte Tiempo de ejecución de una VM con Docker para ver el mapa de persistencia compartido y el flujo de actualización.