GCP

기준일: 2026-07-26
공식 기준: GCP

GCP 문서는 OpenClaw 공식 문서(install/gcp)를 한국어로 정리한 가이드입니다. Run OpenClaw Gateway 24/7 on a GCP Compute Engine VM (Docker) with durable state 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Run OpenClaw Gateway 24/7 on a GCP Compute Engine VM (Docker) with durable state

한국어 가이드 범위: install/gcp 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• What you need
• Quick path
• 트러블슈팅
• Stop the VM first
• Change machine type
• Start the VM
• Service accounts (security best practice)
• 다음 단계
• 관련 문서

상세 내용

본문

Run a persistent OpenClaw Gateway on a GCP Compute Engine VM using Docker, with durable state, baked-in binaries, and safe restart behavior.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

What you need

주요 항목:

• GCP account (e2-micro is free-tier eligible)
• gcloud CLI, or the Cloud Console
• SSH access from your laptop
• Docker and Docker Compose
• Model auth credentials
• Optional provider credentials (WhatsApp QR, Telegram bot token, Gmail OAuth)
• ~20-30 minutes

Quick path

1. Create a GCP project, enable billing and the Compute Engine API 2. Create a Compute Engine VM (e2-small, Debian 12, 20GB) 3. SSH into the VM, install Docker 4. Clone the OpenClaw repository 5. Create persistent host directories 6. Configure .env and docker-compose.yml 7. Bake required binaries, build, and launch

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• .env
• 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
• ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
• ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
• "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"
• Bake required binaries into the image
• Build and launch
• What persists where
• Updates

gcloud init
    gcloud auth login

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

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

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

트러블슈팅

SSH key propagation can take 1-2 minutes after VM creation. Wait and retry.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

gcloud compute os-login describe-profile

Stop the VM first

gcloud compute instances stop openclaw-gateway --zone=us-central1-a

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Change machine type

gcloud compute instances set-machine-type openclaw-gateway \

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Start the VM

gcloud compute instances start openclaw-gateway --zone=us-central1-a ```

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Service accounts (security best practice)

For personal use, your default user account works fine. For automation or CI/CD, create a dedicated service account with minimal permissions:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

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

다음 단계

주요 항목:

• Set up messaging channels: Channels
• Pair local devices as nodes: Nodes
• Configure the Gateway: Gateway configuration

관련 문서

주요 항목:

• Install overview
• Azure
• VPS hosting

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/install/gcp
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

gcloud init
    gcloud auth login

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

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

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

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

exit

관련 링크

• 공식 원문: install/gcp
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.