약 30분
OpenClaw를 설치하고 Telegram을 연결하는 방법
아무것도 없는 상태에서 Telegram으로 메시지를 주고받을 수 있는 에이전트를 만들기까지 약 30분이 걸립니다. 명령어는 공식 문서에서 가져왔습니다. 사용 중인 버전에 맞는지 확인하세요.
필요한 항목
- macOS, Linux, WSL2 또는 Windows가 설치된 컴퓨터나 VPS
- Node 24.16+ 또는 Node 26(설치 프로그램에서 추가 가능)
- 모델용 API 키 또는 구독, 아니면 로컬 모델
- Telegram 계정
단계
- 1
실행 위치 선택
시험해 볼 때는 개인 노트북으로도 충분합니다. 에이전트를 항상 켜 두려면 소형 VPS나 홈 서버를 사용하세요. 게이트웨이 포트를 인터넷에 공개하지 마세요.
- 2
OpenClaw 설치
공식 설치 프로그램을 실행하세요. 운영체제를 감지하고 필요한 경우 Node를 설치한 다음 OpenClaw를 설치하고 초기 설정을 시작합니다.
# macOS / Linux / WSL2 curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex
- 3
초기 설정을 실행하고 서비스 설치
감지된 AI 액세스를 재사용하려면 Quick start를, 전체 설정 과정을 진행하려면 Custom setup을 선택하세요. 그런 다음 게이트웨이를 백그라운드 서비스로 설치해 재부팅 후에도 실행되도록 하세요.
openclaw onboard # after quick start, stop the foreground gateway (Ctrl+C) and install the service openclaw gateway install
- 4
Telegram 봇을 만들고 추가
Telegram에서 @BotFather에 메시지를 보내고(핸들이 정확한지 확인하세요) /newbot을 실행한 다음 토큰을 복사하세요. OpenClaw에 토큰을 추가하고 채널 상태를 확인하세요.
openclaw channels add --channel telegram --token <bot-token> openclaw channels status --probe
- 5
본인 계정 승인
봇에 아무 메시지나 보내세요. 알 수 없는 발신자에게는 답변 대신 페어링 코드가 전송됩니다. 한 시간 안에 본인 계정을 승인하세요.
openclaw pairing list telegram openclaw pairing approve telegram <CODE>
- 6
보안 강화
내장 보안 감사를 실행하고 게이트웨이를 최신 상태로 유지하세요. 2026.4.22 이전 버전에는 알려진 치명적인 취약점이 있습니다.
openclaw security audit openclaw update --channel stable
실전 팁
- gateway.bind를 루프백으로 유지하고 SSH 또는 Tailscale을 통해 접속하세요. 포트를 공개하지 마세요.
- dmPolicy를 pairing으로 설정해 봇을 찾은 낯선 사람이 봇을 사용하지 못하도록 하세요.
- 타사 스킬은 브라우저 확장 프로그램처럼 취급하세요. 신뢰할 수 있는 출처에서만 소수의 스킬을 설치하세요.
- 설정을 신뢰할 수 있을 때까지 exec 승인을 항상 요청하도록 설정하세요.