QR 코드 페어링을 사용하여 10분 이내에 OpenClaw를 WhatsApp에 연결하세요. 이 가이드에서는 OpenClaw v2026.2+, Node.js 22+ 요구사항, Baileys 라이브러리 통합 및 자체 호스팅 AI 어시스턴트를 위한 보안 모범 사례를 다룹니다.
WhatsApp 통합
OpenClaw를 WhatsApp에 연결하고 AI 어시스턴트가 즉시 메시지에 응답하도록 하세요.
TL;DR
- ✓ 사전 요구사항: Node.js 22+, OpenClaw 설치됨
- ✓ 설정: openclaw.json에 WhatsApp 섹션 추가
- ✓ 소요 시간: 약 10분
- ✓ 페어링: QR 코드 인증
사전 요구사항
- 1.
OpenClaw 설치됨
아직 설치하지 않으셨다면 설치 가이드를 따라주세요.
- 2.
WhatsApp 계정
페어링에 활성 WhatsApp 계정이 필요합니다.
- 3.
WhatsApp이 설치된 모바일 기기
설정 중 QR 코드 스캔에 필요합니다.
설정 단계
1단계: openclaw.json 설정
openclaw.json 파일에 WhatsApp 설정을 추가하세요:
{
"channels": {
"whatsapp": {
"enabled": true,
"allowFrom": ["*"]
}
}
}2단계: OpenClaw 시작
WhatsApp을 활성화하고 OpenClaw를 시작하세요:
openclaw start콘솔에 QR 코드가 표시됩니다. WhatsApp 모바일 앱으로 스캔하세요.
3단계: QR 코드 페어링
휴대전화에서 WhatsApp을 열고 다음으로 이동하세요:
- 설정 → 연결된 기기
- "기기 연결"을 탭하세요
- 콘솔의 QR 코드를 스캔하세요
연결 완료! WhatsApp AI 어시스턴트가 준비되었습니다.
고급 구성
특정 발신자 허용
AI 어시스턴트와 상호작용할 수 있는 사용자를 제한하세요:
{
"channels": {
"whatsapp": {
"enabled": true,
"allowFrom": ["+1234567890", "+0987654321"]
}
}
}문제 해결
QR 코드가 스캔되지 않나요?
휴대전화 화면 밝기를 최대로 설정하고 QR 코드가 콘솔에 완전히 표시되는지 확인하세요.
세션 연결이 끊어졌나요?
OpenClaw를 다시 시작하고 QR 코드를 다시 스캔하세요. WhatsApp 세션은 시간이 지나면 만료될 수 있습니다.
메시지를 받지 못하나요?
openclaw.json의 WhatsApp 채널에 "enabled": true가 설정되어 있는지 확인하세요.
관련 가이드
자주 묻는 질문
OpenClaw가 WhatsApp Business와 호환되나요?
네, OpenClaw는 WhatsApp Personal과 WhatsApp Business 계정 모두에서 작동합니다. 설정 과정은 두 계정 유형에 대해 동일합니다.
WhatsApp 페어링은 얼마나 오래 지속되나요?
WhatsApp 세션은 일반적으로 재인증이 필요한 30일 전에 만료됩니다. 그러나 OpenClaw는 세션이 만료될 때 알려줍니다.
OpenClaw를 사용하는 동안 WhatsApp Web을 사용할 수 있나요?
아니요, OpenClaw와 동시에 WhatsApp Web을 사용할 수 없습니다. 그러나 모바일의 OpenClaw는 독립적으로 작동합니다 - 계속해서 휴대전화에서 WhatsApp을 정상적으로 사용할 수 있습니다.
WhatsApp 대화 데이터가 로컬에 저장되나요?
네, OpenClaw에서 처리하는 모든 WhatsApp 대화는 로컬 서버에 유지됩니다. 클라우드 로깅을 명시적으로 구성하지 않는 한第三方 서버로 메시지 데이터가 전송되지 않습니다.