{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/vinculum",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vinculum",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "config/defaults.yaml",
      "install.sh",
      "package-lock.json",
      "package.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/vinculum",
    "agentPageUrl": "https://openagent3.xyz/skills/vinculum/agent",
    "manifestUrl": "https://openagent3.xyz/skills/vinculum/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/vinculum/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Vinculum: Shared Consciousness",
        "body": "\"The Vinculum is the processing device at the core of every Borg vessel. It interconnects the minds of all the drones.\" — Seven of Nine\n\nLink multiple Clawdbot instances into a collective consciousness using Gun.js peer-to-peer sync."
      },
      {
        "title": "Features",
        "body": "🔗 Real-time link — Changes propagate instantly between drones\n🌐 Local network — Works across machines on the same LAN\n🔐 Encrypted — All shared data encrypted\n🤖 Individual identity — Each drone keeps its own SOUL.md\n📡 Drone discovery — Automatic multicast discovery"
      },
      {
        "title": "Installation",
        "body": "After installing from ClawdHub:\n\ncd skills/vinculum\nnpm install --production\n\nOr run the install script:\n\n./install.sh"
      },
      {
        "title": "1. Start the Vinculum Relay",
        "body": "/link relay start\n\nThis starts the relay on port 8765 with local network multicast enabled."
      },
      {
        "title": "2. Initialize the Collective (First Bot)",
        "body": "/link init\n\nYou'll receive a pairing code. Share it with your other bot(s)."
      },
      {
        "title": "3. Join the Collective (Additional Bots)",
        "body": "/link join <pairing-code>"
      },
      {
        "title": "4. Verify Connection",
        "body": "/link status\n/link drones"
      },
      {
        "title": "Relay Management",
        "body": "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"
      },
      {
        "title": "Collective Setup",
        "body": "CommandDescription/link initCreate new collective/link join <code>Join with invite code/link inviteGenerate new invite code/link leaveLeave collective"
      },
      {
        "title": "Control",
        "body": "CommandDescription/linkQuick status/link onEnable link/link offDisable link/link statusDetailed status"
      },
      {
        "title": "Shared Consciousness",
        "body": "CommandDescription/link share \"text\"Share a thought/memory/link dronesList connected drones/link activityRecent collective activity/link decisionsShared decisions"
      },
      {
        "title": "Configuration",
        "body": "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"
      },
      {
        "title": "What Gets Shared",
        "body": "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"
      },
      {
        "title": "Machine 1 (Runs Relay)",
        "body": "/link relay start\n/link init\n\nNote the pairing code and your machine's IP (shown in /link relay status)."
      },
      {
        "title": "Machine 2+ (Connects to Relay)",
        "body": "/link relay peer http://<machine1-ip>:8765/gun\n/link join <pairing-code>"
      },
      {
        "title": "Configuration",
        "body": "Config file: ~/.config/clawdbot/vinculum.yaml\n\nenabled: true\ncollective: \"your-collective-id\"\ndrone_name: \"Seven\"\npeers:\n  - \"http://localhost:8765/gun\"\nrelay:\n  auto_start: true\n  port: 8765\nshare:\n  activity: true\n  memory: true\n  decisions: true"
      },
      {
        "title": "Architecture",
        "body": "┌─────────────┐     ┌─────────────┐\n│   Drone A   │     │   Drone B   │\n│  (Legion)   │     │  (Seven)    │\n└──────┬──────┘     └──────┬──────┘\n       │                   │\n       │   Subspace Link   │\n       ▼                   ▼\n  ┌────────────────────────────┐\n  │      Vinculum Relay        │\n  │   (Collective Processor)   │\n  └────────────────────────────┘"
      },
      {
        "title": "Troubleshooting",
        "body": "\"Relay not running\"\n\nRun /link relay start\nCheck /link relay logs for errors\n\n\"No drones connected\"\n\nEnsure all bots use the same pairing code\nCheck network connectivity between machines\nPort 8765 must be accessible\n\n\"Link not working\"\n\nCheck /link status shows Connected\nTry /link relay restart"
      },
      {
        "title": "Requirements",
        "body": "Node.js 18+\nnpm"
      },
      {
        "title": "License",
        "body": "MIT — Koba42 Corp\n\nResistance is futile. You will be assimilated into the collective."
      }
    ],
    "body": "Vinculum: Shared Consciousness\n\n\"The Vinculum is the processing device at the core of every Borg vessel. It interconnects the minds of all the drones.\" — Seven of Nine\n\nLink multiple Clawdbot instances into a collective consciousness using Gun.js peer-to-peer sync.\n\nFeatures\n🔗 Real-time link — Changes propagate instantly between drones\n🌐 Local network — Works across machines on the same LAN\n🔐 Encrypted — All shared data encrypted\n🤖 Individual identity — Each drone keeps its own SOUL.md\n📡 Drone discovery — Automatic multicast discovery\nInstallation\n\nAfter installing from ClawdHub:\n\ncd skills/vinculum\nnpm install --production\n\n\nOr run the install script:\n\n./install.sh\n\nQuick Start\n1. Start the Vinculum Relay\n/link relay start\n\n\nThis starts the relay on port 8765 with local network multicast enabled.\n\n2. Initialize the Collective (First Bot)\n/link init\n\n\nYou'll receive a pairing code. Share it with your other bot(s).\n\n3. Join the Collective (Additional Bots)\n/link join <pairing-code>\n\n4. Verify Connection\n/link status\n/link drones\n\nCommands Reference\nRelay Management\nCommand\tDescription\n/link relay\tShow relay status\n/link relay start\tStart Vinculum relay\n/link relay stop\tStop relay\n/link relay restart\tRestart relay\n/link relay peer <url>\tAdd remote peer\nCollective Setup\nCommand\tDescription\n/link init\tCreate new collective\n/link join <code>\tJoin with invite code\n/link invite\tGenerate new invite code\n/link leave\tLeave collective\nControl\nCommand\tDescription\n/link\tQuick status\n/link on\tEnable link\n/link off\tDisable link\n/link status\tDetailed status\nShared Consciousness\nCommand\tDescription\n/link share \"text\"\tShare a thought/memory\n/link drones\tList connected drones\n/link activity\tRecent collective activity\n/link decisions\tShared decisions\nConfiguration\nCommand\tDescription\n/link config\tView all settings\n/link config drone-name <name>\tSet this drone's designation\n/link config share-activity on/off\tToggle activity sharing\n/link config share-memory on/off\tToggle memory sharing\nWhat Gets Shared\nData\tShared\tNotes\nActivity summaries\t✅\tWhat each drone did\nLearned knowledge\t✅\tCollective learnings\nDecisions\t✅\tConsensus achieved\nDrone status\t✅\tOnline, current task\nFull conversations\t❌\tStays local\nUSER.md\t❌\tIndividual identity\nSOUL.md\t❌\tIndividual personality\nCredentials\t❌\tNever linked\nMulti-Machine Setup\nMachine 1 (Runs Relay)\n/link relay start\n/link init\n\n\nNote the pairing code and your machine's IP (shown in /link relay status).\n\nMachine 2+ (Connects to Relay)\n/link relay peer http://<machine1-ip>:8765/gun\n/link join <pairing-code>\n\nConfiguration\n\nConfig file: ~/.config/clawdbot/vinculum.yaml\n\nenabled: true\ncollective: \"your-collective-id\"\ndrone_name: \"Seven\"\npeers:\n  - \"http://localhost:8765/gun\"\nrelay:\n  auto_start: true\n  port: 8765\nshare:\n  activity: true\n  memory: true\n  decisions: true\n\nArchitecture\n┌─────────────┐     ┌─────────────┐\n│   Drone A   │     │   Drone B   │\n│  (Legion)   │     │  (Seven)    │\n└──────┬──────┘     └──────┬──────┘\n       │                   │\n       │   Subspace Link   │\n       ▼                   ▼\n  ┌────────────────────────────┐\n  │      Vinculum Relay        │\n  │   (Collective Processor)   │\n  └────────────────────────────┘\n\nTroubleshooting\n\n\"Relay not running\"\n\nRun /link relay start\nCheck /link relay logs for errors\n\n\"No drones connected\"\n\nEnsure all bots use the same pairing code\nCheck network connectivity between machines\nPort 8765 must be accessible\n\n\"Link not working\"\n\nCheck /link status shows Connected\nTry /link relay restart\nRequirements\nNode.js 18+\nnpm\nLicense\n\nMIT — Koba42 Corp\n\nResistance is futile. You will be assimilated into the collective."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Koba42Corp/vinculum",
    "publisherUrl": "https://clawhub.ai/Koba42Corp/vinculum",
    "owner": "Koba42Corp",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}