레이블이 오픈클로(OpenClaw)인 게시물을 표시합니다. 모든 게시물 표시
레이블이 오픈클로(OpenClaw)인 게시물을 표시합니다. 모든 게시물 표시

2026년 2월 22일 일요일

오픈클로(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+
Read More

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

By 
오픈클로(OpenClaw) 설치 가이드 - 서버 없이 구글 클라우드 30~60분 완성

오픈클로(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

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

처음으로
Share:  Facebook Twitter Google+
Read More