WhatsApp Voice Calls

Live voice calls with Hermes over WhatsApp, on the linked-device (personal number) setup most Hermes users already have, with no WhatsApp Business account. Call your bot's number and talk to your Hermes: the voice uses Hermes's own persona (a short briefing fetched from Hermes) and hands real work to Hermes mid-call. Or let Hermes call you for things that matter: whatsapp_call_owner rings only the configured owner number (it has no destination parameter) and reports answered, no answer or declined, so the agent can fall back to another channel, including from cron. A short summary of each call arrives in WhatsApp. Speech runs on Gemini Live (gemini-3.8-live by default), reusing the Gemini key Hermes already has; any Live setup field is configurable, plus a language lock. Setup is a dashboard tab (pairing QR, settings, test call) or an agent runbook skill.

Good to know before installing

Runs a separate sidecar process (Rust, built on whatsapp-rust) that the user starts or installs as a systemd/launchd user service; the binary is downloaded from this repo's GitHub release, built and attested by its release workflow, and checked against checksums pinned in the repo (plus the build attestation when the gh CLI is present). The sidecar becomes an extra linked device of the bot's WhatsApp number through an unofficial protocol, stores that session in the plugin's data directory, and answers only the owner's number. During calls it streams audio to generativelanguage.googleapis.com with GOOGLE_API_KEY or GEMINI_API_KEY (read via get_secret), along with the persona briefing, the outgoing call's reason and ask_hermes results as text. It calls the local api_server with API_SERVER_KEY for ask_hermes (a full Hermes turn with the owner's tools), the persona briefing (at startup and after each call) and the post-call summary, a run that may write to Hermes memory and whose result is sent to the owner on WhatsApp. The dashboard tab's backend saves only this plugin's settings (through hermes config set), starts and stops pairing, places test calls to the owner, and restarts the si

From the plugin's catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install hermes-whatsapp-voice
  2. Said no? Turn it on later:
    hermes plugins enable hermes-whatsapp-voice
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Chat apps & voice
Maintained by
ashwanthbalakrishnan5 (Community)
Needs
No API keys declared
Adds tools
whatsapp_call_owner whatsapp_call_status
Works on
linux, macos
Needs Hermes
0.21.6 or newer
Version
0.1.12
In the catalog
2026-10-17
GitHub stars
122

Watch our video on XFull setup & settings ↗Source code ↗

More in chat apps & voice

All chat apps & voice plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins