가이드

GCP OpenClaw 배포 가이드

이 문서는 Google Cloud Platform (GCP) VM 인스턴스에 OpenClaw를 배포하기 위한 단계별 가이드를 제공합니다. 초기 GCP 설정부터 OpenClaw 및 GOG CLI 구성까지 모든 과정을 다룹니다.

0. 안티그래비티 스킬 다운로드

이 스킬은 GCP VM에 OpenClaw를 설치하는 스킬입니다. 아래 명령어도 프로젝트 루트에 바로 다운로드 가능합니다.

npx dantelabs-agentic-school install gcp-openclaw --target agents --no-common

1. 전제 조건 (로컬 머신)

로컬 컴퓨터에 Google Cloud CLI (gcloud)가 설치되어 있고 인증이 완료되었는지 확인하십시오.

1.0 Google Cloud CLI 설치

# 패키지 소스 추가
sudo apt-get install -y apt-transport-https ca-certificates gnupg curl
curl <https://packages.cloud.google.com/apt/doc/apt-key.gpg> | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] <https://packages.cloud.google.com/apt> cloud-sdk main" | sudo tee /etc/apt/sources.list.d/google-cloud-sdk.list

# 설치
sudo apt-get update && sudo apt-get install -y google-cloud-cli

# 설치 확인
gcloud version

1.1 Google Cloud 인증

gcloud auth login --no-launch-browser

출력된 URL을 브라우저에서 열어 인증하고, 확인 코드를 터미널에 붙여넣습니다.

1.2 프로젝트 및 결제 설정

https://console.cloude.google.com 접속하여 새 프로젝트를 생성합니다.

# 프로젝트 ID 설정
gcloud config set project [YOUR_PROJECT_ID]

# 필요한 서비스 활성화
gcloud services enable compute.googleapis.com
gcloud services enable cloudresourcemanager.googleapis.com

2. VM 인스턴스 생성

충분한 리소스를 가진 VM 인스턴스를 생성합니다. 권장 사양: e2-small (2 vCPU, 2GB RAM) 또는 e2-medium (2 vCPU, 4GB RAM). 운영체제: Ubuntu 22.04 LTS

gcloud compute instances create openclaw-instance \\\\
    --zone=us-central1-a \\\\
    --machine-type=e2-small \\\\
    --image-family=ubuntu-2204-lts \\\\
    --image-project=ubuntu-os-cloud \\\\
    --boot-disk-size=25GB \\\\
    --boot-disk-type=pd-balanced \\\\
    --labels=env=dev,app=openclaw

3. SSH 구성

VM에 쉽게 접속할 수 있도록 SSH를 구성합니다.

3.1 키 생성 및 접속

# 키 자동 생성 및 접속
gcloud compute ssh openclaw-instance --zone=us-central1-a

3.2 표준 SSH 별칭 (선택 사항이지만 권장됨)

로컬 ~/.ssh/config 파일에 다음 내용을 추가합니다.

Host openclaw
    HostName [EXTERNAL_IP]
    User [YOUR_USERNAME]
    IdentityFile ~/.ssh/google_compute_engine

4. 의존성 및 도구 설치 (원격 서버)

서버에 SSH로 접속하여 필요한 도구를 설치합니다.

# 서버 접속
gcloud compute ssh openclaw-instance --zone=us-central1-a

# 업데이트 및 기본 도구 설치
sudo apt-get update
sudo apt-get install -y git curl make build-essential

4.1 Node.js 설치 (v22 이상)

OpenClaw는 Node.js v22 이상이 필요합니다.

curl -fsSL <https://deb.nodesource.com/setup_22.x> | sudo -E bash -
sudo apt-get install -y nodejs

4.2 Go 설치 (최신 버전 필수)

GOG CLI 빌드를 위해서는 반드시 최신 버전의 Go (1.23 이상)가 필요합니다. 운영체제 기본 패키지(예: apt install golang)는 버전이 낮아 빌드에 실패할 수 있으므로, 아래와 같이 수동 설치를 권장합니다.

wget <https://go.dev/dl/go1.23.6.linux-amd64.tar.gz>
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.23.6.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

5. OpenClaw 설치

OpenClaw를 전역으로 설치합니다.

# OpenClaw 설치
curl -fsSL <https://openclaw.ai/install.sh> | bash
# 또는
sudo npm install -g openclaw@latest

5.1 OpenClaw 초기화

openclaw onboard

대화형 설정 마법사를 따라 에이전트를 구성합니다.

QuickStart를 선택합니다. 이 튜토리얼에서는 Google Antigravity Oauth로 Gemini 구독 계정의 모델을 사용할 것이므로, Google 을 선택합니다.

Google Antigravity OAuth을 선택합니다.

Copy this Url 아래 나오는 링크를 Ctrl을 누른 상태에서 클릭하면 브라우저가 열립니다.

원하는 구글 계정으로 로그인을 진행합니다.

로그인이 되면 ‘사이트에 연결할수 없음’이라고 나온다고 당황하지 말고, 위 주소표시줄을 url 을 복사합니다.

다시 안티그래비티 터미널 창으로 와서, 붙여넣고 엔터키를 누릅니다.

그러면 인증이 완료되며, 모델을 선택할수 있습니다. 이 예제에서는 google-antigravity/gemini-3-flash 모델을 선택할 것입니다.

다음은 메신저를 선택하는 단계입니다. Telegram 을 사용하겠습니다.

텔레그램을 데스크톱앱 혹은 웹으로 접속해서 검색창에 ‘Botfather’ 라고 검색합니다. 그러면 가장 윗줄에 나오는 BotFather라는 앱을 열기 합니다.

Start 버튼을 누릅니다.

채팅창이 열리면서 동시에, Botfather가 메뉴 안내 메세지를 보냅니다. 여기서 ‘/newbot’을 클릭하면 새로운 텔레그램봇을 생성하게 됩니다.

이름과 username을 결정해주어야합니다. username은 반드시 _bot 또는 Bot으로 끝나는 이름이어야합니다. 이 예제에서는 이름와 Username을 동일하게 맞춰주도록 하겠습니다. username은 고유한 이름이어야 하므로, 여러분에게 맞는 이름을 선택하세요.

이름과 username을 선택하면 봇이 생성되었다는 안내와, 채팅창 링크와, 프로그램용 HTTP API TOKEN을 안내해 줍니다. 클릭하면 복사가 됩니다.

아직 OpenClaw TUI에서 이 사용자와의 대화를 승인하지 않았기 때문에 채팅창을 열어서 말을 걸어도 OpenClaw가 응답해주지 않습니다. 이 부분은 이후 과정에서 TUI 단계에서 승인을 해주어야 대화가 가능해집니다.

복사한 Token을 안티그래비티 터미널에 붙여넣고 엔터키를 누릅니다.

OpenClaw는 스킬을 바탕으로 기능이 확장되고, 빌트인 스킬과 외부 스키을 모두 연동할수 있습니다. 스킬은 다음 영상에서 자세히 다룰예정이니 여기서는 스킵하도록 하겠습니다.

Hatch in TUI 를 선택하면 터미널 환경에서 OpenClaw와 상견례를 할수 있게 됩니다. 만약 Open the web UI를 선택하게 되면 원격서버는 브라우저 환경이 없으니, 로컬머신에서 웹으로 접속하기 위해서는 ‘SSH 터널링’ 이라는 절차가 필요해집니다. 조금 복잡할수 있으므로 아래 설정 코드로 갈음하고 여기서는 Hatch in TUI로 진행하겠습니다.

OpenClaw는 첫 대화시, ‘페르소나’를 부여해주기를 요청합니다. 역할과 성격, 주사용 이모지 등을 부여해주면 앞으로 그 캐릭터에 맞게 대화를 이어나가게됩니다.

6. GOG CLI 설치

</aside>