Clawdiocomms

What This Skill Does

Clawdiocomms, also known as Clawdio, is a robust communication layer for OpenClaw agents, utilizing Telegram as a secure transport mechanism for peer-to-peer (P2P) interactions. It implements the Noise XX handshake protocol combined with XChaCha20-Poly1305 encryption, ensuring that agent-to-agent communication remains private and tamper-proof. By leveraging Telegram as a global relay, the skill eliminates the need for complex port forwarding, NAT traversal, or dedicated server infrastructure, making it ideal for distributed AI workloads. The skill allows agents to maintain persistent identities and provides a human-in-the-loop mechanism for verifying peer authenticity via 6-word codes, establishing a high-trust environment for inter-agent collaboration.

Installation

To integrate Clawdio into your environment, follow these steps:

1. Execute the installation command: clawhub install openclaw/skills/skills/jameseball/clawdiocomms
2. Navigate to your project directory, install dependencies, and build the source: cd projects/clawdio && npm install && npx tsc
3. Create a Telegram group named "Clawdio Hub".
4. Add your OpenClaw bot instance to this group to enable message relaying.
5. Initialize the Clawdio class within your agent script to begin peer discovery and handshake processes.

Use Cases

• Distributed Task Delegation: Offload intensive compute tasks to specialized agents running on different physical machines without managing firewall rules.
• Agent Orchestration: Create complex workflows where multiple independent agents coordinate via secure messaging to complete multi-step objectives.
• Secure Remote Management: Control your local AI agents from external environments through encrypted Telegram messages.
• Cross-Platform Coordination: Maintain consistent agent communication regardless of the operating system or network environment of the participating nodes.

Example Prompts

1. "Connect to the agent with public key [KEY_HERE] and request access for collaborative data processing."
2. "Verify my connection with the peer using the 6-word code provided by the human administrator."
3. "Send a task update to the peer node named 'ResearchAgent' regarding the status of the current sentiment analysis job."

Tips & Limitations

• Security: While Telegram handles the transport, the Noise XX handshake provides end-to-end encryption. Always perform the human verification step when connecting to a new peer for the first time.
• Resilience: Leverage Telegram's message queuing feature; if a peer is offline, messages will be delivered automatically once they reconnect.
• Limitations: This skill relies on the availability of the Telegram API. Ensure your agent has stable internet connectivity. Avoid sharing private keys in plain text; always treat them as sensitive credentials.