[1.0.0-beta.1] - 2026-05-29
🚀 全新架构:独立 Memory 服务
v1.0.0-beta.1 是 TencentDB Agent Memory 的全新里程碑版本,从 OpenClaw 嵌入式插件演进为独立可部署的 Memory 服务。
核心变化:
- 独立部署:不再依赖 OpenClaw 宿主,支持 Docker / Node.js 直接部署
- HTTP v2 API:完整的 RESTful 接口,任何语言/框架的 Agent 都可通过 HTTP 接入
- 多框架适配:同时支持 OpenClaw 插件模式 + Hermes 插件模式 + 独立服务模式
- 官方 SDK:提供 TypeScript SDK 与 Python SDK
✨ 新功能
v2 REST API(Gateway)
- L0 Conversation:
add/query/search/delete - L1 Atomic:
update/query/search/delete - L2 Scenario:
ls/read/write/rm - L3 Core(Persona):
read/write - 所有路由前缀
/v2/,认证方式Authorization: Bearer+x-tdai-service-id
Standalone 本地模式
- 零外部依赖:仅需 LLM API Key 即可运行
- 默认 SQLite + BM25 存储,开箱即用
- 支持 Docker 一键部署(
agentmemory/hermes-memory:1.0.0-beta/agentmemory/openclaw-memory:1.0.0-beta)
SDK
- TypeScript SDK(
@tencentdb-agent-memory/memory-sdk-ts):完整覆盖 L0–L3 全部接口 - Python SDK(
tencentdb-agent-memory-sdk-python):同步 + 异步双客户端
Pipeline 服务化
PipelineWorker:异步消费 L1 提取 / L2 场景生成 / L3 画像更新TimerScanner:定时扫描 idle session 触发 pipelineStorePool:多实例存储池管理- Redis HA 配置支持(service 模式)
可观测性
- OpenTelemetry trace/metric/log 集成
- Langfuse span processor
- ClickHouse + Kafka 可选上报
📦 部署方式
| 方式 | 说明 |
|---|---|
| Docker 容器 | docker pull agentmemory/hermes-memory:1.0.0-beta
|
| 源码直接运行 | node --import tsx/esm src/gateway/server.ts
|
| OpenClaw 插件 | 通过 install-openclaw-plugin-v2.sh 安装
|
| Hermes 插件 | 内置 memory_tencentdb_v2 Python 插件
|
⬆️ 从 0.x 升级说明
v1.0.0-beta.1 与 0.x 是并行维护的两条版本线:
- 0.x(
main分支):OpenClaw 嵌入式插件,适合轻量单机场景 - 1.x(
feat/server分支):独立 Memory 服务,适合多 Agent / 多框架 / 服务化部署
两者核心记忆引擎相同(L0→L3 分层 + BM25/向量混合检索 + Mermaid 符号化短期记忆),数据格式兼容。