soul-in-sapphire

💠 智能记忆与情绪状态管理系统

OpenClaw 官方长期记忆技能,基于 Notion 实现跨会话持久化存储与情绪状态追踪,为 AI 提供情境感知与连续性决策能力。

收藏
3.4k
安装
725
版本
v1.0.7
CLS 安全性认证2026-05-17
点击查看完整报告 >

使用说明

soul-in-sapphire 是 OpenClaw 框架下的核心长期记忆(LTM)管理技能,通过与 Notion 深度集成,为 AI Agent 提供跨越会话的持久化记忆能力。该技能不仅提供基础的数据存储功能,更构建了完整的情感-认知追踪体系,使 AI 能够记录、回忆并基于历史情境做出适应性决策。

核心用法方面,该技能通过五个结构化的 Notion 数据库实现功能分层:<base>-mem 存储高价值长期记忆(决策、偏好、事实等),<base>-events 记录关键触发事件,<base>-emotions 追踪多维度情绪状态(唤醒度、愉悦度、压力等),<base>-state 保存解释后的认知状态快照,<base>-journal 则维护每日综合反思。用户可通过 CLI 命令完成初始化设置、记忆写入与检索、情绪状态标记以及日志记录。此外,技能支持通过 subagent-spawn-command-builder 进行模型控制的子代理生成计划,实现复杂工作流的自动化编排。

显著优点体现在其高度结构化的数据模型与 Notion 生态的无缝融合。相较于简单的日志存储,该技能采用"记录-回忆-适应"的认知闭环设计,强调高信号价值数据的捕获而非全量归档。情绪追踪维度涵盖生理信号(紧张、疲惫等)、心理需求(安全、自主、成长等)及应对策略,为 AI 行为调整提供细腻的上下文依据。基于 Notion 的存储方案既保证了数据的云端可访问性,又利用 Notion 的原生界面支持人工审阅与干预。

潜在缺点与局限性主要包括对外部服务的强依赖性。由于核心数据存储于 Notion,该技能无法离线运行,且受限于 Notion API 的速率限制与服务可用性。部署门槛相对较高,需要用户预先配置 Node.js 环境、获取 Notion API 密钥,并正确设置五个数据库的 Schema。此外,通过 execFileSync 调用依赖 skill 的架构设计意味着功能完整性受限于 notion-api-automation 技能的可用性。

适合的目标群体主要为使用 OpenClaw 框架构建长期运行 AI 工作流的开发者,以及希望实现"数字孪生"式自我追踪的量化自我(Quantified Self)实践者。对于需要跨会话保持上下文、进行情感计算或构建具有成长记忆能力的 AI 系统的场景尤为适用。

使用风险需关注 API 密钥的安全管理(NOTION_API_KEY 需妥善存储),以及敏感数据托管于第三方平台(Notion)的隐私考量。虽然代码本身无恶意行为,但用户应意识到情绪与状态数据将存储于云端 Notion 工作区,不适合处理极高敏感度的个人信息。网络连接中断将直接导致记忆功能失效,建议关键数据定期进行本地备份。

安全解读

概述

soul-in-sapphire 是一个专为 OpenClaw 框架设计的长期记忆(LTM)管理 skill,以 Notion 为后端存储,构建了一套完整的情感计算与记忆演化系统。其核心设计理念超越了简单的数据归档,强调"记录→回忆→适应"的认知闭环。

核心功能

1. 五维记忆架构

系统通过五个互相关联的 Notion 数据库构建记忆拓扑:

  • `<base>-mem`: 高信号长期记忆(决策、偏好、事实、流程等)
  • `<base>-events`: 事件触发器记录,关联重要性与不确定性指标
  • `<base>-emotions`: 多轴情绪模型(唤醒度、效价、专注度、压力、好奇心等12维度)
  • `<base>-state`: 解释后的状态快照,包含意图标签与需求层次
  • `<base>-journal`: 日常综合反思,整合工作日志与世界上下文

2. 情感-状态计算

emostate_tick.js 实现了事件驱动的情感状态更新,支持:

  • 情绪轴量化(0-10级)
  • 身体信号标记(紧张/放松/疲劳等)
  • 需求层次识别(安全→稳定→归属→尊重→成长)
  • 应对策略选择(记录/询问/暂停/行动/延迟)

3. 子代理规划集成

通过 subagent-spawn-command-builder skill 实现模型控制的子代理生成,支持心跳监控与日记合成任务。

显著优点

  • 认知架构完整性: 罕见地将情感计算、事件追踪、状态推理整合于单一系统
  • 零第三方依赖: 纯 Node.js 内置模块实现,供应链攻击面极小
  • Notion 生态深度整合: 利用数据库关联、富文本、多选标签等原生能力
  • 高信号设计哲学: 明确反对日志倾倒,强调有意义的状态捕获
  • 配置隔离: 用户级配置目录 ~/.config/soul-in-sapphire/,遵循 XDG 规范

潜在局限

  • Notion 供应商锁定: 完全依赖 Notion API,迁移成本较高
  • 网络依赖: 所有操作需实时 API 连接,无离线缓存机制
  • 查询能力受限: Notion 搜索 API 的语义理解能力有限
  • 子进程架构: 通过 execFileSync 调用 notionctl,引入进程间通信开销与潜在竞态
  • 社区维护: 维护者为 nextaltair,属个人开源项目,长期支持存疑

适合人群

  • 构建具身 AI 或数字孪生系统的开发者
  • 需要情感记忆追踪的对话式 AI 项目
  • OpenClaw 框架用户寻求 LTM 解决方案
  • 愿意以 Notion 作为记忆基础设施的研究者

安全风险

| 等级 | 项目 | 说明 |
|------|------|------|
| 中 | 子进程调用 | `execFileSync` 调用外部脚本,需验证 `NOTIONCTL_PATH` |
| 低 | 本地文件访问 | 配置文件读写限于用户目录 |
| 低 | 环境变量 | `NOTION_API_KEY` 为功能必需,需妥善保管 |
| 信息 | 外部依赖 | 依赖 `notion-api-automation` skill,需监控更新 |

总体评估: 标准安全级别(Grade A, Score 78),代码结构清晰,无高危威胁。建议实施路径验证强化与输入校验增强。

技术规格

  • API 版本: Notion 2025-09-03 (data_sources)
  • 运行时: Node.js(无 npm 依赖)
  • 存储: Notion Cloud + 本地 JSON 配置
  • 安全认证: T2 社区项目,CLS-Certify v2.1.0 全量扫描通过

soul-in-sapphire 内容

scripts文件夹
手动下载zip · 24.5 kB
bootstrap_config.jstext/javascript
请选择文件