# TencentDB Memory Setup

Installs and verifies the memory-tencentdb plugin in an OpenClaw environment.

- Repository: https://github.com/TencentCloud/TencentDB-Agent-Memory (30326 stars)
- Category: DevOps
- License: see repository
- Last updated: 2026-10-28
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add TencentCloud/TencentDB-Agent-Memory --skill openclaw-memory-tencentdb-setup -g -a claude-code -y`
Codex: `npx skills add TencentCloud/TencentDB-Agent-Memory --skill openclaw-memory-tencentdb-setup -g -a codex -y`
Cursor: `npx skills add TencentCloud/TencentDB-Agent-Memory --skill openclaw-memory-tencentdb-setup -g -a cursor -y`
Gemini CLI: `npx skills add TencentCloud/TencentDB-Agent-Memory --skill openclaw-memory-tencentdb-setup -g -a gemini-cli -y`

## Description

用于在 OpenClaw 环境中安装、配置并验证 @tencentdb-agent-memory/memory-tencentdb 插件。当用户提到"安装记忆插件""配置 memory-tencentdb""开启长期记忆/召回"或出现相关报错时应触发。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## 目的

在不依赖外部托管记忆服务的前提下，为 OpenClaw 提供可持续的本地长期记忆能力（L0→L1→L2→L3），并完成从安装、配置到验收的一次性闭环。

## 适用场景

- 用户要求在 OpenClaw 中安装或启用 `memory-tencentdb`
- 用户需要配置召回、提取、画像、清理等参数
- 用户反馈"插件已装但无记忆 / 无召回 / 无向量检索"

## 不适用场景

- 用户只需要解释 memory 理念，不要求实际落地
- 用户要接入非 OpenClaw 宿主（先确认目标框架）

## 标准工作流

### 1) 环境预检

先确认基础版本满足要求：

- OpenClaw: `>= 2026.3.13`
- Node.js: `>= 22.16.0`

执行：

```bash
openclaw --version
node -v
```

若版本不满足，先升级再继续。

### 2) 安装插件

执行安装命令：

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

如已安装则执行更新：

```bash
openclaw plugins update memory-tencentdb
```

### 3) 写入最小配置

编辑 `~/.openclaw/openclaw.json`，确保存在：

```json
{
  "memory-tencentdb": {
    "enabled": true
  }
}
```

说明：该插件支持零配置启动；不补充其它字段也能运行基础能力。

### 4) 按需追加推荐配置（生产常用）

根据用户需求补充如下分组：

- `capture`: 对话捕获与保留策略
- `extraction`: L1 提取与去重
- `pipeline`: L1→L2→L3 调度
- `recall`: 召回数量、阈值、策略
- `persona`: 场景与画像触发参数
- `embedding`: 向量检索配置（远端 OpenAI 兼容）

推荐模板：

The rest: https://github.com/TencentCloud/TencentDB-Agent-Memory/blob/HEAD/MemoryCore/SKILL.md