[1.0.0] - 2026-06-11
正式版发布：从 OpenClaw 专属插件演进为面向所有 Agent 的通用记忆服务。完整的 Gateway 独立服务 + v2 HTTP API + 官方 TypeScript / Python SDK，任何 Agent 框架均可接入完整的多层记忆与上下文压缩能力。
⚠️ Breaking Changes
- 客户端/服务端架构拆分：记忆引擎从 OpenClaw 嵌入式插件拆分为独立 Gateway 服务进程，部署方式与接入方式发生变化。
- 配置结构变更：插件配置结构扁平化重构，原
gateway字段迁移为server嵌套。 - 插件入口模式变更：支持
local（进程内本地运行，默认）和client（连接外部 Memory Gateway）两种接入模式。
🚀 独立 Gateway 服务（v2 API）
记忆能力不再绑定 OpenClaw 宿主，以独立服务形式运行，通过 v2 HTTP API 为任意 Agent 提供记忆读写与管线管理：
- 完整 v2 API：14 条标准路由覆盖记忆 CRUD、原子更新、场景索引、管线状态查询等全部操作。
- 管线状态查询（
/v2/pipeline/status）：实时获取 L1/L2/L3 各阶段运行状态与进度。 - 实例生命周期管理（
/v2/instance/destroy）：支持外部系统主动创建/销毁记忆实例。 - 可选 Bearer 鉴权 + CORS 白名单：保护对外暴露的 API 安全。
- 请求体校验：强制 1 MiB 上限，防止异常请求。
🚀 官方 SDK
- TypeScript SDK 1.0.0（
@tencentdb-agent-memory/memory-sdk-ts）：类型安全，覆盖全部 v2 API，npm 安装即用。 - Python SDK（
tencentdb-agent-memory-sdk-python）：pip wheel 安装，同步/异步双模式，覆盖全部 v2 API。
🚀 通用 Agent 框架适配
- OpenClaw 插件适配：支持
local（进程内本地运行，默认）和client（连接外部 Memory Gateway）两种接入模式。local模式保持原有体验。 - Hermes Agent 适配：
memory_tencentdb_v2adapter，支持 Hermes 框架多租户场景。 - 通用接入：任何能发 HTTP 请求的 Agent（LangChain、AutoGPT、自研框架等）均可通过 SDK 或裸 API 接入。
🚀 可观测性
- OpenTelemetry 全链路 Trace：支持 OTLP 协议上报，可对接 Jaeger / Grafana Tempo 等后端。
- Langfuse 集成：仅转发 LLM 相关 span，适合评估记忆提取质量。
- 管线评测指标：L1 提取率、去重决策分布、各阶段 token 消耗、recall 延迟等。
🚀 Offload Server V2
- L1 / L1.5 / L2 异步执行器：独立的 Offload 处理管线，支持大规模会话并发。
- L3 压缩处理器：Mermaid 符号化 + 上下文预算控制，智能上下文压缩。
- MMD 注入：支持多模态数据注入 Offload 流程。
- Gateway 集成
/v2/offload/*路由：统一 Offload API 入口。
📦 部署方式
| 方式 | 说明 |
|---|---|
| Docker 容器 | docker pull agentmemory/hermes-memory:1.0.0
|
| 源码直接运行 | node --import tsx/esm src/gateway/server.ts
|
| OpenClaw 插件 | 通过 install-openclaw-plugin-v2.sh 安装
|
| Hermes 插件 | 内置 memory_tencentdb_v2 Python 插件
|
⬆️ 从 0.x 升级说明
v1.0.0 与 0.x 是并行维护的两条版本线：
- 0.x（
main分支）：OpenClaw 嵌入式插件，适合轻量单机场景 - 1.x（
feat/server分支）：独立 Memory 服务，适合多 Agent / 多框架 / 服务化部署
两者核心记忆引擎相同（L0→L3 分层 + BM25/向量混合检索 + Mermaid 符号化短期记忆），数据格式兼容。
🐛 修复（v1.0.0-beta.2 → v1.0.0）
- Hermes 插件
install_hermes_tdai_gateway.sh完善：支持 root 自动切换用户、旧路径自动迁移、幂等检测以跳过重复安装 - Gateway 配置优化：默认端口 8420，同步写入
/etc/profile.d/和~/.hermes/.env两份环境变量 - SDK 文档补全：TypeScript / Python SDK README 与接入示例
- OpenClaw plugin.json 配置调整：移除 deprecated 字段，适配 OpenClaw 最新版本
📖 文档
- SDK 接入指南（TypeScript / Python 示例）。
- Gateway 独立部署文档。
- OpenClaw / Hermes 插件安装说明。
- Docker 部署与配置参考。
Full Changelog: https://github.com/Tencent/TencentDB-Agent-Memory/commits/feat/server