1. 问题背景与核心痛点
最近在Mac mini M4(32GB内存)上配置OpenClaw 3.13的qmd记忆后端时,遇到了几个令人头疼的问题。作为长期从事Java/JVM开发的工程师,我习惯性地先梳理问题本质:
- 模型下载龟速:qmd首次embed时会从HuggingFace下载三个GGUF模型(如embeddinggemma-300M-Q8_0.gguf),国内网络环境下经常卡在"Gathering information"阶段
- SQLite扩展加载失败:报错
sqlite-vec is not available. Vector operations require a SQLite build with extension loading support.,这是典型的SQLite扩展支持问题 - Bun运行时兼容性问题:qmd基于Bun运行时,但其内置的SQLite版本在macOS上无法加载vec0.dylib向量扩展
提示:这个问题在Java/JVM生态中也很常见,就像某些JNI库需要特定版本的glibc一样,底层库的兼容性问题往往需要深入排查。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与工具链配置
2.1 基础环境确认
bash复制# 查看系统信息
system_profiler SPSoftwareDataType SPHardwareDataType
# 我的环境:
# macOS 26.31 (Sonoma)
# Apple M4芯片
# 32GB统一内存
2.2 必要工具安装
bash复制# 1. 安装Homebrew(如果尚未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 安装支持扩展的SQLite
brew install sqlite --with-fts5 --with-json1 --with-extension-functions
# 3. 验证SQLite版本
/usr/local/opt/sqlite/bin/sqlite3 --version
# 应显示类似:3.45.1 2024-0
