whatsapp-local-router
Route incoming WhatsApp content to local HTTP endpoints and return endpoint JSON directly to the user. Use when a WhatsApp message contains plain text/random symbols that should be sent to POST http://localhost:8080/process, or when a WhatsApp message contains a QR image that should be sent to POST http://localhost:8080/decode-qr.
Why use this skill?
Seamlessly route WhatsApp text and QR image data to local HTTP endpoints with this OpenClaw skill. Perfect for local dev integration.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/olegqm/whatsapp-local-endpoints-routerWhat This Skill Does
The whatsapp-local-router is a specialized bridge designed to connect OpenClaw AI agents with locally hosted services. By intercepting incoming WhatsApp messages, it automatically intelligently routes content based on the data type detected. Whether it is a text-based payload or a QR code image requiring digital interpretation, this skill ensures that the data is passed to the appropriate local HTTP endpoint (running on localhost:8080) for immediate processing. The core philosophy of this tool is transparency; it captures the raw JSON output from your local server and relays it directly to the user interface without unnecessary alteration, effectively turning your local script environment into a functional API layer for WhatsApp interactions.
Installation
To install this skill, ensure your OpenClaw environment is initialized in your workspace root. Run the following command in your terminal:
clawhub install openclaw/skills/skills/olegqm/whatsapp-local-endpoints-router
Ensure that you have your local HTTP service operational at http://localhost:8080 and that the scripts/route_whatsapp.sh script has appropriate execution permissions within the skill directory.
Use Cases
- Automated Text Processing: Pass arbitrary customer text, symbols, or log entries from WhatsApp to a backend analysis engine via the
/processendpoint. - QR Code Scanning: Automatically handle event check-ins, payment confirmations, or authentication tokens shared via image files by routing them to the
/decode-qrendpoint. - Rapid Prototyping: Connect local development environments to the WhatsApp ecosystem, allowing developers to test backend logic without deploying external webhooks.
Example Prompts
- "Here is a photo of the QR code, please decode it and tell me what the payload says."
- "Process this message: [insert text with random symbols here] and show me the raw response."
- "Scan this attached QR image and return the output."
Tips & Limitations
- Timeout Constraints: Note that the skill enforces a strict 20-second timeout. Ensure your local endpoints are optimized for fast response times.
- Prioritization: If a message contains both a text body and an image attachment, the router defaults to image decoding. If you need to process text alongside an image, perform two separate requests.
- Data Preservation: The router is designed to be "dumb" regarding content manipulation. It does not sanitize inputs, so ensure your local endpoints are robust against unexpected string inputs or malformed image data. Always treat the output as the source of truth.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-olegqm-whatsapp-local-endpoints-router": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-read, code-execution