Debian安装openclaw
安装npm
要顺利安装和配置npm环境，通常有两种主流路径可选。考虑到国内网络环境，我们先介绍利用镜像加速的方案，确保过程流畅。
1. 安装 nvm（使用国内镜像加速）
第一步是更新系统包并安装必要工具，然后通过国内镜像源来安装Node版本管理器nvm。
sudo apt update
sudo apt install --reinstall ca-certificates git
设置好Node.js的国内镜像源后，就可以通过官方脚本安装nvm了。
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node/
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
2. 加载 nvm
安装完成后，需要让系统识别nvm命令。执行以下命令加载配置文件。
source ~/.bashrc
如果你使用的是Zsh，相应的命令是 source ~/.zshrc。
3. 验证 nvm 安装
加载完毕，敲入下面这个命令。如果终端能正确返回nvm的版本号，说明安装成功了。
nvm --version
4. 安装 Node.js 22 LTS（满足 Agent Reach 和 OpenClaw 要求）
接下来安装项目所需的Node.js 22长期支持版，并将其设置为默认版本。
nvm install 22
nvm use 22
nvm alias default 22
5. 验证安装
最后，分别检查Node.js和npm的版本，确认一切就绪。
node --version # 终端应显示类似 v22.x.x 的版本号
npm --version # 这里会显示npm的对应版本
-----------------------
或：使用npm和n工具安装
如果你更习惯直接用npm，也可以走这条路线。首先，为了提升下载速度，建议将npm的注册表源切换到国内镜像。
1. 设置 npm 镜像源
npm config set registry https://mirrors.cloud.tencent.com/npm/
2. 验证是否设置成功
执行查询命令，确认镜像源已更换。
npm config get registry
终端输出应为：https://registry.npmmirror.com
3. 安装 n 版本管理工具（现在会很快）
全局安装轻量的Node版本管理工具n。
npm install -g n
4. 安装 Node.js 22
使用n工具安装指定版本的Node.js。
n 22
5. 验证版本
同样，安装完成后别忘了验证一下。
node --version
npm --version
6.安装openclaw
环境准备好之后，就可以安装OpenClaw命令行工具了。
npm i -g openclaw
安装成功后，运行初始化命令来配置工作区。
openclaw onboard
————————————
或：备用安装方案
如果上述方法遇到问题，可以尝试这个更彻底的方案。首先是清理可能存在的旧安装或损坏文件。
1. First, clean up the broken installation
npm uninstall -g openclaw 2>/dev/null
rm -rf /root/.nvm/versions/node/v22.22.1/lib/node_modules/openclaw
2. Clear npm cache
清理npm缓存，避免旧数据干扰。
npm cache clean --force
3. Use the official installer (recommended method)
最后，使用官方提供的一键安装脚本，这通常是最稳妥的方式。
curl -fsSL https://openclaw.ai/install.sh | bash
启动网关看UI
一切安装配置妥当后，可以通过运行网关服务来访问其用户界面。
openclaw gateway
服务启动后，相关工作文件会存放在例如以下的目录中：
/vol1/1000/workspace/.openclaw/workspace
你可能会在终端看到服务监听的端口号：
18789
20000