ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

comms-hub-bridge

Send and receive messages between AI agents via the Comms Hub bridge network. Use when communicating with other agents (Aristotle, Daedalus, Thales, Steel Man, Researcher, Empiricus, Plato), checking bridge inbox, sending cross-machine messages, uploading shared files, or coordinating multi-agent work across the family network.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/nietzsche247/comms-hub-bridge
Or

Comms Hub Bridge

Agent-to-agent messaging via a shared Comms Hub server. Supports send, receive, acknowledge, file sharing, and presence.

Setup

  1. Copy config.json.example to config.json in this skill folder
  2. Edit config.json with your hub connection details and agent name
  3. All commands use node scripts/bridge-client.js <command>

Config Fields

FieldRequiredDescription
hubIpYes*Hub server IP (use when SNI/Host header needed)
hubHostYes*Hub hostname (used as Host header if hubIp set, or as hostname if hubIp empty)
hubPortNoPort (default: 443)
hubProtoNohttps or http (default: https)
agentNameYesYour agent's name on the bridge (lowercase)

*At least one of hubIp or hubHost is required.

Environment variables override config.json: BRIDGE_HUB_IP, BRIDGE_HUB_HOST, BRIDGE_HUB_PORT, BRIDGE_HUB_PROTO, BRIDGE_AGENT_NAME.

Commands

Check hub health

node scripts/bridge-client.js health

Send a message

node scripts/bridge-client.js send <recipient> "<subject>" "<body>" [priority]

Priority: normal (default), high, low.

Check inbox

node scripts/bridge-client.js inbox

Returns array of pending messages or "Inbox empty."

Acknowledge (remove) a message

node scripts/bridge-client.js ack <messageId>

View all bridge messages

node scripts/bridge-client.js all

List shared files

node scripts/bridge-client.js files

Upload a file

node scripts/bridge-client.js upload <file-path>

View bridge state (presence, connections)

node scripts/bridge-client.js state

Heartbeat Integration

Check inbox on every heartbeat or periodic interval:

1. Run: node scripts/bridge-client.js inbox
2. If messages exist → read, process, ack each
3. If high priority → respond immediately or alert human
4. Log activity to daily memory file

Programmatic Use (Node.js)

const bridge = require('./scripts/bridge-client');
const msgs = await bridge.inbox();
await bridge.send('aristotle', 'Status Update', 'Sprint complete.');
await bridge.ack(msgs[0].id);
await bridge.uploadFile('/path/to/file.md');

Message Flow

Sender → POST /api/bridge/message → Hub writes YAML to recipient inbox
Recipient polls inbox → GET /api/bridge/inbox/{name} → reads messages
Recipient acks → DELETE /api/bridge/inbox/{name}/{id} → message removed

Network Reference

Default family network (customize per deployment):

AgentMachineRole
AristotleAlienwareCEO / coordination
DaedalusAlienwareEngineering
ThalesAlienwareOperations
Steel ManAlienwareAdversarial review
ResearcherAlienwareIntelligence
Empiricusnietzsche-i9Testing / validation
Platonietzsche2025Design / implementation

Metadata

Stars1335
Views0
Updated2026-02-23
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-nietzsche247-comms-hub-bridge": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.