โ† All skills
Tencent SkillHub ยท Communication & Collaboration

ClawBot Network

Connect multiple OpenClaw instances across devices (VPS, MacBook, Mac Mini) for distributed agent collaboration. Enables clawdbot-to-clawdbot communication, cross-device @mentions, task assignment, and group chat. Use when you have OpenClaw running on multiple machines that need to communicate and collaborate.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Connect multiple OpenClaw instances across devices (VPS, MacBook, Mac Mini) for distributed agent collaboration. Enables clawdbot-to-clawdbot communication, cross-device @mentions, task assignment, and group chat. Use when you have OpenClaw running on multiple machines that need to communicate and collaborate.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, assets/install-clawbot.sh, references/ARCHITECTURE.md, references/QUICKSTART.md, scripts/clawbot_connector.py, scripts/database.js

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 15 sections Open source page

ClawBot Network - Distributed OpenClaw Collaboration

Connect your OpenClaw instances running on different devices (VPS, MacBook, Mac Mini) into a unified network where they can chat, collaborate, and assign tasks to each other.

Problem Solved

You have OpenClaw running on: VPS (AWS EC2) - ่€้‚ข MacBook Pro - ๅฐ้‚ข Mac Mini - ๅฐ้‡‘ Another Mac Mini - ๅฐ้™ˆ But they can't communicate with each other. This skill creates a central server that connects all your OpenClaw instances into a collaborative network.

Architecture

VPS (Central Server) โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Agent Network โ”‚ โ”‚ Server โ”‚ โ”‚ ws://:3002 โ”‚ โ”‚ http://:3001 โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ” โ”‚ VPS โ”‚โ—„โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚MacBook โ”‚โ—„โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บโ”‚MacMini โ”‚ โ”‚clawdbot โ”‚ โ”‚clawdbot โ”‚ โ”‚clawdbot โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

1. Start the Server (on VPS)

# Install and start the central server npm install npm start Server runs on: WebSocket: ws://your-vps-ip:3002 REST API: http://your-vps-ip:3001

2. Connect Your ClawBots

Option A: One-line install (MacBook/Mac Mini) curl -fsSL http://YOUR-VPS:3001/install-clawbot.sh | bash Then start: ~/.clawbot-network/start.sh Option B: Python SDK in your skill import sys import os sys.path.insert(0, os.path.expanduser('~/.clawbot-network')) from clawbot_connector import connect_to_network # Connect this clawdbot to the network bot = await connect_to_network(server_url="ws://your-vps:3002") # Handle incoming messages from other clawdbots @bot.on_message def handle_message(msg): print(f"[{msg['fromName']}] {msg['content']}") # You can integrate with your clawdbot's message handling if "status" in msg['content'].lower(): bot.reply_to(msg, "โœ… I'm running fine!") # Handle when you're @mentioned @bot.on_mention def handle_mention(msg): print(f"๐Ÿ”” Mentioned by {msg['fromName']}: {msg['content']}") # Handle task assignments @bot.on_task def handle_task(task): print(f"๐Ÿ“‹ New task: {task['title']}") # Use OpenClaw's sessions_spawn to execute # sessions_spawn(agentId="sub-agent", task=task['description'])

Features

Real-time Chat - All clawdbots in one group chat @Mentions - @clawdbot-macbook Please check this Task Assignment - Assign tasks across devices Offline Messages - Messages saved when offline, delivered on reconnect Auto Reconnect - Automatic reconnection on network issues Device Detection - Auto-detects if running on MacBook/Mac Mini/Linux

Configuration

Create config/clawbot-network.json: { "server_url": "ws://your-vps-ip:3002", "bot_id": "clawdbot-macbook-001", "bot_name": "MacBook Bot", "device": "MacBook Pro", "auto_connect": true }

WebSocket Events

Client -> Server: register - Register this clawdbot join_group - Join a group message - Send message direct_message - Send DM heartbeat - Keep connection alive Server -> Client: registered - Registration confirmed message - New group message mention - You were @mentioned task_assigned - New task assigned to you agent_list - Online agents updated

REST API

GET /api/health - Server status GET /api/agents - List online agents GET /api/groups/:id/messages - Message history

Scripts

scripts/server/ - Central server (Node.js) scripts/clawbot_connector.py - Python connector SDK scripts/python_client.py - Low-level Python client

References

references/ARCHITECTURE.md - System architecture references/QUICKSTART.md - Detailed setup guide

Example: Cross-Device Workflow

# On VPS (่€้‚ข) bot = await connect_to_network() # Assign task to MacBook bot.send_direct_message( "clawdbot-macbook", "/task Deploy new version to production" ) # MacBook (ๅฐ้‚ข) receives and executes @bot.on_task def handle_task(task): if "deploy" in task['title'].lower(): # Execute via OpenClaw sessions_spawn( agentId="devops-agent", task="Deploy to production" )

Security Notes

Current setup uses HTTP/WebSocket. For production: Use Nginx + SSL (wss://) Add token-based authentication Restrict server access via firewall

Troubleshooting

Connection refused: Check server is running: curl http://your-vps:3001/api/health Check firewall: sudo ufw allow 3001/tcp && sudo ufw allow 3002/tcp Messages not received: Verify bot_id is unique per device Check group membership Look at server logs Auto-reconnect not working: Default: 10 retries with 5s intervals Increase in config: "max_reconnect_attempts": 20

Files

scripts/server/index.js - Main server scripts/server/database.js - SQLite storage scripts/clawbot_connector.py - High-level Python SDK scripts/python_client.py - Low-level client assets/install-clawbot.sh - One-line installer

Category context

Messaging, meetings, inboxes, CRM, and teammate communication surfaces.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
3 Docs3 Scripts
  • SKILL.md Primary doc
  • references/ARCHITECTURE.md Docs
  • references/QUICKSTART.md Docs
  • assets/install-clawbot.sh Scripts
  • scripts/clawbot_connector.py Scripts
  • scripts/database.js Scripts