armbian 安装openclaw
安装 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
注意事项
这些命令适用于基于 Debian/Ubuntu 的 Linux 发行版
需要使用 sudo 权限或 root 用户执行-y参数自动确认所有提示
安装完成后建议运行apt upgrade -y更新所有已安装软件包
安装 OpenClaw 的注意事项
执行该命令前需确认系统环境是否满足要求。该命令涉及全局安装且包含高风险权限参数，可能对系统安全产生影响。
命令参数解析npm i -g openclaw@2026.3.13表示全局安装指定版本的 OpenClaw 包。@2026.3.13指定了版本号，确保安装特定版本而非最新版。--registry=https://registry.npmmirror.com指定使用镜像源进行安装。该镜像源为国内常用的 npm 镜像，可加速安装过程。--unsafe-perm参数允许在非特权账户下执行安装脚本。该参数会降低安全性限制，可能允许恶意脚本执行。--allow-root参数允许 root 用户执行安装。在 Docker 容器或某些 CI/CD 环境中可能需要此参数。
安全建议
全局安装需谨慎，建议先检查包来源可靠性。可通过官方文档或 GitHub 仓库验证 openclaw 的合法性。
考虑使用npm audit检查包的安全性漏洞。
高风险参数组合可能使系统暴露于潜在威胁中。
替代方案
如需更安全的安装方式，可尝试：
创建隔离的 Docker 环境进行安装测试
使用npx openclaw@2026.3.13临时运行而不全局安装
配置.npmrc文件永久设置镜像源而非命令行参数
故障排查
安装失败时可尝试：
清除 npm 缓存npm cache clean --force
检查网络连接是否可访问镜像源
验证 Node.js 和 npm 版本是否满足包要求
解决 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
注意等号两边不能有空格，且整个变量声明需紧接在命令前。
方法三：修改 package.json（适用于 npm/yarn 项目）
若 OpenClaw 通过 npm scripts 启动，可在 package.json 中修改启动脚本："scripts": { "onboard": "NODE_OPTIONS='--max-old-space-size=2048' openclaw onboard" }
然后通过npm run onboard执行。
注意事项
2048MB（2GB）内存限制可能偏小
Windows 系统需使用set命令代替export：set NODE_OPTIONS=--max-old-space-size=2048 && openclaw onboard