이 글의 목표는 단 하나입니다: 가장 짧은 경로로 OpenClaw의 전체 플로우를 처음부터 끝까지 실행하는 것입니다. 설치, 설정, Telegram 연결, 첫 메시지 전송 및 AI 답변 수신까지. 원리는 설명하지 않고, 확장도 하지 않으며, 가장 빠른 경로만 따릅니다.
OpenClaw이란
OpenClaw은 macOS, Linux, Windows를 지원하는 오픈소스 AI Agent 게이트웨이입니다. 핵심 기능은 일상적으로 사용하는 채팅 도구(WhatsApp, Telegram, Discord, iMessage 등)를 다양한 AI 모델에 통합 연결하여, 익숙한 채팅 인터페이스에서 직접 AI와 대화할 수 있게 하는 것입니다.
미리 알아두면 좋은 핵심 특성:
- 멀티 채널 게이트웨이: 하나의 인스턴스로 여러 채팅 플랫폼을 동시에 관리
- 멀티 Agent 라우팅: 다른 대화를 다른 AI 모델로 라우팅 가능
- 세션 격리: 각 사용자, 각 채널의 대화 컨텍스트가 서로 간섭하지 않음
- 플러그인 확장: Skill 시스템을 통한 기능 확장
- 미디어 지원: 이미지, 음성 등 멀티미디어 메시지 처리 능력
이 정도면 충분합니다. 이제 실습을 시작합니다.
사전 조건
두 가지만 준비하면 됩니다:
- Node.js 22+:
node -v를 실행하여 버전을 확인하고, 22 미만이면 먼저 업그레이드 - Telegram 계정: Telegram은 모든 채널 중 설정이 가장 빠르며, Bot Token 하나만 있으면 됩니다
1단계: OpenClaw 설치
터미널을 열고 전역 설치를 실행합니다:
npm install -g openclaw@latest
설치 완료 후 내장 환경 검사 도구를 실행하여 모든 준비가 완료되었는지 확인합니다:
openclaw doctor
모든 검사 항목이 통과하면 설치에 문제가 없다는 의미입니다. 오류가 있으면 안내에 따라 수정한 후 openclaw doctor를 다시 실행하세요.
2단계: 초기화 및 데몬 프로세스 설치
onboard 명령을 실행하여 초기 설정을 완료하고 동시에 백그라운드 데몬 프로세스를 설치합니다:
openclaw onboard --install-daemon
이 단계에서 몇 가지 기본 설정을 안내합니다:
- AI 모델 공급자 선택 (OpenAI, Claude 등)
- 해당 API 키 입력
- 데몬 프로세스 설치로 OpenClaw이 백그라운드에서 지속 실행 가능
모든 설정은 ~/.openclaw/openclaw.json 파일에 저장됩니다. 이후 설정을 수정해야 하면 이 파일을 직접 편집하면 됩니다.
3단계: Telegram 채널 로그인 및 설정
다음으로 첫 번째 채팅 채널을 연결합니다. 로그인 명령을 실행합니다:
openclaw channels login
Telegram을 선택하면 Bot Token 입력을 요청합니다. 아직 Token이 없다면 다음 단계를 따르세요:
- Telegram에서
@BotFather를 검색하고 대화를 시작 /newbot을 보내고 안내에 따라 봇 이름과 사용자 이름을 설정- 생성 완료 후 BotFather가 Token을 반환 (형식:
7123456789:AAHxxx...)
Token을 터미널에 붙여넣으면 채널 설정이 완료됩니다.
4단계: 게이트웨이 시작
모든 준비가 완료되었으면 OpenClaw 게이트웨이를 시작합니다:
openclaw gateway --port 18789
터미널에 게이트웨이가 시작되었다는 메시지가 표시되면 Telegram을 열고 방금 만든 봇을 찾아 메시지를 보내보세요. 예를 들어 "안녕하세요".
모든 것이 정상이면 몇 초 내에 AI의 답변을 받게 됩니다. 축하합니다, 첫 AI 대화가 성공적으로 완료되었습니다.
다음 단계
기본 플로우를 완료한 후 다음 방향을 계속 탐색해 볼 수 있습니다:
- 웹 대시보드: OpenClaw은 대화 모니터링과 설정 조정에 편리한 시각적 관리 패널을 제공
- 모바일 페어링: Mobile Node 기능을 통해 iOS 또는 Android 디바이스를 OpenClaw 인스턴스와 페어링
- 더 많은 채널 연결:
openclaw channels login에서 WhatsApp, Discord, Slack 등 다른 플랫폼 추가 - 플러그인 설치: Skill Marketplace에서 커뮤니티가 개발한 기능 플러그인 탐색 및 설치
최소한의 실행 경로는 이 네 단계입니다. 전체 과정이 순조롭다면 정말 5분이면 충분합니다. 문제가 발생하면 openclaw doctor가 최고의 진단 출발점입니다.