OpenClaw en GCP Compute Engine (Guía Docker)

¿Cansado de que tu Gateway de OpenClaw se apague cada vez que cierras la laptop? Yo pasé por eso. Quería algo que funcionara todo el día sin gastar una fortuna ni pelearme con configuraciones de servidores complejas.

GCP (Google Cloud Platform) es la mejor opción si buscas estabilidad por unos $5 o $12 dólares al mes. En esta guía te enseño a montar OpenClaw en una VM de Compute Engine usando Docker, asegurando que tus datos y configuraciones sobrevivan a cualquier reinicio.

What you need

• Una cuenta de GCP (puedes usar el free tier para la instancia e2-micro).
• gcloud CLI instalado o acceso al Cloud Console en la web.
• Acceso por SSH y conocimientos básicos de terminal.
• Docker y Docker Compose instalados en la VM.
• Credenciales de tus modelos y proveedores (WhatsApp, Telegram o Gmail).

Inicio rápido

Si ya tienes experiencia con la terminal, este es el camino de 5 minutos:

1. Crea un proyecto en GCP y activa la facturación.
2. Lanza una VM (e2-small, Debian 12) y entra por SSH.
3. Instala Docker y clona el repositorio de OpenClaw.
4. Configura tus archivos .env y docker-compose.yml.

---

1. Configura tu proyecto en GCP

Primero, necesitamos un lugar donde trabajar. Puedes usar la web o la terminal.

Vía CLI:

gcloud projects create mi-openclaw-proyecto --name="OpenClaw Gateway"
gcloud config set project mi-openclaw-proyecto

Activa la facturación en la consola y habilita la API:

gcloud services enable compute.googleapis.com

2. Crea la VM

Recomiendo la e2-small para evitar problemas de memoria, aunque la e2-micro entra en el nivel gratuito.

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

Para entrar a la máquina, usa:

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

3. Instala Docker

Dentro de tu nueva VM, ejecuta estos comandos para tener Docker listo:

sudo apt-get update
sudo apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

Sal y vuelve a entrar por SSH para que los cambios de permisos funcionen.

4. Prepara OpenClaw

Clona el repo y crea las carpetas donde se guardarán tus datos. Esto es vital para que no pierdas nada al reiniciar el contenedor.

git clone https://github.com/openclaw/openclaw.git
cd openclaw
mkdir -p ~/.openclaw/workspace

Configura el entorno

Crea un archivo .env en la raíz con estos datos:

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=pon-un-token-seguro
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/home/$USER/.openclaw
OPENCLAW_WORKSPACE_DIR=/home/$USER/.openclaw/workspace

GOG_KEYRING_PASSWORD=tu-password-aqui
XDG_CONFIG_HOME=/home/node/.openclaw

5. Dockerfile y Binarios (Punto Crítico)

Instalar herramientas dentro de un contenedor que ya está corriendo es un error. Si el contenedor se reinicia, lo pierdes todo. Tienes que “hornear” los binaries en la imagen.

Actualiza tu Dockerfile para incluir lo que necesites (como gog para Gmail o wacli para WhatsApp):

FROM node:22-bookworm

RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*

# Ejemplo: Instalar Gmail CLI
RUN curl -L https://github.com/steipete/gog/releases/latest/download/gog_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/gog

WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts

RUN corepack enable
RUN pnpm install --frozen-lockfile

COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build

ENV NODE_ENV=production
CMD ["node","dist/index.js"]

6. Lanza el Gateway

Usa Docker Compose para construir y arrancar:

docker compose build
docker compose up -d openclaw-gateway

Para ver si todo va bien: docker compose logs -f openclaw-gateway

7. Acceso desde tu laptop

Por seguridad, el Gateway solo escucha dentro de la VM. Para entrar desde tu navegador local, crea un túnel SSH:

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

Ahora entra en http://127.0.0.1:18789/ y usa tu token.

---

Solución de problemas

• Error de conexión SSH: Si acabas de crear la VM, espera un par de minutos. Las llaves tardan un poco en propagarse.
• Out of memory (OOM): Si usas la e2-micro y el proceso se muere, cambia el tipo de máquina a e2-small.
• Binarios no encontrados: Recuerda que si añades una nueva herramienta (skill), debes reconstruir la imagen con docker compose build.
• Permisos de Docker: Si te da error al ejecutar docker, asegúrate de haber cerrado y abierto tu sesión SSH tras instalarlo.

Si necesitas ayuda personalizada con tu configuración, usa nuestro AI Setup Assistant.

Próximos pasos

• Configura tus canales de mensajería: Channels
• Conecta tus dispositivos locales: Nodes
• Personaliza tu Gateway: Gateway configuration
• Aprende más sobre seguridad: /gateway/security