Telegram 채널 설정
OpenClaw와 Telegram을 연동하여 AI 어시스턴트를 구축하는 방법을 안내합니다.
개요
Telegram 채널이란?
OpenClaw의 Telegram 채널은 Telegram Bot API를 통해 사용자와 AI가 대화하는 방식입니다:
- @BotFather로 생성한 봇 토큰 사용
- 개인 채팅, 그룹 채팅, 채널 모두 지원
- Telegram Web, 모바일 앱 모두 지원
1단계: Telegram 봇 생성
BotFather에서 봇 생성
- Telegram에서 @BotFather 검색 및 시작
/newbot명령어 입력- 봇의 표시 이름 입력 (예:
My AI Assistant) - 봇의 사용자명 입력 (반드시
bot으로 끝나야 함, 예:my_ai_assistant_bot) - 발급된 Bot Token 복사
BotFather: Done! Congratulations on your new bot.
You will find it at t.me/my_ai_assistant_bot.
You can now add a description...
Use this token to access the HTTP API:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
봇 추가 설정 (선택사항)
# 봇 설명 추가
/setdescription
# 봇 프로필 사진 설정
/setuserpic
# 봇 명령어 목록 설정
/setcommands
2단계: OpenClaw 설정
CLI로 설정
# Telegram 채널 활성화
openclaw config set channels.telegram.enabled true
# 봇 토큰 설정
openclaw config set channels.telegram.botToken "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
설정 파일로 직접 설정
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
"allowedChatIds": [],
"allowAllChats": true
}
}
}
보안 설정 (특정 사용자만 허용)
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN",
"allowedChatIds": [123456789, 987654321],
"allowAllChats": false
}
}
}
채팅 ID 확인 방법:
# 봇에 메시지 보낸 후 로그에서 확인
openclaw logs | grep "chat_id"
3단계: AI 모델 설정
# Anthropic Claude 설정
openclaw config set models.providers.anthropic.apiKey "sk-ant-..."
openclaw config set models.default "claude-sonnet-4-20250514"
4단계: Gateway 시작 및 테스트
# Gateway 시작
openclaw gateway start
# 연결 테스트
openclaw channel test --type telegram
# 로그 확인
openclaw logs --follow
5단계: Telegram에서 테스트
- Telegram에서 본인의 봇 검색 (예:
@my_ai_assistant_bot) - START 버튼 클릭 또는
/start입력 - 메시지 입력 후 AI 응답 확인
사용자: 안녕!
봇: 안녕하세요! 저는 OpenClaw AI 어시스턴트입니다.
무엇을 도와드릴까요?
사용자: 파이썬으로 Hello World를 출력하는 코드를 알려줘
봇: 파이썬으로 Hello World를 출력하는 코드입니다:
```python
print("Hello, World!")
```
고급 설정
그룹 채팅 지원
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN",
"groupSettings": {
"allowGroups": true,
"requireMention": true,
"mentionPrefix": "@my_ai_assistant_bot"
}
}
}
}
명령어 설정
{
"channels": {
"telegram": {
"commands": {
"/start": "온보딩 메시지 표시",
"/help": "도움말 표시",
"/clear": "대화 기록 초기화",
"/settings": "설정 변경"
}
}
}
}
파일 전송 설정
{
"channels": {
"telegram": {
"files": {
"allowReceive": true,
"maxFileSize": 20971520,
"allowedTypes": ["document", "photo", "audio"]
}
}
}
}
트러블슈팅
"Unauthorized" 오류
# 봇 토큰 재확인
openclaw config get channels.telegram.botToken
# 봇 토큰 재설정
openclaw config set channels.telegram.botToken "NEW_TOKEN"
openclaw gateway restart
봇이 그룹에서 응답하지 않음
그룹에서 봇 관리자 권한 확인:
- 그룹 설정 → 관리자 → 봇 선택
- 메시지 읽기/쓰기 권한 확인
메시지 수신 지연
# Webhook 대신 Polling 사용
openclaw config set channels.telegram.mode "polling"
openclaw gateway restart
참고: