OpenOctopus:领域原生 AI 家庭助手系统,Summon 功能将实体转化为智能 Agent
项目概述
OpenOctopus 是一个开源项目,代码仓库托管在 GitHub。根据仓库文档描述,该项目定位为「AI family home hub」,核心设计理念是「One event, every member, the right context」。项目采用 MIT 许可证发布。
根据 README 文档,OpenOctopus 与传统统一聊天框的设计不同,它被描述为「群聊中的家庭成员」。系统将家庭生活组织成多个「领域」(Realm)------宠物、父母、财务、工作、健康等------每个领域拥有独立的知识库、Agent 团队和技能集。项目文档使用章鱼作为隐喻:每只触手都有自己的神经中枢并自主行动,而中央大脑协调一切。
核心特性
文档中列出了 OpenOctopus 的主要功能模块:
- Realm Matrix(领域矩阵):网格仪表板,概览所有生活领域的健康分数、风险和待办事项
- Summon(召唤):将任何实体(宠物、人物、资产)转换为具有记忆、个性和主动行为的 AI Agent
- Cross-Realm Intelligence(跨领域智能):知识图谱连接所有领域
- Dual-layer Skills(双层技能):全局技能(搜索、日历、邮件)+ 领域技能(兽医查询、税务计算、法律搜索)
- Agent Teams(Agent 团队):专业 Agent + 召唤 Agent 在每个领域内协作
- RealmHub(领域中心):一键安装预构建的领域包
- Governance(治理):人在回路审批、完整审计日志、隐私和权限层级
- Local-first(本地优先):默认使用 SQLite,可选通过 PostgreSQL/Supabase 进行云同步
领域矩阵设计
文档中定义了以下预配置领域模板,用户可以自由创建、合并或删除领域:
| 领域 | 内容类型 | 示例 Agent |
|---|---|---|
pet |
宠物、兽医、食物记录 | 健康顾问、Momo(召唤) |
parents |
父母、健康档案 | 护理助手、妈妈(召唤) |
partner |
伴侣、纪念日 | 关系顾问 |
finance |
账户、投资、债务 | 预算规划师、税务助手 |
work |
项目、同事、目标 | 任务管理器、周报记者 |
legal |
合同、案例、法规 | 合规律师、劳动法顾问 |
vehicle |
汽车、保险、维护 | 维护追踪器、成本报告 |
home |
房屋、电器、维修 | 家庭管理员 |
health |
体检、处方 | 健康监测器 |
fitness |
训练计划、身体数据 | 健身教练 |
hobby |
项目、学习材料 | 学习教练 |
friends |
社交圈、活动 | 社交雷达 |
Summon 机制
文档将 Summon 描述为「杀手级功能」,可以将数据转换为活生生的 Agent。
转换流程为:
原始数据 → 结构化实体 → SUMMON → 具有记忆、个性和主动性的 Agent
支持的实体类型包括:
- 生命体:宠物、家人、朋友 → 模拟对话、个性、情感表达
- 资产:汽车、房屋、投资组合 → 状态监控、维护提醒、成本报告
- 组织:公司、医院 → 流程指南、联系人管理
- 抽象概念:目标、项目、习惯 → 进度追踪、偏差提醒、回顾
文档中提供了一个交互示例来说明召唤 Agent 的协作方式:
用户:「我下周要旅行 5 天。」
Momo(宠物):「谁来喂我、遛我 5 天?!」
妈妈(父母):「妈妈刚说她想来------她可以照顾 Momo。」
汽车(车辆):「出发前充满电?还是打车去机场?」
预算(财务):「旅行预算估计:¥X。记得保存收据。」
→ 系统编制「旅行准备清单」供您批准。
Agent 团队架构
文档定义了三层 Agent 架构:
中央 Agent(全局层)
- Router:意图检测和领域路由
- Coordinator:跨领域分析
- Scheduler:主动触发和定时任务
领域 Agent(领域层)
- Professional:专业角色如法律顾问、预算规划师、健康监测
- Summoned ✦:被召唤的实体如 Momo、妈妈、特斯拉
RealmHub 生态
RealmHub 被描述为「应用商店,但面向生活领域」。可以安装完整的领域包,例如:
- 法律顾问团队:实体模板(律师、合同、法规)+ 3 个 Agent + 技能
- 宠物护理:宠物档案 + 健康顾问 + 兽医查询 + 疫苗追踪器
- 家庭财务:账户 + 预算规划师 + 投资分析器
每个领域包包含:领域模板、实体模板、Agent 配置、技能配置和示例数据。
技术栈
根据 Dockerfile 和 package.json,项目的技术选型如下:
| 层级 | 选型 |
|---|---|
| 运行时 | Node.js >= 22 + TypeScript |
| 网关 | 统一编排(参考 OpenClaw Gateway) |
| 客户端 | Web 仪表板(Realm Matrix)+ CLI(tentacle) |
| 数据存储 | SQLite(本地优先)+ PostgreSQL/Supabase(可选同步) |
| 向量存储 | pgvector / 本地向量存储(按领域分片) |
| 插件系统 | 全局技能 + 领域技能 + 领域包规范 |
项目使用 pnpm 作为包管理器,版本为 pnpm@10.30.2。CI/CD 通过 GitHub Actions 管理。
项目支持多种 LLM 提供商。文档特别提到了 Volcengine Ark Agent Plan 的配置方法,需要设置 ARK_API_KEY、ARK_BASE_URL 和 ARK_CHAT_MODEL 环境变量。
生态系统组件
文档中定义了项目的生态命名:
项目吉祥物
项目吉祥物是名为 Octo 的深海章鱼。文档描述其性格为「冷静、多线程、安静聪明」。八只手臂同时处理整个生活,而一个大脑保持同步。召唤实体时,触手尖端会发出青色光芒。
说明与解读
本文内容基于项目公开的 README 文档和代码仓库中的配置文件。上述所有功能描述均来自项目文档中记录的设计目标和规范。
该项目的架构设计显示出对家庭 AI 助手的创新思路:传统 AI 助手通常提供统一的对话接口,而 OpenOctopus 提出的「多领域 + 多 Agent」模式尝试提供更精细化的上下文管理和角色分工。Summon 机制是一个有趣的概念探索,尝试将现实世界的实体以 Agent 形式数字化呈现并实现多 Agent 协作。
对于研究 Agent 架构、家庭 AI 应用或多智能体系统的开发者来说,这个项目的代码和文档可以作为参考。项目是开源的,感兴趣的读者可以查看代码仓库了解具体实现。