memory-lancedb 设置

在 OpenClaw 中启用语义向量记忆：通过 memorystore 存储的记忆会被本地嵌入并索引，然后通过 memoryrecall 按需召回——无需加载完整上下文。

前提条件

• - OpenClaw 已安装在 /usr/local/lib/node_modules/openclaw
• 兼容 OpenAI 的嵌入 API 密钥（Gemini AI Studio 免费密钥即可）

设置步骤

1. 获取 Gemini API 密钥（免费）

访问 aistudio.google.com → 获取 API 密钥 → 创建 API 密钥。

2. 配置插件

bash
openclaw config set plugins.entries.memory-lancedb.enabled true
openclaw config set plugins.entries.memory-lancedb.config.embedding.baseUrl https://generativelanguage.googleapis.com/v1beta/openai/
openclaw config set plugins.entries.memory-lancedb.config.embedding.model text-embedding-004
openclaw config set plugins.entries.memory-lancedb.config.embedding.apiKey 你的API密钥
openclaw config set plugins.entries.memory-lancedb.config.embedding.dimensions 768

3. 安装依赖

bash

步骤1：在 openclaw 根目录安装主包

步骤2：在插件目录安装平台特定的原生绑定

npm install @lancedb/lancedb-darwin-x64 # Intel Mac

npm install @lancedb/lancedb-linux-x64-gnu # Linux x64

4. 修补 native.js（仅限 Apple Silicon）

LanceDB 的 native.js 会先尝试 x64，失败时执行 break，永远不会到达 arm64。运行修补脚本：

bash
python3 ~/.openclaw/workspace/skills/memory-lancedb-setup/references/patch_native.py

5. 重启网关并验证

bash
openclaw gateway restart

然后测试：

memory_store → 应返回：已存储：...
memory_recall → 应返回匹配条目及相似度百分比

从 MEMORY.md 迁移

如果 MEMORY.md 文件较大，将关键信息迁移到向量存储，并将 MEMORY.md 缩减为 20-30 行的索引。按主题分组，对每组调用 memory_store：

• - 身份与权限
• 执行规则
• 项目配置（cron ID、文档令牌）
• 技术知识（API 特性、字段名称）
• 工作流程与标准操作程序

仅在 MEMORY.md 中保留每次会话必须了解的规则。

故障排除

常见错误及修复方法请参见 references/troubleshooting.md。