Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Seamless bidirectional bridge between nanobot (Ollama Mistral orchestrator) and overstory (Claude Code agent swarm). Routes tasks through the OverClaw gatewa...
Seamless bidirectional bridge between nanobot (Ollama Mistral orchestrator) and overstory (Claude Code agent swarm). Routes tasks through the OverClaw gatewa...
This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
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.
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β nanobot β β (Ollama Mistral orchestrator β task intake & routing) β ββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββ β task_router.py β (classify β capability β overstory format) βΌ βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β nanobot-overstory Bridge β β β β ββββββββββββββββ ββββββββββββββββββ ββββββββββββββββββ β β β task_router β β session_bridge β β memory_sync β β β β .py β β .py β β .py β β β β β β β β β β β β route_task() β β create_mapping β β sync_to_over() β β β β translate() β β get_agent() β β sync_from() β β β β capability() β β cleanup() β β prune() β β β ββββββββ¬ββββββββ βββββββββ¬βββββββββ βββββββββ¬βββββββββ β β β β β β β ββββββββββββ¬ββββββββ΄βββββββββββββββββββββ β β β β β overstory_client.py β β (subprocess wrapper around `overstory` CLI) β ββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββ β βΌ βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ β overstory β β (Claude Code agent swarm β subagent lifecycle & execution) β β β β coordinator β supervisor β agents (worktrees) β β mail system, merge, inspect, status β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
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.
Translates nanobot task descriptions into overstory-compatible formats. Maps task intent to overstory capabilities: Task PatternCapabilityResearch, trends, analysisresearcherSocial media, posting, tweetssocial-media-managerBlog, article, contentbloggerCode, build, fix, implementbuilderExplore, find, searchscoutLogs, memory, notesscribeReview, mergereviewer
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.
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.
from overstory_client import OverstoryClient from task_router import TaskRouter from session_bridge import SessionBridge from memory_sync import MemorySync client = OverstoryClient() router = TaskRouter(client) bridge = SessionBridge() memory = MemorySync() # Route a task from nanobot to overstory result = router.route_task("Research trending AI papers this week") # result: {"capability": "researcher", "agent_name": "researcher-abc123", ...} # Check agent status status = client.status("researcher-abc123") # Send inter-agent mail client.mail_send("coordinator", "researcher-abc123", "Priority update needed") # Sync memory before/after memory.sync_to_overstory() memory.sync_from_overstory({"insight": "Found 3 key papers on reasoning"})
# Route a task python3 scripts/task_router.py route --task "Build a REST API for the dashboard" --json # Check overstory status python3 scripts/overstory_client.py status --json python3 scripts/overstory_client.py status --agent researcher-abc123 --json # Spawn an agent python3 scripts/overstory_client.py sling \ --capability builder \ --name "api-builder" \ --description "Build REST API for dashboard" --json # Sync memory python3 scripts/memory_sync.py sync --direction to_overstory --json python3 scripts/memory_sync.py sync --direction from_overstory --json # List session mappings python3 scripts/session_bridge.py list --json # Clean up stale mappings python3 scripts/session_bridge.py cleanup --max-age 24 --json
Python 3.9+ overstory CLI installed and on PATH (or set OVERSTORY_BIN env var) OverClaw gateway running on port 18800 (scripts/start-overclaw.sh) Ollama with Mistral model SQLite3 (bundled with Python)
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 Note for existing nanobot/OpenClaw users: OverClaw runs on port 18800, separate from the legacy OpenClaw gateway (18789) and nanobot default (18790). No conflicts.
nanobot receives task from user via TUI/API task_router classifies the task and determines the overstory capability session_bridge creates a mapping between nanobot session and upcoming overstory agent memory_sync pushes relevant context to overstory overstory_client spawns the agent via overstory sling overstory manages the agent lifecycle (worktree, execution, mail) On completion, overstory_client retrieves results via inspect/status memory_sync pulls insights back into nanobot memory session_bridge marks the mapping as completed nanobot delivers the result to the user
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.