一、安装前准备

1. 确认 Node.js 版本 ≥ 22（OpenClaw 运行必备），已安装则跳过；未安装需先安装 Node.js。
2. 切换国内 npm 镜像，避免下载超时：

• 卸载旧版：npm uninstall -g openclaw
• 清理缓存：npm cache clean --force

1. 安装后提示“command not found”

• 原因：npm 全局 bin 目录未加入系统 PATH
• 解决：重启终端，重新执行初始化命令；或手动将 npm 全局 bin 目录加入系统 PATH。

2. 网关启动失败/端口 18789 被占用

• 原因：端口冲突、防火墙拦截
• 解决：

1. 查看端口占用：Windows 用 netstat -ano | findstr :18789；macOS 用 lsof -i :18789
2. 杀死占用进程，或更换端口：openclaw config set gateway.port 18790
3. 放行防火墙，重启网关：openclaw gateway restart

 四、安装成功后：快速上手 3 步走

1. 验证安装：openclaw --version（显示 2026.3.11 即成功）
2. 启动网关：openclaw gateway start
3. 访问面板：浏览器打开 http://localhost:18789，开始使用 OpenClaw。