OpenClaw 설치부터 텔레그램 AI 비서 연동까지, 10분 가이드

OpenClaw는 터미널, 파일, 브라우저를 직접 조작하는 AI 에이전트를 만들어주는 오픈소스 프로젝트다. ChatGPT가 "답변"을 한다면, OpenClaw는 "행동"을 한다.

이 글에서는 설치부터 텔레그램 연동까지 전 과정을 정리했다. 따라하면 10분이면 나만의 AI 비서가 텔레그램에서 응답하는 걸 볼 수 있다.

공식 사이트: openclaw.ai | 문서: docs.openclaw.ai | GitHub: github.com/openclaw/openclaw

1단계: 설치

터미널에서 한 줄이면 된다.

macOS / Linux:

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

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

Node.js가 없어도 설치 스크립트가 자동으로 설치해준다. 실행하면 곧바로 온보딩 위저드가 시작된다.

📸 스크린샷 1: 설치 스크립트 실행 → 온보딩 위저드 시작 화면

2단계: 온보딩 — QuickStart 선택

온보딩 위저드가 시작되면 먼저 QuickStart와 Advanced 중 하나를 선택한다. 처음이면 QuickStart로 가면 된다. 기본 설정으로 알아서 잡아준다.

📸 스크린샷 2: QuickStart / Advanced 선택 화면

3단계: AI 모델 선택 + API 키

사용할 AI 모델을 선택하고 API 키를 입력한다. 현재 지원하는 주요 모델 3가지:

• Anthropic (Claude) — 코딩, 분석, 장문 처리에 강함
• OpenAI (GPT) — 범용, 이미지 생성 가능
• Google (Gemini) — 웹 검색 연동, 무료 티어 넉넉

API 키는 각 서비스의 개발자 콘솔에서 발급:

• Anthropic: console.anthropic.com
• OpenAI: platform.openai.com
• Google: aistudio.google.com

📸 스크린샷 3: 모델/프로바이더 선택 화면

📸 스크린샷 4: API 키 입력 화면

4단계: Gateway 시작

온보딩이 끝나면 Gateway가 자동으로 시작된다. Gateway는 AI를 24시간 돌아가게 해주는 백그라운드 서비스다.

# 상태 확인
openclaw gateway status

# 웹 UI 열기
openclaw dashboard

브라우저에서 Control UI가 열리면 성공이다. 여기서 바로 채팅 테스트도 할 수 있다.

📸 스크린샷 5: Gateway 실행 상태 (터미널)

📸 스크린샷 6: Control UI (웹 브라우저)

5단계: 텔레그램 봇 만들기

5-1. BotFather에서 봇 생성

텔레그램에서 @BotFather를 검색해서 대화를 시작한다.

/newbot

봇 이름과 username을 입력하면 봇 토큰이 발급된다. 이 토큰을 복사해둔다.

📸 스크린샷 7: BotFather — /newbot → 토큰 발급

5-2. OpenClaw에 텔레그램 연결

OpenClaw 설정 파일(openclaw.json)에 텔레그램 채널을 추가한다:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "여기에_봇토큰_입력",
      "dmPolicy": "pairing"
    }
  }
}

또는 환경변수로도 가능하다:

export TELEGRAM_BOT_TOKEN="여기에_봇토큰_입력"

설정 후 Gateway를 재시작한다:

openclaw gateway restart

📸 스크린샷 8: openclaw.json 텔레그램 설정

6단계: 페어링 — 내 계정 연결

보안을 위해 아무나 봇에 말 걸 수 없다. 내 텔레그램 계정을 "페어링"해야 한다.

1. 텔레그램에서 내 봇에게 아무 메시지나 보낸다
2. 터미널에서 페어링 요청을 확인하고 승인한다:

# 페어링 요청 확인
openclaw pairing list telegram

# 승인
openclaw pairing approve telegram YOUR_CODE

승인하면 끝이다. 이제부터 텔레그램에서 AI와 대화할 수 있다.

📸 스크린샷 9: 텔레그램에서 봇에게 첫 메시지

📸 스크린샷 10: 터미널에서 페어링 승인

7단계: 테스트

텔레그램에서 봇에게 말을 걸어본다:

지금 몇 시야?

AI가 시스템 시간을 확인해서 답해준다. 단순한 답변이 아니라, 실제로 내 컴퓨터에서 명령을 실행해서 알려주는 거다.

좀 더 재미있는 것도 해보자:

바탕화면에 hello.txt 파일 만들어줘. 내용은 "OpenClaw 테스트 성공!"으로.

텔레그램 메시지 하나로 내 컴퓨터에 파일이 생긴다. 이게 OpenClaw의 핵심이다.

📸 스크린샷 11: 텔레그램 AI 대화 — 실제 작동

정리

다음 글 예고

이 AI 비서에게 실제로 업무를 시키는 방법을 다룰 예정이다:

• 메모리 설정 — 대화 맥락 유지
• 스킬 추가 — 날씨, 검색, 자동화
• 크론 자동화 — 정해진 시간에 자동 실행

참고 링크:

• OpenClaw 공식 사이트
• 설치 가이드
• 텔레그램 연동 문서
• GitHub 저장소