环境：WSL2，Ubuntu 24.04

一、准备工作

删除记忆索引数据库

# 备份旧数据库（以防万一）
cp ~/.openclaw/memory/main.sqlite ~/.openclaw/memory/main.sqlite.bak

# 删除旧的向量数据库（这会清除现有记忆索引，但不会删除原始文件）
rm ~/.openclaw/memory/main.sqlite

记忆文件存储于：

~/.openclaw/workspace/memory

二、修改配置

1. 启用记忆搜索
openclaw config set agents.defaults.memorySearch.enabled true

2. 使用本地模型
openclaw config set agents.defaults.memorySearch.provider local

3. 删除之前的配置的模型名称

openclaw config unset agents.defaults.memorySearch.model

4. 配置新的模型名称（gguf格式）

penclaw config set agents.defaults.memorySearch.local.modelPath "hf:Qwen/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-Q8_0.gguf"

也可以配置模型绝地路径

或者手动修改配置文件，

~/.openclaw/openclaw.json

{
  "agents": {
      "memorySearch": {
        "enabled": true,
        "provider": "local",
        "local": {
          "modelPath": "hf:ggml-org/embeddinggemma-300m-qat-q8_0-GGUF/embeddinggemma-300m-qat-Q8_0.gguf"
        }
      }
    }
  },
  ...
}

三、重启检查

重新启动

openclaw gateway restart

查看记忆系统的详细运行状态

openclaw memory status --deep

如果是在线模型路径，OpenClaw去下载embedding模型。

生成~/.openclaw/memory/main.sqlite

Hugging Face下载卡住，下载缓慢，设置国内镜像hf-mirror.com

模型文件保存在：~/.node-llama-cpp/models 下，文件名加前缀了：

hf_ggml-org_embeddinggemma-300m-qat-Q8_0.gguf

健康检查

openclaw doctor

查看日志

看看有没有什么报错，解决一下
openclaw logs --follow

重建索引

#rm ~/.openclaw/memory/main.sqlite

openclaw memory index --force

四、测试验证

准备工作

openclaw dashboard 控制台聊天

点击右下角的+号，或者输入/new，会开启新聊天。开启新聊天后，之前的聊天应该会保留。

openclaw tui 命令行聊天

验证

openclaw memory search "你好"

openclaw memory search "性格"

WSL2 Ubuntu OpenClaw 配置记忆搜索 Memory search

OpenClaw 记忆搜索Memory search远程在线embedding模型