【OpenClaw】安装遇到问题记录

解决NPM全局安装命令无法识别的问题

在Linux环境下使用NPM全局安装工具时，不少人都会遇到一个典型问题：明明安装成功了，系统却提示“命令未找到”。这种情况通常是因为系统环境变量没有正确配置导致的。下面我们就来完整梳理一下这个问题的排查和解决流程。

PATH未配置

安装完OpenClaw后直接运行命令，系统返回“command not found”的错误。这其实是个明确的信号：系统在当前配置的PATH路径中找不到这个可执行文件。

启动失败

尝试执行openclaw命令时系统无法识别，这意味着我们需要手动定位这个文件到底被安装到了哪里。

解决

解决问题的关键在于找到正确的安装路径并将其添加到系统PATH中。具体操作步骤如下：

# 查询openclaw启动文件位置
ls /home/another/.npm-global/bin/openclaw

echo $SHELL

# 编辑配置文件（以 bash 为例）
echo 'export PATH="/home/another/.npm-global/bin:$PATH"' >> ~/.bashrc

source ~/.bashrc

# 验证
which openclaw

这个流程的核心思路很简单：先确认可执行文件的实际位置，然后将其所在目录添加到环境变量中。需要注意的是，不同的shell配置文件会有所不同——如果是bash就编辑.bashrc，如果是zsh则需要编辑.zshrc。完成配置后，记得使用source命令使更改立即生效，最后通过which命令验证配置是否成功。

说到底，这类问题的根源在于NPM全局安装的默认路径可能不在系统的标准PATH中。按照这个步骤操作一遍，基本上就能彻底解决这个问题了。

来源：互联网