A distributed communication layer that connects multiple OpenClaw instances across different devices into a unified, collaborative agent network.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawbot-network
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 clawbot-network 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 ClawBot Network?
The ClawBot Network is a powerful extension within the Openclaw Skills library designed to bridge the gap between isolated agent instances. By establishing a central server architecture, it enables seamless communication between OpenClaw deployments on VPS, MacBook, and Mac Mini hardware. This skill transforms individual bots into a cohesive team capable of real-time chat, cross-device mentions, and synchronized task execution.
Built on a robust Node.js and WebSocket backbone, the ClawBot Network provides the infrastructure for true distributed intelligence. It allows developers to leverage the unique strengths of different hardware—such as using a high-performance VPS for processing and local Mac devices for specialized tool access—all coordinated through a single Openclaw Skills interface.
ClawBot Network Use Cases
- Distributing heavy computational tasks from a local MacBook to a high-performance VPS using Openclaw Skills.
- Synchronizing deployment workflows where a local agent triggers a production release on a remote server.
- Creating a unified command center to monitor multiple OpenClaw instances from a single group chat interface.
- Facilitating complex multi-agent handoffs between specialized bots running on different physical machines.
How ClawBot Network Works
- Deploy the central WebSocket and REST API server on a persistent host like a VPS to act as the primary communication hub for Openclaw Skills.
- Register individual OpenClaw instances (ClawBots) to the network using unique identifiers and device-specific metadata.
- Establish persistent WebSocket connections for real-time bi-directional event streaming between registered agents.
- Route messages, @mentions, and task assignments through the central server to the targeted recipient agent.
- Utilize the built-in SQLite database on the server to handle offline message queuing, ensuring delivery even after temporary network disruptions.
ClawBot Network Setup
To get started with this addition to your Openclaw Skills library, follow these steps:
- Start the Central Server (on your VPS):
cd scripts/server
npm install
npm start
- Connect Local Devices:
curl -fsSL http://YOUR-VPS-IP:3001/install-clawbot.sh | bash
~/.clawbot-network/start.sh
- Python Integration: Ensure your local environment can import the connector:
# Add the network directory to your Python path
export PYTHONPATH=$PYTHONPATH:~/.clawbot-network
ClawBot Network Data Schema & Taxonomy
The ClawBot Network organizes data to ensure reliable communication across the Openclaw Skills ecosystem:
| Component | Type | Description |
|---|---|---|
clawbot-network.json |
Config | Stores server URL, bot ID, name, and device hardware type. |
agents Table |
SQLite | Tracks online status, unique IDs, and metadata for every connected bot. |
messages Table |
SQLite | Stores history for group chats and direct messages, including offline queues. |
tasks Table |
SQLite | Manages cross-device task state, assignments, and completion status. |
ClawBot Network Advanced Features
- Intelligent Device Detection: Automatically identifies host environment (MacBook vs. Linux VPS) to optimize resource usage within the Openclaw Skills framework.
- Offline Message Buffering: Ensures no task or mention is lost during intermittent connectivity issues by caching data at the server level.
- Multi-Agent Task Spawning: Programmatically trigger remote agent execution via high-level Python SDK methods.
- Secure Auto-Reconnection: Features exponential backoff logic to maintain persistent network presence without manual intervention.
- Unified REST API: Provides endpoints for health monitoring and message history retrieval for external monitoring tools.
SKILL.md
Loading
Related Openclaw Skills
Protico Agent Skill
A bridge for AI agents to engage in real-world human discussions and gather sentiment across a network of partner websites via the Protico community widget.
Skill Audit Guardian
A specialized security tool that automatically audits Openclaw Skills ZIP files for suspicious patterns and risk levels.
Antigravity Image Generation
A high-performance image generation skill that utilizes the Gemini 3 Pro model via internal Google Antigravity endpoints.
Workspace Maintenance
Maintain a clean and discoverable documentation environment through non-destructive maintenance cycles and systematic archiving.
Markdown Fetch
An optimization skill that reduces AI token consumption by 80% by fetching web content in Markdown format via Cloudflare.
macOS Screenshot to Telegram
A utility that captures macOS screenshots and transmits them directly to Telegram chats using the Telegram Bot API.
Featured*
