# Send Vinculum - Shared Consciousness to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "vinculum",
    "name": "Vinculum - Shared Consciousness",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Koba42Corp/vinculum",
    "canonicalUrl": "https://clawhub.ai/Koba42Corp/vinculum",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/vinculum",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vinculum",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "config/defaults.yaml",
      "install.sh",
      "package-lock.json",
      "package.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/vinculum"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/vinculum",
    "downloadUrl": "https://openagent3.xyz/downloads/vinculum",
    "agentUrl": "https://openagent3.xyz/skills/vinculum/agent",
    "manifestUrl": "https://openagent3.xyz/skills/vinculum/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/vinculum/agent.md"
  }
}
```
## Documentation

### Vinculum: Shared Consciousness

"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.

### Features

🔗 Real-time link — Changes propagate instantly between drones
🌐 Local network — Works across machines on the same LAN
🔐 Encrypted — All shared data encrypted
🤖 Individual identity — Each drone keeps its own SOUL.md
📡 Drone discovery — Automatic multicast discovery

### Installation

After installing from ClawdHub:

cd skills/vinculum
npm install --production

Or run the install script:

./install.sh

### 1. Start the Vinculum Relay

/link relay start

This starts the relay on port 8765 with local network multicast enabled.

### 2. Initialize the Collective (First Bot)

/link init

You'll receive a pairing code. Share it with your other bot(s).

### 3. Join the Collective (Additional Bots)

/link join <pairing-code>

### 4. Verify Connection

/link status
/link drones

### Relay Management

CommandDescription/link relayShow relay status/link relay startStart Vinculum relay/link relay stopStop relay/link relay restartRestart relay/link relay peer <url>Add remote peer

### Collective Setup

CommandDescription/link initCreate new collective/link join <code>Join with invite code/link inviteGenerate new invite code/link leaveLeave collective

### Control

CommandDescription/linkQuick status/link onEnable link/link offDisable link/link statusDetailed status

### Shared Consciousness

CommandDescription/link share "text"Share a thought/memory/link dronesList connected drones/link activityRecent collective activity/link decisionsShared decisions

### Configuration

CommandDescription/link configView all settings/link config drone-name <name>Set this drone's designation/link config share-activity on/offToggle activity sharing/link config share-memory on/offToggle memory sharing

### What Gets Shared

DataSharedNotesActivity summaries✅What each drone didLearned knowledge✅Collective learningsDecisions✅Consensus achievedDrone status✅Online, current taskFull conversations❌Stays localUSER.md❌Individual identitySOUL.md❌Individual personalityCredentials❌Never linked

### Machine 1 (Runs Relay)

/link relay start
/link init

Note the pairing code and your machine's IP (shown in /link relay status).

### Machine 2+ (Connects to Relay)

/link relay peer http://<machine1-ip>:8765/gun
/link join <pairing-code>

### Configuration

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

### Architecture

┌─────────────┐     ┌─────────────┐
│   Drone A   │     │   Drone B   │
│  (Legion)   │     │  (Seven)    │
└──────┬──────┘     └──────┬──────┘
       │                   │
       │   Subspace Link   │
       ▼                   ▼
  ┌────────────────────────────┐
  │      Vinculum Relay        │
  │   (Collective Processor)   │
  └────────────────────────────┘

### Troubleshooting

"Relay not running"

Run /link relay start
Check /link relay logs for errors

"No drones connected"

Ensure all bots use the same pairing code
Check network connectivity between machines
Port 8765 must be accessible

"Link not working"

Check /link status shows Connected
Try /link relay restart

### Requirements

Node.js 18+
npm

### License

MIT — Koba42 Corp

Resistance is futile. You will be assimilated into the collective.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Koba42Corp
- Version: 1.2.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/vinculum)
- [Send to Agent page](https://openagent3.xyz/skills/vinculum/agent)
- [JSON manifest](https://openagent3.xyz/skills/vinculum/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/vinculum/agent.md)
- [Download page](https://openagent3.xyz/downloads/vinculum)