OpenClaw 爆火!保姆级安装 + 使用心得,新手零失败

最近 OpenClaw 直接刷屏，本地跑 AI、不用服务器、速度还快，谁用谁香！我折腾了好几天，踩了 N 个坑，整理了这份超全安装使用心得，步骤细，新手照着做就能搞定👇

一、先搞懂：OpenClaw 到底香在哪？

简单说，它就是本地 AI 运行神器，不用连云端、数据全在自己电脑里，隐私拉满！

能跑各种大模型，聊天、写代码、做总结全能打
启动快、响应稳，比在线 AI 少了网络延迟
免费开源，配置灵活，新手老手都能玩

二、安装前必看：3 个关键准备（避坑第一步）

1. 系统要求（别白忙活！）

Windows：Win10/11 64 位，优先用 WSL2（官方推荐，最稳）
macOS：12 及以上，Intel/M 芯片都支持
Linux：主流发行版（Ubuntu、CentOS 等）
核心：Node.js 必须≥22 版本，低了直接装失败

2. 工具提前装（少走弯路）

Windows：管理员权限 PowerShell、Git（装了更稳）
macOS/Linux：终端、Git、Xcode 命令行工具（macOS）
国内用户：提前换 npm 镜像源，不然安装慢到崩溃！

npm config set registry https://registry.npmmirror.com

3. 权限很重要！

Windows 全程用管理员身份开终端，macOS/Linux 必要时加 sudo，不然权限报错能卡你半小时。

三、全平台安装：3 种方法，新手选第一种！

方法 1：官方一键脚本（推荐！零配置）

Windows（PowerShell 管理员）

1.先开执行策略（首次必做）

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认。

2.执行一键安装

iwr -useb https://openclaw.ai/install.ps1 | iex

国内慢就用镜像：

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

macOS/Linux

curl -fsSL https://openclaw.ai/install.sh | bash

脚本会自动装 Node、配环境，坐等完成就行！

方法 2：npm 安装（适合会点命令的）

1.先装 Node.js 22+（用 nvm 管理更方便）

# 安装nvm（macOS/Linux）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash# 装Node22nvm install 22nvm use 22

2.全局装 OpenClaw

npm install -g openclaw@latest

方法 3：WSL2 安装（Windows 最稳方案）

1.管理员 PowerShell 装 WSL2

wsl --install

重启电脑。

2.打开 Ubuntu，更新系统

sudo apt update && sudo apt upgrade -y

3.用一键脚本安装，和 Linux 步骤一样。

四、安装后初始化：5 分钟搞定，直接用！

1.初始化配置（自动引导，超简单）

openclaw onboard

跟着提示选：模型存储路径、端口（默认 18789）、是否开机自启。

2.安装网关服务（后台运行，不占终端）

openclaw gateway install

Windows 必须管理员，不然会报 schtasks 错误！

3.启动网关

openclaw gateway start

4.打开控制面板（可视化操作，新手福音）

openclaw dashboard

浏览器自动打开 http://127.0.0.1:18789，界面超清爽。

五、核心使用：3 个常用操作，玩转 OpenClaw

1.下载模型（本地 AI 的灵魂）

控制面板点「模型」→「添加模型」，支持 Hugging Face、本地模型文件
新手推荐：Llama 3、Qwen 7B，轻量又好用
命令行下载（更快）

openclaw model pull llama3:8b

2.启动对话（直接用！）

控制面板点「聊天」，选已下载的模型，输入问题就能聊
命令行对话（适合终端党）

openclaw chat --model llama3:8b

3.后台管理（省心）

查看状态：openclaw gateway status
重启网关：openclaw gateway restart
停止服务：openclaw gateway stop

六、我踩过的坑：10 大常见问题 + 秒解方案

1.安装失败：npm ERR! ENOTFOUND

原因：网络 / 源问题、Node 版本低
解决：换国内源、清缓存、升级 Node22+

npm cache clean --forcenpm config set registry https://registry.npmmirror.comnpm install -g openclaw@latest

2.Windows：Gateway install failed（schtasks 错误）

原因：没开管理员权限
解决：关闭终端，右键 PowerShell 选「以管理员身份运行」，重新执行安装

3.端口 18789 被占用

解决：杀进程或换端口

# Windowsnetstat -ano | findstr :18789taskkill /F /PID 进程号# 换端口openclaw config set gateway.port 18790openclaw gateway restart

4.命令找不到：openclaw: command not found

原因：环境变量没配好
解决：重新安装，或手动加路径到 PATH

5.编译失败（红色报错，提 gcc/clang）

原因：缺 C++ 编译工具
解决：

Windows：装 VS Build Tools，勾 C++ 生成工具
macOS：xcode-select --install
Linux：sudo apt install build-essential

6.权限不足：EACCES

Windows：管理员终端
macOS/Linux：sudo npm install -g openclaw，或配置 npm 全局目录

7.路径含中文 / 空格报错

解决：模型、安装路径全用英文，别放中文文件夹里。

8.网关启动后 RPC probe failed

解决：重启网关、查日志（%AppData%\Local\Temp\openclaw\）、检查端口是否通。

9.模型下载慢 / 失败

解决：换国内模型源、用命令行下载、检查网络。

10.控制面板打不开

解决：确认网关在运行、换浏览器、清缓存

七、使用心得：新手必学的 3 个小技巧

模型选轻量版：7B/8B 参数足够日常用，13B 及以上对电脑配置要求高
后台运行更省心：网关装成服务，开机自启，不用每次开终端
定期更新：npm update -g openclaw，新版本修复超多 bug

八、总结

OpenClaw 真的是本地 AI 的宝藏工具，安装没想象中难，照着步骤来，新手也能快速上手！重点就是管理员权限、Node22+、国内源、避中文路径，这几点搞定，基本不会踩坑。

赶紧动手装一个，本地跑 AI 的快乐，谁用谁知道！有问题评论区留言，我一一解答～