# OpenClaw on GCP Compute Engine

## Overview

This guide establishes a persistent OpenClaw Gateway on Google Cloud's Compute Engine using Docker, designed for reliable 24/7 operation at approximately $5-12 monthly.

## Key Setup Steps

The deployment process involves:

1. **GCP Project Configuration** - Create a project and enable the Compute Engine API
2. **VM Provisioning** - Deploy a Debian 12 instance (e2-small recommended with 2 vCPU, 2GB RAM)
3. **Docker Installation** - Set up containerization on the host system
4. **Repository Cloning** - Obtain the OpenClaw codebase
5. **Persistent Directories** - Create `~/.openclaw` and workspace folders for state preservation
6. **Environment Configuration** - Define `.env` with tokens and credentials
7. **Binary Baking** - Embed required tools (gog, goplaces, wacli) in the Docker image at build time
8. **Container Launch** - Start the gateway service

## Critical Architecture Decision

Installing binaries inside a running container is a trap. Anything installed at runtime will be lost on restart. All external dependencies must be embedded during image construction via the Dockerfile.

## Access Method

The guide recommends SSH port forwarding rather than direct exposure: keep the Gateway loopback-only on the VM; access via SSH tunnel.

## State Persistence

Long-lived data (configurations, tokens, workspace artifacts) survives container restarts through host volume mounts, while the container itself remains ephemeral and rebuilable.
