OpenClaw 踩坑实录:更新出 bug 怎么办?OpenClaw最新一键安装教程

# 卸载全局包 

npm uninstall -g openclaw  

# 删除残留文件（想保留配置请注释掉最后一行） 

sudo rm -rf /usr/local/lib/node_modules/openclaw 

# rm -rf ~/.openclaw  # 慎用！会删除你的所有配置

openclaw uninstall

openclaw --version 

# 提示 command not found 就是卸载干净了

curl -fsSL https://gitee.com/openclaw-io/openclaw/raw/main/install.sh | bash

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh | bash -s -- --version 2026.3.25

openclaw --version

OpenClaw 2026.3.25 (xxxxxxxx)

wsl --install

# 和 Linux 一键安装命令相同 

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh | bash

curl -fsSL https://gitee.com/openclaw-io/openclaw/raw/main/install.sh | bash

openclaw --version

提示：WSL2 里的 OpenClaw 可以直接通过 Windows 浏览器访问控制 UI，端口默认 10636，直接访问 http://localhost:10636 即可。

openclaw gateway enable-systemd

sudo openclaw gateway enable-launchd

症状

curl 下载一直卡住，或者说 443 连接超时

原因

网络问题无法访问 GitHub

解决

使用国内 Gitee 镜像安装：

curl -fsSL https://gitee.com/openclaw-io/openclaw/raw/main/install.sh | bash

症状

npm 安装时报 EACCES: permission denied

解决

脚本会自动处理大多数权限问题，如果还是错，执行：

sudo chown -R $(whoami) /usr/local/lib/node_modules sudo chown -R $(whoami) /usr/local/bin

症状

EADDRINUSE: address already in use

原因

10636 端口被占了

# 编辑配置文件 

nano ~/.openclaw/config.json

{

   "gateway": {

     "port": 10637

   }

 }

openclaw gateway restart

症状

安装时报 engine: node: >=22.14.0 错误

原因

你的 Node.js 版本太旧

解决

一键安装脚本会自动帮你安装符合要求的 Node.js，如果手动安装遇到这个问题，使用 nvm 升级：

# 如果用 

nvm nvm install 22 

nvm use 22

export OPENCLAW_PREFIX=/your/custom/path curl -fsSL ... | bash