✈️
Telegram
커뮤니케이션 메시징 및 소셜설치 명령어
npx clawhub@latest install telegram
설치 안내
1
환경 확인
Node.js 22 이상과 OpenClaw가 설치되어 있는지 확인하세요. 터미널에서 openclaw --version을 실행하여 확인할 수 있습니다.
2
설치 실행
위의 설치 명령어를 터미널에서 실행하세요. ClawHub가 자동으로 Telegram을(를) ~/.openclaw/skills/ 디렉토리에 다운로드하고 설치합니다.
3
설치 확인
openclaw skills list를 실행하여 설치된 스킬 목록을 확인하고, Telegram이(가) 목록에 표시되는지 확인하세요.
4
매개변수 설정 (선택사항)
아래 소개의 설정 안내에 따라 ~/.config/openclaw/openclaw.json5에 스킬 설정 항목을 추가하세요.
수동 설치 방법: Skill 폴더를
~/.openclaw/skills/ 또는 프로젝트의 skills/ 디렉토리에 복사하세요. 폴더에 SKILL.md 파일이 포함되어 있어야 합니다.
Bot 운영
그룹 채팅 지원
파일 전송
상세 소개
Telegram 스킬은 OpenClaw에서 가장 많이 사용되는 채널 연동 중 하나로, Telegram을 통해 언제 어디서나 AI 어시스턴트와 대화할 수 있습니다.
핵심 기능
- 1:1 대화: Bot과 일대일 대화로 완전한 AI 어시스턴트 경험
- 그룹 채팅 통합: Bot을 그룹에 추가하고 @mention 또는 키워드로 답장 트리거
- 인라인 모드: 모든 채팅에서 @botname으로 Bot을 호출, 대화 전환 불필요
- 파일 송수신: 사용자가 보낸 파일(이미지, 문서, 오디오) 수신 및 파일 답장 전송
- 키보드 버튼: Inline Keyboard와 Reply Keyboard로 인터랙티브 메뉴 생성
설정 방법
@BotFather를 통해 Bot을 생성하고 Token을 획득합니다.
{
skills: {
telegram: {
botToken: "123456:ABC-xxx",
allowedUsers: [], // 비어있음=모든 사용자, Telegram user ID 입력으로 접근 제한
groupMode: "mention", // mention=@시 답장, always=항상 답장
maxMessageLength: 4096
}
}
}
사용 시나리오
- 개인 AI 어시스턴트: 언제든 Telegram으로 질문하거나 AI에게 작업 요청
- 그룹 도우미: 기술 토론 그룹에서 실시간 답변 제공
- 파일 처리: PDF를 보내 Bot이 내용 요약, 이미지를 보내 Bot이 분석
- 정기 푸시: RSS 등 다른 스킬과 결합하여 정기적으로 정보 푸시