wacli

• 에이전트가 특정 연락처나 그룹에 WhatsApp 메시지를 대신 전송하길 원할 때 (예: 고객에게 알림 전송, 팀 그룹에 공지).
• 프로그래밍 방식으로 과거 WhatsApp 대화에서 특정 키워드, 날짜 또는 연락처를 검색해야 할 때.
• WhatsApp 기록을 동기화하고 백필하여 로컬 저장소에 저장한 후 후속 처리나 조회에 활용하고 싶을 때.
• WhatsApp 수신자에게 선택적 캡션과 함께 파일이나 문서(PDF, 이미지 등)를 전송해야 할 때.

• 귀하가 직접 WhatsApp을 통해 에이전트와 채팅하는 경우 — OpenClaw가 해당 대화를 자동으로 처리하므로, 귀하 자신의 채팅 세션에 대해 wacli를 호출하지 마십시오.
• 수신되는 WhatsApp 메시지를 실시간으로 받거나 응답해야 하는 경우 — wacli는 아웃바운드/조회 도구이며, 수신함 리스너가 아닙니다.
• 수신자 또는 메시지 내용이 불명확한 경우 — 발송 전에 항상 세부 사항을 확인하십시오.

wacli send text를 사용하여 전화번호 또는 WhatsApp 그룹 JID로 메시지를 전송하세요. 개인 채팅(<number>@s.whatsapp.net)과 그룹 채팅(<id>@g.us) 모두 지원합니다.

wacli send file을 사용하여 WhatsApp 연락처 또는 그룹에 파일(PDF, 이미지 등)을 첨부하고 전송하세요. 선택적으로 캡션 문자열을 추가할 수 있습니다.

wacli messages search를 사용하여 키워드, 날짜 범위, 채팅별로 동기화된 WhatsApp 기록을 조회하세요. 작업을 수행하기 전에 과거 대화 맥락을 검색하는 데 유용합니다.

wacli chats list를 사용하면 이름이나 번호로 연락처 또는 그룹을 검색할 수 있으며, 특정 채팅 내에서 메시지를 보내거나 검색하는 데 필요한 JID를 반환합니다.

wacli history backfill을 사용하여 WhatsApp 서버에서 이전 메시지를 로컬 저장소로 가져옵니다. 휴대폰이 온라인 상태여야 하며, 결과는 최선의 노력을 기반으로 제공됩니다.

wacli auth는 QR 기반 로그인 및 초기 동기화를 처리합니다. wacli sync --follow는 로컬 저장소를 지속적으로 최신 상태로 유지합니다. wacli doctor는 연결 문제를 진단하는 데 도움을 줍니다.

에이전트가 회의 지연 또는 상태 변경을 감지하고, 수동 작업 없이 wacli send text를 사용하여 관련 연락처 또는 WhatsApp 그룹 채팅에 알림을 전송합니다.

에이전트가 PDF 보고서나 안건을 생성하고, 설명적인 캡션과 함께 wacli send file을 사용하여 WhatsApp 수신자에게 직접 전달합니다.

후속 메시지를 작성하기 전에, 에이전트는 특정 주제나 키워드를 기준으로 WhatsApp 대화 기록을 검색합니다 (예: wacli messages search "invoice" --after 2025-01-01). 이를 통해 관련된 이전 메시지를 찾아낼 수 있습니다.

워크플로우는 WhatsApp 메시지 기록을 로컬 저장소(~/.wacli)에 동기화하고 백필하여, 다운스트림 도구가 대화 데이터를 쿼리하거나 인덱싱하거나 분석할 수 있도록 합니다.