OpenClaw på GCP Compute Engine (Docker, produktionsguide för VPS)¶

Mål¶

Kör en beständig OpenClaw Gateway på en GCP Compute Engine-VM med Docker, med hållbart tillstånd, inbakade binärer och säkert omstartsbeteende.

Om du vill ha "OpenClaw 24/7 för ~$5-12/mo", är detta en tillförlitlig inställning på Google Cloud. Prissättningen varierar beroende på maskintyp och region; välj den minsta virtuella maskinen som passar din arbetsbelastning och skala upp om du träffar OOMs.

Vad gör vi (enkelt uttryckt)?¶

Skapa ett GCP-projekt och aktivera fakturering
Skapa en Compute Engine-VM
Installera Docker (isolerad app-runtime)
Starta OpenClaw Gateway i Docker
Persist ~/.openclaw + ~/.openclaw/workspace på värden (överlever omstarter/ombyggnader)
Få åtkomst till Control UI från din laptop via en SSH-tunnel

Gatewayn kan nås via:

SSH-portvidarebefordran från din laptop
Direkt portexponering om du själv hanterar brandvägg och tokens

Denna guide använder Debian på GCP Compute Engine. Ubuntu fungerar också; kartpaket därefter. För generiska Docker-flödet, se Docker.

Snabb väg (erfarna operatörer)¶

Skapa GCP-projekt + aktivera Compute Engine API
Skapa Compute Engine-VM (e2-small, Debian 12, 20GB)
SSH in i VM:n
Installera Docker
Klona OpenClaw-repositoriet
Skapa beständiga värdkataloger
Konfigurera .env och docker-compose.yml
Baka in nödvändiga binärer, bygg och starta

Vad du behöver¶

GCP-konto (free tier-berättigad för e2-micro)
gcloud CLI installerad (eller använd Cloud Console)
SSH-åtkomst från din laptop
Grundläggande vana vid SSH + copy/paste
~20–30 minuter
Docker och Docker Compose
Autentiseringsuppgifter för modeller
Valfria leverantörsuppgifter
WhatsApp QR
Telegram-bottoken
Gmail OAuth

1. Installera gcloud CLI (eller använd Console)¶

Alternativ A: gcloud CLI (rekommenderas för automatisering)

Installera från https://cloud.google.com/sdk/docs/install

Initiera och autentisera:

gcloud init
gcloud auth login

Alternativ B: Cloud Console

Alla steg kan göras via webbgränssnittet på https://console.cloud.google.com

2. Skapa ett GCP-projekt¶

CLI:

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

Aktivera fakturering på https://console.cloud.google.com/billing (krävs för Compute Engine).

Aktivera Compute Engine API:

gcloud services enable compute.googleapis.com

Konsol:

Gå till IAM & Admin > Create Project
Namnge det och skapa
Aktivera fakturering för projektet
Navigera till APIs & Services > Enable APIs > sök ”Compute Engine API” > Enable

3. Skapa VM:n¶

Maskintyper:

Typ	Specifikationer	Kostnad	Noteringar
e2-small	2 vCPU, 2GB RAM	~$12/mån	Rekommenderad
e2-micro	2 vCPU (delad), 1GB RAM	Free tier-berättigad	Kan få OOM vid last

CLI:

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

Konsol:

Gå till Compute Engine > VM instances > Create instance
Namn: openclaw-gateway
Region: us-central1, Zon: us-central1-a
Maskintyp: e2-small
Startdisk: Debian 12, 20GB
Skapa

4. SSH in i VM:n¶

CLI:

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

Konsol:

Klicka på ”SSH”-knappen bredvid din VM i Compute Engine-instrumentpanelen.

Obs: SSH-nyckelförökning kan ta 1-2 minuter efter skapande av virtuella datorer. Om anslutningen avslås, vänta och försök igen.

5. Installera Docker (på VM:n)¶

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

Logga ut och in igen för att gruppändringen ska träda i kraft:

exit

SSH:a sedan in igen:

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

Verifiera:

docker --version
docker compose version

6. Klona OpenClaw-repositoriet¶

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

Den här guiden förutsätter att du bygger en anpassad image för att garantera binär persistens.

7. Skapa beständiga värdkataloger¶

Docker behållare är efhemeral. Alla långlivade stater måste leva på värden.

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

8. Konfigurera miljövariabler¶

Skapa .env i repositoriets rot.

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=change-me-now
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

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

GOG_KEYRING_PASSWORD=change-me-now
XDG_CONFIG_HOME=/home/node/.openclaw

Generera starka hemligheter:

openssl rand -hex 32

Committa inte denna fil.

9. Docker Compose-konfiguration¶

Skapa eller uppdatera 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:
      # Recommended: keep the Gateway loopback-only on the VM; access via SSH tunnel.
      # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly.
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"

      # Optional: only if you run iOS/Android nodes against this VM and need Canvas host.
      # If you expose this publicly, read /gateway/security and firewall accordingly.
      # - "18793:18793"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
      ]

10. Baka in nödvändiga binärer i imagen (kritiskt)¶

Installera binärer i en fungerande behållare är en fälla. Allt som är installerat vid körtiden kommer att gå förlorat vid omstart.

Alla externa binärer som krävs av Skills måste installeras vid image-build-tid.

Exemplen nedan visar endast tre vanliga binärer:

gog för Gmail-åtkomst
goplaces för Google Places
wacli för WhatsApp

Detta är exempel, inte en fullständig lista. Du kan installera så många binärer som behövs med samma mönster.

Om du senare lägger till nya Skills som beror på ytterligare binärer måste du:

Uppdatera Dockerfile
Bygga om imagen
Starta om containrarna

Exempel på Dockerfile

FROM node:22-bookworm

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

# Example binary 1: 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

# Example binary 2: Google Places CLI
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/goplaces

# Example binary 3: WhatsApp CLI
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/wacli

# Add more binaries below using the same pattern

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"]

11. Bygg och starta¶

docker compose build
docker compose up -d openclaw-gateway

Verifiera binärer:

docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli

Förväntad utdata:

/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli

12. Verifiera Gateway¶

docker compose logs -f openclaw-gateway

Lyckat resultat:

[gateway] listening on ws://0.0.0.0:18789

13. Åtkomst från din laptop¶

Skapa en SSH-tunnel för att vidarebefordra Gateway-porten:

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

Öppna i din webbläsare:

http://127.0.0.1:18789/

Klistra in din gateway-token.

Vad persisterar var (sanningskälla)¶

OpenClaw körs i Docker, men Docker är inte sanningens källa. Alla långlivade tillstånd måste överleva omstarter, återuppbygga och starta om.

Komponent	Plats	Persistensmekanism	Noteringar
Gateway-konfig	`/home/node/.openclaw/`	Värdvolym-mount	Inkluderar `openclaw.json`, tokens
Modellautentiseringsprofiler	`/home/node/.openclaw/`	Värdvolym-mount	OAuth-tokens, API-nycklar
Skill-konfig	`/home/node/.openclaw/skills/`	Värdvolym-mount	Status på Skill-nivå
Agent-arbetsyta	`/home/node/.openclaw/workspace/`	Värdvolym-mount	Kod och agentartefakter
WhatsApp-session	`/home/node/.openclaw/`	Värdvolym-mount	Bevarar QR-inloggning
Gmail-nyckelring	`/home/node/.openclaw/`	Värdvolym + lösenord	Kräver `GOG_KEYRING_PASSWORD`
Externa binärer	`/usr/local/bin/`	Docker-image	Måste bakas in vid build-tid
Node-runtime	Containerfilsystem	Docker-image	Byggs om vid varje image-build
OS-paket	Containerfilsystem	Docker-image	Installera inte vid runtime
Docker-container	Flyktig	Omstartbar	Säker att förstöra

Uppdateringar¶

För att uppdatera OpenClaw på VM:n:

cd ~/openclaw
git pull
docker compose build
docker compose up -d

Felsökning¶

SSH-anslutning nekas

SSH-nyckelförökning kan ta 1-2 minuter efter skapande av virtuella datorer. Vänta och försök igen.

OS Login-problem

Kontrollera din OS Login-profil:

gcloud compute os-login describe-profile

Se till att ditt konto har nödvändiga IAM-behörigheter (Compute OS Login eller Compute OS Admin Login).

Slut på minne (OOM)

Om du använder e2-micro och får OOM, uppgradera till e2-small eller e2-medium:

# Stop the VM first
gcloud compute instances stop openclaw-gateway --zone=us-central1-a

# Change machine type
gcloud compute instances set-machine-type openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small

# Start the VM
gcloud compute instances start openclaw-gateway --zone=us-central1-a

Tjänstekonton (säkerhetsrekommendation)¶

För personligt bruk fungerar ditt standardanvändarkonto bra.

För automatisering eller CI/CD-pipelines, skapa ett dedikerat tjänstekonto med minsta möjliga behörigheter:

Skapa ett tjänstekonto:

bash gcloud iam service-accounts create openclaw-deploy \ --display-name="OpenClaw Deployment"

Tilldela rollen Compute Instance Admin (eller en snävare anpassad roll):

bash gcloud projects add-iam-policy-binding my-openclaw-project \ --member="serviceAccount:openclaw-deploy@my-openclaw-project.iam.gserviceaccount.com" \ --role="roles/compute.instanceAdmin.v1"

Undvik att använda ägarrollen för automatisering. Använd principen om minst privilegium.

Se https://cloud.google.com/iam/docs/understanding-roles för detaljer om IAM-roller.

Nästa steg¶

Sätt upp meddelandekanaler: Channels
Para lokala enheter som noder: Nodes
Konfigurera Gateway: Gateway configuration

Install overview

Other install methods

Maintenance

Hosting and deployment

Advanced

GCP

OpenClaw på GCP Compute Engine (Docker, produktionsguide för VPS)¶

Mål¶

Vad gör vi (enkelt uttryckt)?¶

Snabb väg (erfarna operatörer)¶

Vad du behöver¶

1. Installera gcloud CLI (eller använd Console)¶

2. Skapa ett GCP-projekt¶

3. Skapa VM:n¶

4. SSH in i VM:n¶

5. Installera Docker (på VM:n)¶

6. Klona OpenClaw-repositoriet¶

7. Skapa beständiga värdkataloger¶

8. Konfigurera miljövariabler¶

9. Docker Compose-konfiguration¶

10. Baka in nödvändiga binärer i imagen (kritiskt)¶

11. Bygg och starta¶

12. Verifiera Gateway¶

13. Åtkomst från din laptop¶

Vad persisterar var (sanningskälla)¶

Uppdateringar¶

Felsökning¶

Tjänstekonton (säkerhetsrekommendation)¶

Nästa steg¶