本文仅为开源工具个人实操分享，所有工具、模型均来自官方开源渠道，请勿用于商用、违规用途，模型使用请严格遵守对应开源协议，所有操作均为本地环境测试，个人需自行承担操作相关风险。

本文适配 OpenClaw v3.22+ 版本，覆盖 macOS、Windows、Linux 三大系统，提供「一键脚本（新手首选）、npm 安装（版本可控）、源码编译（开发者定制）」三种安装方式，附初始化配置、AO 多 Agent 引擎集成及高频问题解决方案，全程可对照执行。

一、安装前准备（必做！避坑核心）

1.1 系统 & 硬件最低要求

1.2 权限 & 网络准备

⚠️ 关键前提，否则安装必失败：

• Windows：右键打开「PowerShell」→ 选择「以管理员身份运行」
• macOS/Linux：命令前加 sudo 获取系统权限「或以root身份运行」
• 网络：国内用户务必先配置镜像加速（下文各步骤已标注国内镜像命令）

二、三种安装方式（任选其一，新手优先方式 1）

方式 1：一键脚本安装（全自动・零门槛）

自动检测系统、安装 Node.js、部署 OpenClaw 并启动初始化向导，新手直接复制对应命令。

✅ macOS / Linux / WSL2

# 官方脚本（海外/网络好的用户）
curl -fsSL https://openclaw.ai/install.sh | bash

# 国内加速镜像（推荐国内用户，解决超时/失败）
curl -fsSL https://gitee.com/openclaw/install/raw/main/install.sh | bash

✅ Windows（PowerShell・管理员）

# 官方脚本（自动初始化）
iwr -useb https://openclaw.ai/install.ps1 | iex

# 进阶：跳过初始化向导（仅安装程序，后续手动配置）
iwr -useb https://openclaw.ai/install.ps1 | iex -NoOnboard

方式 2：npm 全局安装（版本可控・普通用户）

前提：已手动安装 Node.js ≥v22.14（未安装先看「七、常见问题 7.1」）

# 第一步：检查Node版本（显示≥v22.14.0才继续）
node --version

# 第二步：全局安装OpenClaw（官方源）
npm install -g openclaw@latest

# 国内用户先配置镜像再安装（避免下载失败）
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

方式 3：源码安装（自定义编译・开发者专用）

前提：已安装 Node.js + pnpm + Git（未装 pnpm 先执行第一步）

# 1. 安装pnpm包管理工具（比npm更快）
npm install -g pnpm

# 2. 克隆源码（二选一，国内选Gitee）
git clone https://github.com/openclaw/openclaw.git  # 官方源
git clone https://gitee.com/openclaw/openclaw.git    # 国内镜像

# 3. 进入目录 → 配置国内镜像 → 安装依赖 → 编译构建
cd openclaw
pnpm config set registry https://registry.npmmirror.com  # 国内加速
pnpm install# 安装项目依赖
pnpm run build# 编译源码

# 4. 全局链接（让系统识别openclaw命令）
npm link

三、安装验证（必做！确认安装成功）

执行以下命令，显示版本号（如 v3.22.0）即安装成功，无输出则需排查问题。

# 两种方式均可
openclaw--version
# 或简写
openclaw-v

四、初始化配置（onboard 向导・核心步骤）

安装完成后会自动启动向导，若未启动可手动执行：

openclaw onboard

4.1 向导关键步骤（每一步都要填对）

1. Gateway 网关
   ：默认端口 18789（无需改，除非端口被占用），勾选「启用后台服务」
2. 工作区
   ：默认路径~/.openclaw（直接回车即可）
3. LLM 配置
   ：填入 API Key（支持 Claude、GPT、DeepSeek 等，无 Key 可先跳过，后续补填）
4. 技能安装
   ：务必勾选「Agency Orchestrator（AO）多 Agent 引擎」

4.2 启动 & 验证服务

# 启动网关（后台运行，不占用终端）
openclaw start--daemon

# 查看服务状态（显示running即正常）
openclaw status

# 访问Web UI（安装成功的最终验证）
# 浏览器打开：http://localhost:18789（能看到界面即完成基础配置）

五、集成 Agency Orchestrator（AO）多 Agent 引擎

AO 是 OpenClaw 的核心扩展，用于触发多 Agent 工作流（如内容创作、数据分析），需单独安装配置。

5.1 安装 AO 扩展

# 进入OpenClaw扩展目录（自动创建，无需手动建）
cd ~/.openclaw/extensions

# 克隆AO源码（国内选Gitee镜像）
git clone https://github.com/openclaw/agent-orchestrator.git  # 官方源
# git clone https://gitee.com/openclaw/agent-orchestrator.git  # 国内镜像

# 安装AO依赖
cd agent-orchestrator
npm install

# 注册AO到OpenClaw（关键！否则无法调用）
openclaw extension enable agent-orchestrator

5.2 启动 AO 服务

# 后台启动AO调度器
npx ao start--daemon

# 检查AO状态（显示running即正常，否则看「七、常见问题7.3」）
npx ao status

5.3 注册预设 Agent（触发工作流必需）

需注册以下 Agent 才能运行「内容创作」等预设工作流，复制命令逐一执行：

# 1. 选题规划师（带网页搜索工具）
npx ao register topic-planner claude-3-5-sonnet "选题规划师" --tools web_search

# 2. 研究员（带网页搜索+文档读取工具）
npx ao register researcher claude-3-5-sonnet "研究员" --tools web_search,read

# 3. 撰稿人
npx ao register writer claude-3-5-sonnet "撰稿人"

# 4. 审稿人
npx ao register reviewer claude-3-5-sonnet "审稿人"

# 5. 排版师
npx ao register formatter claude-3-5-sonnet "排版师"

# 查看已注册Agent（确认无遗漏）
npx ao agents list

六、触发 AO 工作流（实际使用）

6.1 自然语言触发（新手推荐）

在 OpenClaw Web UI 聊天框直接发送：

启动AI技术文创作全流程

或简写：

orchestrate 执行内容创作工作流

6.2 斜杠命令触发（精准执行・进阶）

直接运行本地 YAML 模板文件：

/ao run ~/.openclaw/workspaces/ao-content/ai-article-writing.yaml

6.3 查看工作流进度

聊天框会实时输出进度，示例：

[AO] 已启动：AI技术文创作全流程
[AO] Step1/5：topic-planner 正在选题...
[AO] Step5/5：完成！成品：final-article.md

七、常见问题解决（避坑指南）

7.1 Node.js 版本过低

# macOS/Linux 一键安装Node.js 24 LTS
curl -fsSL https://nodejs.org/dist/v24.0.0/node-v24.0.0-linux-x64.tar.xz | tar -xJf - -C /usr/local --strip-components=1

# Windows 用户
# 手动下载安装包：https://nodejs.org/dist/v24.0.0/node-v24.0.0-x64.msi

7.2 权限不足（报错「Permission denied」）

# macOS/Linux：加sudo提升权限
sudo curl -fsSL https://openclaw.ai/install.sh | bash

# Windows：务必右键PowerShell → 以管理员身份运行（不要直接双击打开）

7.3 AO 触发失败 / 状态异常

# 第一步：重启AO服务
npx ao stop
npx ao start--daemon

# 第二步：重新注册缺失的Agent（比如选题规划师丢了）
npx ao register topic-planner claude-3-5-sonnet "选题规划师"--tools web_search

# 第三步：检查API Key是否有效（LLM配置错误会导致Agent无响应）
openclaw onboard  # 重新进入向导补填API Key

7.4 国内网络超时 / 克隆失败

# 全局配置npm镜像
npm config set registry https://registry.npmmirror.com

# 全局配置git镜像（克隆源码时用）
git config --global url."https://gitee.com/".insteadOf "https://github.com/"

7.5 端口 18789 被占用（启动网关失败）

# 方式1：修改网关端口（比如改成18790）
openclaw onboard  # 重新进入向导，修改Gateway端口

# 方式2：查看占用端口的进程并关闭（macOS/Linux）
lsof -i :18789  # 查看进程ID
kill-9 [进程ID]  # 替换为实际ID

# Windows查看并关闭占用进程
netstat -ano | findstr :18789# 查看进程ID
taskkill /F /PID [进程ID]  # 强制关闭

八、卸载 OpenClaw（彻底清理）

# 1. 停止所有服务
openclawstop
npxao stop

# 2. 卸载npm全局包
npmuninstall -g openclaw

# 3. 删除数据目录（Linux/macOS）
rm-rf ~/.openclaw

# 3. 删除数据目录（Windows PowerShell）
Remove-Item-Recurse -Force $HOME/.openclaw

九、重要注意事项

✅ 安装前关闭杀毒软件 / 防火墙，避免拦截脚本或端口；

✅ AO 工作流必须确保「所有 Agent 已注册 + LLM API Key 有效」，否则无法运行；

✅ 定期更新版本：openclaw update（主程序）、npx ao update（AO 扩展）；

✅ 报错优先查日志：路径~/.openclaw/logs/，日志会标注具体错误原因；

✅ 国内用户全程使用 Gitee 镜像 + npmmirror，可 99% 解决网络问题。

十、写在最后

如果大家安装后能看到Web UI画面了，但苦于JSON、Yaml文件配置的问题，导致自己个儿想安装的插件或者一些大语言模型无法正常使用，这里可以尝试让OpenClaw自行安装，但是消耗的Tokens很多，慎行。（一定要明白如何配置）

建议收藏这篇教程，部署的时候一步步对照着做，踩坑了可以在评论区留言，有时间我会一一解答✅

关注我 @浩宇提效实验室，后续会持续分享低配置电脑也能跑的 AI 部署教程、各种小白可落地的 AI 提效神器，帮你用免费技术工具，少花 90% 的冤枉钱！