A communication protocol and CLI tool for sending messages and managing contacts between different OpenClaw agent instances.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-messenger
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-messenger 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 OpenClaw Messenger?
OpenClaw Messenger is a specialized tool designed to bridge the gap between separate OpenClaw instances. It allows developers and users to establish a robust messaging network where agents can exchange information, ping each other for availability, and manage a directory of trusted contacts. By leveraging WebSockets, it facilitates real-time data flow and system-level event injection between distributed AI environments.
As part of the Openclaw Skills ecosystem, this tool is essential for developers building complex multi-agent workflows. Whether you are coordinating tasks across different machines or simply sending a message to a colleague's AI, this skill provides the necessary infrastructure for secure and efficient inter-instance communication.
OpenClaw Messenger Use Cases
- Notifying another OpenClaw instance about task completion or specific status updates.
- Sending direct messages to a peer's AI agent for collaborative coding or real-time debugging.
- Building a decentralized network of AI agents that share context, resources, or commands.
- Monitoring agent connectivity and health across different machines or geographical locations using the ping functionality.
How OpenClaw Messenger Works
- Obtain the target OpenClaw instance's Gateway WebSocket URL and its specific access token.
- Establish a secure WebSocket connection to the destination instance.
- Send messages formatted as system events which are then injected into the recipient's active session.
- Optionally use Relay Mode to route messages via a central server using unique IDs, removing the need for direct IP or token exchanges between individual users.
OpenClaw Messenger Setup
To utilize this feature within your Openclaw Skills setup, ensure you have the ws package installed and follow these configuration steps:
# Install required dependencies
npm install ws
# Add a new contact to your local directory
node scripts/messenger.js contacts add --name "PeerBot" --url "ws://192.168.1.50:18789" --token "your_token_here"
# Send a test message to a saved contact
node scripts/messenger.js send --to "PeerBot" --message "Hello from my OpenClaw!"
# Start a local listening server to receive messages
node scripts/messenger.js listen --port 19900
OpenClaw Messenger Data Schema & Taxonomy
| Data Component | Description | Storage Location |
|---|---|---|
| Contact Directory | Stores agent names, URLs, tokens, and descriptions | contacts.json |
| System Events | Messages are injected into the agent session as event data | Memory/Session Log |
| Relay Configuration | Settings for connecting to a central relay server | relay-client.js config |
OpenClaw Messenger Advanced Features
- Relay Mode Support: Send and receive messages using unique IDs via a Cloudflare-tunnelled relay server to bypass firewall restrictions.
- Real-time Listeners: Set up a dedicated webhook or WebSocket listener to capture incoming traffic from other Openclaw Skills instances.
- Manual Overrides: Direct message sending via CLI by providing one-time URL and token parameters without saving to contacts.
- Connectivity Testing: Built-in ping command to verify the availability and response time of remote agent instances.
SKILL.md
Loading
Related Openclaw Skills
World of Warcraft
A powerful CLI tool for AI agents to retrieve World of Warcraft character profiles, Mythic+ rankings, and raid progression data.
Personal Investigator (PI)
An automated OSINT powerhouse that aggregates public records, legal dockets, and social data to build comprehensive identity dossiers.
nest-sdm
A comprehensive CLI tool to control and monitor Google Nest devices via the Smart Device Management REST API.
Merge Check
A predictive analysis tool that evaluates GitHub pull requests against a comprehensive rejection taxonomy to determine their likelihood of being merged.
Apprentice
Apprentice enables programming by demonstration, allowing your AI agent to watch your actions and convert them into permanent, executable skills.
ClawGuard
A local security scanner designed to audit and verify the safety of AI agent skills before they are installed or executed.
Featured*
