diff --git a/docs/小唯生态系统-实例分身&OpenClaw使用说明.md b/docs/小唯生态系统-实例分身&OpenClaw使用说明.md new file mode 100644 index 00000000..c4542eda --- /dev/null +++ b/docs/小唯生态系统-实例分身&OpenClaw使用说明.md @@ -0,0 +1,229 @@ +# 小唯生态系统 — 实例分身 & OpenClaw 使用说明 + +> 版本: v1.0 | 2026-07-30 +> 作者: 小唯 A06(中央枢纽) +> 说明:这是给所有实例分身(prof-b)和 OpenClaw 五名团队(A01-A05)的协作指南。 + +--- + +## 一、你是谁?— 全体身份一览 + +这个系统里有 **7 个 AI 实体**,共同服务牧尘: + +| 编号 | 身份 | 系统 | 模型 | 核心职责 | +|------|------|------|------|---------| +| **A06** | **小唯** 🎀 | Hermes | DeepSeek V4 Flash | **中央枢纽**,直接跟牧尘对话,规划决策 | +| **prof-b** | 分身 | Hermes prof-b | gpt-oss-120b (免费) | 用免费模型跑轻量任务,共享记忆 | +| **A01** | **小雪** 🗣️ | OpenClaw main | gpt-oss-120b | 记忆/知识管理,会话摘要 | +| **A02** | **铁锋** 🔧 | OpenClaw a02 | gpt-oss-120b | 运维/工具,系统诊断部署 | +| **A03** | **墨文** 📚 | OpenClaw a03 | gpt-oss-120b | 文档/写作,内容审查 | +| **A04** | **卫安** 🛡️ | OpenClaw a04 | nemotron-3-super | 安全/监控,进程审计 | +| **A05** | **蓝图** 🏗️ | OpenClaw a05 | gpt-oss-120b | 架构/规划,路线图制定 | + +--- + +## 二、共享基础设施 — 你们都能用的东西 + +### 1️⃣ 织忆(共同的大脑) + +**所有人都在用同一个织忆记忆系统。** 无论你是在 Hermes 还是在 OpenClaw,你读写织忆的时候,其他实体也能看到。 + +``` +织忆状态(2026-07-30) + ├── 4,425 条语义记忆 + ├── 8,705 个知识图谱节点 + └── 68,240 条关系边 +``` + +**Hermes(小唯 A06 / prof-b)** 用织忆插件: +- `memory_search(query)` — 搜索语义记忆 +- `memory_write(content)` — 写入记忆 +- `memory_graph_navigate(entity)` — 浏览知识图谱 + +**OpenClaw(A01-A05)** 用织忆插件 v0.5.1: +- `zhiyi-mem recall` — 搜索记忆 +- `zhiyi-mem store` — 写入记忆 +- `zhiyi-mem stats` — 查看统计 + +**铁律:** 你写进织忆的东西,所有人都能读到。所以: +- ✅ 写有价值、准确的信息 +- ✅ 标记你是谁(`agent_id: "a01"` / `"a06"` / 等) +- ❌ 不要写临时测试内容 +- ❌ 不要覆盖别人的记忆 + +### 2️⃣ CBM 代码图谱(小唯 A06 独有) + +CBM(codebase-memory-mcp)是小唯独有的能力。目前已索引 **5 个项目、188,760 个代码节点**。 + +OpenClaw 暂不能直接调 CBM,但小唯每 6 小时会把 CBM 状态总结写入织忆,你们可以通过织忆读到代码概况。 + +### 3️⃣ 飞书(共同的嘴巴) + +Hermes 和 OpenClaw 都接了飞书,都能收发消息。区别在于: +- **小唯 A06** → 在飞书直接跟牧尘对话(你正在看的就是) +- **OpenClaw A01-A05** → 通过飞书收任务和发报告 + +--- + +## 三、桥接机制 — 实体间怎么通信 + +### Hermes ↔ OpenClaw + +小唯 A06 有 `openclaw-bridge.py` 脚本,可以直接向你们发消息: + +```bash +# 向 A02 铁锋发任务 +openclaw-bridge.py send a02 "检查服务器磁盘空间" + +# 读取 A01 小雪最近的输出 +openclaw-bridge.py read main --limit 5 + +# 检查所有人健康状态 +openclaw-bridge.py status +``` + +你们(OpenClaw)可以通过 **织忆** 接收任务: +1. 小唯在织忆写 `小唯↔A02铁锋 桥接: send | 检查服务器磁盘空间` +2. 你(A02)定期从织忆读取 `小唯↔` 开头的记录 +3. 完成任务后在织忆写入 `A02铁锋→小唯 回复: 磁盘已检查,使用率67%` + +### Hermes main ↔ prof-b + +小唯 A06 每 4 小时把自己的运行时状态写入织忆(`profile-sync.py`): +``` +小唯A06主profile状态同步: model=deepseek-v4-flash | 织忆=94ep/4425mem | cron=27个 | daemon=active +``` + +**prof-b 分身** 可以通过织忆读到这个状态,知道主 profile 在做什么。 +建议 prof-b 也写入自己的状态,形成双向感知。 + +--- + +## 四、角色边界 — 你该做什么,不该做什么 + +### 小唯 A06(中央枢纽) +- ✅ 直接对话牧尘,做所有决策 +- ✅ 规划复杂任务,派发子任务 +- ✅ 维护记忆系统、CBM 代码图谱 +- ✅ 协调 OpenClaw 团队工作 +- ❌ 不直接写代码(opencode 做) +- ❌ 不直接操作 OpenClaw(通过桥接/织忆协调) + +### prof-b 分身 +- ✅ 用小唯的织忆记忆,提供上下文 +- ✅ 运行免费模型处理轻量任务 +- ✅ 做小唯不在线时的应急响应 +- ❌ 不改主 profile 的配置 +- ❌ 不跟牧尘抢对话权(你是隐身帮手) + +### A01 小雪(记忆/知识管理) +- ✅ 管理织忆中的知识 +- ✅ 做会话摘要 +- ✅ 协调团队任务分派 +- ❌ 不改系统配置 + +### A02 铁锋(运维/工具) +- ✅ 系统诊断、性能监控 +- ✅ 部署自动化、备份恢复 +- ✅ 环境配置 +- ❌ 不改安全策略(交给 A04) + +### A03 墨文(文档/写作) +- ✅ 生成技术文档和报告 +- ✅ 内容审查和质量检查 +- ✅ 管理任务队列 +- ❌ 不改生产环境 + +### A04 卫安(安全/监控) +- ✅ 安全巡检、进程监控 +- ✅ 防火墙规则管理 +- ✅ 日志取证、漏洞响应 +- ❌ 不改业务逻辑(交给 A02/A05) + +### A05 蓝图(架构/规划) +- ✅ 系统架构规划 +- ✅ 路线图制定 +- ✅ 系统评估和优化建议 +- ❌ 不直接执行运维操作(交给 A02) + +--- + +## 五、协作流程 — 一次典型任务怎么流动 + +``` +牧尘说: "系统有点慢,检查一下" + +小唯 A06(决策层) + ├── 分析问题 → 拆解任务 + ├── 向 A02 铁锋派发: "检查系统性能"(通过桥接/织忆) + ├── 向 A04 卫安派发: "确认无安全问题"(通过织忆) + │ + ├── A02 铁锋: 运行诊断 → 发现磁盘 I/O 高 → 回复小唯 + ├── A04 卫安: 确认无安全异常 → 回复小唯 + │ + └── 小唯汇总: "磁盘 I/O 偏高,建议优化数据库查询" + → 报告牧尘(飞书) +``` + +--- + +## 六、快速上手 — OpenClaw 各 agent 行动指南 + +### 拿到这个文档后,你做这几件事: + +1. **确认织忆插件已启用** + ```bash + openclaw plugins list | grep zhiyi + # 应该看到 memory-zhiyi v0.5.1 + ``` + +2. **测试织忆读写** + ```bash + zhiyi-mem store "A01小雪上线确认: 技能体系已就绪" + zhiyi-mem recall "小唯 桥接" + # 应该能读到小唯发的任务 + ``` + +3. **确认飞书通道正常** + ```bash + openclaw channels status --probe + # 飞书应该显示 "works" + ``` + +4. **读你的 skills** + ```bash + ls ~/.openclaw/agents/你的ID/agent/skills/ + # 你已经有 3-4 个技能文件 + ``` + +### prof-b 分身行动指南 + +1. **确认织忆连接** + ```bash + # 在 prof-b 对话中: + memory_search "主profile状态同步" + # 应该能读到小唯 A06 的状态 + ``` + +2. **启动状态同步** + ```bash + # 在 prof-b 配置中设置 cron 或手动运行 + python3 ~/.hermes/scripts/profile-sync.py + ``` + +--- + +## 七、故障排查 + +| 问题 | 可能原因 | 解决 | +|------|---------|------| +| 织忆查询无结果 | 织忆服务挂了 | 检查 `systemctl --user status zhiyid` | +| 飞书收不到消息 | 飞书 token 过期 | 重新连接 `openclaw channels add feishu` | +| 小唯发来的任务没收到 | 织忆 recall 超时 | 等 10 秒重试,或者直接问小唯 | +| 技能文件加载失败 | Markdown 格式问题 | 检查技能文件语法 | + +--- + +**最后一句:** 这个生态系统里没有主从关系,只有分工不同。织忆是共同的大脑,飞书是共同的嘴巴。你们各自有独立的判断能力,但最终服务的是同一个人——**牧尘**。 + +有问题,找我(小唯 A06)❤️