普通用户安装OpenClaw注意事项

目前很火的OpenClaw，笔者在周末花了一天的时间摸索，终于可以使用了，为了普通用户更好的安装，特意编写了这个注意事项，希望能对大家有帮助。如果出现了下面的图片，安装就成功了！

安装一、安全前置提醒（必看）

国家网安中心建议：普通用户不要在日常办公电脑上安装OpenClaw。

推荐安装环境：专用设备 / 虚拟机 / 隔离环境（避免影响日常办公数据安全）。

二、系统与环境要求（必满足）

2.1 Node.js版本要求

需安装 Node.js ≥ 22.0.0（推荐版本：22 LTS 或 24 版本）

版本检查方法：打开终端（Windows：PowerShell；macOS/Linux：终端），输入命令 node --version，查看输出版本是否符合要求。

2.2 系统要求

操作系统：Windows 10及以上 / macOS 12及以上 / Linux（推荐Ubuntu 20.04及以上）
内存：≥ 2GB（推荐 4GB及以上，确保运行流畅）
硬盘：≥ 500MB 剩余空间（用于安装程序及相关依赖）

2.3 安装路径禁忌

安装路径严禁包含中文、空格、特殊符号（如！、@、#、中文文件夹名等），否则会导致安装失败或无法正常启动。

推荐路径：

Windows：C:\openclaw
macOS/Linux：~/openclaw

三、Windows系统安装注意事项

以管理员身份运行终端：找到PowerShell，右键点击，选择“以管理员身份运行”（必须管理员权限，否则会出现权限不足错误）。
修改执行策略：在PowerShell中输入以下命令，按回车后输入Y确认，允许执行本地脚本。 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
执行官方安装命令：复制以下命令到PowerShell中，按回车执行，等待安装完成（过程中不要关闭终端）。 iwr -useb https://openclaw.ai/install.ps1 | iex

四、macOS / Linux系统安装注意事项

4.1 权限问题（最常见坑点）

严禁直接使用 sudo npm install 命令安装（存在安全风险，可能导致系统权限异常）。

推荐操作：配置用户级npm目录，步骤如下（复制命令逐行执行）： mkdir ~/.npm-globalnpm config set prefix '~/.npm-global'echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc # macOS系统执行此句# echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc # Linux系统执行此句（注释可删除）source ~/.zshrc # macOS系统执行此句# source ~/.bashrc # Linux系统执行此句（注释可删除）

4.2 执行官方安装命令

配置完权限后，复制以下命令到终端，按回车执行，等待安装完成： curl -fsSL https://openclaw.ai/install.sh | bash

五、通用避坑要点（所有系统适用）

5.1 网络问题（国内用户必做）

国内网络访问npm官方源可能较慢，甚至导致安装失败，建议切换淘宝镜像，命令如下： npm config set registry https://registry.npmmirror.com

5.2 端口占用问题

OpenClaw默认占用端口 18789，若端口被其他程序占用，会导致无法启动，解决方法如下：

查看端口占用情况： # macOS/Linux系统lsof -i :18789# Windows系统netstat -ano | findstr :18789
更换端口启动：若端口被占用，可使用以下命令指定新端口（示例端口18790，可自行替换）： openclaw gateway --port 18790

5.3 版本不稳定问题

部分新版本（如3.22版）可能存在UI无法打开的问题，建议回滚至稳定版本，操作命令如下： npm uninstall -g openclaw # 卸载当前版本npm install -g openclaw@2026.2.25 # 安装稳定版本

5.4 “openclaw命令找不到”问题

若安装完成后，输入openclaw命令提示“找不到命令”，可按以下步骤排查：

重新检查Node.js版本，确保版本≥22.0.0；
重新安装OpenClaw：npm install -g openclaw@latest；
检查环境变量配置（参考对应系统的权限配置步骤，确保npm路径已添加到系统环境变量）。

六、安装后验证（必做）

安装完成后，在终端输入以下命令，验证是否安装成功：

openclaw --version  # 查看版本，确认安装成功openclaw gateway start  # 启动OpenClaw服务

启动成功后，打开浏览器，访问 http://localhost:18789（若更换了端口，将18789替换为新端口），能正常打开页面即表示安装成功。

七、安全与使用建议

日常运行OpenClaw时，不要使用管理员/root权限（避免误操作影响系统安全）；
不要将隐私文件、工作文件存放在OpenClaw安装目录下，防止数据泄露或被误删；
定期更新OpenClaw版本，修复已知漏洞，命令：npm update -g openclaw；
若长时间不使用，建议关闭OpenClaw服务，命令：openclaw gateway stop。