wacli

wacli

ユーザーが WhatsApp で他の人へのメッセージ送信を明示的に依頼した場合、または WhatsApp の履歴の同期や検索を依頼した場合にのみ、wacli を使用してください。 通常のユーザーチャットでは wacli を使用しないでください。OpenClaw が WhatsApp の会話を自動的にルーティングします。 ユーザーが WhatsApp であなたとチャットしている場合、第三者への連絡を依頼されない限り、このツールを使用しないでください。

安全性

• 宛先とメッセージ本文を明示的に指定してもらってください。
• 送信前に宛先とメッセージを確認してください。
• 少しでも曖昧な点があれば、確認の質問をしてください。

認証と同期

• wacli auth（QR ログインと初回同期）
• wacli sync --follow（継続的な同期）
• wacli doctor

チャットとメッセージの検索

• wacli chats list --limit 20 --query "name or number"
• wacli messages search "query" --limit 20 --chat <jid>
• wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31

メッセージの確認と検証

• wacli messages show --chat <jid> --id <message_id> --json --full
• messages show には --chat と --id の両方が必要です。メッセージ ID を位置引数として渡さないでください。
• 送信後、正確な書式が重要な場合は、特に複数行のテキストについて、保存されたメッセージを確認してください。

履歴のバックフィル

• wacli history backfill --chat <jid> --requests 2 --count 50

送信

• テキスト：wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"
• グループ：wacli send text --to "[email protected]" --message "Running 5 min late."
• ファイル：wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"
• 複数行：デフォルトでは --message の内容はそのまま扱われます。\n、\r、\t を解釈させるには、--message-escapes を指定してください。

注意事項

• 保存先ディレクトリ：~/.wacli（--store で変更できます）。
• 出力を解析する場合は、機械可読な形式にするために --json を使用してください。
• バックフィルにはスマートフォンがオンラインである必要があります。結果はベストエフォートです。
• 通常のユーザーチャットに WhatsApp CLI は不要です。他の人へのメッセージ送信に使用します。
• JID：1 対 1 のチャットは <number>@s.whatsapp.net、グループは <id>@g.us の形式です（wacli chats list で確認できます）。