OpenClaw을 Google Cloud Compute Engine에 배포하기

Google Cloud 플랫폼 개요

Google Cloud Platform(GCP)은 세계 3대 클라우드 서비스 제공자 중 하나로, Compute Engine은 유연한 가상 머신 인스턴스를 제공합니다. GCP의 무료 티어에는 e2-micro 인스턴스가 포함되어 있어, 가벼운 OpenClaw 배포의 시작점으로 활용할 수 있습니다. 이 글에서는 GCE 인스턴스에 OpenClaw AI Agent 게이트웨이를 배포하는 방법을 상세히 소개합니다.

사전 요구사항

결제 기능이 활성화된 Google Cloud 계정
gcloud CLI 도구 설치 완료(또는 Cloud Shell 사용)
기본적인 Linux 명령줄 조작 경험

Compute Engine 인스턴스 생성

gcloud CLI로 생성

로컬에 gcloud CLI가 설치되어 있다면 명령줄로 직접 인스턴스를 생성할 수 있습니다:

gcloud compute instances create openclaw-server \
  --zone=asia-east1-b \
  --machine-type=e2-small \
  --image-family=ubuntu-2404-lts-amd64 \
  --image-project=ubuntu-os-cloud \
  --boot-disk-size=20GB \
  --tags=http-server,https-server

이 명령어는 타이완 리전에 e2-small 인스턴스(2 vCPU, 2GB RAM)를 생성하며, Ubuntu 24.04 LTS 시스템을 실행합니다. 여러 채팅 플랫폼을 연결하고 많은 메시지를 처리하는 시나리오에서는 e2-medium(2 vCPU, 4GB RAM) 이상의 사양을 권장합니다.

방화벽 규칙 설정

OpenClaw의 Dashboard 포트에 대한 방화벽 규칙을 생성합니다:

gcloud compute firewall-rules create allow-openclaw \
  --allow=tcp:3000 \
  --target-tags=http-server \
  --description="Allow OpenClaw Dashboard access"

인스턴스에 연결

gcloud 명령어로 SSH를 통해 연결합니다:

gcloud compute ssh openclaw-server --zone=asia-east1-b

또는 GCP Console에서 인스턴스 옆의 "SSH" 버튼을 클릭하여 브라우저 내장 터미널로 연결할 수 있습니다.

Node.js 22 설치

OpenClaw은 Node.js 22+ 버전을 요구합니다. NodeSource 공식 저장소를 사용하여 설치합니다:

sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

설치 버전을 확인합니다:

node --version
npm --version

Node.js 버전이 22.x 이상인지 확인하세요. Bun을 대체 런타임으로 사용하지 마세요. WhatsApp과 Telegram 연결 처리 시 알려진 호환성 문제가 있습니다.

OpenClaw 설치

두 가지 설치 방식 중 선택할 수 있습니다.

방법 1: npm 전역 설치

sudo npm install -g openclaw@latest

방법 2: 공식 설치 스크립트

curl -fsSL https://openclaw.ai/install.sh | bash

설치 후 확인합니다:

openclaw --version

OpenClaw 초기화

가이드 프로그램을 실행하여 초기 설정을 완료합니다:

openclaw onboard --install-daemon

가이드 프로그램이 다음 설정 단계를 안내합니다:

AI 모델 설정: AI 모델 제공자의 API 키를 선택하고 입력합니다(OpenAI, Anthropic, Google Gemini 등 지원)
채팅 플랫폼 연결: WhatsApp, Telegram, Discord 등 연결할 채팅 앱을 설정합니다
데몬 프로세스 설치: Linux에서는 자동으로 systemd 서비스를 설정합니다

설정 파일은 ~/.openclaw/openclaw.json에 저장됩니다.

systemd 서비스 설정

가이드 프로그램이 자동으로 systemd 서비스를 생성하지 않은 경우, 수동으로 설정할 수 있습니다. 서비스 파일을 생성합니다:

sudo tee /etc/systemd/system/openclaw.service > /dev/null << 'EOF'
[Unit]
Description=OpenClaw AI Agent Gateway
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=사용자이름
ExecStart=/usr/bin/openclaw start
Restart=always
RestartSec=5
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
EOF

서비스를 활성화하고 시작합니다:

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

서비스 상태를 확인합니다:

sudo systemctl status openclaw

진단 검사 실행

OpenClaw 내장 진단 도구로 모든 것이 정상인지 확인합니다:

openclaw doctor

이 명령어는 Node.js 버전, 설정 파일 무결성, 네트워크 연결, 각 채팅 플랫폼의 연결 상태 등을 검사합니다. 모든 검사 항목이 통과하는지 확인하세요.

관리 패널 접속

Dashboard를 시작합니다:

openclaw dashboard

브라우저에서 http://외부IP:3000에 접속하면 OpenClaw 관리 패널을 열 수 있습니다. 여기에서 채팅 플랫폼 연결을 시각적으로 관리하고, 메시지 로그를 확인하며, AI 모델 매개변수를 설정할 수 있습니다.

HTTPS 설정(강력 권장)

프로덕션 환경에서는 HTTPS 설정을 강력히 권장합니다. Nginx와 Certbot을 설치합니다:

sudo apt install -y nginx certbot python3-certbot-nginx

Nginx 설정을 생성하고 인증서를 신청합니다:

sudo tee /etc/nginx/sites-available/openclaw << 'EOF'
server {
    server_name openclaw.yourdomain.com;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}
EOF

sudo ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d openclaw.yourdomain.com

고정 외부 IP 설정

기본적으로 GCE 인스턴스는 임시 외부 IP를 사용하므로, 재시작 후 변경될 수 있습니다. 고정 IP를 예약하는 것을 권장합니다:

gcloud compute addresses create openclaw-ip --region=asia-east1
gcloud compute instances delete-access-config openclaw-server --zone=asia-east1-b --access-config-name="External NAT"
gcloud compute instances add-access-config openclaw-server --zone=asia-east1-b --address=예약된고정IP

모니터링 및 로그

GCP는 강력한 Cloud Monitoring과 Cloud Logging 서비스를 제공합니다. GCP Console에서 인스턴스의 CPU, 메모리, 네트워크 사용 현황을 확인할 수 있습니다. OpenClaw의 실행 로그는 다음 명령어로 확인할 수 있습니다:

journalctl -u openclaw -f

비용 최적화 제안

개인 프로젝트나 소규모 사용의 경우, 다음 전략으로 비용을 관리할 수 있습니다:

e2-micro 인스턴스(무료 티어 포함)를 시작점으로 사용
가장 가까운 리전을 선택하여 지연 시간 단축
예산 알림을 설정하여 예상치 못한 비용 방지
트래픽 변동이 큰 경우 선점형 인스턴스 사용을 고려하여 비용 절감

정리

Google Cloud Compute Engine은 OpenClaw에 안정적이고 신뢰할 수 있는 실행 환경을 제공합니다. GCP는 아시아 태평양 지역에 여러 데이터 센터를 보유하고 있어 한국 및 동남아시아 사용자에게 특히 유리합니다. 이 튜토리얼의 설정을 통해 프로덕션 수준의 OpenClaw AI Agent 게이트웨이를 구축하여 다양한 채팅 플랫폼과 AI 모델을 안정적으로 연결할 수 있습니다.