本文专为技术新手与开发者打造，从环境准备、分系统安装、核心配置、首次运行、问题排查五大维度，带你一步步从零搭建私人 AI 执行助理，全程无复杂操作，跟着做就能成功！

一、环境准备：硬件与依赖全梳理

先确认你的设备满足最低条件，避免踩坑：

1.1 硬件要求

• CPU：i5 / R5 及以上（多核更好）
• 内存：≥4GB（推荐 8GB+，运行更流畅）
• 存储：剩余空间 ≥5GB

1.2 软件依赖

• Node.js ≥ v22.14+（推荐 v24）docs.openclaw.ai

• Git（源码安装需要）

• curl / PowerShell（执行一键脚本）

二、三种安装方式

OpenClaw 提供三种安装路径，按你的需求选择：

2.1 一键脚本安装（官方推荐，3 分钟搞定）

适合：新手、不想折腾、要最快部署

1. Windows（PowerShell 管理员）

1. 右键开始菜单 → 打开 Windows PowerShell (管理员) / 终端 (管理员)
2. （可选，解决权限问题）先执行：

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
   

3. 执行一键安装（国内网络可用镜像）：

   # 官方原版
   iwr -useb https://openclaw.ai/install.ps1 | iex
   
   # 国内镜像（网络差推荐）
   iwr -useb https://gitee.com/openclaw/install/raw/main/install.ps1 | iex
   

2. macOS / Linux / WSL2

打开终端，直接运行：

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

# 国内镜像
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

脚本会自动：

• 检测并安装 Node.js
• 全局安装 OpenClaw
• 自动启动初始化引导（onboard）docs.openclaw.ai

2.2 npm 全局安装

适合：已装 Node、想手动控制版本

1. 确认 Node 版本：

   node --version  # 必须 ≥v22.14.0
   

2. （可选）切换国内 npm 镜像（加速）：

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

3. 全局安装：

   npm install -g openclaw@latest
   

2.3 源码安装

适合：想改代码、参与开发、自定义编。本篇博客面向新手，源码安装可自行参考网上教程。

三、安装验证

安装完成后，在终端输入：

openclaw --version
# 或简写
openclaw -v

出现版本号（如 v2026.3.8）即安装成功。

四、初始化配置

安装成功后，脚本会自动进入 onboard 初始化向导；若没自动启动，手动运行：

openclaw onboard

跟着终端提示一步步配置（新手推荐 Quick Start）：

1. 风险提示：输入 yes 确认
2. 模式选择：quick start
3. 填入你的 LLM API Key（如 OpenAI、DeepSeek、通义千问等）
4. 连接通讯平台（如 Slack、Discord）：新手可 skip for now
5. 开启 Skills（插件）：新手选 no 或 skip
6. 完成后，服务自动启动

五、启动与访问 Web 面板

配置完成后，OpenClaw 默认在 18789 端口启动 Web 管理界面。

• 启动服务（如未自动启动）：

  openclaw start
  

• 停止服务：

  openclaw stop
  

• 浏览器访问：

  http://localhost:18789
  

进入后就能看到 OpenClaw 控制台，开始用自然语言指挥你的 AI 助理了。

六、常见问题与避坑

1. Windows 权限报错

   • 务必用 管理员身份 运行 PowerShell
   • 先执行 Set-ExecutionPolicy RemoteSigned ... 解锁策略

2. Node 版本过低 / 安装失败

   升级Nodejs或重新官网下载安装

3. 国内网络下载超时

   一律用国内镜像脚本 /npm 镜像

4. sharp 模块编译失败（macOS 常见）

   SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
   ```{insert\_element\_4\_}
   

5. 端口 18789 被占用

   # 修改端口
   openclaw config set gateway.port 18789
   openclaw restart
   

---

七、下一步：让 OpenClaw 真正干活

安装完成只是开始，你可以：

• 接入更多模型（Claude、Gemini、本地 Ollama 等）
• 开启官方 / 社区 Skills（文件管理、浏览器、代码执行、邮件等）
• 接入微信、钉钉、Slack 等平台，让 AI 在聊天里帮你办事

---

八、总结

OpenClaw 把 “只能聊天” 的 AI，变成了 “能干活” 的本地私人助理。安装非常友好 ——新手用一键脚本，3 分钟就能跑起来；有经验的用户可以 npm 或源码定制。

核心亮点：

• ✅ 完全开源、本地运行、数据隐私
• ✅ 跨平台（Windows/macOS/Linux）
• ✅ 支持几乎所有主流大模型
• ✅ 真正能操作文件、执行命令、调用工具

现在就动手装一个，体验 “AI 替你干活” 的快乐吧！