오픈클로(OpenClaw) 완전 설치 가이드
서버 없이 구글 클라우드(GCP)로 30~60분 완성 (2026년 기준)

단태랩스 영상 기반 + 공식 문서 반영 초보자용 상세 가이드

핵심 목표
텔레그램으로 24시간 나만의 AI 비서(자비스) 부르기 + 구글 서비스(메일·캘린더·시트·독스·드라이브) 완전 제어

1. 오픈클로(OpenClaw)란?

오픈소스 개인 AI 에이전트 프레임워크

• 텔레그램·슬랙 등 메신저로 실시간 대화
• 구글 서비스 완전 제어 (읽기/쓰기/삭제/생성)
• 원하는 LLM 선택 (Gemini, Claude, GPT, Grok 등)
• 셀프호스팅 → 데이터 유출 걱정 ↓
• 개발자: Peter Steinberger (2026년 기준 OpenAI 합류 후에도 독립 유지)

2. 사전 준비물 (필수)

1. 구글 계정 (무료 크레딧 $300 신규 가입 시 제공)
2. 결제 수단 등록 (크레딧 소진 후 자동 과금 안 됨)
3. 텔레그램 앱 (모바일/PC/웹 모두 가능)
4. VS Code + WSL (윈도우 사용자 필수)
5. 30~60분 시간

3. 전체 흐름 (타임라인)

1. 로컬 환경 세팅 (AntiGravity + WSL) → 5분
2. GCP 프로젝트 & API 활성화 → 8분
3. OAuth 클라이언트 생성 → 5분
4. gcloud CLI 인증 → 5분
5. VM 생성 & OpenClaw 설치 → 10~15분
6. 텔레그램 봇 + 온보드 → 5~10분
7. 실전 테스트 & 자동화 → 나머지

4. 상세 설치 단계

1 로컬 환경 준비 (VS Code + WSL)

• VS Code 설치 → 확장 “Remote - WSL” 설치
• Ctrl+Shift+P → Remote-WSL: Connect to WSL → Ubuntu 선택
• 새 폴더 → 워크스페이스 안에 openclaw 빈 폴더 생성

2 AntiGravity 스킬 다운로드

npx @dantelabs/agentic-school gcp-openclaw

→ agents/gcp-openclaw 폴더만 남기고 나머지 삭제

3 Google Cloud Console 설정

https://console.cloud.google.com

1. 새 프로젝트 생성 → 이름: openclaw → 프로젝트 ID 복사
2. API 및 서비스 → 다음 API 활성화:
   • Gmail API
   • Google Calendar API
   • Google Sheets API
   • Google Docs API
   • Google Drive API
3. OAuth 동의 화면 → 앱 이름: OpenClaw → 범위 최대 권한 추가 → 테스트 사용자에 본인 이메일 추가
4. OAuth 2.0 클라이언트 ID 생성 → 유형: 데스크톱 앱 → JSON 다운로드
5. openclaw/.keys/credentials.json 에 붙여넣기

4 AntiGravity로 VM 자동 생성

AntiGravity 패널에 붙여넣기 예시:

GCP 오픈클로 스킬을 이용해서 프로젝트 ID [프로젝트ID여기] 에 연결하고, 오픈클로를 GCP VM에 호스팅해줘. 모델은 gemini-1.5-pro-latest 써줘.

5 VM 접속 & OpenClaw 설치

출력된 SSH 명령 복사·실행

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

openclaw onboard

6 온보드 마법사 (핵심!)

1. Quick Start
2. Model → Google Antigravity OAuth → Gemini 1.5 Flash / Pro 선택
3. Messenger → Telegram
   • @BotFather → /newbot → 이름·유저네임 입력 (끝에 bot 필수)
   • 토큰 복사 → 붙여넣기
4. Skills → clawhub 추천

7 텔레그램 승인 & 첫 대화

openclaw users approve [내 텔레그램 ID]

텔레그램에서 /start → 이제 자유롭게 대화 가능!

5. 실전 사용 예시

• “광고성 메일 전체 삭제해줘”
• “매일 아침 7시 네이버 뉴스 요약 보내줘”
• “오후 7시 유튜브 업로드 리마인더 등록”
• “이 대화 구글 독스로 요약해서 링크 줘”

보안 주의사항
• VM SSH 키·텔레그램 토큰·OAuth JSON 절대 유출 금지
• OpenClaw에 “키 평문 출력 금지” 명령 미리 입력

6. 운영 팁

• 재시작: openclaw gateway restart 또는 openclaw daemon restart
• 로그: openclaw logs
• 비용: 월 1~3만 원 수준 예상 → GCP 예산 알림 설정 추천
• 업데이트: npm update -g openclaw

즐거운 오픈클로 라이프 되세요! 🚀
궁금한 점 → 언제든 물어보세요 😄

처음으로