核心问题：没有npm配置环境变量！！下面是将npm全局包的安装路径配置到系统的环境变量 PATH的步骤。

openclaw 安装成功了，但终端找不到这个命令。这几乎总是因为 npm 全局包的安装路径没有被添加到系统的环境变量 PATH 中。

可以按下面的步骤来定位和修复。

1. 快速诊断：检查安装路径是否在 PATH 中

在终端依次运行下面三行命令，看一下输出结果：

# 1. 查看 npm 全局包的安装位置
npm prefix -g

# 2. 查看当前系统的 PATH 环境变量
echo "$PATH"

# 3. 查看 openclaw 被安装到了哪里（如果存在）
which openclaw

如何判断？
如果第一行命令返回的路径（例如 /home/yao/.npm-global）后面加上 /bin （即 /home/yao/.npm-global/bin）没有出现在第二行命令的输出中，问题就找到了。这就是环境变量缺失导致的。

2. 解决方案：将 npm 的 bin 目录添加到 PATH

第一步：编辑 shell 配置文件

根据你使用的 shell，用编辑器打开对应的文件。大概率用的是 bash。

# 如果是 bash 用户，编辑 ~/.bashrc
nano ~/.bashrc

# 如果是 zsh 用户，编辑 ~/.zshrc
# nano ~/.zshrc

第二步：添加环境变量

在文件末尾，加上下面这行。记得把 /home/yao/.npm-global 替换成你第一步用 npm prefix -g 查到的实际路径。

export PATH="/home/yao/.npm-global/bin:$PATH"

保存文件后退出（在 nano 里是按 Ctrl+X，然后按 Y 确认）。

第三步：让配置生效

直接关闭当前终端，再重新打开一个新终端，这是最稳妥的方法。或者，也可以在当前终端运行下面的命令来临时生效：

source ~/.bashrc

最后，再运行 openclaw --version 或 openclaw onboard --install-daemon，应该就可以正常使用了。