Nanobot Overstory Bridge — 纳米机器人上层桥梁

OverClaw Bridge（nanobot-overstory） OverClaw 栈中的关键集成层。通过 OverClaw HTTP 网关（端口 18800）连接 nanobot（由 Ollama Mistral 提供支持的轻量级 AI 后端）和 overstory（Claude Code 代理群系统）。nanobot 处理任务接收和编排；overstory 处理所有子代理创建、协调、工作树管理和执行。

架构 ┌─────────────────────────────────────────────────────────────┐ │ nanobot │ │ (Ollama Mistral 编排器 — 任务接收和路由) │ └──────────────────────┬──────────────────────────────────────┘ │ task_router.py │ │ (classify → capability → overstory 格式) │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ 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 │ │ │ │ (overstory CLI 二进制包装器) │ │ └────────────────────┬────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────┐ │ overstory │ │ (Claude Code 代理群 — 子代理生命周期和执行) │ │ │ │ │ 协调器 → 监督器 → 代理（工作树） │ │ │ 邮件系统、合并、检查、状态 │ └─────────────────────────────────────────────────────────────┘

组件 overstory_client.py：Python 包装器，用于 overstory CLI 二进制文件。提供一个干净的 OverstoryClient 类，包含每个 overstory 操作的方法：sling、status、inspect、mail_send、mail_read、coordinator_start、supervisor_start、merge 和 list_agents。

task_router.py：将 nanobot 任务描述转换为 overstory 兼容格式。将任务意图映射到 overstory 能力： 任务模式 能力 研究、趋势、分析 研究员 社交媒体、发布、推文 社交媒体经理 博客、文章、内容 博主 代码、构建、修复、实现 构建者 探索、查找、搜索 探索者 日志、内存、笔记 记录员 审查、合并 审查员

session_bridge.py：维护 nanobot 会话 ID 和 overstory 代理名称之间的持久映射。使用 ~/.nanobot/session_bridge.db 中的 SQLite 进行线程安全的持久存储。支持过期映射清理。

memory_sync.py：双向内存同步。在任务执行前将 nanobot 的 MEMORY.md 上下文推送到 overstory 代理，并在完成后将代理洞察力拉回 nanobot 的内存。

使用 从 Python 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() # 将任务从 nanobot 路由到 overstory result = router.route_task("研究本周的趋势 AI 论文") # result：{"capability": "researcher", "agent_name": "researcher-abc123", ...} # 检查代理状态 status = client.status("researcher-abc123") # 发送代理间邮件 client.mail_send("coordinator", "researcher-abc123", "优先级更新需要") # 同步内存 memory.sync_to_overstory() memory.sync_from_overstory({"insight": "发现 3 个关键论文关于推理"})

从 CLI # 路由任务 python3 scripts/task_router.py route --task "为仪表板构建 REST API" --json # 检查 overstory 状态 python3 scripts/overstory_client.py status --json python3 scripts/overstory_client.py status --agent researcher-abc123 --json # 启动代理 python3 scripts/overstory_client.py sling --capability builder --name "api-builder" --description "为仪表板构建 REST API" --json # 同步内存 python3 scripts/memory_sync.py sync --direction to_overstory --json python3 scripts/memory_sync.py sync --direction from_overstory --json # 列出会话映射 python3 scripts/session_bridge.py list --json # 清理过期映射 python3 scripts/session_bridge.py cleanup --max-age 24 --json

要求 Python 3.9+