如何快速加强应用小龙虾 OpenClaw 持久记忆和知识库

前言

  OpenClaw memory 机制支持混合搜索：A（全文FTS5索引、关键词BM25搜索）+ B（向量索引、语义搜索）
memory-search，memory-get -> memory-core (源数据格式 .md，位置有固定的，有可配的)
A -> Builtin（基于 sqlite，内置、默认）
B -> sqlite-vec(基于 sqlite，内置、默认) -> 向量嵌入引擎 + 向量嵌入模型（自由选择，灵活配置，主要参考主机配置 + 个人应用场景/企业规模）
如果记忆系统检测发现 B. 功能的“向量嵌入引擎 + 向量嵌入模型”已配置，则自动启用混合搜索
本方案主要针对个人/小企业，中大型企业务必选择其它方案，但通常本地模型足够了，不需要远程提供商
查看记忆系统当前状态：openclaw memory status (--deep)

node-llama-cpp 插件方案（向量嵌入引擎 + 向量嵌入模型）

• 安装 node-llama-cpp 插件

  • (sudo) npm install -g node-llama-cpp
  • 遇到路径问题手动校正即可

• 下载向量嵌入模型（必须参数适中，GGUF格式，适合本地部署）

  • 根据主机内存和GPU情况 + OpenClaw实际应用场景，让大模型给出选项，此处推荐 Qwen3-Embedding-0.6B
  • 国外下载地址：huggingface
  • 国内下载地址：魔搭modelscope

• 修改配置

  {
    "agents": {
      "defaults": {
        "memorySearch": {
          "enabled": true,
          "extraPaths": ["/root/.openclaw/knowledge", "./xiaolongxia/knowledge"],  // 除了记忆系统默认位置，可以在此指定自定义位置
          "provider": "local",
          "local": {
            "modelPath": "/root(home/admin)/.openclaw/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-f16.gguf"
          },
          "query": {
            "hybrid": {
              "enabled": true,
              "vectorWeight": 0.7,
              "textWeight": 0.3,
              "mmr": {
                "enabled": true
              },
              "temporalDecay": {
                "enabled": true
              }
            }
          }
        }
      }
    }
  }
  

ollama 独立服务方案（向量嵌入引擎 + 向量嵌入模型）

• 安装 ollama

  • (sudo) curl -fsSL https://ollama.com/install.sh | sh
  • systemctl status ollama（service ollama status，通常情况下， 安装 ollama 完成后服务已启动）
  • ollama --version（遇到路径问题手动校正即可）

• ollama 加载模型

  • ollama search 模糊模型名/模型名关键词（也可进入官网查询 https://ollama.com/library ）
  • ollama pull qwen3-embedding:0.6b（模型名:标签）
  • ollama list（确认拉取/下载成功）
  • ollama run qwen3-embedding:0.6b（模型名:标签）

• 修改配置

  {
    "agents": {
      "defaults": {
        "memorySearch": {
          "enabled": true,
          "extraPaths": ["/root/.openclaw/knowledge", "./xiaolongxia/knowledge"],  // 除了记忆系统默认位置，可以在此指定自定义位置
          "provider": "ollama",
          "model": "qwen3-embedding",
          "remote": {
            "baseUrl": "http://localhost:11434"
          },
          "query": {
            "hybrid": {
              "enabled": true,
              "vectorWeight": 0.7,
              "textWeight": 0.3,
              "mmr": {
                "enabled": true
              },
              "temporalDecay": {
                "enabled": true
              }
            }
          }
        }
      }
    }
  }
  

备注

1. openclaw config validate
2. openclaw memory status (--deep)
3. openclaw gateway restart
4. openclaw memory index (--force)
   which，whereis，find（太慢）都可用以查找位置，唯 locate 指令最快最全（需要安装 apt install plocate）