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