클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

텔레그램 채널 연결 (add-telegram)

NanoClaw 프로젝트에 텔레그램 봇 채널을 어댑터 복사부터 토큰 설정·페어링까지 한 번에 붙여주는 스킬입니다.

자동화·워크플로중급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

NanoClaw 에이전트가 텔레그램으로 대화할 수 있도록 채널 어댑터를 설치·등록해 줍니다. 구체적으로:

  • channels 브랜치에서 텔레그램 어댑터와 페어링/마크다운 정리 헬퍼, 테스트 파일을 복사
  • src/channels/index.ts에 자기등록 import 한 줄 추가, setup/index.ts의 STEPS에 pair-telegram 단계 등록
  • @chat-adapter/telegram@4.29.0을 정확한 버전으로 고정 설치 (범위·latest 금지 정책)
  • 빌드 + telegram-registration.test.ts 통합 테스트로 검증
  • BotFather로 봇 만드는 안내 → 토큰을 .env에 저장(이미 값이 있으면 덮어쓰지 않음) → getMe로 토큰 확인 및 봇 핸들 확보
  • 서비스 재시작 후 4자리 코드 페어링으로 telegram:<chatId>와 소유자 사용자 ID 확정

모든 nc: 지시문이 멱등(idempotent)해서 중간에 실패해도 처음부터 다시 실행해도 안전합니다.

이런 분께 추천

  • NanoClaw를 셀프 호스팅하며 텔레그램에서 에이전트를 부리고 싶은 분
  • /setup 흐름 중 채널을 붙이는 단계에 있는 분
  • 개인 DM 또는 소규모 그룹 채팅으로 에이전트와 대화하려는 분
  • 참고: 이 스킬은 NanoClaw 저장소 전용이며 일반 프로젝트용 텔레그램 봇 템플릿이 아닙니다.

활용 예시

  1. 첫 채널 붙이기: "텔레그램 채널을 추가해줘" → 어댑터 복사·등록·설치·빌드까지 진행하고, BotFather 안내를 받아 토큰을 입력한 뒤 4자리 코드를 봇에게 보내면 DM이 main 에이전트에 연결됩니다.
  2. 그룹 채팅에 연결: 팀 그룹에 봇을 초대하고 Group Privacy를 끈 뒤 --intent wire-to:folder로 페어링해서 음수 chat ID(telegram:-100...) 그룹을 등록합니다.
  3. 문제 해결: 답장이 안 오면 pnpm exec vitest run src/channels/telegram-registration.test.ts로 등록 상태를 확인하고, 초록이면 재시작 후 logs/nanoclaw.error.log에서 토큰 오류를 확인합니다.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ 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/add-telegram && cp -r nanoclaw/.claude/skills/add-telegram/* ~/.claude/skills/add-telegram/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 먼저 NanoClaw 저장소를 클론하거나, 이미 쓰고 있다면 그 디렉터리로 이동합니다: git clone https://github.com/nanocoai/nanoclaw.git && cd nanoclaw
  2. 이 스킬은 저장소 안 .claude/skills/add-telegram/에 이미 포함되어 있습니다. 저장소 루트에서 Claude Code를 실행하면 자동으로 인식됩니다.
  3. 다른 곳에서도 쓰고 싶다면 개인 스킬 폴더로 복사합니다: mkdir -p ~/.claude/skills/add-telegram && cp -r .claude/skills/add-telegram/* ~/.claude/skills/add-telegram/
  4. 사전 준비: Node.js와 pnpm, curl, jq가 설치되어 있어야 하고 pnpm install이 한 번 끝나 있어야 합니다.
  5. 텔레그램 앱에서 @BotFather에게 /newbot을 보내 봇을 만들고 토큰(123456:ABC-DEF... 형태)을 복사해 둡니다.
  6. Claude Code에서 "텔레그램 채널을 추가해줘"라고 요청하면 스킬이 실행됩니다. 토큰 입력 요청이 오면 붙여넣습니다.
  7. 재시작 후 터미널에 4자리 코드가 나타나면, 등록하고 싶은 채팅에서 봇에게 그 4자리만 보냅니다(그룹이면 @봇이름 코드 형태).
  8. 성공하면 /init-first-agent 또는 /manage-channels로 에이전트에 채널을 연결합니다.
GitHub에서 원본 보기 ↗라이선스: MIT