Skip to content
cccskills
FreePublished on GitHubEnglish overview

wacli

Send WhatsApp messages and files to specified people or groups, or sync and search conversation history. The skill guides recipient confirmation and helps locate past messages by chat, keyword, and date.

OriginalShow the original description

Send third-party WhatsApp messages or sync/search WhatsApp history via wacli, not normal active chats.

AI rating100/ 100See how to install

Good for

  • Sending a message to a specified WhatsApp contact
  • Sharing a file with a WhatsApp group
  • Finding past messages by keyword and date
  • Syncing and retrieving older conversation history

Overview

What it does

Helps you contact a specified person or group on WhatsApp and find past conversations. It uses wacli to send text messages or files with captions. It also supports syncing history, finding chats by name or phone number, and searching messages by keyword or date range. You can inspect individual messages in detail and retrieve additional older history.

When it helps

Use it to pass a message to a particular contact or share materials with a group. It also helps you find earlier discussions, such as an invoice you received, by narrowing the search to a chat or date.

Example requests

  • “Send ‘Are you free at 3 pm?’ to this phone number.”
  • “Send agenda.pdf to this group with the caption ‘Agenda’.”
  • “Search messages from 2025 for invoice.”

Notes

Install wacli and log in using a QR code. The recipient and message text are confirmed before sending. This skill is not used for your normal WhatsApp conversation with the agent. Retrieving older history requires your phone to be online, and retrieval results are not guaranteed.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt limits use to messaging others and syncing or searching history, explicitly excluding normal conversations.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodIt provides commands and argument examples for authentication, search, message inspection, history retrieval, and sending.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodSending requires an explicit recipient and message, confirmation before sending, and clarification when anything is ambiguous.
Easy setupDoes it need few tools or API keys, and are they documented?
AGoodIt provides brew or Go installation metadata and QR login instructions using wacli auth.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 19, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (1)

  • SKILL.md2.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

wacli

Use wacli only when the user explicitly asks you to message someone else on WhatsApp or when they ask to sync/search WhatsApp history. Do NOT use wacli for normal user chats; OpenClaw routes WhatsApp conversations automatically. If the user is chatting with you on WhatsApp, you should not reach for this tool unless they ask you to contact a third party.

Safety

  • Require explicit recipient + message text.
  • Confirm recipient + message before sending.
  • If anything is ambiguous, ask a clarifying question.

Auth + sync

  • wacli auth (QR login + initial sync)
  • wacli sync --follow (continuous sync)
  • wacli doctor

Find chats + messages

  • 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

Inspect / verify messages

  • wacli messages show --chat <jid> --id <message_id> --json --full
  • messages show requires both --chat and --id; do not pass the message ID as a positional argument.
  • After sending, verify the stored message when exact formatting matters, especially multiline text.

History backfill

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

Send

  • Text: wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"
  • Group: wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."
  • File: wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"
  • Multiline: --message is literal by default; pass --message-escapes to interpret \n, \r, \t.

Notes

  • Store dir: ~/.wacli (override with --store).
  • Use --json for machine-readable output when parsing.
  • Backfill requires your phone online; results are best-effort.
  • WhatsApp CLI is not needed for routine user chats; it's for messaging other people.
  • JIDs: direct chats look like <number>@s.whatsapp.net; groups look like <id>@g.us (use wacli chats list to find).

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

1password

FreeSummaryAI rating 100

Set up and authenticate the 1Password CLI, then supply stored passwords and API keys to commands or configuration. The skill covers desktop integration, service accounts, and interactive sign-in while keeping secrets out of chat and logs.

  • Setting up the 1Password CLI
  • Supplying API keys to commands
  • Using service account authentication in CI
openclaw/openclaw392.5KUpdated Oct 19, 2026

acp-router

FreeSummaryAI rating 80

Route requests from OpenClaw to external coding agents such as Claude Code or Cursor. Start or continue sessions using ACP, a protocol for connecting agents, or relay prompts directly through acpx while preserving conversation context.

  • Starting a Claude Code session in a thread
  • Continuing work with an external coding agent
  • Relaying prompts directly through acpx
openclaw/openclaw392.5KUpdated Oct 19, 2026

add-model-provider

FreeSummaryAI rating 100

Add a model provider to OpenClaw and verify it with a real response. The skill validates configuration, keeps credentials in environment or file references, and reports test results and any default model changes.

  • Adding a model provider to OpenClaw
  • Configuring credentials through environment or file references
  • Checking whether a model returns a real response
openclaw/openclaw392.5KUpdated Oct 19, 2026

agent-transcript

FreeSummaryAI rating 90

Prepare an agent activity transcript for a GitHub pull request or issue. Extract relevant prompts, decisions, and results from local logs, remove sensitive material, and preview the edited record before separately authorized publication.

  • Preparing an agent activity record for a pull request
  • Extracting task-relevant prompts and results from local logs
  • Previewing a transcript with sensitive information removed
openclaw/openclaw392.5KUpdated Oct 19, 2026

apple-notes

FreeSummaryAI rating 100

Manage Apple Notes on macOS through memo, a command-line tool. Create, browse, search, edit, delete, and move notes between folders, or export selected notes to HTML or Markdown for use outside the app.

  • Creating notes with titles
  • Finding notes by folder or approximate search
  • Editing notes and organizing them into folders
openclaw/openclaw392.5KUpdated Oct 19, 2026

apple-reminders

FreeSummaryAI rating 70

Manage Apple Reminders from your Mac with remindctl, a terminal tool. View tasks by date, add or edit reminders, organize lists, and mark tasks complete or delete them, including personal to-dos that sync to iOS.

  • Review today’s tasks and overdue reminders
  • Add personal to-dos with due dates
  • Organize tasks visible on an iPhone or iPad
openclaw/openclaw392.5KUpdated Oct 19, 2026

See all skills by openclaw

Report a problem with this skill