Openclaw qmd 如何安装
来源：互联网 2026-03-31 15:57:01如何为 OpenClaw 安装 QMD 记忆后端 为 OpenClaw 安装官方的 QMD 记忆后端，可以借助向量数据库技术显著增强助手的长期记忆能力，使其能够记住历史对话。整个安装配置过程预计可在十分钟内完成。 第一步：检查系统与环境要求 OpenClaw 版本: 确认您的 OpenClaw 版本
如何为 OpenClaw 安装 QMD 记忆后端
为 OpenClaw 安装官方的 QMD 记忆后端，可以借助向量数据库技术显著增强助手的长期记忆能力，使其能够记住历史对话。整个安装配置过程预计可在十分钟内完成。
第一步：检查系统与环境要求
-
OpenClaw 版本: 确认您的 OpenClaw 版本不低于
2026.2.2。您可以在终端中运行openclaw --version进行查看。若版本过低，请先完成升级。长期稳定更新的攒劲资源： >>>点此立即查看<<<
-
包管理器: 建议使用 Bun 以获得更快的安装速度，可通过
curl -fsSL https://bun.sh/install | bash命令安装。使用 Node.js 22 或更高版本亦可。
第二步：安装 QMD 命令行工具
您需要通过包管理器安装 QMD 的 CLI 工具，以下是两种常用方法。
方法一：使用 Bun 安装（推荐）
bash
bun install -g https://github.com/tobi/qmd
方法二：使用 npm 安装
bash
npm install -g @tobilu/qmd
安装完成后，运行 qmd --version 命令。若能正常显示版本号，则表明安装成功。若提示“命令未找到”，请检查并配置好 Bun 或 npm 的全局安装路径至系统环境变量 PATH 中。
第三步：安装并配置 SQLite 数据库
QMD 记忆后端依赖于支持向量扩展的 SQLite，请根据您的操作系统进行安装。
-
macOS 用户: 建议使用 Homebrew 安装：
brew install sqlite -
Ubuntu/Debian 用户: 请执行：
sudo apt install sqlite3 libsqlite3-dev -
Windows 用户:
-
访问 SQLite 官方网站下载页面。
-
在 “Precompiled Binaries for Windows” 部分，下载
sqlite-tools-win-x64-*.zip文件（适用于 64 位系统）。 -
将压缩包解压至例如
C:\sqlite的目录。 -
将此目录（如
C:\sqlite）添加到系统的Path环境变量中。 -
重启终端后，运行
sqlite3 --version验证安装。
-
第四步：验证 QMD 工具安装状态
在终端中依次执行以下命令，以确认 QMD 已正确安装并可用：
bash
qmd --version
qmd --help
正常情况将显示版本号和命令帮助信息。若仍遇到“命令未找到”的错误，请重新检查 PATH 环境变量配置，或尝试重启终端及计算机。
第五步：配置 OpenClaw 启用 QMD 后端
-
定位配置文件
-
Linux/macOS 系统：
~/.openclaw/openclaw.json -
Windows 系统：
C:\Users\<你的用户名>\.openclaw\openclaw.json
-
-
编辑配置文件
使用文本编辑器打开上述配置文件，添加以下 JSON 配置以启用 QMD 后端并设置超时：
json
{
"memory": {
"backend": "qmd",
"qmd": {
"limits": {
"timeoutMs": 8000
}
}
}
}提示：此为基础配置。如需配置自动更新、作用域隔离等高级功能，请参考官方文档获取更多参数详情。
第六步：初始化与重启服务
-
（可选）预先初始化 QMD
此步骤可加速 OpenClaw 首次调用记忆时的响应。在终端中执行：
bash
# 假设工作区位于 ~/.openclaw/workspace
cd ~/.openclaw/workspace
qmd update
qmd embed
qmd query "test" -c memory-root --json >/dev/null 2>&1 -
重启 OpenClaw 服务进程
-
对于标准安装的服务：
bash
openclaw gateway restart -
对于 Docker 容器运行的服务：
bash
docker compose restart
-
第七步：验证安装与配置结果
-
检查服务日志
运行
openclaw logs --follow命令查看实时日志。若出现Using QMD memory backend或类似关键词，表明 QMD 后端已成功加载。 -
进行功能测试
向 OpenClaw 提问一个它之前应已获知信息的问题（例如您曾告知的个人偏好）。如果助手能基于记忆给出准确回答，则证明 QMD 记忆后端已完全生效。
侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述
