大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



🤵‍♂️ 个人主页：小李同学_LSH的主页

目录

1. 系统要求（必看）

最低配置

软件要求

2. Windows 安装（PowerShell 管理员）

2.1 准备：解锁脚本权限（必须）

2.2 一键安装（推荐，自动装 Node+OpenClaw）

2.3 验证安装

2.4 初始化配置（onboarding）

2.5 启动服务

2.6 访问面板

3. Ubuntu 安装（20.04/22.04）

3.1 一键安装（推荐）

3.2 手动 npm 安装（已装 Node22+）

4. macOS 安装（12+）

4.1 一键安装

4.2 brew 装 Node（可选）

4.3 初始化 + 启动

5. Docker 部署（环境隔离，生产推荐）

5.1 安装 Docker

5.2 一键部署

5.3 访问

6. 源码编译安装（开发者 / 自定义）

7. 常用命令

8. 常见问题与解决

8.1 Windows：命令找不到（PATH 问题）

8.2 安装慢 / 超时

8.3 Node 版本不对

8.4 端口 3000 被占用

---

> 适合：AI 网关、大模型代理、私有化部署、ChatGPT 转发、企业级 AI 中台、个人AI助手搭建

> 系统：Windows10/11、Ubuntu20.04/22.04、macOS12+、WSL2（Windows 最优部署方案）

> 内容：系统配置对比、一键脚本安装、npm手动安装、Docker隔离部署、源码编译、初始化配置、常用命令、常见坑与解决方案（附截图提示）

> 难度：新手友好（一键脚本）→ 进阶（源码编译）→ 生产级（Docker+守护进程）

OpenClaw 作为近期爆火的开源个人 AI 助手，核心优势是“可运行在个人设备、支持多渠道交互（WhatsApp、Telegram等）、可接管邮箱、日历、值机等实操任务”，无需复杂配置即可快速搭建属于自己的私有化 AI 服务。

本文针对不同系统（Windows、Ubuntu、macOS），提供 4种安装方式，补充详细表格对比、分步命令注释、实操截图提示，解决新手安装中“命令报错、环境不兼容、启动失败”等核心问题，全程可复制粘贴，零基础也能顺利完成部署。

最低配置

• CPU：2 核
• 内存：4GB（生产建议 8GB+）
• 磁盘：20GB+
• 网络：能访问外网（下载依赖 + 调用模型）

软件要求

• Node.js：22.16+ / 24（推荐）docs.openclaw.ai
• 系统：Windows10/11、Ubuntu18.04+、macOS12+、WSL2（Windows 推荐）

无论哪种安装方式，都需要满足以下软件依赖，避免出现“依赖缺失”报错：

以管理员身份打开 PowerShell（Win+X → 选 PowerShell (管理员)）：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

国内慢 / 超时：换镜像

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

等待 3~8 分钟，自动完成 Node 安装、OpenClaw 全局部署。

powershell -c "irm https://openclaw.ai/install.ps1 | iex"

输出版本号即成功。

openclaw onboard --flow quickstart

按提示：

1. 风险提示：yes
2. 安装模式：quick start
3. 模型选择：选「千问」（免费额度，新手友好）
4. 浏览器自动跳转登录授权，完成后终端继续
5. 其他：skip 跳过，后续面板可改

openclaw start

看到 Gateway started successfully 即成功。

浏览器打开：

http://localhost:3000

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

脚本自动安装 Node.js 22+、依赖、OpenClaw。

sudo apt update && sudo apt install -y curl git build-essential curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs npm install -g openclaw@latest

bash运行

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

bash运行

brew install node@22 npm install -g openclaw 

bash运行

openclaw onboard openclaw start

bash

运行

# Ubuntu sudo apt install -y docker.io docker-compose sudo systemctl enable docker && sudo systemctl start docker 

bash运行

mkdir -p ~/openclaw && cd ~/openclaw git clone https://github.com/openclaw/openclaw.git . ./docker-setup.sh 

自动构建镜像、生成令牌、启动服务。

plaintext

http://localhost:3000 

---

bash运行

# 克隆 git clone https://github.com/openclaw/openclaw.git cd openclaw

安装依赖（需 pnpm）

npm install -g pnpm pnpm install

构建

pnpm ui:build pnpm build

链接全局

pnpm link –global

初始化

openclaw onboard –install-daemon

---

bash运行

# 启动 openclaw start

停止

openclaw stop

重启

openclaw gateway restart

查看版本

openclaw –version

重新配置

openclaw onboard

---

• 重装后新开 PowerShell
• 检查路径：where openclaw
• 手动加环境变量：C:Users你的用户名AppDataRoaming pm

• 换国内镜像：
  • Windows：iwr -useb https://clawd.org.cn/install.ps1 | iex
  • Linux/macOS：curl -fsSL https://openclaw.ai/install.sh | bash -s -- --registry https://registry.npmmirror.com

• 用 nvm 管理版本：

bash运行

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

• 改端口：openclaw config set port 3001
• 重启：openclaw restart

OpenClaw 作为轻量、高效的开源个人 AI 助手，安装流程简单，支持多系统、多安装方式，新手可通过一键脚本5分钟完成部署，开发者可通过源码编译自定义功能。

---

本文涵盖了 Windows、Ubuntu、macOS 三大系统的完整安装流程，新增了多类对比表格、详细命令注释、常见坑解决方案，全程可复制粘贴，确保零基础也能顺利完成安装。

安装完成后，可在web面板中配置模型、绑定聊天渠道（WhatsApp、Telegram等），实现“清邮箱、发邮件、管日历、值机”等实操功能，真正打造属于自己的个人 AI 助手。