2026년 2월 22일 일요일

Home » » 오픈클로(OpenClaw) 설치·구글 클라우드 연동·운영 완전 가이드

오픈클로(OpenClaw) 설치·구글 클라우드 연동·운영 완전 가이드

By 

오픈클로(OpenClaw) 설치·구글 클라우드 연동·운영 완전 가이드

아래는 제공된 유튜브 영상(단태랩스)의 내용을 기반으로, 초보자도 따라 할 수 있도록 매우 상세하게 재구성한 오픈클로(OpenClaw) 설치·구글 클라우드 연동·운영 완전 가이드입니다.
2026년 2월 기준 최신 정보(공식 docs.openclaw.ai, GitHub 등)를 반영하여 보완했습니다. 서버 없이 구글 클라우드(GCP)만으로 30~60분 안에 끝낼 수 있도록 단계별로 정리했습니다.

오픈클로(OpenClaw)란 무엇인가? (1분 요약)

오픈클로는 개인용 오픈소스 AI 에이전트 프레임워크입니다.
  • 텔레그램·슬랙·디스코드 등 메신저로 24시간 대화
  • 실시간으로 요청 처리 (이메일 읽기/쓰기/삭제, 캘린더 일정 등록·알림, 구글 시트·독스·드라이브 제어 등)
  • 파일 시스템 접근 가능 (로컬·클라우드 모두)
  • 원하는 LLM 선택 (Gemini, Claude, GPT, Grok 등)
  • 가장 큰 장점 = “나만의 자비스”처럼 동작하면서도 완전 오픈소스 + 셀프호스팅이라 데이터가 외부로 빠져나가지 않음

개발자: Peter Steinberger (2026년 초 OpenAI 합류 후에도 프로젝트는 독립 재단으로 유지 중)

사전 준비물 (필수 체크리스트)

  1. 구글 계정 (Gmail) – 무료 크레딧 $300 있음 (신규 가입 시)
  2. 결제 수단 등록 (크레딧 소진 후 자동 과금 안 됨 → 안심)
  3. 텔레그램 앱 (스마트폰·PC·웹 모두 OK)
  4. VS Code + WSL (윈도우 사용자 필수, 맥은 기본 터미널 사용)
  5. 약 30~60분 시간 + 인내심

전체 흐름 (30분 목표 타임라인)

  1. 안티그래비티 + WSL 환경 세팅 (5분)
  2. GCP 프로젝트 생성 & API 활성화 (8분)
  3. OAuth 클라이언트 ID/시크릿 생성 (5분)
  4. gcloud CLI 설치 & 인증 (5분)
  5. VM 인스턴스 생성 & OpenClaw 설치 (10~15분)
  6. 텔레그램 봇 생성 & 온보드 (5~10분)
  7. 구글 서비스 연동 테스트 & 자동화 설정 (나머지)

1단계: 로컬 환경 준비 (AntiGravity + WSL)윈도우 사용자 → WSL 필수 (Ubuntu 추천)

  1. VS Code 설치 → 확장 프로그램 검색 → “Remote - WSL” 설치
  2. Ctrl + Shift + P → “Remote-WSL: Connect to WSL” → Ubuntu 선택
  3. 새 폴더 열기 → 워크스페이스 폴더 안에 openclaw 빈 폴더 생성
  4. 터미널 열기 (Ctrl + J) → 전체 화면으로 확대 (Move Terminal into Editor Area)
AntiGravity용 스킬 다운로드 (단태랩스 제공 GCP 전용 스킬)
bash
npx @dantelabs/agentic-school gcp-openclaw
→ agents/gcp-openclaw 폴더만 남기고 나머지 삭제

2단계: Google Cloud Console 설정https://console.cloud.google.com 이동

  1. 새 프로젝트 생성
    • 프로젝트 이름: openclaw (또는 자유)
    • 프로젝트 ID 복사해두기 (나중에 필요)
  2. API 및 서비스 → 라이브러리 검색 & 활성화 (사용 설정)
    • Gmail API
    • Google Calendar API
    • Google Sheets API
    • Google Docs API
    • Google Drive API (필요한 것만 추가해도 OK, 많을수록 편함)
  3. OAuth 동의 화면 구성
    • 앱 이름: OpenClaw
    • 사용자 지원 이메일: 본인 Gmail
    • 앱 로고·도메인 등 생략 가능
    • 범위(Scope) 추가 → 위 API들 전부 검색 → 최대 권한 선택 (나중에 줄여도 됨)
    • 테스트 사용자 → 본인 이메일 추가
  4. 사용자 인증 정보 → OAuth 2.0 클라이언트 ID 생성
    • 애플리케이션 유형: 데스크톱 앱
    • 이름: OpenClaw Desktop
    • 생성 후 client_id와 client_secret JSON 다운로드
    • openclaw 폴더 안에 .keys 폴더 생성 → JSON 파일 붙여넣기 (예: credentials.json)

3단계: gcloud CLI 설치 & GCP 인증 (AntiGravity 활용)

VS Code 터미널에서 AntiGravity 우측 패널 열기
명령 예시 (복사해서 AntiGravity에 붙여넣기) 
GCP 오픈클로 스킬을 이용해서 프로젝트 ID [여기에 프로젝트 ID 붙여넣기] 에 연결하고, 오픈클로를 GCP VM에 호스팅해줘. 모델은 gemini-1.5-pro-latest 써줘.
→ gcloud 설치 여부 확인 → 브라우저 링크 뜨면 클릭 → 로그인 → 인증 코드 복사 → AntiGravity에 붙여넣기.
결제 계정 연결 안 되어 있으면 → Billing 메뉴 → 결제 계정 연결 → 프로젝트에 연결

4단계: VM 인스턴스 자동 생성

AntiGravity가 아래 작업 대부분 대신 수행:
  • Compute Engine API 활성화
  • e2-small (또는 e2-micro 무료 가능) Ubuntu 22.04 LTS
  • 부팅 디스크 25~30GB
  • 방화벽 → SSH 허용 (22번 포트)
  • 외부 IP 자동 할당
완료 후 SSH 명령어 출력됨 (예: gcloud compute ssh openclaw-vm --zone=asia-northeast3-a)

5단계: VM 접속 & OpenClaw 설치

터미널에서 SSH 명령 복사·실행 → VM 내부로 진입
OpenClaw 공식 설치 (curl 방식 가장 간단) 
bash
curl -fsSL https://openclaw.ai/install.sh |bash
→ 설치 완료 후 바로 온보드 시작 
bash
openclaw onboard

6단계: 온보드 마법사 따라가기 (가장 중요한 부분)

  1. Quick Start 선택
  2. Model Provider → Google Antigravity OAuth (Gemini 무료/유료 모두 지원)
    • URL 클릭 → Gmail 로그인 → 권한 모두 허용 → 코드 복사 → 붙여넣기
    • 모델 선택: gemini-1.5-flash (빠름) / gemini-1.5-pro (똑똑함)
  3. Messenger → Telegram (가장 안정적)
    • Telegram 앱 열기 →@BotFather 검색
    • /newbot → 봇 이름 입력 (예: MySuperClawBot)
    • 유저네임 입력 (반드시 bot으로 끝나야 함, 예: mysuperclaw_bot)
    • 토큰 복사 (예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)
    • OpenClaw에 붙여넣기
  4. Skills 설치 → 기본 스킬 + clawhub (추천)
    • Google 관련 스킬 자동 설치됨 (gog-cli 기반)
  5. 완료 → openclaw tui 또는 텔레그램으로 바로 대화 시작

7단계: 텔레그램에서 처음 대화 & 승인

  • 봇 채팅창 열기 → /start
  • OpenClaw TUI에서 승인 필요 → VM 터미널로 돌아가서 승인
    bash
    openclaw users approve [your-telegram-user-id]
  • 이제 텔레그램에서 자유롭게 대화 가능!

8단계: 실제 써보기 (실전 예시 프롬프트)

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

운영·관리 팁 (장기적으로 알아두기)

  • 재시작: openclaw gateway restart 또는 openclaw daemon restart
  • 로그 확인: VM에서 openclaw logs
  • 비용 관리: GCP → Billing → 예산 알림 설정 (월 1~3만 원 수준)
  • 보안:
    • VM에 방화벽 엄격히 (SSH 키만 허용)
    • Telegram 토큰·OAuth JSON 절대 유출 금지
    • OpenClaw에 “절대 평문으로 키 출력 금지” 명령 사전 입력
  • 업데이트: npm update -g openclaw

마무리 & 다음 단계 추천

30분 만에 “구글 클라우드 + 오픈클로” 조합으로 나만의 AI 비서 완성!
처음에는 막히는 부분이 많지만, 한 번 세팅하면 24시간 언제 어디서나 텔레그램으로 자비스 부르기 가능합니다.더 화끈한 활용법 (스마트홈 연동, 코드 작성 자동화, 다중 에이전트 등)은 다음 영상·커뮤니티에서 계속 업데이트될 예정입니다.궁금한 부분 있으면 언제든 물어보세요 — 오픈클로처럼 바로 답변 드릴게요

처음으로

Share:  Facebook Twitter Google+