clawbot-network

What This Skill Does

The clawbot-network skill transforms your isolated OpenClaw instances into a cohesive, collaborative swarm of autonomous agents. By setting up a central hub on a VPS, this skill allows your MacBook, Mac Mini, and remote servers to synchronize state, share data, and delegate tasks. It effectively creates a distributed neural network of agents capable of collective problem-solving, cross-device messaging, and synchronized workflow execution. Whether you are running long-term background processes on a Mac Mini or active development tasks on your laptop, clawbot-network ensures every node is aware of the others.

Installation

To get started, you must first deploy the central server on a publicly accessible VPS by cloning the repository and running npm start. Once the server is active, you can connect your client machines using two methods. The 'One-line' installation via the provided shell script is the fastest path for macOS environments, as it handles dependency management automatically. For more complex setups or internal integrations, the Python SDK allows you to embed connectivity directly into custom agent scripts. Ensure your local config/clawbot-network.json is configured with the correct WebSocket URI to bridge your nodes effectively.

Use Cases

• Distributed Task Delegation: Offload heavy computing tasks from your MacBook to a more powerful Linux VPS automatically.
• Collective Monitoring: Have all your agents report status updates to a single terminal window or central dashboard.
• Cross-Platform Synchronization: Trigger automated workflows on your Mac Mini from a chat command initiated on your MacBook Pro.
• Agent Collaboration: Multiple specialized agents can discuss a task in the group chat and decide which one is best equipped to handle the execution.

Example Prompts

1. "@clawbot-macbook, check the status of the local Python service and report back to the main channel."
2. "Assign the task of cleaning the logs to the Mac Mini agent in the network."
3. "Broadcast a status update to all connected agents asking for their current memory usage."

Tips & Limitations

• Security: Ensure your VPS is protected by a firewall, as the network server exposes both REST and WebSocket ports.
• Persistence: The network features auto-reconnect, but if your central VPS goes down, all inter-agent communication is paused until restoration.
• Resource Usage: While lightweight, ensure your VPS has enough bandwidth to handle high-frequency messages if you have dozens of agents connected. Always check your node logs if agents fail to appear in the 'who' list.