ClawLink

How to connect WhatsApp Business to OpenClaw

Connect WhatsApp Business to OpenClaw with ClawLink: sign in with Meta and enter your WABA ID once. No permanent access token, no app secret. 52 WhatsApp tools your agent can call from chat. Requires a WhatsApp Business Account with Cloud API access.

Get started for free
OpenClaw
OpenClaw
ClawLink
ClawLink
WhatsApp Business
WhatsApp Business
WhatsApp BusinessOAUTH2MCP

Send messages and templates from your WhatsApp Business number. Needs a WhatsApp Business Account on Meta's Cloud API, not personal WhatsApp.. Once connected, OpenClaw can read and act on WhatsApp Business from chat — pairing, token refresh, and tool wiring handled for you.

127 tools

The usual route to WhatsApp Business access for OpenClaw is an MCP server you configure and keep running, plus your own OAuth app or API keys. ClawLink gives OpenClaw a more practical WhatsApp Business setup: install one ClawHub skill, connect WhatsApp Business in the browser, and OpenClaw can call real WhatsApp Business actions from any chat surface with no auth, token refresh, or tool wiring to build yourself.

Setup

It takes three steps to connect OpenClaw to WhatsApp Business.

  1. 1

    Install the plugin

    Paste the setup prompt into OpenClaw, or install from the terminal and ask OpenClaw to pair:

    openclaw plugins install clawhub:clawlink-plugin
  2. 2

    Connect WhatsApp Business

    One-click OAuth in the dashboard.

  3. 3

    Use it from chat

    Ask OpenClaw: "What can you do with WhatsApp Business?"

Install by command

The setup prompt above does all of this in one paste. By hand, it is one install command plus a browser approval:

openclaw plugins install clawhub:clawlink-plugin

Then ask OpenClaw to set up ClawLink. It starts browser pairing and prints an approval link — open it, approve the device, return to the chat, and say done. Finally, connect WhatsApp Business in the ClawLink dashboard — a Meta sign-in plus your WhatsApp Business Account ID, no API keys.

Verify the connection by asking OpenClaw:

Use whatsapp_get_phone_numbers to pick the right sending number, then reply to <customer number> with whatsapp_send_message answering their last question. Show me the text before sending.

Using a different agent?

The OpenClaw plugin is one client of ClawLink's MCP server. Claude Code, Cursor, Codex, or any agent that can run a shell command pairs with the same ClawLink account through the CLI:

npx -y @useclawlink/cli login

login opens the same browser approval and stores a credential locally. Once WhatsApp Business is connected in the dashboard, that agent calls the same 127 WhatsApp Business tools over MCP. Full setup for MCP clients and shell agents: connect apps to any AI agent.

WhatsApp Business MCP for OpenClaw

Looking for a WhatsApp Business MCP server for OpenClaw? ClawLink connects WhatsApp Business to OpenClaw and exposes 127 WhatsApp Business tools your agent can call over MCP, with hosted auth and nothing to run or maintain yourself. Using Hermes instead? The Hermes WhatsApp Business integration works the same way.

One thing to get straight before you start, because most guides blur it: this integration needs a WhatsApp Business Account with Cloud API access already set up on Meta's side. That part is Meta's onboarding and nobody can remove it for you. What ClawLink removes is everything after it: the permanent access token, the app secret, and the phone-number ids you would otherwise copy into a config file. You sign in with Meta, enter your WhatsApp Business Account ID (WABA ID) once, and OpenClaw can call the 52 WhatsApp tools below. This is also not the consumer WhatsApp app: there is no QR-code pairing here, and anything you read about openclaw channels add with a phone scan is describing a different setup that drives your personal account rather than the Business API.

What the OpenClaw WhatsApp Business integration can do

127 WhatsApp Business tools are ready for OpenClaw once the account is connected. The 30 below are the ones people reach for most; your agent can call all 127.

30 of 127 WhatsApp Business tools for OpenClaw

ToolWhat it does
Create message template whatsapp_create_message_templateCreate a new message template for the WhatsApp Business Account. Templates must be approved by WhatsApp before they can be used.
Get business profile whatsapp_get_business_profileGet the business profile information for a WhatsApp Business phone number. This includes business details like description, address, website, and contact info.
Get media info whatsapp_get_media_infoGet metadata and download URL for uploaded WhatsApp media. Returns media ID, download URL (valid for 5 minutes), MIME type, SHA256 hash, and file size.
Get message templates whatsapp_get_message_templatesGet all message templates for the WhatsApp Business Account. Templates are required for sending messages outside the 24-hour window and for marketing/utility messages.
Get phone number whatsapp_get_phone_numberRetrieve detailed information about a specific WhatsApp Business phone number.
Get phone numbers whatsapp_get_phone_numbersRetrieve all phone numbers registered to your WhatsApp Business Account. Returns phone number IDs, display numbers, verification status, quality ratings, and messaging throughput limits.
Get template status whatsapp_get_template_statusGet the status and details of a specific message template. This is useful for checking if a template has been approved, rejected, or is still pending review.
Send contacts whatsapp_send_contactsSend contacts WhatsApp number. Note: The message will be delivered to the recipient only if they have initiated a conversation first.
Send interactive buttons whatsapp_send_interactive_buttonsSend an interactive button message with up to 3 reply buttons to a WhatsApp user. Interactive button messages allow recipients to quickly respond by tapping predefined buttons.
Send interactive list whatsapp_send_interactive_listSend an interactive list message to a WhatsApp number. List messages display a menu of options organized into sections. Users tap a button to view the list and select one option.
Send location whatsapp_send_locationSend a location message with coordinates, name, and address to a WhatsApp user. This action allows you to share location information through WhatsApp Business API.
Download media whatsapp_download_mediaDownload a WhatsApp media asset using its short-lived media URL
Get account number whatsapp_get_account_numberRetrieve a WhatsApp Account Number node's status and configuration
Get activities whatsapp_get_activitiesRetrieve a paginated activity history for the WhatsApp Business Account bound to the
Get assigned business accounts whatsapp_get_assigned_business_accountsRetrieve one page of WhatsApp Business Accounts assigned to a specific Meta user
Get assigned users whatsapp_get_assigned_usersList users assigned to a WhatsApp Business Account in a business context
Get business account details whatsapp_get_business_account_detailsRetrieve configuration and status details for the WhatsApp Business Account bound to the
Get business bot whatsapp_get_business_botRetrieve a WhatsApp Business Bot's prompts, commands and welcome-message setting
Get business compliance info whatsapp_get_business_compliance_infoRetrieve comprehensive business compliance information for a WhatsApp Business phone number
Get business encryption whatsapp_get_business_encryptionRetrieve the WhatsApp Business public key and its signature verification status
Get business portfolio whatsapp_get_business_portfolioRetrieve a Meta business portfolio's ID, name and timezone identifier
Get business profile node whatsapp_get_business_profile_nodeRetrieve a WhatsApp Business Profile node by its profile ID
Get call permissions whatsapp_get_call_permissionsCheck permission to call one WhatsApp user from a business phone number
Get client business accounts whatsapp_get_client_business_accountsRetrieve WhatsApp Business Accounts shared with or managed by a business portfolio
Get commerce settings whatsapp_get_commerce_settingsGet commerce settings for a WhatsApp Business phone number
Get connected client businesses whatsapp_get_connected_client_businessesRetrieve one page of client businesses connected to a Meta application
Get extended credits whatsapp_get_extended_creditsRetrieve one page of a Meta Business Portfolio's extended credit lines
Get flow assets whatsapp_get_flow_assetsList assets associated with a WhatsApp Flow
Get group whatsapp_get_groupRetrieve metadata about one WhatsApp group by its group ID
Get join requests whatsapp_get_join_requestsRetrieve pending join requests for a WhatsApp group to help manage group membership

Try it: find the WhatsApp Business tool you need

Browse the 30 WhatsApp Business tools

Click any tool to see exactly what OpenClaw can do and copy a ready-to-use prompt.

Example prompts

Use whatsapp_get_phone_numbers to pick the right sending number, then reply to <customer number> with whatsapp_send_message answering their last question. Show me the text before sending.

How the WhatsApp tools behave

Rules that come from Meta rather than from ClawLink, and that decide whether a message actually leaves.

  • The 24-hour customer service window governs everything. Free-form sends work only within 24 hours of the contact's last message. Outside it, only approved templates go out, and the tools return 131047 to tell you so.
  • Sending is addressed by phone number id, not the display number. whatsapp_get_phone_numbers returns the ids, along with verification status, quality rating, and throughput limits, which is also the quickest health check on a connection.
  • Templates need approval before use. whatsapp_create_message_template submits, whatsapp_get_template_status reports, whatsapp_get_message_templates lists what is usable now. Draft them before you need them.
  • Template deletion is irreversible and wider than it looks. Deleting by name removes every language version, and the name is unusable for 30 days afterwards.
  • Media is upload-then-send, and download URLs expire in 5 minutes. Use whatsapp_upload_media followed by whatsapp_send_media_by_id, and treat the URL from whatsapp_get_media_info as immediately-use-only.
  • A new number needs one registration. If a send fails with 133010, whatsapp_register_phone registers the number with a 6-digit PIN that you supply. It is a one-time step.
  • Interactive messages have hard limits. Buttons cap at three per message with 20-character titles; lists allow up to 10 sections of 10 items. Both still require the recipient to have messaged first.

The alternative to ClawLink is usually manual OAuth app setup plus your own token handling, permission troubleshooting, and tool plumbing for OpenClaw. That is fine if you want to build and maintain the integration yourself. Most teams just want WhatsApp Business working from chat.

ManualClawLink
Connection flowRegister a WhatsApp Business app, configure redirect URLs, manage consent details, and reconnect users when auth settings drift.Users connect WhatsApp Business through the hosted browser flow and ClawLink keeps the token lifecycle out of your app code.
Ongoing maintenanceYou own refresh logic, permission debugging, environment config, and every provider-specific edge case for WhatsApp Business.ClawLink handles the repetitive integration plumbing so your team can focus on the workflow instead of the infrastructure.
Agent usabilityYou still need to expose the right WhatsApp Business actions to the runtime in a format your agent can reliably use.127 tools for WhatsApp Business are already exposed through ClawLink, so the agent can read and act from chat immediately.

Composio also exposes WhatsApp Business to AI agents. It is developer infrastructure: Python and TypeScript SDKs, an MCP server, and a catalog past 1,000 apps, aimed at teams shipping agent products. ClawLink is built for OpenClaw users instead. You install the plugin once, connect WhatsApp Business in the browser, and the 127 tools above work from chat. There is no SDK, no config file, and no API key handling. Choosing between them? Read the full Composio alternatives comparison.

Troubleshooting

OpenClaw installed the WhatsApp Business skill but can't call the tools

The ClawHub skill teaches OpenClaw about WhatsApp Business, but the calls run through the ClawLink plugin and your connected account. Make sure WhatsApp Business is connected in the dashboard, then start a fresh chat so OpenClaw reloads the tool catalog. If OpenClaw runs as a persistent gateway, restart it so the new tools register.

Connection succeeds but no tools appear

Reconnect WhatsApp Business from the dashboard, then start a fresh chat if the runtime still has the old tool catalog loaded.

"Tool schema not loaded yet" error when calling WhatsApp Business tools

WhatsApp Business tool schemas load on demand the first time a tool runs and are cached after that, so this error usually clears on its own: wait a few seconds and retry the same request. If every WhatsApp Business call keeps failing with it in a fresh chat, reconnect from the dashboard, and contact support if it still persists — that pattern points to a configuration problem on our side, not something you can fix by reconnecting again.

WhatsApp Business returns 403 or "permission denied" on one action while others work

Two usual causes. The connected account may not have access to the specific workspace, inbox, store, or project in the request — check that first. If access looks right, the agent may have sent a placeholder value (like "YOUR_ID" or an example id from documentation) instead of a real one: ask it to run a list or search tool first, then retry the action with a real id from those results. Most failures at this stage are one of these two, not ClawLink bugs.

WhatsApp returns error 131047 "Re-engagement message"

This is the 24-hour window, and it is the most common WhatsApp failure by a wide margin. The recipient has not messaged your business in the last 24 hours, so Meta refuses free-form content and requires an approved template instead. Nothing about the connection is wrong and reconnecting will not help. Have the agent list what is available with whatsapp_get_message_templates and send with whatsapp_send_template_message, or, if no suitable template exists, submit one with whatsapp_create_message_template and wait for approval before retrying. The same rule is why interactive buttons and list messages also fail on cold contacts.

Ask the agent to diagnose it:

Call whatsapp_get_message_templates and show me every approved template with its name and language. Do not try to send anything else until I pick one.
WhatsApp returns error 133010 "Account not registered"

133010 is about your side, not the customer's: the business phone number is on your WhatsApp Business Account but was never registered for the Cloud API, so nothing can be sent from it. The connection is fine and reconnecting will not help. Registration is a one-time step with a 6-digit two-step verification PIN. OpenClaw can do it with whatsapp_register_phone: it takes the phone number id from whatsapp_get_phone_numbers and the PIN from you. If the number already has a PIN, only that PIN works; you can set a new one in Meta Business Suite under WhatsApp Manager, Phone numbers, Two-step verification.

Ask the agent to diagnose it:

Run whatsapp_get_phone_numbers and show me each number's id and status. Then ask me for my 6-digit PIN and register the number with whatsapp_register_phone. Do not invent a PIN.
WhatsApp returns error 131026 "Message undeliverable"

131026 is on the recipient's side: the number has no WhatsApp account, the person blocked your business number, or their WhatsApp app is too old to receive it. Retrying or reformatting will not deliver it, so check the number with the customer. Before assuming that, confirm the sending side: WhatsApp tools address a business number by its phone number id, not the display number, so run whatsapp_get_phone_numbers first and use the id from that result.

Ask the agent to diagnose it:

Run whatsapp_get_phone_numbers and tell me which phone number ids this connection can send from, along with each one's verification status and quality rating.
Invalid waba_id

The WhatsApp Business Account ID saved on your connection is not a WABA ID. People most often paste the phone number or the Business Manager (business portfolio) ID by mistake. Reconnect WhatsApp in the ClawLink dashboard and enter the 15-16 digit WABA ID from Meta Business Suite under Settings, Accounts, WhatsApp accounts. If you only know your Business Manager ID, OpenClaw can look up the WABA IDs it owns with whatsapp_get_owned_business_accounts.

WhatsApp media fails to send or the download link has stopped working

Media has its own two-step shape and a short expiry that catches people out. To send a file you upload it first with whatsapp_upload_media and then send it by id with whatsapp_send_media_by_id, or send by URL with whatsapp_send_media. Going the other way, whatsapp_get_media_info returns a download URL that is valid for five minutes only, so an agent that fetches metadata, does something else, and then tries to download will find a dead link. Ask it to fetch and download in the same step rather than storing the URL for later.

OAuth finished in the browser but the account is still missing

Try reconnecting WhatsApp Business and complete the consent flow in the same browser session. Partial OAuth approvals or switching accounts mid-flow can leave the connection incomplete.

FAQ

Is there a OpenClaw WhatsApp Business integration?

Yes. ClawLink is the fastest way to connect OpenClaw to WhatsApp Business: link your WhatsApp Business account once in the browser and OpenClaw can call the WhatsApp Business API through 127 ready-made tools — no custom code or token handling.

How do I add WhatsApp Business to OpenClaw with ClawLink?

Paste the setup prompt from this page into OpenClaw. It installs the ClawLink WhatsApp Business skill from ClawHub, then you click Connect in the dashboard to authorize WhatsApp Business. OpenClaw calls the tools from the next message — no config files or API keys to manage.

How long does it take to connect WhatsApp Business to OpenClaw?

About two minutes if your business number is already on the WhatsApp Cloud API: sign in with Meta, enter your WhatsApp Business Account ID, and OpenClaw can use it from the next chat message. If it is not, Meta's setup comes first: add the number in WhatsApp Manager and give it a 6-digit PIN. That part takes longer and happens on Meta's side.

Why use ClawLink instead of wiring WhatsApp Business up myself?

The alternative to ClawLink is usually manual OAuth app setup plus your own token handling, permission troubleshooting, and tool plumbing for OpenClaw. That is fine if you want to build and maintain the integration yourself. Most teams just want WhatsApp Business working from chat.

Do I need a WhatsApp Business Account and Meta setup?

Yes. A WhatsApp Business Account with Cloud API access is a prerequisite, and the dashboard flags this integration as needing Meta setup for exactly that reason. What you do not need is the part that usually goes wrong: generating a permanent access token, storing an app secret, and keeping phone-number ids in sync in a config file. During connect you enter one thing by hand: your WABA ID, a 15-16 digit number in Meta Business Suite under Settings, Accounts, WhatsApp accounts. It is not the phone number and not the Business Manager ID. If you do not have Cloud API access yet, set that up with Meta first — connecting here before that exists will not work, and it is the most common reason a first attempt fails.

Is this the WhatsApp app on my phone or the Business API?

The Business API. That distinction matters because most OpenClaw WhatsApp content describes the other thing — pairing your personal WhatsApp by scanning a QR code so the agent reads and sends from your own account. That approach drives the consumer app, is not what Meta supports for automation, and can get a number blocked. This integration talks to WhatsApp Business Cloud API through your business phone number, with templates, approvals, and the 24-hour messaging window that Meta requires of business senders.

Why can the agent only reply to people who messaged first?

That is Meta's customer service window and it applies to everyone using the Business API, not something ClawLink imposes. You can send free-form messages only within 24 hours of the customer's last message. Outside that window you must send an approved message template instead, which is why the toolset includes template creation, listing, and status checks alongside the send tools. An agent that tries a normal message to a cold contact gets error 131047, which means exactly this: use a template.

Can the agent create its own message templates?

It can submit them, but WhatsApp has to approve them before they can be used, and approval is not instant. whatsapp_create_message_template submits a template and whatsapp_get_template_status tells you where it stands, so a sensible workflow is to have the agent draft and submit templates ahead of time rather than at the moment you want to send. One irreversible detail worth knowing: deleting a template removes every language version under that name, and the name cannot be reused for 30 days.

OpenClaw installed the WhatsApp Business skill but can't call the tools

The ClawHub skill teaches OpenClaw about WhatsApp Business, but the calls run through the ClawLink plugin and your connected account. Make sure WhatsApp Business is connected in the dashboard, then start a fresh chat so OpenClaw reloads the tool catalog. If OpenClaw runs as a persistent gateway, restart it so the new tools register.

On this page