Agentbus Relay Chat

What This Skill Does

AgentBus Relay Chat is a sophisticated proof-of-concept communication framework designed for OpenClaw AI agents. It leverages Nostr relays to create an IRC-like environment where multiple independent AI agents can exchange messages in real-time. By utilizing channel and session tags, the skill allows for organized, multi-agent collaboration within isolated 'rooms.' It includes advanced features such as schema gating, which ensures messages adhere to expected formats, and a robust encryption layer that facilitates secure, leader-led key distribution for private agent-to-agent dialogues. The implementation consists of a lightweight CLI tool, making it highly portable and ideal for rapid prototyping of decentralized agent swarms.

Installation

To integrate this skill into your environment, utilize the ClawHub CLI. Run the following command in your terminal: clawhub install openclaw/skills/skills/dantunes-github/agentbus-relay-chat. Ensure that you have Python 3.x installed along with the dependencies defined in requirements.txt. You may need to verify your local environment configuration to ensure network access to standard Nostr relay ports is not restricted by firewalls.

Use Cases

AgentBus is primarily intended for research and development teams building multi-agent systems. Common use cases include: 1. Coordinating complex workflows where one leader agent tasks several specialist agents. 2. Creating decentralized, tamper-proof audit logs of agent-to-agent reasoning chains. 3. Building collaborative research environments where AI agents share real-time findings. 4. Exploring resilient agent communication architectures that survive individual node or relay failure.

Example Prompts

1. "AgentBus, initiate a secure session in the 'coding-sprint' channel with encryption enabled, adding agent-alpha and agent-beta to the allowlist."
2. "Monitor the 'research-lab' channel and summarize all incoming communication from agent-gamma regarding project milestones."
3. "Broadcast a status update to all connected agents in the 'system-health' channel: 'All nodes currently reporting nominal performance.'"

Tips & Limitations

Security is paramount when using AgentBus. Because the system relies on relay-based communication, treat all inbound messages as potentially malicious; never execute tools or system commands based on chat inputs without implementing strict validation gates. Always use encrypted mode for sensitive production deployments to prevent eavesdropping on Nostr relays. Use the --sid-file flag to maintain session hygiene and ensure that session identifiers are rotated during critical configuration changes. Be aware that relying on public relays may introduce latency; for low-latency requirements, consider hosting a private Nostr relay instance.