概述
memory-lancedb 是 OpenClaw 内置的记忆插件,将长期记忆存储在 LanceDB 向量数据库中,使用 embedding 进行语义召回。支持自动召回(对话前注入相关记忆)和自动捕获(回复后保存重要事实)。通过 plugins.slots.memory = "memory-lancedb" 激活为主动记忆插件。
核心功能
- 向量存储:基于 LanceDB,默认路径
~/.openclaw/memory/lancedb,支持 S3 等远程存储后端 - 多 Embedding 提供商:OpenAI、GitHub Copilot、Ollama(原生
/api/embed端点)、任意 OpenAI 兼容端点 - 自动召回/捕获:
autoRecall在模型轮次前召回相关记忆;autoCapture在回复后自动保存 - 文本长度限制:
recallMaxChars(默认 1000,用于 embedding 请求)和captureMaxChars(默认 500,控制捕获资格) - CLI 命令:
openclaw ltm list/search/stats,openclaw memory query(支持 SQL 风格过滤) - Agent 工具:
memory_recall、memory_store、memory_forget
配置/使用
最小配置(OpenAI embedding):
{
plugins: {
slots: { memory: "memory-lancedb" },
entries: {
"memory-lancedb": {
enabled: true,
config: {
embedding: { provider: "openai", model: "text-embedding-3-small" },
autoRecall: true,
autoCapture: false
}
}
}
}
}Ollama 本地 embedding:
{
embedding: {
provider: "ollama",
baseUrl: "http://127.0.0.1:11434",
model: "mxbai-embed-large",
dimensions: 1024
},
recallMaxChars: 400
}注意:openai-codex OAuth 不是 OpenAI Platform embedding 凭证,需使用 OpenAI API key 或其他支持 embedding 的提供商。
相关页面
- memory — 记忆系统总览
- active-memory — 主动记忆机制
- memory-search — 记忆搜索算法
- concepts/plugin-memory-wiki — Memory Wiki 知识库插件(可与 LanceDB 并存)