安装memos-local-openclaw-plugin的分步指南

作者：技术拾光

时间：2026-05-08

在Windows上安装memos-local-openclaw-plugin：一份避坑指南如果你正在Windows环境下尝试为OpenClaw安装本地记忆插件，那么你来对地方了。这份指南将手把手带你完成整个安装流程，特别是那个在Windows上有点“脾气”的关键依赖项——better-sqlite

文章目录

在Windows上安装memos-local-openclaw-plugin：一份避坑指南

如果你正在Windows环境下尝试为OpenClaw安装本地记忆插件，那么你来对地方了。这份指南将手把手带你完成整个安装流程，特别是那个在Windows上有点“脾气”的关键依赖项——better-sqlite3的编译。别担心，只要跟着步骤走，大部分问题都能迎刃而解。

重要提醒
此插件依赖 better-sqlite3，在 Windows 上需要编译原生模块，可能会遇到一些环境问题。请严格按照以下步骤操作。

1. 环境检查

工欲善其事，必先利其器。动手之前，先确认你的装备是否齐全：

Node.js：版本需要 >= 18.0.0。稳妥起见，推荐使用 18.x 或 20.x 这些长期支持（LTS）版本。
OpenClaw：确保版本在 >= 2026.2.0 或以上。
操作系统：Windows 10 或 11 的 64 位系统。

打开你的终端（CMD或PowerShell），运行以下命令验证一下：

node -v
openclaw --version

如果系统提示找不到 openclaw 命令，那说明你需要先把OpenClaw的安装目录添加到系统的环境变量 PATH 里。这是第一步，也是很多新手容易卡住的地方。

2. 准备编译环境 (关键步骤)

接下来是重头戏，为编译 better-sqlite3 这个原生模块铺平道路。Windows平台在这方面需要一些额外的工具链。

以管理员身份打开终端
这一步很重要！在开始菜单搜索“cmd”或“PowerShell”，右键点击它，然后选择“以管理员身份运行”。后续的安装操作需要这个权限。
安装 node-gyp
这是Node.js用来编译原生模块的构建工具。在刚才打开的管理员终端中输入：
```
npm install -g node-gyp
```
安装 Windows 构建工具
根据你安装的Node.js版本，选择对应的命令：
- Node.js 18 / 20 (推荐)
```
npm install -g --production windows-build-tools
```
- Node.js 16 或更早版本
```
npm install -g --production windows-build-tools@4.0.0
```
配置 Python (如未安装)
如果后续步骤中 node-gyp 抱怨找不到Python，你需要安装 Python 3.9 或 3.10。安装时务必勾选“Add Python to PATH”这个选项。安装完成后，在终端里执行：
```
npm config set python python3
```

3. 安装插件

环境准备好之后，就可以安装插件本体了。这里提供两种方式，任选其一即可。

方式一：使用 NPM 包名安装 (推荐)

这是最简单直接的方法。在终端中依次执行：

# 进入 OpenClaw 插件目录
cd %USERPROFILE%\.openclaw\extensions
# 安装插件
npm install @memtensor/memos-local-openclaw-plugin@latest

方式二：从 GitHub 仓库安装

如果你想从源码安装或指定特定版本，可以这么做：

# 进入 OpenClaw 插件目录
cd %USERPROFILE%\.openclaw\extensions
# 克隆仓库
git clone https://github.com/MemTensor/MemOS-Local-OpenClaw-Plugin.git memos-local-openclaw-plugin
# 进入插件目录
cd memos-local-openclaw-plugin
# 安装依赖
npm install

4. 编译 `better-sqlite3`

插件安装好了，但最关键的步骤现在才开始。编译 better-sqlite3 是整个过程里最容易报错的环节，需要一点耐心。

进入插件目录
确保终端位于插件所在的文件夹：

cd %USERPROFILE%\.openclaw\extensions\memos-local-openclaw-plugin

执行重建命令
运行以下命令，触发针对你当前系统的原生编译：
```
npm rebuild better-sqlite3
```
结果无非两种：
- 成功：命令行会愉快地显示 better-sqlite3@x.x.x 重建成功的字样。
- 失败：如果出现刺眼的红色错误信息，先别慌。常见的罪魁祸首包括Python版本不对、构建工具没装好、或者权限问题。根据错误提示去搜索，或者回到第二步仔细检查环境配置。

5. 重启并验证

编译通过，胜利在望。最后一步是启动并确认一切工作正常。

重启 OpenClaw 网关
让插件生效：
```
openclaw gateway restart
```

检查插件状态
运行状态检查命令：

openclaw status

如果安装成功，你应该能看到类似下面的输出，这表示插件已就绪：

Memory │ enabled (plugin memos-local-openclaw-plugin)
memos-local: initialized (db: C:\Users\Tony\.openclaw\memos-local\memos.db)

检查数据库文件
顺便确认一下数据库文件是否已正确生成在预期路径：
```
C:\Users\Tony\.openclaw\memos-local\memos.db
```

6. 访问记忆管理界面 (可选)

这个插件还贴心地提供了一个Web管理界面，让你能直观地查看和管理AI记住的所有信息。

启动 OpenClaw 网关 (如果尚未运行)
```
openclaw gateway start
```
在浏览器中访问
打开浏览器，输入以下地址：
```
http://127.0.0.1:18799
```
首次访问时，可能会提示你设置一个管理密码，按照页面指示操作即可。登录之后，你就能看到所有的记忆条目，并且可以进行搜索、删除等操作了。

7. 常见问题排查

安装过程难免遇到小波折，这里有几个常见问题的解决思路：

openclaw: command not found
问题很明确：系统找不到OpenClaw命令。解决办法就是将OpenClaw的安装目录完整路径，添加到系统的 PATH 环境变量中。
better-sqlite3 编译失败
这是高发区，可以按顺序排查：
1. 确认整个过程都在管理员终端中进行。
2. 检查Python是否为3.9或3.10版本，并且确定已添加到系统PATH。
3. 确认windows-build-tools已安装成功。
4. 终极大法：在插件目录下，删除 node_modules 文件夹和 package-lock.json 文件，然后重新执行 npm install 和 npm rebuild better-sqlite3。
openclaw status 未显示插件
如果状态列表里没有插件，试试：
1. 去 %USERPROFILE%\.openclaw\extensions\ 目录下，确认插件文件夹的名字是准确的 memos-local-openclaw-plugin。
2. 查看OpenClaw的运行日志，里面通常有加载失败的具体原因：openclaw gateway logs。