Telegram 채널 추가 (NanoClaw)
NanoClaw 프로젝트에 Chat SDK 기반 Telegram 봇 채널을 코드 복사부터 봇 토큰 등록·채팅 페어링까지 한 번에 붙여주는 스킬.
자동화·워크플로중급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
- NanoClaw의
channels브랜치에서 Telegram 어댑터와 페어링·마크다운 정리 헬퍼, 관련 테스트를 프로젝트로 복사합니다. - 채널 배럴(
src/channels/index.ts)에 자기등록 import를 추가하고,setup/index.ts의 STEPS 맵에pair-telegram로더를 등록합니다. @chat-adapter/telegram을 정확한 버전으로 고정 설치하고, 빌드 + 등록 테스트(telegram-registration.test.ts)로 배선이 살아있는지 검증합니다.- BotFather로 봇을 만드는 방법을 안내하고, 봇 토큰을
.env에 저장(기존 값은 덮어쓰지 않음)한 뒤getMe로 유효성과 봇 핸들을 확인합니다. - 서비스를 재시작한 후 4자리 코드 페어링 핸드셰이크를 실행해
telegram:<chatId>주소와 소유자 Telegram 사용자 ID를 확보합니다. - 토큰 거부,
getMe실패, 페어링 미완료, 그룹 프라이버시 문제 등 흔한 장애의 원인과 복구법을 정리해 둡니다.
이런 분께 추천
- NanoClaw(nanocoai/nanoclaw) 기반으로 에이전트를 운영하며 Telegram으로 대화하고 싶은 개발자.
/setup또는/init-first-agent흐름 중 메신저 채널을 연결해야 하는 분.- 수동 작업 없이 재실행 안전한(idempotent) 통합 절차가 필요한 팀.
활용 예시
- "내 NanoClaw 인스턴스에 Telegram 봇을 붙여줘" → 파일 복사·의존성 설치·빌드·테스트까지 자동 수행.
- BotFather에서 받은 토큰을 붙여넣으면 형식 검증 후
.env에 저장하고getMe로 봇 username을 확인. - 그룹 채팅에 등록: 서비스 재시작 후 출력된 4자리 코드를
@봇이름 1234형태로 그룹에 보내telegram:-100...주소를 페어링.
주의: 이 스킬은 NanoClaw 저장소 안(pnpm,
setup/스크립트,channels브랜치 접근 가능 상태)에서만 동작합니다. Telegram 스레드는 지원하지 않습니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-telegram/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-telegram 폴더를 내 ~/.claude/skills/add-telegram/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-telegram ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 NanoClaw 저장소를 준비합니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 디렉터리를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r nanoclaw/.claude/skills/add-telegram ~/.claude/skills/ - 작업 디렉터리를 NanoClaw 프로젝트 루트로 이동합니다:
cd nanoclaw(이미 운영 중인 프로젝트가 있다면 그 폴더로 이동) pnpm install로 의존성이 정상 설치되는지,git fetch origin channels로channels브랜치를 받을 수 있는지 확인합니다.- Claude Code를 실행하고 "Telegram 채널을 추가해줘"라고 요청하면 스킬이 발동합니다.
- 진행 중 Telegram 앱에서 @BotFather에게
/newbot을 보내 봇을 만들고, 발급된 토큰을 요청 시 붙여넣습니다. - 마지막에 터미널에 표시되는 4자리 코드를 원하는 채팅(1:1 또는 그룹)에서 봇에게 그대로 전송해 페어링을 완료합니다.
GitHub에서 원본 보기 ↗라이선스: MIT