帮你快速理解、总结文档立即下载
文档中心>腾讯云数据库 AI 服务>Memory 应用指南>快速接入>OpenClaw 接入指引

OpenClaw 接入指引

最近更新时间：2026-06-12 11:01:54
我的收藏

本页目录：

本文介绍如何在 OpenClaw 中通过官方记忆插件 @tencentdb-agent-memory/memory-tencentdb 接入 TencentDB Agent Memory 云服务，让你的 OpenClaw Agent 在多轮对话间具备稳定的长期记忆能力。
说明：
适用对象：已经在使用 OpenClaw（≥ 2026.3.13）开发 Agent 应用、希望直接复用 TencentDB Agent Memory 云上托管能力的开发者。

前置准备

在开始接入前，请先完成以下准备：
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 实例，您可以在控制台的实例详情页中查看记忆数据。

中国站