如何快速上手小龙虾 OpenClaw 持久记忆和知识库

前言

• 在默认安装，没有任何相关配置的情况下，OpenClaw 的记忆引擎是 Builtin，基于 sqlite，在 .openclaw/memory/main.sqlite
• 在默认安装，没有任何相关配置的情况下，OpenClaw 的记忆引擎，只支持全文索引（FTS5）、关键词搜索（BM25）

源文件位置

• 默认位置: ~/.openclaw/workspace/MEMORY.md（其中外链文件处不会被解析、索引）
• 默认位置: ~/.openclaw/workspace/memory/YYYY-MM-DD-*.md
• 配置位置:（配置完成后，1. openclaw config validate，2. openclaw gateway restart）
  • 指令配置
    openclaw config set agents.defaults.memorySearch '{}'
    openclaw config set agents.defaults.memorySearch.extraPaths[0] "path1"
    openclaw config set agents.defaults.memorySearch.extraPaths[1] "path2"
    openclaw config set agents.defaults.memorySearch.extraPaths[2] "path3"
    openclaw config set agents.defaults.experimental.sessionMemory true（暂时试行）
  • 直接修改配置文件
    {
    "agents": {
    "defaults": {
    "memorySearch": {
    "extraPaths": [
    "path1",
    "path2",
    "path3"
    ]
    },
    "experimental": {
    "sessionMemory": true（暂时试行）
    }
    }
    }
    }

操作步骤

1. 将 .md 格式的目标文件放入 ‘源文件位置’（默认记忆引擎的‘源文件位置’ 中不是 .md 格式的文件会被忽略）
2. 手动执行 openclaw memory index --force（可以先行查看一下功能状态 openclaw memory status --deep）

备注

• 其它位置、其它格式的文件可以示意小龙虾 Openclaw 先行转换为 .md 格式然后移至 ‘源文件位置’
• 如果想要默然记忆引擎支持混合 Hybrid 索引、搜索（+ 向量索引、语义搜索），必须增加两项事宜：1. 安装 node-ollama-cpp 扩展插件或启用内置插件 ollama + 安装独立服务 ollama 2. 配置向量嵌入接口/模型（包括下载本地嵌入模型）
• 安装 sqlite-vec 扩展插件可大大加强 openclaw，memory-core、memory-search、memory-get等的向量嵌入和搜索功能
• 上述旨在打造记忆，打造完成后会自动参与回复，但如果用户只是想临时搜索某处某内容，通过对话示意小龙虾 OPenclaw 即可完成一次文件搜索、全文搜索