安装 Node.js 22.x 版本
更新系统软件包列表以确保获取最新的软件信息
apt update -y
下载并运行 NodeSource 的安装脚本,该脚本会自动配置 apt 源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
安装 Node.js 和 npm(包含在 Node.js 安装包中)
apt install -y nodejs
#检查 Node.js 版本 node -v #检查 npm 版本 npm -v
安装 OpenClaw 全局包
执行以下命令以全局安装 OpenClaw 的指定版本(2026.3.13),使用 npmmirror 镜像源,并启用必要的权限参数:
npm i -g openclaw@2026.3.13 --registry=https://registry.npmmirror.com --unsafe-perm --allow-root
参数说明
-g:全局安装,使包在系统范围内可用。openclaw@2026.3.13:指定安装的包名及版本号。--registry=https://registry.npmmirror.com:使用 npmmirror 镜像源加速下载。--unsafe-perm:允许在 root 用户下运行脚本(可能涉及文件系统权限操作)。--allow-root:明确允许以 root 用户身份安装(避免权限警告)。
注意事项
- 需提前安装 Node.js 和 npm 环境。
- 若安装失败,检查网络连接或尝试清除 npm 缓存后重试:
npm cache clean --force --unsafe-perm和--allow-root通常用于 Docker 或受限环境,日常开发中可能无需使用。
解决 NODE_OPTIONS 环境变量与 OpenClaw 启动问题
在命令行中直接使用 NODE_OPTIONS="--max-old-space-size=2048" openclaw onboard 可能导致环境变量未正确传递给应用。以下是正确的解决方法:
方法一:通过 export 设置环境变量
export NODE_OPTIONS="--max-old-space-size=2048" openclaw onboard
方法二:单条命令中设置环境变量
NODE_OPTIONS="--max-old-space-size=2048" openclaw onboard
"scripts": { "onboard": "NODE_OPTIONS='--max-old-space-size=2048' openclaw onboard" }
set NODE_OPTIONS=--max-old-space-size=2048 && openclaw onboard
安装微信插件步骤
执行以下命令安装微信插件:
openclaw plugins install "@tencent-weixin/openclaw-weixin@compat-host-gte2026.3.0-lt2026.3.22"
重新绑定微信二维码
openclaw channels login --channel openclaw-weixin
确保Node.js环境已安装,版本需符合插件要求。安装完成后,重启应用使插件生效。
版本兼容性说明
插件版本@tencent-weixin/openclaw-weixin@compat-host-gte2026.3.0-lt2026.3.22要求宿主环境版本:
- 大于等于2026.3.0
- 小于2026.3.22
常见问题排查
安装失败时检查网络连接和npm源设置。权限问题可尝试使用管理员权限或添加–unsafe-perm参数。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/262224.html