OpenClaw 완전정복 : 설치부터 응용 사례까지

오픈클로(OpenClaw) 설치하기

Google AI Studio에서 Google(Gemini) API 키 발급하기

  1. https://aistudio.google.com 접속 → Google 계정 로그인

  2. 좌측 또는 상단 메뉴에서 Get API key(또는 API keys) 선택

  3. Create API key 클릭 (필요 시 프로젝트 선택/생성)

  4. 생성된 키 복사해서 안전한 곳(비밀관리/환경변수)에 보관

텔레그램 설치 및 가입(계정 만들기)

아래 절차로 Telegram 계정을 먼저 준비합니다.

모바일(iOS/Android)

  1. App Store / Google Play에서 Telegram 설치

  2. 앱 실행 → Start Messaging 선택

  3. 국가 선택 및 전화번호 입력

  4. SMS/전화로 받은 인증코드 입력

  5. 이름(프로필) 설정

  6. (선택) 사용자명(username) 설정

데스크톱(Windows/macOS/Linux) — 옵션

  • https://desktop.telegram.org에서 설치하거나, 각 OS 스토어 앱으로 설치

  • 로그인은 QR 코드 또는 전화번호 방식 중 선택

주의사항

  • 인증코드를 받을 수 있는 실사용 가능한 전화번호가 필요합니다.

  • 계정 보호를 위해 2단계 인증(비밀번호) 설정을 권장합니다. (설정 > 개인정보 및 보안 > 2단계 인증)

  • 계정/세션 보호를 위해 로그인 알림을 수시로 확인하세요.

이제 아래의 ‘Telegram’ 채널 연결 절차로 봇을 생성/연결합니다.

Step 4: OpenClaw CLI 설치

gcloud compute ssh openclaw-server --zone=asia-northeast3-a

아래 방법 중 하나를 선택합니다.

방법 1 — 공식 스크립트 (권장)

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

방법 2 — npm

npm install -g openclaw@latest

방법 3 — pnpm

npm install -g pnpm
pnpm add -g openclaw@latest

Step 5: OpenClaw 설정 (온보딩 마법사)

openclaw onboard --install-daemon

온보딩 마법사에서 설정하는 항목:

  • Gateway 설정: 로컬 vs 리모트

  • 인증 설정: OpenAI API 키 또는 Anthropic API 키

  • 채널 연결: WhatsApp, Telegram, Discord 등

  • 데몬 설치: systemd 서비스로 자동 시작 설정

API 키 추가 설정 (선택)

openclaw configure --section model   # Anthropic 또는 OpenAI
openclaw configure --section web     # (선택) Brave Search API 키

Step 6: 채널 연결

WhatsApp

openclaw channels login
# 터미널에 표시되는 QR 코드를 WhatsApp에서 스캔

Telegram

  1. @BotFather에게 /newbot 전송 → 봇 생성 → API 토큰 복사

  2. 토큰 설정:

    openclaw configure --section channels
    # Telegram 선택 후 토큰 입력
  3. 봇에게 아무 메시지 전송 → 페어링 코드 수신

  4. 페어링 승인:

    openclaw pairing list telegram
    openclaw pairing approve telegram <페어링코드>

Discord

  1. Discord Developer Portal에서 봇 생성 → 토큰 복사

  2. 토큰 설정:

    openclaw configure --section channels
    # Discord 선택 후 토큰 입력