OpenClaw之Memory配置成本地模式，Ubuntu+CUDA+cuDNN+llama.cpp

文章目录

• • 背景：Memory不生效的问题
  • OpenClaw的Memory配置
  • Ubuntu24.04安装CUDA和cuDNN
  • 编译llama.cpp
  • • 验证方案1：
    • [验证方案2：下载并运行Llama-2 7B模型](#验证方案2：下载并运行Llama-2 7B模型)
  • 安装node-llama-cpp
  • 验证Memory
  • [sqlite-vec unavailable](#sqlite-vec unavailable)
  • 踩过的坑
  • • 安装node-llama-cpp的一些提示
    • 安装node-llama-cpp的前置条件
    • [Using `node-llama-cpp` With Vulkan](#Using node-llama-cpp With Vulkan)

承接上文：Windows11基于WSL2首次运行Openclaw，并对接飞书应用，我已经在电脑上安装了OpenClaw，接下来解决Memory问题。走了很多弯路，下面主要讲我总结的正确的安装过程。

总结来说：针对Memory不生效的问题，又不想用OpenAI或Gemini，或者只想单纯的节省token，可以按照如下的方式，设置为local模式：

• 修改openclaw.json配置
• 安装CUDA和cuDNN
• 编译llama.cpp，使用cuda
• 安装node-llama-cpp
• 验证

背景：Memory不生效的问题

执行openclaw doctor命令，有如下提示

◇  Memory search 
Memory search is enabled but no embedding provider is configured. 
Semantic recall will not work without an embedding provider.               Fix (pick one):     
  - Set OPENAI_API_KEY or GEMINI_API_KEY in your environment
  - Add credentials: openclaw auth add --provider openai
  - For local embeddings: configure agents.defaults.memorySearch.provider and local model
    path
  - To disable: openclaw config set agents.defaults.memorySearch.enabled false
  Verify: openclaw memory status --deep

这是因为"长期记忆检索"（memory_search）的 provider 只支持 openai | gemini | local，其中 openai/gemini 都需要单独的 API Key（或 remote.apiKey）。

这一块网上的资料很少，且部分缺少上下文。我就决定自己来配置使用本地(local)模式的Memory。

OpenClaw的Memory配置

参考官网上的Memory介绍，我做了如下修改。

1、修改openclaw.json：如下，在~/.openclaw/openclaw.json中，增加/修改如下内容

  "agents": {
    "defaults": {
      "model": {
        "primary": "zai/glm-5"
      },
      "models": {
        "zai/glm-5": {
          "alias": "GLM"
        }
      },
      "workspace": "/home/band/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard",
        "reserveTokensFloor": 20000,
        "memoryFlush": {
          "enabled": true,
          "softThresholdTokens": 4000,
          "systemPrompt": "Session nearing compaction. Store durable memories now.",
          "prompt": "Write any lasting notes to memory/YYYY-MM-DD.md; reply with NO_REPLY if nothing to store."
        }
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      },
      "memorySearch": {
        "provider": "local",
        "local": {
          "modelPath": "hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf"
        },
        "fallback": "none",
        "sources": [
          "memory",
          "sessions"
        ],
        "experimental": {
          "sessionMemory": true
        },
        "store": {
          "vector": {
            "enabled": true,
            "extensionPath": "~/.npm-global/lib/node_modules/sqlite-vec/node_modules/sqlite-vec-linux-x64/vec0.so"
          }
        }
      }
    }
  }

注意：

• modelPath采用官方建议的模型，注意是模型名称，不是本地的目录，我就是在这卡了很久。
• extensionPath后文有讲到，修改为本地的目录

Ubuntu24.04安装CUDA和cuDNN

按照官网的教程安装，地址：https://developer.nvidia.com/cuda-downloads

mkdir /opt/nvidia
cd /opt/nvidia
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/cuda-ubuntu2404.pinsudo mv cuda-ubuntu2404.pin /etc/apt/preferences.d/cuda-repository-pin-600wget https://developer.download.nvidia.com/compute/cuda/13.1.1/local_installers/cuda-repo-ubuntu2404-13-1-local_13.1.1-590.48.01-1_amd64.debsudo dpkg -i cuda-repo-ubuntu2404-13-1-local_13.1.1-590.48.01-1_amd64.debsudo cp /var/cuda-repo-ubuntu2404-13-1-local/cuda-*-keyring.gpg /usr/share/keyrings/sudo apt-get updatesudo apt-get -y install cuda-toolkit-13-1

安装后，还需要设置环境变量

echo 'export PATH=/usr/local/cuda-13.1/bin${PATH:+:${PATH}}' | sudo tee -a /etc/profile.d/cuda.sh
echo 'export LD_LIBRARY_PATH=/usr/local/cuda-13.1/lib64${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}' | sudo tee -a /etc/profile.d/cuda.sh
source /etc/profile.d/cuda.sh

验证：nvcc --version，提示如下表明已经cuda toolkit安装成功。

安装cuDNN

wget https://developer.download.nvidia.com/compute/cudnn/9.19.0/local_installers/cudnn-local-repo-ubuntu2404-9.19.0_1.0-1_amd64.deb
sudo dpkg -i cudnn-local-repo-ubuntu2404-9.19.0_1.0-1_amd64.deb
sudo cp /var/cudnn-local-repo-ubuntu2404-9.19.0/cudnn-*-keyring.gpg /usr/share/keyrings/
sudo apt-get update
sudo apt-get -y install cudnn

使用如下命令查看安装的目录

# 注意大小写
dpkg -L libcudnn9-cuda-13
dpkg -l |grep cudnn

验证，与前文类似，先安装Anaconda，再安装pytorch，所有工作完成后。执行如下命令：python test_cuda.py

编译llama.cpp

node-llama-cpp 会尝试构建 CUDA / Vulkan / CPU 三种版本，最终 fallback 到 CPU 版成功。为了避免用CPU版本，我先安装调试好CUDA。我估计这一步可以采用官网的指引，Install llama.cpp using brew, nix or winget。

https://github.com/ggml-org/llama.cpp/blob/master/docs/build.md

git clone https://github.com/ggml-org/llama.cpp.git
# 前提，要设置好环境变量，DLLAMA_OPENSSL是必要的，后面会有提示
cd llama.cpp
cmake -B build -DGGML_CUDA=ON -DLLAMA_OPENSSL=ON
cmake --build build --config Release

验证llama.cpp是否已经安装好

验证方案1：

访问： https://huggingface.co/Qwen/Qwen3-0.6B-GGUF/tree/main ，点击Use this model，选择llama.cpp，出现下面的窗口

因为我是再WSL种运行，就选择cli方案：

# Run inference directly in the terminal:
./build/bin/llama-cli -hf Qwen/Qwen3-0.6B-GGUF:Q8_0

如果出现下面的错误，加上-DLLAMA_OPENSSL=ON参数，重新编译llama.cpp。

解决之后又有新的报错。暂时先到这里，没有继续验证，TODO

验证方案2：下载并运行Llama-2 7B模型

# 安装并初始化git-lfs（GIt Large File Storage）
$ sudo apt install git-lfs
$ git lfs install

这个方案我没有做完。

安装node-llama-cpp

npm install -g node-llama-cpp
# 此处官网文档和网上的资料都给了我误导
node-llama-cpp --version
# 3.16.1

验证Memory

openclaw gateway restart
openclaw memory status --deep

正在下载模型到~/.node-llama-cpp/models，说明已经起作用了。

sqlite-vec unavailable

在openclaw doctor或openclaw memory status --deep，还有个错误。

[memory] sqlite-vec unavailable: /home/band/sqlite-vec.so: cannot open shared object file: No such file or directory

循着网上的信息，找到正主：https://github.com/asg017/sqlite-vec，安装教程在：https://alexgarcia.xyz/sqlite-vec/installation.html，编译教程：https://alexgarcia.xyz/sqlite-vec/compiling.html

# 缺少什么安装什么
sudo apt-get update 
sudo apt-get install unzip
sudo apt install -y libsqlite3-dev
git clone https://github.com/asg017/sqlite-vec 
cd sqlite-vec 
./scripts/vendor.sh 
make loadable

按照官网的编译教程还是有误，就没继续。

我用了一个取巧的办法，

# 先安装，安装的目录在~/.npm-global/lib/node_modules/sqlite-vec/node_modules/sqlite-vec-linux-x64/vec0.so。
# 如果不知道在哪，可以先用whereis node-llama-cpp/pnpm，找到~/.npm-global/bin/，lib在同一个目录
npm install -g sqlite-vec

修改如下配置，重启gateway，再执行openclaw memory status --deep，问题修复

"extensionPath": "~/.npm-global/lib/node_modules/sqlite-vec/node_modules/sqlite-vec-linux-x64/vec0.so"

踩过的坑

安装node-llama-cpp的一些提示

openclaw的文档提示如下：

### [本地嵌入自动下载]

- 默认本地嵌入模型：`hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf`（约 0.6 GB）。
- 当 `memorySearch.provider = "local"` 时，`node-llama-cpp` 解析 `modelPath`；如果 GGUF 缺失，它会自动下载到缓存（或 `local.modelCacheDir`，如果已设置），然后加载它。下载在重试时会续传。
- 原生构建要求：运行 `pnpm approve-builds`，选择 `node-llama-cpp`，然后运行 `pnpm rebuild node-llama-cpp`。
- 回退：如果本地设置失败且 `memorySearch.fallback = "openai"`，我们自动切换到远程嵌入（`openai/text-embedding-3-small`，除非被覆盖）并记录原因。

运行openclaw doctor，提示如下

Memory search provider is set to "local" but no local model file was found. 

  Fix (pick one): 
  - Install node-llama-cpp and set a local model path in config
  - Switch to a remote provider: openclaw config set agents.defaults.memorySearch.provider
    openai
  Verify: openclaw memory status --deep

看起来必须要安装node-llama-cpp。于是继续搜寻资料。

cd ~/.openclaw/extensions
npm install node-llama-cpp
# 此时node-llama-cpp安装到~/.openclaw/extensions/node_modules，没有起作用。
pnpm approve-builds
# 提示没有需要编译的:There are no packages awaiting approval
npx --no node-llama-cpp inspect gpu
# 提示报错

安装node-llama-cpp的前置条件

OpenClaw 依赖 node-llama-cpp，网上说要原生编译安装。需要从源码编译 llama.cpp（大型 C++ AI 库）。所以要先编译llama.cpp，还依赖CUDA和cuDNN。所以正确的安装顺序是：

• 安装CUDA

• 安装cuDNN

• 编译llama.cpp

• 原生编译安装node-llama-cpp

  https://github.com/withcatai/node-llama-cpp.git

  sudo apt-get update
  sudo apt-get install build-essential cmake git libstdc++6 libgomp1

  npx node-llama-cpp source download
  npx node-llama-cpp source build

当我尝试执行npx node-llama-cpp source download，一直报错。

此时我再尝试执行npx --no node-llama-cpp inspect gpu，能正确执行，但是报错如下。让我很意外，怀疑是因为我把llama.cpp已经编译成功的缘故。

Vulkan: Vulkan is detected, but using it failed
To resolve errors related to Vulkan, see the Vulkan guide: https://node-llama-cpp.withcat.ai/guide/vulkan

Using node-llama-cpp With Vulkan

这个问题是在处理node-llama-cpp时遇到的，目前看没有影响，后面也没处理。

关键词：openclaw, Memory_search, node-llama-cpp, 本地模式，cuda等