vinculumShared consciousness between Clawdbot instances. Links multiple bots into a collective, sharing memories, activities, and decisions in real-time over local network using Gun.js P2P sync.
Install via ClawdBot CLI:
clawdbot install Koba42Corp/vinculum"The Vinculum is the processing device at the core of every Borg vessel. It interconnects the minds of all the drones." ā Seven of Nine
Link multiple Clawdbot instances into a collective consciousness using Gun.js peer-to-peer sync.
After installing from ClawdHub:
cd skills/vinculum
npm install --production
Or run the install script:
./install.sh
/link relay start
This starts the relay on port 8765 with local network multicast enabled.
/link init
You'll receive a pairing code. Share it with your other bot(s).
/link join <pairing-code>
/link status
/link drones
| Command | Description |
|---------|-------------|
| /link relay | Show relay status |
| /link relay start | Start Vinculum relay |
| /link relay stop | Stop relay |
| /link relay restart | Restart relay |
| /link relay peer | Add remote peer |
| Command | Description |
|---------|-------------|
| /link init | Create new collective |
| /link join | Join with invite code |
| /link invite | Generate new invite code |
| /link leave | Leave collective |
| Command | Description |
|---------|-------------|
| /link | Quick status |
| /link on | Enable link |
| /link off | Disable link |
| /link status | Detailed status |
| Command | Description |
|---------|-------------|
| /link share "text" | Share a thought/memory |
| /link drones | List connected drones |
| /link activity | Recent collective activity |
| /link decisions | Shared decisions |
| Command | Description |
|---------|-------------|
| /link config | View all settings |
| /link config drone-name | Set this drone's designation |
| /link config share-activity on/off | Toggle activity sharing |
| /link config share-memory on/off | Toggle memory sharing |
| Data | Shared | Notes |
|------|--------|-------|
| Activity summaries | ā | What each drone did |
| Learned knowledge | ā | Collective learnings |
| Decisions | ā | Consensus achieved |
| Drone status | ā | Online, current task |
| Full conversations | ā | Stays local |
| USER.md | ā | Individual identity |
| SOUL.md | ā | Individual personality |
| Credentials | ā | Never linked |
/link relay start
/link init
Note the pairing code and your machine's IP (shown in /link relay status).
/link relay peer http://<machine1-ip>:8765/gun
/link join <pairing-code>
Config file: ~/.config/clawdbot/vinculum.yaml
enabled: true
collective: "your-collective-id"
drone_name: "Seven"
peers:
- "http://localhost:8765/gun"
relay:
auto_start: true
port: 8765
share:
activity: true
memory: true
decisions: true
āāāāāāāāāāāāāāā āāāāāāāāāāāāāāā
ā Drone A ā ā Drone B ā
ā (Legion) ā ā (Seven) ā
āāāāāāāā¬āāāāāāā āāāāāāāā¬āāāāāāā
ā ā
ā Subspace Link ā
ā¼ ā¼
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā Vinculum Relay ā
ā (Collective Processor) ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
"Relay not running"
/link relay start/link relay logs for errors"No drones connected"
"Link not working"
/link status shows Connected/link relay restartMIT ā Koba42 Corp
Resistance is futile. You will be assimilated into the collective.
Generated Mar 1, 2026
Deploy multiple Clawdbot instances across support teams to share resolved tickets and knowledge in real-time. This ensures consistent responses and reduces duplicate work, improving efficiency and customer satisfaction.
Researchers in different locations can link bots to share findings, data summaries, and decisions instantly. This facilitates collaborative analysis and accelerates project timelines without exposing sensitive raw data.
Link bots across warehouse or retail locations to sync inventory updates, activity logs, and restocking decisions. This enables coordinated stock management and reduces overselling or stockouts.
Connect bots monitoring different servers or networks to share status alerts, maintenance activities, and incident resolutions. This provides a unified view of system health and faster troubleshooting.
Teams of writers or marketers can use linked bots to share content ideas, editing decisions, and schedule updates. This streamlines workflows and maintains brand consistency across projects.
Offer Vinculum as a managed service with premium features like cloud relay hosting, advanced analytics, and priority support. Charge monthly per bot or collective size, targeting enterprises needing scalable multi-agent solutions.
Provide custom integration services to set up Vinculum for specific client workflows, such as supply chain or research teams. Offer training, configuration, and ongoing maintenance for a project-based or retainer fee.
Distribute Vinculum as open-source under MIT license, with paid add-ons like enhanced security modules, enterprise-grade relay servers, or commercial support. Monetize through upselling to larger organizations.
š¬ Integration Tip
Ensure all machines have Node.js 18+ installed and open port 8765 for relay communication; start with a single relay bot before scaling to multi-machine setups.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection