Whassist OpenClaw Plugin

OpenClaw plugin for Whassist WhatsApp intelligence.

Install

For public distribution through ClawHub:

openclaw plugins install clawhub:whassist-openclaw
openclaw gateway restart

OpenClaw chat commands can enable or inspect installed plugins, but this tested Gateway version does not install packages from chat. Install from the server CLI first, then restart the Gateway.

For local development:

npm install
npm run build
openclaw plugins install -l .
openclaw gateway restart

Connect

In OpenClaw chat:

connect whassist

OpenClaw should ask the user to open:

https://app.wh-assist.com/openclaw

The user opens that URL in a new Chrome tab, logs into Whassist or creates an account, creates a one-time code, and pastes that code into OpenClaw chat. OpenClaw connection comes before WhatsApp QR setup so the agent can guide the rest of onboarding from chat. The plugin exchanges the code through:

POST https://app.wh-assist.com/api/v1/openclaw/exchange

If the user is not logged in, Whassist preserves the connect intent through login or registration and returns them directly to the code page. The public /openclaw start page is only the first entry point; signed-in users continue on /openclaw/connect or onboarding.

The returned API key is stored in plugins.entries.whassist.config.apiKey and is never printed in chat. After a successful exchange, OpenClaw should call whassist_setup_status and guide the user from chat:

1. If WhatsApp is not connected, send the signed-in onboarding setup link.
2. If WhatsApp is connected but contacts are missing, send the same setup link for contact import.
3. If setup is ready, tell the user their remaining credits.
4. If credits are exhausted, send the OpenClaw pricing link.

Setup link:

https://app.wh-assist.com/onboarding?flow=openclaw&redirect=%2F

Pricing link:

https://app.wh-assist.com/pricing?surface=openclaw

Tools

• whassist_connect
• whassist_setup_status
• whassist_credits
• whassist_check_connection
• whassist_ask_agent
• whassist_list_chats
• whassist_get_messages
• whassist_send_message

whassist_send_message requires confirmed: true and should only be called after the user confirms the exact target and message.