WhatsApp 채널 추가 (NanoClaw)
NanoClaw에 Baileys 기반 WhatsApp 채널을 안전 점검·QR/페어링 인증·설정 기록까지 한 번에 붙여주는 설치 스킬.
자동화·워크플로고급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
- NanoClaw의
channels브랜치에서 네이티브 WhatsApp(Baileys) 어댑터와 포맷팅 컨테이너 스킬을 복사해 등록합니다. - Baileys·qrcode·pino를 정확한 버전으로 고정 설치하고, 빌드 + 등록 테스트로 검증합니다.
- 설치 전에 "전용 번호 vs 개인 번호" 안전 점검을 강제하고, 개인 번호일 경우 계정 정지 위험 경고와 명시적 동의를 받습니다.
- QR 코드 또는 8자 페어링 코드로 연동 기기 인증을 진행하고, 터미널 QR이 작을 때는 브라우저 QR 헬퍼로 대체할 수 있습니다.
ASSISTANT_HAS_OWN_NUMBER,ASSISTANT_NAME을.env에 명시적으로 기록하고 서비스를 재시작한 뒤 DM 채널(JID)까지 확정합니다.- 과거 스팸 카드로 잘못 연결된 그룹 배선 점검, 세션 손상·코드 만료·conflict 등 문제 해결 절차를 함께 제공합니다.
이런 분께 추천
- NanoClaw를 셀프호스팅하며 WhatsApp으로 에이전트와 대화하려는 사용자
- 여분 SIM/eSIM으로 전용 봇 번호를 운영하려는 분
- 개인 번호의 "나에게 보내기" 셀프 채팅만 에이전트 인박스로 쓰려는 분
활용 예시
- "WhatsApp 붙여줘" → 전용 번호 선택 → 어댑터 복사·의존성 설치 → 터미널 QR 스캔 → 개인 번호 입력 후 양방향 대화 개설.
- 카메라를 쓸 수 없는 헤드리스 서버에서 페어링 코드 방식으로 링크하고, 실패 시 QR 브라우저 헬퍼(
--clean)로 재시도. - 이미 설치돼 있으나
ASSISTANT_HAS_OWN_NUMBER가 없어 봇이 가족 단톡방 모든 메시지에 답하는 상황을 마이그레이션 감사 절차로 정리.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-whatsapp/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 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 && cd nanoclaw && ls .claude/skills/add-whatsapp⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널에서
git clone https://github.com/nanocoai/nanoclaw.git로 저장소를 받고cd nanoclaw로 이동합니다. pnpm install로 기본 의존성을 설치하고, NanoClaw 기본/setup을 먼저 완료합니다.- 이 스킬은 저장소의
.claude/skills/add-whatsapp/에 이미 포함되어 있습니다. 별도 프로젝트에서 쓰려면cp -r .claude/skills/add-whatsapp ~/.claude/skills/로 복사할 수 있지만, 실제 동작은 NanoClaw 프로젝트 루트에서만 보장됩니다. - 프로젝트 루트에서 Claude Code를 실행합니다.
/add-whatsapp를 입력합니다.- 먼저 나오는 번호 유형 질문에 답합니다 — 가능하면
dedicated(여분 SIM/eSIM)를 선택하세요.shared(개인 번호)는 계정 정지 위험 경고에 동의해야 진행됩니다. qr(휴대폰 카메라로 스캔) 또는pairing-code(숫자만, 국가코드 포함 번호 입력)를 선택해 WhatsApp → 설정 → 연결된 기기 → 기기 연결에서 링크합니다.- 어시스턴트 이름과 (전용 번호일 경우) 본인 개인 번호를 입력하면
.env기록 후 서비스가 자동 재시작되고, WhatsApp에 환영 메시지가 도착합니다.
GitHub에서 원본 보기 ↗라이선스: MIT