WhatsApp 연결을 하는 이유
WhatsApp은 전 세계에서 가장 많은 사용자를 보유한 메신저 중 하나입니다. OpenClaw을 WhatsApp에 연결하면 평소 사용하는 채팅 화면에서 바로 AI 어시스턴트와 대화할 수 있습니다. 별도의 앱을 열 필요도 없고, 새로운 주소를 기억할 필요도 없으며, AI에게 메시지를 보내는 것이 친구에게 메시지를 보내는 것처럼 자연스럽습니다.
OpenClaw은 WhatsApp Web 프로토콜을 통해 연결하며, PC에서 WhatsApp Web에 로그인하는 것과 동일한 원리로 작동합니다. 이제 전체 설정 과정을 진행해 보겠습니다.
사전 요구사항
시작하기 전에 다음을 확인하세요:
- OpenClaw이 설치되어 있고 정상 실행 중 (설치 가이드 참고)
- AI 모델 공급자가 최소 하나 이상 설정되어 있어야 합니다 (예: Anthropic Claude)
- 정상적으로 사용 중인 WhatsApp 계정이 있어야 합니다
- 스마트폰의 WhatsApp 앱이 최신 버전이어야 합니다
Onboard 마법사로 WhatsApp 채널 추가
아직 초기 설정 단계에 있다면, openclaw onboard 마법사에서 연결할 채널을 선택할 때 WhatsApp을 선택하면 됩니다.
이미 초기 설정을 완료한 상태에서 WhatsApp 채널만 추가하고 싶다면, 다음 명령을 실행하세요:
openclaw channel add whatsapp
이 명령으로 WhatsApp 채널 설정 과정이 시작됩니다.
QR 코드 스캔으로 페어링 완료
채널 추가 명령을 실행하면 터미널에 QR 코드가 표시됩니다. 스마트폰의 WhatsApp으로 이 QR 코드를 스캔하여 페어링을 완료합니다:
- 스마트폰에서 WhatsApp을 엽니다
- 설정 > 연결된 기기 (iOS) 또는 메뉴 > 연결된 기기 (Android)로 이동합니다
- 기기 연결을 탭합니다
- 스마트폰 카메라를 터미널에 표시된 QR 코드에 맞춥니다
스캔이 성공하면 터미널에 연결 성공 메시지가 표시됩니다. 전체 과정은 보통 몇 초 이내에 완료됩니다.
QR 코드가 만료되었다면 (보통 60초 후 만료), Enter를 눌러 새 QR 코드를 생성할 수 있습니다.
설정 파일 확인
페어링이 완료되면 OpenClaw이 자동으로 설정 파일을 업데이트합니다. ~/.config/openclaw/openclaw.json5를 확인하여 WhatsApp 채널이 추가되었는지 확인할 수 있습니다:
{
channels: {
whatsapp: {
enabled: true,
autoReply: true,
// 세션 설정
allowedNumbers: [], // 빈 배열은 모든 번호를 허용합니다
ignoreGroups: true // 기본적으로 그룹 메시지를 무시합니다
}
}
}
주요 설정 항목 설명:
autoReply:true로 설정하면 메시지 수신 시 자동으로 답변합니다.false로 설정하면 특정 접두사로 시작해야 트리거됩니다.allowedNumbers: AI와 대화할 수 있는 전화번호를 제한합니다. 비어 있으면 제한 없음을 의미합니다. 보안을 위해 자신의 번호를 입력하는 것을 권장합니다.ignoreGroups: 그룹 메시지를 무시할지 여부입니다. 초기에는true로 설정하여 그룹에서 불필요한 답변이 발생하지 않도록 하는 것을 권장합니다.
메시지 송수신 테스트
OpenClaw Gateway가 실행 중인지 확인합니다:
openclaw up
그런 다음 다른 WhatsApp 계정으로 (또는 친구에게 부탁하여) 해당 WhatsApp 번호로 메시지를 보내보세요. 모든 설정이 올바르다면, OpenClaw이 AI 모델을 통해 응답을 생성하고 자동으로 답장을 보냅니다.
자신에게 메시지를 보내서 테스트할 수도 있습니다. WhatsApp에서 "나에게 보내기" 대화를 찾아 메시지를 보내고 AI 답변이 오는지 확인해 보세요.
Dashboard에서도 메시지 송수신 상황을 모니터링할 수 있습니다:
openclaw dashboard
Dashboard에서는 모든 채널의 메시지 로그를 표시하므로, 메시지가 정상적으로 전달되는지 쉽게 확인할 수 있습니다.
자주 발생하는 문제 해결
QR 코드 스캔 후 반응이 없음
- 스마트폰과 PC가 같은 네트워크 환경에 있는지 확인하세요
- WhatsApp이 최신 버전인지 확인하세요
- OpenClaw 서비스를 재시작한 후 다시 스캔을 시도하세요
메시지를 보냈지만 답변이 없음
먼저 Gateway 로그를 확인합니다:
openclaw logs
주요 원인:
- AI 모델 공급자의 API 키가 유효하지 않거나 잔액이 부족
- API 엔드포인트에 네트워크 접근이 불가능 (특정 네트워크 환경에서 발생)
autoReply가false로 설정되어 있음
연결이 자주 끊어짐
WhatsApp Web 연결은 네트워크 불안정으로 인해 가끔 끊어질 수 있습니다. OpenClaw에는 자동 재연결 기능이 내장되어 있지만, 자주 끊어진다면 다음을 확인하세요:
- 스마트폰의 WhatsApp이 온라인 상태인지
- 스마트폰의 네트워크가 안정적인지
- 다른 기기에서도 WhatsApp Web에 로그인했는지 (최대 4개의 연결 기기 지원)
진단 명령으로 더 자세한 정보를 확인할 수 있습니다:
openclaw doctor
그룹에서 답변을 원하지 않음
설정 파일에서 ignoreGroups가 true로 되어 있는지 확인하세요. 특정 그룹에서만 AI 답변을 활성화하려면, 그룹 화이트리스트를 설정할 수 있습니다:
{
channels: {
whatsapp: {
ignoreGroups: false,
allowedGroups: ["그룹ID1", "그룹ID2"]
}
}
}
보안 권장사항
allowedNumbers를 통해 AI와 대화할 수 있는 번호를 제한하여, 모르는 사람이 API 사용량을 소비하는 것을 방지하세요- Dashboard의 메시지 로그를 정기적으로 확인하여 비정상적인 사용이 없는지 점검하세요
- AI 어시스턴트와의 대화에서 민감한 개인정보를 보내지 마세요
마무리
WhatsApp은 OpenClaw에서 가장 많이 사용되는 채널 중 하나이며, 설정 과정도 복잡하지 않습니다. 페어링이 완료되면 추가 유지보수가 거의 필요 없으며, OpenClaw이 연결 유지와 메시지 전달을 자동으로 처리합니다. 사용 중 문제가 발생하면 OpenClaw 공식 문서를 참고하거나 OpenClaw GitHub 저장소에서 관련 이슈를 검색해 보세요. 다른 채널 연결 방법은 OpenClaw을 방문하세요.