WhatsApp 채널 설정
OpenClaw와 WhatsApp을 연동하여 AI 어시스턴트를 구축하는 방법을 안내합니다.
개요
WhatsApp 채널이란?
OpenClaw의 WhatsApp 채널은 WhatsApp Web 프로토콜을 사용하여 메시지를 처리합니다:
- QR 코드 스캔으로 간단한 연결
- 개인 계정 또는 Business 계정 지원
- 메시지, 이미지, 파일 전송 지원
설정 방법
QR 코드 연결
1단계: 설정 파일 구성
{
"channels": {
"whatsapp": {
"enabled": true,
"sessionPath": "~/.openclaw/whatsapp-session"
}
}
}
2단계: Gateway 시작 및 QR 스캔
openclaw gateway start
Gateway가 시작되면 터미널에 QR 코드가 표시됩니다.
3단계: WhatsApp에서 QR 스캔
- WhatsApp 앱 실행
- 설정 → 연결된 기기 → 기기 연결
- 터미널의 QR 코드 스캔
QR 코드가 만료되면 자동으로 갱신됩니다.
연결 후 세션 정보는 sessionPath에 저장됩니다.
접근 제한 설정
특정 전화번호만 봇을 사용하도록 제한:
{
"channels": {
"whatsapp": {
"enabled": true,
"allowedNumbers": [
"+821012345678",
"+821098765432"
],
"allowAll": false
}
}
}
자동 응답 설정
{
"channels": {
"whatsapp": {
"autoReply": {
"enabled": true,
"outsideHours": "현재 업무 시간 외입니다. 운영 시간: 09:00-18:00",
"businessHours": {
"start": "09:00",
"end": "18:00",
"timezone": "Asia/Seoul"
}
}
}
}
}
트러블슈팅
QR 코드가 표시되지 않음
# 디버그 모드로 시작
openclaw --debug gateway start
세션이 자주 만료됨
{
"channels": {
"whatsapp": {
"sessionRefresh": {
"enabled": true,
"interval": 86400
}
}
}
}
메시지가 수신되지 않음
# 채널 상태 확인
openclaw channel status --type whatsapp
# 재연결
openclaw channel reconnect --type whatsapp
주의사항
- WhatsApp 이용약관 준수: 스팸 발송 금지
- 메시지 속도 제한: 과도한 자동 메시지는 계정 차단 위험
- 세션 보안:
sessionPath의 파일을 안전하게 보관하세요
참고: