用途：在不依赖外部托管记忆服务的前提下，为 OpenClaw 提供本地长期记忆能力（L0→L1→L2→L3），并完成安装、配置到验收的闭环。适用于安装或启用 memory-tencentdb、配置召回/提取/画像/清理参数，以及排查“已装但无记忆、无召回、无向量检索”等情况；不适用于仅解释记忆理念或接入非 OpenClaw 宿主。
环境预检：需 OpenClaw >= 2026.3.13、Node.js >= 22.16.0，可用 openclaw --version 与 node -v 检查。
安装与更新：openclaw plugins install @tencentdb-agent-memory/memory-tencentdb；已安装则执行 openclaw plugins update memory-tencentdb。
最小配置：在 ~/.openclaw/openclaw.json 中写入 memory-tencentdb 段的 enabled: true。插件支持零配置启动；生产可按需追加 capture、extraction、pipeline、recall、persona、embedding 分组。其中 embedding 若配置远端 provider（如 openai/deepseek），必须同时提供 apiKey、baseUrl、model、dimensions，缺任一项会降级为非向量模式；provider 设为 none 则禁用向量，仅保留关键词路径。l0l1RetentionDays 为 0 表示不清理，非 0 建议 >=3，设为 1~2 需显式开启 allowAggressiveCleanup。
生效验证：执行 openclaw gateway restart；确认 Gateway 日志出现 [memory-tdai] 前缀，且已创建 ~/.openclaw/state/memory-tdai/，至少含 conversations/、records/、scene_blocks/、vectors.db。随后进行 2~3 轮包含偏好、约束、背景的对话，发起新一轮观察是否注入召回上下文，并调用 tdai_memory_search、tdai_conversation_search 确认可检索。
排查要点：无日志时检查 enabled 与重启；有记录无召回时检查 recall.enabled 与 scoreThreshold；无向量结果检查 embedding 四元组；清理过猛检查保留天数与 allowAggressiveCleanup；配置改动无效时确认文件路径并再次重启。apiKey 属敏感信息，应优先用环境变量注入，不在聊天、日志或截图中明文扩散；仅修改 memory-tencentdb 配置段，避免覆盖其它插件配置。