메인 콘텐츠로 건너뛰기
WhatsApp Web과 마찬가지로 QR 코드를 스캔하여 WhatsApp을 LemonClaw 인스턴스에 연결하세요. 이 가이드는 호스팅된 Claw 인스턴스와 셀프 호스팅된 LemonClaw 배포 모두에 적용됩니다.

​
사전 요구 사항

WhatsApp은 사용자의 실제 전화번호를 사용합니다. 봇을 통해 전송된 메시지는 사용자의 WhatsApp 계정에서 보낸 것으로 표시됩니다. 분리를 원할 경우 전용 번호를 사용하세요.
VoIP 번호는 지원되지 않습니다. WhatsApp은 실제 SIM 기반 전화번호가 필요합니다. 가상 번호(Google Voice, Skype 등)는 QR 코드 페어링에 작동하지 않습니다.

​
설정 가이드

1

LemonClaw WebUI 열기

  1. 호스팅형 Claw를 사용하는 경우, Claw Dashboard로 이동하여 Open WebUI를 클릭합니다.
  2. LemonClaw를 셀프 호스팅하는 경우, 자체 WebUI(예: http://your-ip:18789)를 열고 token으로 로그인합니다.
  3. WebUI에서 Settings → Channels로 이동합니다.
  4. WhatsApp 섹션을 확장합니다.
  5. Access Policy를 구성합니다 (allowlist 권장).
  6. 먼저 Save를 클릭합니다. QR 코드를 스캔하기 전에 구성을 저장해야 합니다.
2

QR 코드 스캔

  1. Scan QR Code 버튼을 클릭합니다.
  2. QR 코드가 나타납니다 (~60초 동안 유효).
  3. 휴대폰에서 WhatsApp → Settings → Linked Devices → Link a Device를 엽니다.
  4. 화면에 표시된 QR 코드를 스캔합니다.
  5. 연결이 설정될 때까지 기다립니다.
3

Access Policy 구성

WhatsApp은 allowlist 정책을 사용합니다. 지정한 전화번호만 AI 봇과 상호작용할 수 있습니다.LemonClaw WebUI에서 허용된 전화번호를 추가합니다 (국제 형식, 예: +1234567890).
다른 플랫폼과 달리 WhatsApp은 페어링 메커니즘을 지원하지 않습니다. 허용된 연락처를 명시적으로 추가해야 합니다.
4

채팅 시작하기

허용된 연락처에서 연결된 WhatsApp 번호로 메시지를 보내면 AI가 응답합니다!

​
그룹 설정

WhatsApp 그룹이 지원됩니다. Channels 섹션에서 그룹 동작을 구성하세요:
설정옵션설명
Group PolicyOpen (기본값) / Allowlist / Disabled그룹에서 누가 봇을 트리거할 수 있는지 제어합니다
Require @mentionOn / Off봇이 @mention되었을 때만 응답합니다
Group IDs그룹 JIDs 목록특정 그룹으로 제한 (비어 있음 = 모든 그룹)
Group Allowed Users전화번호 목록이 사용자들만 봇을 트리거할 수 있습니다 (allowlist 모드)
그룹 allowlist의 전화번호에는 E.164 형식을 사용하세요 (예: +1234567890).

​
문제 해결

Scan QR Code를 다시 클릭하여 새 코드를 생성하세요. QR 코드는 약 60초 후에 만료됩니다.
WhatsApp은 비활성 상태가 지속되면 연결된 기기의 연결을 해제할 수 있습니다. QR 코드를 다시 스캔하여 다시 연결하세요.
  • 발신자의 번호가 allowlist에 있는지 확인하세요 (allowlist 정책을 사용하는 경우)
  • 인스턴스가 실행 중인지 확인하세요
  • LemonData 잔액을 확인하세요