사전 요구 사항
- Telegram 계정
- LemonClaw 인스턴스:
- 호스팅형: Claw 인스턴스 생성
- 셀프 호스팅형: LemonClaw 설치
설정 가이드
BotFather로 봇 생성하기
- Telegram을 열고 @BotFather를 검색하세요
/newbot을 전송하세요- 봇의 **표시 이름(display name)**을 선택하세요 (예: “My AI Assistant”)
bot으로 끝나는 **사용자 이름(username)**을 선택하세요 (예:my_ai_assistant_bot)- BotFather가 Bot Token을 회신합니다 — 다음과 같은 형식입니다:
LemonClaw WebUI 열기
- 호스팅형 Claw를 사용하는 경우, Claw Dashboard로 이동하여 Open WebUI를 클릭하세요
- LemonClaw를 셀프 호스팅하는 경우, 본인의 WebUI(예:
http://your-ip:18789)를 열고 토큰으로 로그인하세요 - WebUI에서 Settings → Channels로 이동하세요
- Telegram 섹션을 확장하세요
- Bot Token을 붙여넣으세요
- Save를 클릭하세요
선택 사항: 봇 프로필 사용자 정의
봇을 생성한 후 BotFather를 사용하여 사용자 정의할 수 있습니다:| 명령어 | 용도 |
|---|---|
/setdescription | 봇의 바이오/설명 설정 |
/setabouttext | ”정보(About)” 섹션 설정 |
/setuserpic | 프로필 사진 업로드 |
/setcommands | 명령어 제안 추가 |
그룹에서 사용하기
그룹 설정
LemonClaw WebUI의 Channels 설정에서 그룹 동작을 구성하세요:| 설정 | 옵션 | 설명 |
|---|---|---|
| Group Policy | Open (기본값) / Allowlist / Disabled | 그룹에서 누가 봇을 트리거할 수 있는지 제어합니다 |
| Require @mention | On / Off | 봇이 @mention되었을 때만 응답합니다 (권장) |
| Group IDs | 채팅 ID 목록 | 특정 그룹으로 제한 (비어 있음 = 모든 그룹) |
| Group Allowed Users | 사용자 ID 목록 | 이 사용자들만 봇을 트리거할 수 있습니다 (allowlist 모드) |
DM 정책
누가 봇에게 다이렉트 메시지를 보낼 수 있는지 제어합니다:| 정책 | 동작 |
|---|---|
| Pairing (기본값) | 새 사용자는 페어링 코드를 받습니다 — 승인을 위해 WebUI에 입력하세요 |
| Allowlist | 지정한 사용자 ID만 봇에게 메시지를 보낼 수 있습니다 |
| Open | 누구나 봇에게 메시지를 보낼 수 있습니다 (주의해서 사용하세요 — AI 크레딧이 소모됩니다) |
문제 해결
봇이 응답하지 않음
봇이 응답하지 않음
- bot token이 정확한지 확인하세요 (불필요한 공백 확인)
- 인스턴스가 실행 중인지 확인하세요 (대시보드의 녹색 상태)
- 대시보드에서 인스턴스를 재시작해 보세요
'Pairing code'가 나타나지 않음
'Pairing code'가 나타나지 않음
- 그룹이 아닌 봇에게 다이렉트 메시지를 보내고 있는지 확인하세요
- 페어링 시스템은 새 사용자의 첫 번째 메시지에서 활성화됩니다
봇의 응답이 느림
봇의 응답이 느림
- 응답 시간은 선택한 AI 모델에 따라 다릅니다
- 더 큰 모델 (Claude Opus, GPT-5)은 몇 초 정도 걸릴 수 있습니다
- LemonData 잔액을 확인하세요 — 크레딧이 부족하면 오류가 발생합니다