腾讯云数据库 AI 服务 OpenClaw 接入指引

一、前置准备

在开始接入前，请先完成以下准备：

1. 开通 TencentDB Agent Memory 服务，并在控制台创建一个 Memory 实例，记录下：

·实例访问地址（url，从控制台实例详情页获取）

·API Key（用于实例鉴权）

·实例 ID（instanceId，用于隔离不同业务的记忆数据）

2. 本地已安装 OpenClaw CLI，且版本 ≥ 2026.3.13：

openclaw –version

二、接入流程总览

OpenClaw 通过记忆插件 @tencentdb-agent-memory/memory-tencentdb 接入 TencentDB Agent Memory，整体流程分三步：

1. 安装插件

2. 配置 openclaw.json

3. 重启 OpenClaw Gateway

完成后，OpenClaw Agent 会在每一轮对话中自动完成「召回 > 注入 > 捕获 > 沉淀」的记忆闭环，无需在业务代码里手写任何记忆调用逻辑。

三、一、安装插件

通过 OpenClaw CLI 安装记忆插件（需 ≥ 1.0.0 版本）：

openclaw plugins install @tencentdb-agent-memory/memory-tencentdb

如果已安装旧版本（< 1.0.0），可通过以下命令升级到最新版本：

openclaw plugins update memory-tencentdb

插件安装完成后，可通过下述命令确认是否安装成功：

openclaw plugins list

输出中应包含 @tencentdb-agent-memory/memory-tencentdb，且版本号 ≥ 1.0.0。

四、二、配置 openclaw.json

打开 ~/.openclaw/openclaw.json（项目级配置可放置在项目根目录的 openclaw.json），按下面示例填入 TencentDB Agent Memory 的接入信息：

{ "plugins": { "entries": { "memory-tencentdb": { "enabled": true, // hooks 仅在 OpenClaw ≥ 2026.4.24 版本中支持，低于该版本请勿添加此字段 "hooks": { "allowPromptInjection": true, "allowConversationAccess": true }, "config": { "mode": "client", "server": { "url": "${TDAI_MEMORY_SERVER_URL}", "apiKey": "${TDAI_MEMORY_API_KEY}", "instanceId": "${TDAI_MEMORY_INSTANCE_ID}" } } } } }}

注意：说明：

注意：提示：示例中的 ${TDAI_MEMORY_SERVER_URL} 等占位符，建议通过环境变量注入，避免把 API Key 等敏感信息直接写入配置文件。

注意：hooks 字段仅在 OpenClaw ≥ 2026.4.24 版本中支持。如果你的 OpenClaw 版本低于 2026.4.24，请勿在配置中添加 hooks 字段，否则可能导致插件加载异常。

五、配置项说明

顶层配置

配置项	是否必选	说明
enabled	是	是否启用 memory-tencentdb 插件，需设置为 true。
config.mode	是	运行模式，设置为 client（也可使用别名 gateway 或 remote），表示连接云上 Memory 实例。

server 配置

配置项	是否必选	说明
config.server.url	是	Memory 实例访问地址，从控制台实例详情页获取。
config.server.apiKey	是	API Key，用于实例接口鉴权。建议通过环境变量引用，不要直接写死在配置文件中。
config.server.instanceId	否	实例 ID，用于隔离不同业务的记忆数据。默认 "default"。

recall 配置（记忆召回）

配置项	是否必选	说明
config.recall.enabled	否	是否启用自动召回。开启后，每轮对话前会自动检索相关记忆并注入到上下文中。默认 true。
config.recall.maxResults	否	单次召回返回的最大记忆条数，默认 5。
config.recall.maxCharsPerMemory	否	单条记忆注入的最大字符数，0 表示不限制。默认 0。
config.recall.maxTotalRecallChars	否	每轮 auto-recall 注入的记忆总字符预算，0 表示不限制。默认 0。
config.recall.scoreThreshold	否	最低分数阈值，低于该分数的记忆不会被召回。默认 0.3。
config.recall.strategy	否	搜索策略：keyword（关键词）、embedding（向量）、hybrid（混合 RRF 融合，推荐）。默认 "hybrid"。
config.recall.timeoutMs	否	召回整体超时（毫秒），超时后跳过记忆注入。默认 5000。

capture 配置（对话捕获）

配置项	是否必选	说明
config.capture.enabled	否	是否启用自动对话捕获。开启后，每轮对话结束时会自动记录对话内容用于后续记忆提取。默认 true。
config.capture.excludeAgents	否	Glob 模式列表，匹配的 Agent 不会被捕获和召回（如 ["bench-judge-*"]）。默认 []。

六、三、重启 OpenClaw Gateway

完成配置后，重启 OpenClaw Gateway 使配置生效：

openclaw gateway restart

重启完成后，即可正常使用 OpenClaw 进行对话。对话过程中产生的记忆数据会自动同步到云上 Memory 实例，你可以在控制台的实例详情页中查看记忆数据。