{
  "schemaVersion": "1.0",
  "item": {
    "slug": "nanobot-overstory-bridge",
    "name": "Nanobot Overstory Bridge",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/RuneweaverStudios/nanobot-overstory-bridge",
    "canonicalUrl": "https://clawhub.ai/RuneweaverStudios/nanobot-overstory-bridge",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/nanobot-overstory-bridge",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=nanobot-overstory-bridge",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "scripts/gateway_tools.py",
      "scripts/generate_agent_context.py",
      "scripts/memory_sync.py",
      "scripts/overstory_client.py"
    ],
    "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. 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. 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/nanobot-overstory-bridge"
    },
    "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/nanobot-overstory-bridge",
    "agentPageUrl": "https://openagent3.xyz/skills/nanobot-overstory-bridge/agent",
    "manifestUrl": "https://openagent3.xyz/skills/nanobot-overstory-bridge/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/nanobot-overstory-bridge/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OverClaw Bridge (nanobot-overstory)",
        "body": "The critical integration layer in the OverClaw stack. Connects nanobot (lightweight AI backend powered by Ollama Mistral) to overstory (Claude Code agent swarm system) through the OverClaw HTTP gateway on port 18800. nanobot handles task intake and orchestration; overstory handles all subagent creation, coordination, worktree management, and execution."
      },
      {
        "title": "Architecture",
        "body": "┌─────────────────────────────────────────────────────────────┐\n│                        nanobot                              │\n│  (Ollama Mistral orchestrator — task intake & routing)      │\n└──────────────────────┬──────────────────────────────────────┘\n                       │  task_router.py\n                       │  (classify → capability → overstory format)\n                       ▼\n┌─────────────────────────────────────────────────────────────┐\n│              nanobot-overstory Bridge                        │\n│                                                             │\n│  ┌──────────────┐  ┌────────────────┐  ┌────────────────┐  │\n│  │ task_router   │  │ session_bridge │  │ memory_sync    │  │\n│  │ .py           │  │ .py            │  │ .py            │  │\n│  │               │  │                │  │                │  │\n│  │ route_task()  │  │ create_mapping │  │ sync_to_over() │  │\n│  │ translate()   │  │ get_agent()    │  │ sync_from()    │  │\n│  │ capability()  │  │ cleanup()      │  │ prune()        │  │\n│  └──────┬───────┘  └───────┬────────┘  └───────┬────────┘  │\n│         │                  │                    │           │\n│         └──────────┬───────┴────────────────────┘           │\n│                    │                                        │\n│           overstory_client.py                               │\n│           (subprocess wrapper around `overstory` CLI)       │\n└────────────────────┬────────────────────────────────────────┘\n                     │\n                     ▼\n┌─────────────────────────────────────────────────────────────┐\n│                       overstory                             │\n│  (Claude Code agent swarm — subagent lifecycle & execution) │\n│                                                             │\n│  coordinator → supervisor → agents (worktrees)              │\n│  mail system, merge, inspect, status                        │\n└─────────────────────────────────────────────────────────────┘"
      },
      {
        "title": "overstory_client.py",
        "body": "Python wrapper around the overstory CLI binary. Provides a clean OverstoryClient class with methods for every overstory operation: sling, status, inspect, mail_send, mail_read, coordinator_start, supervisor_start, merge, and list_agents."
      },
      {
        "title": "task_router.py",
        "body": "Translates nanobot task descriptions into overstory-compatible formats. Maps task intent to overstory capabilities:\n\nTask PatternCapabilityResearch, trends, analysisresearcherSocial media, posting, tweetssocial-media-managerBlog, article, contentbloggerCode, build, fix, implementbuilderExplore, find, searchscoutLogs, memory, notesscribeReview, mergereviewer"
      },
      {
        "title": "session_bridge.py",
        "body": "Maintains a persistent mapping between nanobot session IDs and overstory agent names. Uses SQLite at ~/.nanobot/session_bridge.db for thread-safe, persistent storage. Supports stale mapping cleanup."
      },
      {
        "title": "memory_sync.py",
        "body": "Bidirectional memory synchronization. Pushes nanobot's MEMORY.md context to overstory agents before task execution, and pulls agent insights back into nanobot's memory after completion."
      },
      {
        "title": "From Python",
        "body": "from overstory_client import OverstoryClient\nfrom task_router import TaskRouter\nfrom session_bridge import SessionBridge\nfrom memory_sync import MemorySync\n\nclient = OverstoryClient()\nrouter = TaskRouter(client)\nbridge = SessionBridge()\nmemory = MemorySync()\n\n# Route a task from nanobot to overstory\nresult = router.route_task(\"Research trending AI papers this week\")\n# result: {\"capability\": \"researcher\", \"agent_name\": \"researcher-abc123\", ...}\n\n# Check agent status\nstatus = client.status(\"researcher-abc123\")\n\n# Send inter-agent mail\nclient.mail_send(\"coordinator\", \"researcher-abc123\", \"Priority update needed\")\n\n# Sync memory before/after\nmemory.sync_to_overstory()\nmemory.sync_from_overstory({\"insight\": \"Found 3 key papers on reasoning\"})"
      },
      {
        "title": "From CLI",
        "body": "# Route a task\npython3 scripts/task_router.py route --task \"Build a REST API for the dashboard\" --json\n\n# Check overstory status\npython3 scripts/overstory_client.py status --json\npython3 scripts/overstory_client.py status --agent researcher-abc123 --json\n\n# Spawn an agent\npython3 scripts/overstory_client.py sling \\\n  --capability builder \\\n  --name \"api-builder\" \\\n  --description \"Build REST API for dashboard\" --json\n\n# Sync memory\npython3 scripts/memory_sync.py sync --direction to_overstory --json\npython3 scripts/memory_sync.py sync --direction from_overstory --json\n\n# List session mappings\npython3 scripts/session_bridge.py list --json\n\n# Clean up stale mappings\npython3 scripts/session_bridge.py cleanup --max-age 24 --json"
      },
      {
        "title": "Requirements",
        "body": "Python 3.9+\noverstory CLI installed and on PATH (or set OVERSTORY_BIN env var)\nOverClaw gateway running on port 18800 (scripts/start-overclaw.sh)\nOllama with Mistral model\nSQLite3 (bundled with Python)"
      },
      {
        "title": "Environment Variables",
        "body": "VariableDefaultDescriptionNANOBOT_GATEWAY_URLhttp://localhost:18800OverClaw gateway URLOVERCLAW_PORT18800OverClaw gateway portOVERSTORY_BINoverstoryPath to overstory binaryNANOBOT_WORKSPACE/Users/ghost/.openclaw/workspaceWorkspace rootNANOBOT_SKILLS_DIR<workspace>/skillsSkills directoryNANOBOT_MEMORY_PATH<workspace>/MEMORY.mdPath to MEMORY.mdSESSION_BRIDGE_DB~/.nanobot/session_bridge.dbSession mapping databaseBRIDGE_LOG_LEVELINFOLogging verbosity\n\nNote for existing nanobot/OpenClaw users: OverClaw runs on port 18800, separate from the legacy OpenClaw gateway (18789) and nanobot default (18790). No conflicts."
      },
      {
        "title": "Integration Flow",
        "body": "nanobot receives task from user via TUI/API\ntask_router classifies the task and determines the overstory capability\nsession_bridge creates a mapping between nanobot session and upcoming overstory agent\nmemory_sync pushes relevant context to overstory\noverstory_client spawns the agent via overstory sling\noverstory manages the agent lifecycle (worktree, execution, mail)\nOn completion, overstory_client retrieves results via inspect/status\nmemory_sync pulls insights back into nanobot memory\nsession_bridge marks the mapping as completed\nnanobot delivers the result to the user"
      }
    ],
    "body": "OverClaw Bridge (nanobot-overstory)\n\nThe critical integration layer in the OverClaw stack. Connects nanobot (lightweight AI backend powered by Ollama Mistral) to overstory (Claude Code agent swarm system) through the OverClaw HTTP gateway on port 18800. nanobot handles task intake and orchestration; overstory handles all subagent creation, coordination, worktree management, and execution.\n\nArchitecture\n┌─────────────────────────────────────────────────────────────┐\n│                        nanobot                              │\n│  (Ollama Mistral orchestrator — task intake & routing)      │\n└──────────────────────┬──────────────────────────────────────┘\n                       │  task_router.py\n                       │  (classify → capability → overstory format)\n                       ▼\n┌─────────────────────────────────────────────────────────────┐\n│              nanobot-overstory Bridge                        │\n│                                                             │\n│  ┌──────────────┐  ┌────────────────┐  ┌────────────────┐  │\n│  │ task_router   │  │ session_bridge │  │ memory_sync    │  │\n│  │ .py           │  │ .py            │  │ .py            │  │\n│  │               │  │                │  │                │  │\n│  │ route_task()  │  │ create_mapping │  │ sync_to_over() │  │\n│  │ translate()   │  │ get_agent()    │  │ sync_from()    │  │\n│  │ capability()  │  │ cleanup()      │  │ prune()        │  │\n│  └──────┬───────┘  └───────┬────────┘  └───────┬────────┘  │\n│         │                  │                    │           │\n│         └──────────┬───────┴────────────────────┘           │\n│                    │                                        │\n│           overstory_client.py                               │\n│           (subprocess wrapper around `overstory` CLI)       │\n└────────────────────┬────────────────────────────────────────┘\n                     │\n                     ▼\n┌─────────────────────────────────────────────────────────────┐\n│                       overstory                             │\n│  (Claude Code agent swarm — subagent lifecycle & execution) │\n│                                                             │\n│  coordinator → supervisor → agents (worktrees)              │\n│  mail system, merge, inspect, status                        │\n└─────────────────────────────────────────────────────────────┘\n\nComponents\noverstory_client.py\n\nPython wrapper around the overstory CLI binary. Provides a clean OverstoryClient class with methods for every overstory operation: sling, status, inspect, mail_send, mail_read, coordinator_start, supervisor_start, merge, and list_agents.\n\ntask_router.py\n\nTranslates nanobot task descriptions into overstory-compatible formats. Maps task intent to overstory capabilities:\n\nTask Pattern\tCapability\nResearch, trends, analysis\tresearcher\nSocial media, posting, tweets\tsocial-media-manager\nBlog, article, content\tblogger\nCode, build, fix, implement\tbuilder\nExplore, find, search\tscout\nLogs, memory, notes\tscribe\nReview, merge\treviewer\nsession_bridge.py\n\nMaintains a persistent mapping between nanobot session IDs and overstory agent names. Uses SQLite at ~/.nanobot/session_bridge.db for thread-safe, persistent storage. Supports stale mapping cleanup.\n\nmemory_sync.py\n\nBidirectional memory synchronization. Pushes nanobot's MEMORY.md context to overstory agents before task execution, and pulls agent insights back into nanobot's memory after completion.\n\nUsage\nFrom Python\nfrom overstory_client import OverstoryClient\nfrom task_router import TaskRouter\nfrom session_bridge import SessionBridge\nfrom memory_sync import MemorySync\n\nclient = OverstoryClient()\nrouter = TaskRouter(client)\nbridge = SessionBridge()\nmemory = MemorySync()\n\n# Route a task from nanobot to overstory\nresult = router.route_task(\"Research trending AI papers this week\")\n# result: {\"capability\": \"researcher\", \"agent_name\": \"researcher-abc123\", ...}\n\n# Check agent status\nstatus = client.status(\"researcher-abc123\")\n\n# Send inter-agent mail\nclient.mail_send(\"coordinator\", \"researcher-abc123\", \"Priority update needed\")\n\n# Sync memory before/after\nmemory.sync_to_overstory()\nmemory.sync_from_overstory({\"insight\": \"Found 3 key papers on reasoning\"})\n\nFrom CLI\n# Route a task\npython3 scripts/task_router.py route --task \"Build a REST API for the dashboard\" --json\n\n# Check overstory status\npython3 scripts/overstory_client.py status --json\npython3 scripts/overstory_client.py status --agent researcher-abc123 --json\n\n# Spawn an agent\npython3 scripts/overstory_client.py sling \\\n  --capability builder \\\n  --name \"api-builder\" \\\n  --description \"Build REST API for dashboard\" --json\n\n# Sync memory\npython3 scripts/memory_sync.py sync --direction to_overstory --json\npython3 scripts/memory_sync.py sync --direction from_overstory --json\n\n# List session mappings\npython3 scripts/session_bridge.py list --json\n\n# Clean up stale mappings\npython3 scripts/session_bridge.py cleanup --max-age 24 --json\n\nRequirements\nPython 3.9+\noverstory CLI installed and on PATH (or set OVERSTORY_BIN env var)\nOverClaw gateway running on port 18800 (scripts/start-overclaw.sh)\nOllama with Mistral model\nSQLite3 (bundled with Python)\nEnvironment Variables\nVariable\tDefault\tDescription\nNANOBOT_GATEWAY_URL\thttp://localhost:18800\tOverClaw gateway URL\nOVERCLAW_PORT\t18800\tOverClaw gateway port\nOVERSTORY_BIN\toverstory\tPath to overstory binary\nNANOBOT_WORKSPACE\t/Users/ghost/.openclaw/workspace\tWorkspace root\nNANOBOT_SKILLS_DIR\t<workspace>/skills\tSkills directory\nNANOBOT_MEMORY_PATH\t<workspace>/MEMORY.md\tPath to MEMORY.md\nSESSION_BRIDGE_DB\t~/.nanobot/session_bridge.db\tSession mapping database\nBRIDGE_LOG_LEVEL\tINFO\tLogging verbosity\n\nNote for existing nanobot/OpenClaw users: OverClaw runs on port 18800, separate from the legacy OpenClaw gateway (18789) and nanobot default (18790). No conflicts.\n\nIntegration Flow\nnanobot receives task from user via TUI/API\ntask_router classifies the task and determines the overstory capability\nsession_bridge creates a mapping between nanobot session and upcoming overstory agent\nmemory_sync pushes relevant context to overstory\noverstory_client spawns the agent via overstory sling\noverstory manages the agent lifecycle (worktree, execution, mail)\nOn completion, overstory_client retrieves results via inspect/status\nmemory_sync pulls insights back into nanobot memory\nsession_bridge marks the mapping as completed\nnanobot delivers the result to the user"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/RuneweaverStudios/nanobot-overstory-bridge",
    "publisherUrl": "https://clawhub.ai/RuneweaverStudios/nanobot-overstory-bridge",
    "owner": "RuneweaverStudios",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/nanobot-overstory-bridge",
    "downloadUrl": "https://openagent3.xyz/downloads/nanobot-overstory-bridge",
    "agentUrl": "https://openagent3.xyz/skills/nanobot-overstory-bridge/agent",
    "manifestUrl": "https://openagent3.xyz/skills/nanobot-overstory-bridge/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/nanobot-overstory-bridge/agent.md"
  }
}