openclaw-memory-tencentdb-setup
用于在 OpenClaw 环境中安装、配置并验证 @tencentdb-agent-memory/memory-tencentdb 插件。当用户提到"安装记忆插件""配置 memory-tencentdb""开启长期记忆/召回"或出现相关报错时应触发。
- License 许可
- MIT
- 所属仓库
- pvbang/nexus
- 最近更新
- 2026-11-13
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- openclaw-memory-tencentdb-setup
- version
- 1.0.0
- description
- 用于在 OpenClaw 环境中安装、配置并验证 @tencentdb-agent-memory/memory-tencentdb 插件。当用户提到"安装记忆插件""配置 memory-tencentdb""开启长期记忆/召回"或出现相关报错时应触发。
02 资源文件 140
- 其他.gitignore686 B
- 其他.npmignore232 B
- 资产文件assets/images/flowchart1.cn.png27.2 KB
- 资产文件assets/images/flowchart1.png22.3 KB
- 资产文件assets/images/flowchart2.cn.png26.7 KB
- 资产文件assets/images/flowchart2.png16.8 KB
- 资产文件assets/images/logo.png129.4 KB
- 资产文件assets/images/logo2.png212.3 KB
- 资产文件assets/images/memory-pyramid-en.jpg664.5 KB
- 资产文件assets/images/memory-pyramid.png611.2 KB
- 资产文件assets/images/star-helper.png201.3 KB
- 参考文档CHANGELOG.md14.5 KB
- 参考文档CONTRIBUTING_CN.md4.3 KB
- 参考文档CONTRIBUTING.md4.8 KB
- 其他docker/opensource/Dockerfile.hermes4.6 KB
- 参考文档docker/opensource/README-hermes.md5.7 KB
- 脚本hermes-plugin/memory/memory_tencentdb/__init__.py46.9 KB
- 脚本hermes-plugin/memory/memory_tencentdb/client.py5.7 KB
- 参考文档hermes-plugin/memory/memory_tencentdb/plugin.yaml458 B
- 参考文档hermes-plugin/memory/memory_tencentdb/README.md14.5 KB
- 脚本hermes-plugin/memory/memory_tencentdb/supervisor.py11.8 KB
- 脚本hermes-plugin/memory/memory_tencentdb/tests/__init__.py—
- 脚本hermes-plugin/memory/memory_tencentdb/tests/test_gateway_shutdown_leak.py32.8 KB
- 脚本hermes-plugin/memory/memory_tencentdb/tests/test_memory_tencentdb_recovery.py15.3 KB
- 脚本index.ts34.1 KB
- 许可证LICENSE1.3 KB
- 参考文档openclaw.plugin.json11.9 KB
- 参考文档package.json3.6 KB
- 参考文档README_CN.md18.4 KB
- 参考文档README.md18.7 KB
- 脚本scripts/bugfix-20260423/bugfix-20260423-full.sh12.7 KB
- 脚本scripts/bugfix-20260423/BUGFIX-20260423-SOP.md2.0 KB
- 脚本scripts/bugfix-20260423/bugfix-20260423.sh9.4 KB
- 脚本scripts/export-diagnostic.sh8.8 KB
- 脚本scripts/install_hermes_memory_tencentdb.sh12.1 KB
- 脚本scripts/memory-tencentdb-ctl.sh37.8 KB
- 脚本scripts/openclaw-after-tool-call-messages.patch.sh15.1 KB
- 脚本scripts/README.memory-tencentdb-ctl.md16.9 KB
- 脚本scripts/setup-offload.sh13.7 KB
- 参考文档SKILL-DIAGNOSTIC-EXPORT.md6.6 KB
- 参考文档SKILL-MIGRATION.md7.8 KB
- 脚本src/adapters/index.ts931 B
- 脚本src/adapters/openclaw/host-adapter.ts3.4 KB
- 脚本src/adapters/openclaw/index.ts325 B
- 脚本src/adapters/openclaw/llm-runner.ts3.1 KB
- 脚本src/adapters/standalone/host-adapter.ts2.5 KB
- 脚本src/adapters/standalone/index.ts358 B
- 脚本src/adapters/standalone/llm-runner.ts10.6 KB
- 脚本src/cli/commands/seed.ts10.2 KB
- 脚本src/cli/index.ts1.8 KB
- 参考文档src/cli/README.md4.6 KB
- 脚本src/config.ts25.3 KB
- 脚本src/core/conversation/l0-recorder.ts21.6 KB
- 脚本src/core/hooks/auto-capture.ts14.5 KB
- 脚本src/core/hooks/auto-recall.ts31.3 KB
- 脚本src/core/index.ts613 B
- 脚本src/core/persona/persona-generator.ts8.9 KB
- 脚本src/core/persona/persona-trigger.ts4.3 KB
- 脚本src/core/profile/profile-sync.ts8.0 KB
- 脚本src/core/prompts/l1-dedup.ts7.0 KB
- 脚本src/core/prompts/l1-extraction.ts6.1 KB
- 脚本src/core/prompts/persona-generation.ts7.9 KB
- 脚本src/core/prompts/scene-extraction.ts14.1 KB
- 脚本src/core/record/l1-dedup.ts14.6 KB
- 脚本src/core/record/l1-extractor.ts17.8 KB
- 脚本src/core/record/l1-reader.ts6.4 KB
- 脚本src/core/record/l1-writer.ts9.8 KB
- 脚本src/core/report/reporter.ts2.7 KB
- 脚本src/core/scene/scene-extractor.ts17.8 KB
- 脚本src/core/scene/scene-format.ts1.9 KB
- 脚本src/core/scene/scene-index.ts2.8 KB
- 脚本src/core/scene/scene-navigation.ts2.4 KB
- 脚本src/core/seed/input.ts14.7 KB
- 脚本src/core/seed/seed-runtime.ts14.3 KB
- 脚本src/core/seed/types.ts3.6 KB
- 脚本src/core/store/bm25-client.ts4.9 KB
- 脚本src/core/store/bm25-local.ts2.8 KB
- 脚本src/core/store/embedding.ts22.8 KB
- 脚本src/core/store/factory.ts4.3 KB
- 脚本src/core/store/search-utils.ts1.8 KB
- 脚本src/core/store/sqlite.ts81.5 KB
- 脚本src/core/store/tcvdb-client.ts10.4 KB
- 脚本src/core/store/tcvdb.ts41.4 KB
- 脚本src/core/store/types.ts11.3 KB
- 脚本src/core/tdai-core.ts19.0 KB
- 脚本src/core/tools/conversation-search.ts9.0 KB
- 脚本src/core/tools/memory-search.ts9.2 KB
- 脚本src/core/types.ts8.0 KB
- 脚本src/gateway/config.ts8.0 KB
- 脚本src/gateway/server.ts14.7 KB
- 脚本src/gateway/types.ts3.0 KB
- 脚本src/offload/backend-client.ts12.9 KB
- 脚本src/offload/context-token-tracker.ts5.2 KB
- 脚本src/offload/hooks/after-tool-call.ts28.0 KB
- 脚本src/offload/hooks/before-agent-start.ts5.2 KB
- 脚本src/offload/hooks/before-prompt-build.ts12.6 KB
- 脚本src/offload/hooks/llm-input-l3.ts55.5 KB
- 脚本src/offload/hooks/llm-output.ts736 B
- 脚本src/offload/index.ts95.6 KB
- 脚本src/offload/l3-helpers.ts10.1 KB
- 脚本src/offload/l3-token-counter.ts1.3 KB
- 脚本src/offload/l3-token-helpers.ts582 B
- 脚本src/offload/local-llm/index.ts5.9 KB
- 脚本src/offload/local-llm/llm-caller.ts2.1 KB
- 脚本src/offload/local-llm/parsers/json-utils.ts2.8 KB
- 脚本src/offload/local-llm/parsers/l1-parser.ts1.1 KB
- 脚本src/offload/local-llm/parsers/l15-parser.ts1.2 KB
- 脚本src/offload/local-llm/parsers/l2-parser.ts2.7 KB
- 脚本src/offload/local-llm/prompts/l1-prompt.ts5.4 KB
- 脚本src/offload/local-llm/prompts/l15-prompt.ts5.0 KB
- 脚本src/offload/local-llm/prompts/l2-prompt.ts7.7 KB
- 脚本src/offload/mmd-injector.ts14.1 KB
- 脚本src/offload/mmd-meta.ts1.9 KB
- 脚本src/offload/opik-tracer.ts12.3 KB
- 脚本src/offload/pipelines/l2-mermaid.ts9.3 KB
- 脚本src/offload/reclaimer.ts15.1 KB
- 脚本src/offload/session-registry.ts4.7 KB
- 脚本src/offload/state-manager.ts17.0 KB
- 脚本src/offload/state-reporter.ts12.7 KB
- 脚本src/offload/storage.ts22.4 KB
- 脚本src/offload/time-utils.ts1.1 KB
- 脚本src/offload/types.ts8.8 KB
- 脚本src/offload/user-id.ts2.5 KB
- 脚本src/utils/backup.ts4.5 KB
- 脚本src/utils/checkpoint.ts17.5 KB
- 脚本src/utils/clean-context-runner.ts23.2 KB
- 脚本src/utils/ensure-hook-policy.ts8.9 KB
- 脚本src/utils/env.ts556 B
- 脚本src/utils/managed-timer.ts4.5 KB
- 脚本src/utils/manifest.ts4.4 KB
- 脚本src/utils/memory-cleaner.ts10.2 KB
- 脚本src/utils/pipeline-factory.ts25.7 KB
- 脚本src/utils/pipeline-manager.ts42.2 KB
- 脚本src/utils/sanitize.ts15.7 KB
- 脚本src/utils/serial-queue.ts3.5 KB
- 脚本src/utils/session-filter.ts3.4 KB
- 脚本src/utils/text-utils.ts913 B
- 脚本tsdown.config.ts1017 B
- 脚本vitest.config.ts642 B
- 脚本vitest.e2e.config.ts317 B
03 SKILL.md 正文
目的
在不依赖外部托管记忆服务的前提下,为 OpenClaw 提供可持续的本地长期记忆能力(L0→L1→L2→L3),并完成从安装、配置到验收的一次性闭环。
适用场景
- 用户要求在 OpenClaw 中安装或启用
memory-tencentdb - 用户需要配置召回、提取、画像、清理等参数
- 用户反馈"插件已装但无记忆 / 无召回 / 无向量检索"
不适用场景
- 用户只需要解释 memory 理念,不要求实际落地
- 用户要接入非 OpenClaw 宿主(先确认目标框架)
标准工作流
1) 环境预检
先确认基础版本满足要求:
- OpenClaw:
>= 2026.3.13 - Node.js:
>= 22.16.0
执行:
openclaw --version
node -v
若版本不满足,先升级再继续。
2) 安装插件
执行安装命令:
openclaw plugins install @tencentdb-agent-memory/memory-tencentdb
如已安装则执行更新:
openclaw plugins update memory-tencentdb
3) 写入最小配置
编辑 ~/.openclaw/openclaw.json,确保存在:
{
"memory-tencentdb": {
"enabled": true
}
}
说明:该插件支持零配置启动;不补充其它字段也能运行基础能力。
4) 按需追加推荐配置(生产常用)
根据用户需求补充如下分组:
capture: 对话捕获与保留策略extraction: L1 提取与去重pipeline: L1→L2→L3 调度recall: 召回数量、阈值、策略persona: 场景与画像触发参数embedding: 向量检索配置(远端 OpenAI 兼容)
推荐模板:
{
"memory-tencentdb": {
"capture": {
"enabled": true,
"excludeAgents": [],
"l0l1RetentionDays": 90,
"cleanTime": "03:00"
},
"extraction": {
"enabled": true,
"enableDedup": true,
"maxMemoriesPerSession": 10,
"model": "provider/model"
},
"pipeline": {
"everyNConversations": 5,
"enableWarmup": true,
"l1IdleTimeoutSeconds": 600,
"l2DelayAfterL1Seconds": 90,
"l2MinIntervalSeconds": 900,
"l2MaxIntervalSeconds": 3600,
"sessionActiveWindowHours": 24
},
"recall": {
"enabled": true,
"maxResults": 5,
"scoreThreshold": 0.3,
"strategy": "hybrid"
},
"persona": {
"triggerEveryN": 50,
"maxScenes": 15,
"backupCount": 3,
"sceneBackupCount": 10,
"model": "provider/model"
},
"embedding": {
"enabled": true,
"provider": "openai",
"baseUrl": "https://api.openai.com/v1",
"apiKey": "${EMBEDDING_API_KEY}",
"model": "text-embedding-3-small",
"dimensions": 1536,
"conflictRecallTopK": 5
}
}
}
5) 关键配置规则(避免隐性失败)
embedding.provider = "none"时,向量能力会禁用,仅保留关键词路径。- 若配置远端
provider(如openai/deepseek),必须同时提供:apiKeybaseUrlmodeldimensions
- 上述任一缺失时,插件会继续运行,但自动降级为非向量模式。
l0l1RetentionDays:0表示不清理- 非
0时建议>=3 - 若设为
1~2,需显式开启allowAggressiveCleanup
6) 重启并验证生效
执行:
openclaw gateway restart
检查项:
- Gateway 日志中出现
[memory-tdai]前缀 - 数据目录已创建:
~/.openclaw/memory-tdai/ - 至少包含:
conversations/、records/、scene_blocks/、vectors.db
7) 功能冒烟测试
执行一次最小对话回路并验证:
- 连续对话 2~3 轮,提供可记忆信息(偏好、约束、背景)。
- 发起新一轮对话,观察是否出现召回上下文注入。
- 在 Agent 中调用:
tdai_memory_searchtdai_conversation_search
- 确认能检索到刚刚产生的内容。
故障排查速查
- 插件无日志:检查
openclaw.json中memory-tencentdb.enabled是否为true,并确认已重启 Gateway。 - 有记录无召回:检查
recall.enabled、scoreThreshold是否过高。 - 无向量结果:检查
embedding四元组(apiKey/baseUrl/model/dimensions)是否齐全。 - 清理过猛导致历史过少:检查
l0l1RetentionDays与allowAggressiveCleanup。 - 配置已改但行为不变:确认修改的是
~/.openclaw/openclaw.json,并再次重启 Gateway。
安全与合规约束
- 将
apiKey视为敏感信息;不在聊天、日志、截图中明文扩散。 - 优先使用环境变量注入密钥;配置示例中仅保留占位符。
- 仅修改
memory-tencentdb对应配置段,避免覆盖用户其它插件配置。
完成定义(Definition of Done)
在结束任务前,必须同时满足:
- 插件安装/更新命令执行成功
openclaw.json已存在有效memory-tencentdb配置- Gateway 已重启
[memory-tdai]日志可见- 数据目录与关键文件已生成
- 至少 1 次检索工具调用成功返回结果
交付话术模板
可在完成后向用户输出:
- 已完成
memory-tencentdb安装与配置,并重启 Gateway。 - 已验证日志与数据目录生效,记忆链路可用。
- 如需下一步优化,可继续调优
recall.scoreThreshold、pipeline.everyNConversations、persona.triggerEveryN与embedding模型参数。
04 同仓库更多 Skills
skill-creator
Create, edit, improve, or audit AgentSkills. Use when creating a new skill from scratch or when asked to improve, review, audit, tidy up, or clean up an existing skill or SKILL.md file. Also use when editing or restructuring a skill directory (moving files to references/ or scripts/, removing stale content, validating against the AgentSkills spec). Triggers on phrases like "create a skill", "author a skill", "tidy up a skill", "improve this skill", "review the skill", "clean up the skill", "audit the skill".
prose
OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.
writing-plans
Write implementation plans: bite-sized tasks, paths, code.
test-driven-development
TDD: enforce RED-GREEN-REFACTOR, tests before code.
systematic-debugging
4-phase root cause debugging: understand bugs before fixing.
subagent-driven-development
Execute plans via delegate_task subagents (2-stage review).