OpenClaw 설치 및 Telegram 연결 방법
컴퓨터를 준비하는 것부터 Telegram에서 응답하는 에이전트를 실행하는 것까지 약 30분 정도 걸립니다. 안내된 명령어는 공식 문서를 기준으로 하므로 설치하는 버전의 문서와 대조해 확인하세요.
필요한 것
- macOS, Linux, WSL2 또는 Windows를 실행하는 컴퓨터나 VPS
- Node 24.16+ 또는 Node 26. 설치 프로그램이 대신 추가할 수 있습니다.
- 모델용 API 키 또는 구독, 아니면 로컬 모델
- Telegram 계정
단계별 설정
-
컴퓨터를 선택하고 봇 만들기
시험 삼아 사용한다면 노트북으로도 충분합니다. 항상 켜 둘 에이전트는 소형 VPS나 홈 서버에서 실행하는 것이 좋으며, 게이트웨이 포트를 인터넷에 공개해서는 안 됩니다. Telegram에서 계정 이름을 꼼꼼히 확인한 뒤 @BotFather에게 메시지를 보내고 /newbot을 실행한 다음 발급된 토큰을 복사하세요.
-
OpenClaw 설치
사용 중인 시스템에 맞는 공식 설치 프로그램을 실행하세요. 설치 프로그램이 운영체제를 감지하고, Node가 없으면 추가한 뒤 OpenClaw를 설치하고 초기 설정을 시작합니다.
# macOS / Linux / WSL2 curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex
-
초기 설정 및 게이트웨이 서비스 설치
감지된 AI 접근 설정을 재사용하려면 Quick start를, 모든 옵션을 직접 지정하려면 Custom setup을 선택하세요. 초기 설정이 끝나면 포그라운드에서 실행 중인 게이트웨이를 중지하고 백그라운드 서비스로 설치해 재부팅 후에도 다시 시작되도록 하세요.
openclaw onboard # after the quick start, stop the foreground gateway (Ctrl+C), then: openclaw gateway install
-
Telegram 채널 추가
봇 토큰을 사용해 Telegram을 채널로 추가하세요. 그런 다음 채널 상태를 확인해 연결이 정상적으로 작동하는지 확인하세요.
openclaw channels add --channel telegram --token <bot-token> openclaw channels status --probe
-
페어링 승인
봇에 아무 메시지나 보내세요. 알 수 없는 발신자에게는 답장 대신 페어링 코드가 전송됩니다. 대기 중인 요청을 확인하고 1시간 이내에 자신의 코드를 승인하세요.
openclaw pairing list telegram openclaw pairing approve telegram <CODE>
-
보안 점검 및 업데이트
내장 보안 점검을 실행하고 stable 채널에서 업데이트하세요. 2026.4.22보다 오래된 버전에는 알려진 치명적인 취약점이 있으므로 계속 사용하지 마세요.
openclaw security audit openclaw update --channel stable
설정 후 처음 할 일
- dmPolicy를 pairing으로 설정해 봇을 찾아낸 낯선 사람이 봇을 사용하지 못하게 하세요.
- 설정을 신뢰할 수 있을 때까지 exec 승인을 항상 요청하도록 설정하세요.
- 보안 점검과 업데이트를 정기적으로 반복하세요.
흔히 하는 실수
- 게이트웨이 포트를 외부에 노출하지 마세요. gateway.bind를 loopback으로 유지하고 SSH 또는 Tailscale로 연결하세요.
- 타사 스킬을 너무 많이 설치하지 마세요. 브라우저 확장 프로그램처럼 취급하고 신뢰하는 출처에서 몇 개만 추가하세요.
- 에이전트가 루프에 빠져 멈추지 않으면 모델 토큰을 계속 소비한다는 점을 잊지 마세요.