A model-agnostic utility for Openclaw Skills that converts plain text mentions into interactive, clickable WhatsApp blue mentions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-mention-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-mention-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WhatsApp @Mention Skill?
The WhatsApp @Mention Skill is a specialized utility designed for the OpenClaw ecosystem that ensures AI-generated messages leverage WhatsApp native interactive features. It functions as a middleware layer that intercepts outgoing messages to identify text-based mentions such as @Name or @PhoneNumber and transforms them into valid WhatsApp Local Identities (LIDs). This integration is essential for developers using Openclaw Skills who require their AI agents to effectively ping and notify specific individuals within group chats or direct threads without needing to prompt the model for complex ID strings.
WhatsApp @Mention Skill Use Cases
- Notifying specific group members during automated AI interactions in high-volume chats.
- Ensuring AI reminders trigger native WhatsApp notifications by utilizing proper LID formatting.
- Simplifying mention logic across multiple AI models within the Openclaw Skills framework.
- Maintaining a dynamic and automated contact directory through passive member discovery in groups.
How WhatsApp @Mention Skill Works
- The skill monitors the outgoing message pipeline within the OpenClaw environment.
- It scans message strings for mention patterns including names, phone numbers, or existing LIDs.
- The system references a local LID_CACHE.json file to find the corresponding WhatsApp Local Identity.
- It replaces the plain text mention with the specific metadata required for WhatsApp to render a blue clickable mention.
- The finalized message is sent via the WhatsApp channel, ensuring the recipient is correctly notified.
WhatsApp @Mention Skill Setup
Install the skill directly using the OpenClaw CLI:
openclaw skills install whatsapp-mention
Alternatively, you can perform a manual installation from the source repository:
git clone https://github.com/junwei1213/openclaw-mention-skill.git
cd openclaw-mention-skill
bash install.sh
Note: Because OpenClaw updates may overwrite patched files, it is recommended to re-run the install script after any core updates to your Openclaw Skills setup.
WhatsApp @Mention Skill Data Schema & Taxonomy
| Component | Description |
|---|---|
| LID Cache | A JSON file located at /home/openclaw/.openclaw/workspace/LID_CACHE.json storing name, phone, and LID mappings. |
| Member Script | A Node.js utility (add-member.js) for manual cache population using specific flags for LID, name, and phone. |
| Mapping Files | Internal Baileys credential files (lid-mapping-*.json) used to resolve unknown identities. |
WhatsApp @Mention Skill Advanced Features
- Automatic member discovery: The skill dynamically learns and caches LIDs from incoming group messages.
- Model-agnostic compatibility: Works with GPT-4, Claude, Llama, and other LLMs available in Openclaw Skills without specific prompting instructions.
- Manual Directory Management: Provides a CLI tool to manually map specific contacts to names for high-priority mentions.
- Seamless Re-patching: Includes a dedicated uninstall and reinstall workflow to maintain compatibility across OpenClaw versions.
SKILL.md
Loading
Related Openclaw Skills
UI Designer
An expert UI design skill for creating scalable design systems, accessible components, and pixel-perfect interface implementations.
AgentDerby
A collaborative AI agent system designed for dream-first creative pixel art on shared public canvases using verified execution.
Bible Verse & Scripture API
A high-performance skill for fetching Bible verses, passages, and random scriptures from multiple translations via bible-api.com.
PhysiXpert: Elite Physics Master AI
A high-performance modular framework that transforms AI agents into elite physics experts for theoretical analysis and experimental design.
Context & Memory
A sophisticated framework for managing context window lifecycles, cross-session knowledge transfer, and token budget optimization for AI agents.
Pipeworx Bluesky Skill
A comprehensive interface for reading Bluesky profiles, posts, and network data via the AT Protocol.
Featured*
