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

WhatsApp 채널 추가 (NanoClaw)

NanoClaw에 Baileys 기반 WhatsApp 채널을 직접 연결해 QR 또는 페어링 코드로 로그인시켜 주는 설치 스킬입니다.

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

무엇을 해주나

NanoClaw 프로젝트에 WhatsApp 채널 어댑터를 추가하는 설치 자동화 스킬입니다. Chat SDK 브리지 없이 Baileys(WhatsApp Web 클라이언트)로 직접 연결하며, 다음 과정을 순서대로 안내·실행합니다.

  • channels 브랜치에서 src/channels/whatsapp.ts, 등록 테스트, WhatsApp 포맷팅 컨테이너 스킬 복사
  • 채널 배럴(src/channels/index.ts)에 자기 등록 import 1줄 추가
  • @whiskeysockets/baileys, qrcode, pino 등 의존성을 정확한 버전으로 설치
  • 빌드 + 등록 통합 테스트 실행
  • QR 스캔 또는 8자리 페어링 코드로 기기 연결(선택 시 브라우저 QR, 헤드리스 환경 대응 포함)
  • 전용 번호/개인(공유) 번호 모드 판별 후 .env의 ASSISTANT_HAS_OWN_NUMBER, ASSISTANT_NAME 기록
  • 서비스 재시작, DM 채널(JID) 확인, 과거 스팸성 그룹 배선 감사

특히 개인 번호를 연결하면 WhatsApp 계정이 정지·차단될 수 있다는 경고를 먼저 띄우고, 사용자가 명시적으로 동의하지 않으면 진행을 막는 안전 장치가 들어 있습니다.

이런 분께 추천

  • NanoClaw를 운영하며 WhatsApp으로 에이전트와 대화하고 싶은 분
  • 예비 SIM/eSIM으로 전용 봇 번호를 만들어 두신 분
  • 터미널·pnpm·systemd 환경에 익숙한 중급 이상 개발자

일반적인 Claude 스킬처럼 아무 프로젝트에서 쓰는 도구가 아니라 NanoClaw 저장소 전용 설치 절차라는 점을 유의하세요.

활용 예시

  1. 전용 번호로 봇 만들기 — 예비 eSIM 번호를 QR로 연결하고, 본인 개인 번호를 대화용 번호로 등록하면 에이전트가 별도 연락처로 나타나 양방향 대화가 가능해집니다.
  2. 개인 번호 self-chat 모드 — 위험 경고에 동의하고 개인 번호를 쓰면, 에이전트는 "나에게 보내기" 채팅에만 존재하고 @에이전트이름으로 시작하는 메시지에만 답하도록 설정할 수 있습니다.
  3. 카메라 없는 서버에서 설치 — 헤드리스 호스트를 감지해 페어링 코드 방식으로 자동 전환하거나, 터미널 QR이 작아 스캔이 안 될 때 wa-qr-browser.ts로 브라우저에 큰 QR을 띄웁니다.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-whatsapp 폴더를 내 ~/.claude/skills/add-whatsapp/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && cp -r /tmp/nanoclaw/.claude/skills/add-whatsapp ~/.claude/skills/add-whatsapp

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

  1. NanoClaw 프로젝트가 준비돼 있는지 확인하세요. 이 스킬은 NanoClaw 저장소 안에서만 의미가 있습니다 (pnpm, Node 20+ 필요).
  2. 터미널에서 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  3. 스킬 폴더를 Claude 스킬 경로로 복사합니다: cp -r nanoclaw/.claude/skills/add-whatsapp ~/.claude/skills/add-whatsapp (프로젝트 안에서 그대로 쓰려면 복사 없이 사용해도 됩니다).
  4. NanoClaw 프로젝트 루트에서 Claude Code를 실행하고 /add-whatsapp을 입력합니다.
  5. 번호 안전 확인에서 dedicated(전용 번호, 권장) 또는 shared(개인 번호)를 고릅니다. 개인 번호를 고르면 계정 정지 위험 경고를 읽고 명시적으로 동의해야 진행됩니다.
  6. 어댑터 복사·의존성 설치·빌드·테스트가 자동으로 진행되도록 승인합니다.
  7. 인증 방식으로 qr(카메라 스캔) 또는 pairing-code(전화번호 입력 후 8자리 코드)를 선택하고, 휴대폰에서 WhatsApp → 설정 → 연결된 기기 → 기기 연결로 들어가 60초 안에 완료합니다.
  8. 에이전트 이름과(전용 번호라면) 본인 개인 번호를 입력하면 .env가 갱신되고 서비스가 재시작됩니다.
  9. 실패 시 rm -rf store/auth/ 후 인증 단계를 다시 실행하고, 문제가 계속되면 문서의 Troubleshooting 절을 따라가세요.
GitHub에서 원본 보기 ↗라이선스: MIT