用途：为智能体团队提供共享、持续增长的记忆，避免每次会话从零开始。适用于用户明确提到 TencentDB、memory-tencentdb、Memory Hub 或团队记忆，或需要跨智能体框架、跨团队成员持久留存记忆、从历史对话提取技能库、在代码库上构建 Wiki/CodeGraph 的场景。
主要能力：Chat Memory 按 L0 原始对话→L1 原子→L2 场景→L3 人格分层蒸馏，保留偏好、事实、决策与交互历史；技能库可从对话与工具调用历史中提取可复用、带版本与触发边界的 Skill 并经审核共享；Wiki + CodeGraph 把文档、规范、运维手册转为关联 Wiki，并把代码符号、文件、调用关系与影响路径索引化，按需查询而非整体注入上下文；Memory Panel 提供人工审查与控制界面，决定记忆的晋升、共享或清理；资产可跨智能体框架携带、在团队内共享。
使用方式：前提是运行中的 OpenAI 兼容 LLM 端点（用于抽取与嵌入），以及 Docker 或 Node.js >= 22.16。快速路径用 Docker Compose 部署三个服务：先克隆仓库 git clone https://github.com/AnEntrypoint/agent-memory.git，按仓库内 Docker Compose 部署 README 操作，启动前在 .env 配置 memory 与 proxy 组的 LLM 参数，启动脚本会运行 MemoryCore、MemoryHub、MemoryProxy 并打印 Claude Code 配置命令，面板地址为 http://localhost:8125；独立 Memory Hub、Proxy 与 Claude Code/CodeBuddy 集成、端口与卸载见 INSTALL.md（中文为 INSTALL_CN.md）。若宿主是 OpenClaw 而非 Claude Code，可执行 openclaw plugins install @tencentdb-agent-memory/memory-tencentdb，并在 ~/.openclaw/openclaw.json 配置 {"memory-tencentdb": {"enabled": true}}，基础能力零配置可用，生产调优分组包括 capture、extraction、pipeline、recall、persona、embedding，完整模板与失败模式见上游插件文档。旧版（v1.x/v0.x 到 v2.0.0+）迁移使用上游仓库迁移 README 中的工具；把 gm 自身记忆迁入 tencentdb_backend 存储的导入动词、批处理脚本、384 维要求与归档选项见 references/gm-memory-migration.md。
与 gm 自身记忆动词的关系：需要独立部署（Docker Compose、面板 UI）时用本技能；只想让 gm 记忆兼容腾讯格式而不运行独立服务时，改用 gm.config.json 的 memory.tencentdb_backend 配置；本会话内的本地召回可直接用 gm 的 memorize/recall/memorize-fire/memorize-prune（默认后端，无需搭建）。
验证：确认 node -v >= 22.16，使用 OpenClaw 插件时确认 openclaw --version >= 2026.3.13；启动或重启后读取日志（OpenClaw 插件路径为 [memory-tdai] 前缀，Docker Compose 为对应容器日志），不要仅凭退出码判断成功；确认数据目录存在且非空（OpenClaw 为 ~/.openclaw/state/memory-tdai/，含 conversations/、records/、scene_blocks/、vectors.db）；执行真实往返测试，用 2-3 轮陈述可记忆事实，开启新会话确认召回确实出现（通过面板或 tdai_memory_search/tdai_conversation_search 等搜索调用），冒烟测试召回失败即视为未完成，不能仅凭配置文件存在就报告成功。
常见失败模式：完全没有日志，多为 memory-tencentdb.enabled 未设为 true，或配置变更后未重启网关/服务；有记录但召回不到，多为 recall.enabled 为 false 或 recall.scoreThreshold 过高；无向量结果，多为 embedding 配置缺少 apiKey/baseUrl/model/dimensions 之一，任一缺失会禁用向量搜索并在 error 级记录 [EMBEDDING CONFIG ERROR]，插件会继续运行而不嵌入；历史消失过快，多为 l0l1RetentionDays 过低（1-2）且未显式开启 allowAggressiveCleanup。
限制与安全：embedding.apiKey 与任何 LLM 凭据应视为敏感信息，不要回显到聊天、日志或截图，优先用环境变量注入而非配置文件明文；编辑配置时只改 memory-tencentdb/agent-memory 相关段落，不要覆盖无关插件或服务配置。资料未提供收费标准、具体定价与平台支持范围，亦未提供完整配置模板，需以上游文档为准。