memory-lancedb-pro

环境要求

• 已安装 OpenClaw 2026.3+ 及 openclaw CLI
• CPU 需支持 AVX 指令（部分 Linux x64 构建需 AVX2，否则可能 SIGILL 崩溃）
• 具备 Node.js / npm 环境（使用 npm 安装方式时）
• 一个 OpenAI 兼容的嵌入服务 API Key（如 OpenAI、Jina、DashScope、SiliconFlow、Ollama）

安装与启动步骤

1. 1检查 CPU 指令集

   确认 CPU 支持 AVX，避免 LanceDB 原生向量检索崩溃；无输出表示不支持。

   grep -o 'avx[^ ]*' /proc/cpuinfo | head -1

   复制

2. 2一键安装脚本

   社区维护脚本会自动下载、装依赖、选配置并写入 openclaw.json，最后重启；推荐新手使用。

   curl -fsSL https://raw.githubusercontent.com/CortexReach/toolbox/main/memory-lancedb-pro-setup/setup-memory.sh -o setup-memory.sh
   bash setup-memory.sh

   复制

3. 3或用 CLI 手动安装

   通过 OpenClaw 插件命令安装 beta 版本，README 推荐这种方式。

   openclaw plugins install memory-lancedb-pro@beta

   复制

4. 4或用 npm 安装

   npm 安装后必须把插件安装目录的绝对路径加入 openclaw.json 的 plugins.load.paths，否则不生效。

   npm i memory-lancedb-pro@beta

   复制

5. 5写入 openclaw.json

   把插件挂到 memory 槽位并开启自动捕获与召回；apiKey 支持 ${ENV_VAR} 占位符。

   {
     "plugins": {
       "slots": { "memory": "memory-lancedb-pro" },
       "entries": {
         "memory-lancedb-pro": {
           "enabled": true,
           "config": {
             "embedding": {
               "provider": "openai-compatible",
               "apiKey": "${OPENAI_API_KEY}",
               "model": "text-embedding-3-small"
             },
             "autoCapture": true,
             "autoRecall": true,
             "smartExtraction": true,
             "canonicalCorpus": { "enabled": true, "syncOnSearch": true },
             "dreaming": { "enabled": false },
             "extractMinMessages": 2,
             "extractMaxChars": 8000,
             "sessionMemory": { "enabled": false }
           }
         }
       }
     }
   }

   复制

6. 6升级后修复

   若从旧版本升级，新版改用 before_prompt_build 钩子，需运行 doctor 修复配置。

   openclaw doctor --fix

   复制

7. 7查看记忆库统计

   确认记忆库已建立且数据正常，可查看行数等统计信息。

   openclaw memory-pro stats

   复制

关键配置

如何确认成功

运行 openclaw memory-pro stats 能正常输出记忆库统计，且新会话中不再报插件或钩子错误，即表示部署成功。

常见问题

注意事项

• 密钥字段支持 ${ENV_VAR} 占位符或 SecretRef 对象，SecretRef 仅支持 env 和 file 两种来源，exec 会被运行时校验拒绝。
• sessionMemory 默认关闭，官方建议第一天上手时保持关闭，避免会话摘要污染检索结果。
• 一键脚本支持 bash setup-memory.sh --dry-run 预览、--beta 包含预发布版本。
• 若用 npm 方式安装，脚本会跳过 git 更新并提示你自行执行 npm update。