Telegram 봇 설정 가이드

Telegram 검색창에 'botfather'를 입력하고 파란색 인증 마크가 있는 공식 BotFather(약 490만 명의 사용자 표시)를 클릭합니다. 이것은 Telegram의 공식 봇 관리 도구입니다.

BotFather와의 대화에서 다음 단계를 따르세요: 1️⃣ /newbot 명령어 전송 2️⃣ 봇 표시 이름 입력 (예: myopenclawtest) 3️⃣ 봇 사용자명 입력 (bot 또는 _bot으로 끝나야 함, 예: openclaw1314520_bot) 4️⃣ 생성 성공 시 BotFather가 Bot Token을 반환합니다 (형식: 835019428:XXXXXX_XXXXXXXXXXXXXX) ⚠️ Bot Token은 봇의 비밀번호와 같은 민감한 정보입니다. 안전하게 보관하고 절대 공유하지 마세요! 다음 설정 단계를 위해 이 토큰을 복사하세요.

OpenClaw 계정에 로그인한 후 상단 네비게이션 바에서 'My OpenClaw'을 클릭하여 콘솔에 접속합니다. 콘솔에서 'Channels' 탭으로 전환한 후 중앙 또는 우측 상단의 '+ Add Channel' 버튼을 클릭합니다.

나타나는 'Add Channel' 대화상자에서: 1️⃣ Channel Type: 'Telegram' 선택 2️⃣ Account Name: 선택사항, 비워둘 수 있음 3️⃣ Bot Token: 2단계에서 BotFather로부터 받은 토큰을 붙여넣기 완료되면 우측 하단의 빨간색 'Save' 버튼을 클릭합니다.

저장을 클릭하면 시스템이 자동으로 Telegram 봇을 설정합니다. OpenClaw Gateway가 새 설정을 적용하기 위해 3초 후 재시작됩니다. 설정이 성공적으로 완료되면 채널 목록에서 Telegram 채널이 'Configured' 상태로 표시됩니다. ⏱️ 전체 설정 과정은 보통 5~8초 정도 소요됩니다. Gateway 재시작이 완료될 때까지 잠시 기다려 주세요.

Telegram으로 돌아가 BotFather 메시지에 있는 봇 링크(예: t.me/openclaw1314520_bot)를 클릭하거나 봇의 사용자명을 검색합니다. 채팅을 열면 하단의 'Menu' 버튼을 클릭하거나 /start 명령어를 직접 전송합니다. 봇이 즉시 환영 메시지로 답장합니다. 어떤 질문(예: 'Hello' 또는 'Tell me about yourself')이든 보낼 수 있으며, 봇은 설정한 AI 모델을 기반으로 응답합니다. 🎉 축하합니다! Telegram 봇이 OpenClaw에 성공적으로 연결되었습니다. 이제 Telegram에서 언제든지 AI 어시스턴트와 대화할 수 있습니다. 💬 봇은 기본적으로 'open' 모드를 사용하며, 누구나 대화할 수 있습니다.

⚠️ 중요 안내: 기본적으로 Telegram 봇의 DM Policy는 open 모드로 설정되어 있으며, 이는 누구나 봇과 대화할 수 있어 API 할당량이 빠르게 소진될 수 있음을 의미합니다. 보안을 강화하는 방법: 봇을 사용할 수 있는 사람을 제한하려면 OpenClaw Gateway WebUI에서 DM Policy를 pairing 모드로 변경할 수 있습니다: 1️⃣ Gateway WebUI(예: https://xxx.open-claw.org)에 접속합니다 2️⃣ 설정에서 Telegram 채널 설정을 찾아 dmPolicy를 "pairing"으로 변경합니다 3️⃣ 설정을 저장하면 새 사용자가 봇과 처음 대화할 때 페어링 코드(예: ABC123)를 받게 됩니다 4️⃣ OpenClaw WebUI 채팅창에서 다음 명령어를 입력하여 사용자를 승인합니다: openclaw pairing approve telegram <pairing-code> 예시: openclaw pairing approve telegram ABC123 ✅ 승인이 완료되면 해당 사용자는 봇을 정상적으로 사용할 수 있습니다. 이를 통해 봇 사용 권한을 효과적으로 관리하고 남용 및 할당량 낭비를 방지할 수 있습니다.