乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > OpenClaw 爆火!保姆级安装 + 使用心得,新手零失败

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

当前时间： 2026-08-12 06:20:58 分类：办公文件 评论(0)
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 的快乐，谁用谁知道！有问题评论区留言，我一一解答～