synapse-brain（突触脑）

Synapse Brain Skill

Synapse Brain = 持久调度 + 跨会话状态 + 子代理编排

核心理念：AI Agent 应该是持久的"大脑"，而非每次从零开始的无状态会话。

| | 传统 Agent | Synapse Brain | |--|------------|---------------| | 会话 | 每次从零开始 | 状态持久化，醒来即恢复 | | 调度 | 手动调用子代理 | 自动路由、分配、追踪 | | 记忆 | 随会话消失 | state.json 持久化 | | 协作 | 独立工作 | 调度 code/wiki 等 Skills |

🚦 快速决策：我该用什么？

你想做什么？
│
├─ 启动/恢复项目任务     → init（初始化 session）
│   └─ 例："继续做用户系统"、"开始新项目 X"
│
├─ 分配子任务给子代理    → dispatch（调度执行）
│   └─ 例："并行开发登录和注册"、"让 dev 实现导出"
│
├─ 查询任务状态           → status（状态查询）
│   └─ 例："现在进度如何？"、"昨天那个任务完成了没"
│
└─ 保存/恢复会话          → save/restore（状态管理）
    └─ 例："保存当前进度"、"恢复上次会话"

📋 命令速查卡片

Brain Agent 架构

用户请求
    ↓
┌─────────────────────────────┐
│  Synapse Brain (持久调度)     │
│                             │
│  1. Session Restore          │ ← state.json 恢复上下文
│  2. Intent Classification    │ ← 识别意图类型
│  3. Task Routing             │ ← 路由到合适 Skill/Agent
│  4. Subagent Dispatch        │ ← 调用 OpenClaw 子代理
│  5. Result Aggregation       │ ← 汇总结果
│  6. State Persist            │ ← 保存状态到 state.json
└─────────────┬───────────────┘
              ↓
    ┌─────────┼─────────┐
    ↓         ↓         ↓
synapse-  synapse-  专业子代理
  code      wiki    (dev/qa/arch)

Session 持久化

Brain 通过 state.json 维护跨会话状态：

{
  "session_id": "sess_20260410_001",
  "project": "my-project",
  "created_at": "2026-04-10T12:00:00Z",
  "updated_at": "2026-04-10T14:30:00Z",
  "tasks": [
    {
      "id": "task-001",
      "title": "用户登录功能",
      "status": "completed",
      "skill": "synapse-code",
      "mode": "lite",
      "agents_used": ["req-analyst", "developer", "qa-engineer"]
    },
    {
      "id": "task-002",
      "title": "用户注册功能",
      "status": "in_progress",
      "skill": "synapse-code",
      "mode": "lite",
      "stage": "DEV"
    }
  ],
  "subagents": {
    "active": 1,
    "completed": 3,
    "failed": 0
  },
  "knowledge": {
    "wiki_initialized": true,
    "wiki_root": "~/my-project/wiki",
    "last_ingest": "2026-04-10T13:00:00Z"
  }
}

子代理调度策略

Brain 根据任务特征自动选择调度策略：

与 synapse-code 互操作

# Brain 调度 code 执行开发任务
/synapse-brain dispatch "实现用户登录" --skill synapse-code --mode lite

# 等价于
/synapse-code run my-project "实现用户登录" --mode lite

Brain 会：

1. 自动记录任务到 session state
2. 调用 synapse-code 执行
3. 接收结果并更新任务状态
4. 触发 wiki 知识沉淀

与 synapse-wiki 互操作

# Brain 查询已有知识
/synapse-brain query "RAG 是什么？" --skill synapse-wiki

# Brain 保存新资料
/synapse-brain ingest ~/raw/article.md --skill synapse-wiki

Brain 会：

1. 检查 wiki 是否初始化
2. 调用 synapse-wiki 对应命令
3. 更新知识索引到 session state

Scripts

安装

# 方式 1: 从源码安装（推荐）
git clone https://github.com/ankechenlab-node/synapse-brain.git
cd synapse-brain
./install.sh

# 方式 2: OpenClaw (从 ClawHub)
npx clawhub install synapse-brain

# 方式 3: 手动复制
cp -r synapse-brain ~/.openclaw/skills/

配置

Brain 需要与 synapse-code 和 synapse-wiki 配合使用：

{
  "brain": {
    "state_dir": "~/.openclaw/brain-state",
    "auto_save": true,
    "auto_save_interval": 300,
    "skills": {
      "code": "synapse-code",
      "wiki": "synapse-wiki"
    }
  }
}

使用场景

• 🧠 长期项目管理 — 跨多个 Session 追踪进度
• 🔄 复杂任务编排 — 自动调度多个子代理协作
• 📊 状态可视化 — 随时查询项目进展
• 🤝 Skill 互操作 — code 和 wiki 的统一入口
• 💾 会话持久化 — 每次醒来即恢复上下文