智能记忆 v3.1 技能

智能记忆 v3.1 是一个本地优先处理转录的认知记忆运行时，具备修订感知推导、固定上下文通道、实体感知检索和有界提示组合功能。

核心运行时：

• 节点适配器：smart-memory/index.js
• 本地 API：server.py
• 系统外观：cognitive_memory_system.py
• 规范存储：storage/sqlite_memory_store.py以及transcripts/

核心能力

• 转录优先的摄取和每条消息的转录记录
• 类型化的长期记忆，包括偏好、身份和任务状态
• 基于证据的修订生命周期决策和替代链
• 显式的核心与工作记忆通道
• 具备轻量级关系提示的实体感知检索
• 基于转录历史记录的确定性重建
• 面向工作上下文的热记忆兼容性预测
• 严格令牌限制的提示组合与追踪元数据
• 用于转录记录、证据、历史、通道及评估运行的检查端点

OpenClaw 集成

使用位于skills/smart-memory-openclaw/目录下的原生封装包

。

• 主要导出项：
• createSmartMemorySkill(options)

createOpenClawHooks({ skill, agentIdentity, summarizeWithLLM })

封装层保持稳定，而后端底层现已转为转录记录优先架构。

1. 工具接口

• memory_search用途：通过
• /retrieve接口查询相关记忆，支持,type,limit,min_relevance, 以及可选的conversation_history
• 在执行前对后端进行健康检查

2. memory_commit

• 目的：持久化重要的事实、决策、信念、目标或会话摘要
• 在执行前对后端进行健康检查
• 序列化提交以保护本地嵌入吞吐量
• 将失败的提交排队到.memory_retry_queue.json

3. memory_insights

• 目的：呈现待处理的背景洞察
• 在执行前对后端进行健康检查
• 调用/insights/pending

API 端点

核心端点：

• GET /health
• POST /ingest
• POST /retrieve
• POST /compose
• POST /run_background
• GET /memories
• GET /memory/{memory_id}
• GET /insights/pending

转录与检查端点：

• POST /transcripts/message
• GET /transcripts/{session_id}
• GET /transcript/message/{message_id}
• GET /memory/{memory_id}/evidence
• POST /revise
• GET /memory/{memory_id}/history
• GET /memory/{memory_id}/active
• GET /memory/{memory_id}/chain
• GET /lanes/{lane_name}
• POST /lanes/{lane_name}/{memory_id}
• DELETE /lanes/{lane_name}/{memory_id}
• POST /rebuild
• POST /rebuild/{session_id}
• GET /eval/suite/{suite_name}
• GET /eval/case/{案例ID}

操作指南

• 在连续性至关重要时，发言前请查询记忆
• 除非检索结果确实支持，否则不要声称存在先前的上下文
• 转录文本是权威来源，记忆是派生信息
• 将SQLite视为规范的运行时存储
• 仅将JSON视为离线导出或备份格式
• 保持仅CPU的PyTorch策略不变

已弃用

遗留的向量记忆CLI构件仍属弃用状态，不应恢复使用。