本教程为Mac系统环境，其余系统暂时未做测试，大致步骤差不多。整体步骤没问题，如果你在配置过程遇到其它报错，截图给GPT即可知道如何解决。

整个流程主要分为三步：

1️⃣ 基础环境准备
2️⃣ OpenClaw 源码安装与构建
3️⃣ 启动并完成配置向导

按照步骤操作，10 分钟即可完成部署。

一、基础环境准备

OpenClaw 运行依赖以下两个环境：

• Node.js（≥22版本）
• pnpm 包管理器

如果尚未安装，可以按照下面步骤进行配置。

---

1. 安装 Node.js

建议安装 Node.js LTS 长期支持版本（22+）。

安装教程：

https://www.runoob.com/nodejs/nodejs-install-setup.html

安装完成后，在终端执行：

node -v
npm -v

如果成功输出版本号，则说明安装成功。

---

2. 安装 pnpm 包管理器

pnpm 是 OpenClaw 推荐使用的包管理工具。

执行以下命令即可安装：

curl -fsSL https://get.pnpm.io/install.sh | sh -

安装完成后重新加载环境变量：

如果使用 zsh

source ~/.zshrc

如果使用 bash

source ~/.bashrc

验证是否安装成功：

pnpm --version

---

二、OpenClaw 源码拉取与构建

OpenClaw 推荐通过 源码方式安装，主要包含：

• 克隆仓库
• 安装依赖
• 构建 UI
• 编译项目

---

1. 克隆源码仓库

打开终端执行：

git clone https://github.com/openclaw/openclaw.git

---

2. 进入项目目录

cd openclaw

后续所有命令都在此目录执行。

---

3. 安装项目依赖

执行：

pnpm install

安装项目所需的全部依赖。

---

4. 构建 UI 界面

执行：

pnpm ui:build

首次运行会自动安装 UI 相关依赖并编译前端界面。

---

5. 编译项目核心代码

执行：

pnpm build

编译完成后会生成 dist 目录，为后续运行做好准备。

---

三、OpenClaw 启动与配置向导

构建完成后，即可启动 OpenClaw 配置向导。

该向导会引导完成：

• 模型配置
• API连接
• 消息渠道
• 技能系统
• 网关配置

---

1. 启动 Onboarding 配置向导

执行：

openclaw onboard --install-daemon

该命令会：

• 启动配置向导
• 自动安装守护进程（launchd / systemd）
• 让 OpenClaw 后台常驻运行

---

如果提示命令不存在

若出现：

command not found: openclaw

先执行：

pnpm link --global

然后重新运行启动命令。

---

四、配置向导填写步骤

启动后会进入 交互式配置流程。

按以下固定选项填写即可一次性完成配置。

---

1 安装守护进程

Install daemon?

选择：

yes

---

2 Onboarding 模式

Onboarding mode

选择：

QuickStart

（第一个选项）

---

3 模型服务提供商

Model/auth provider

选择：

Custom Provider

即：

Any OpenAI or Anthropic compatible endpoint

---

4 API Base URL

输入：

https://api.zhangsan.cool/v1

---

5 API Key

输入你在控制台获取的 API Key：

https://api.zhangsan.cool/console/token

---

6 接口兼容模式

选择：

OpenAI-compatible

---

7 Model ID

输入：

gpt-5.3-codex

（也可以替换为你使用的其他模型）

---

8 Endpoint ID

直接 回车使用默认值。

---

9 Model alias（可选）

可以自定义模型名称，例如：

chuan

---

接下来：

QuickStart
Skills
Hooks

全部选择 否或跳过。

---

最后看到：

How do you want to hatch your bot?

选择：

Open the Web UI

系统会自动打开 OpenClaw Web 管理界面。

---

五、配置界面示例

这是我部署过程中的部分界面，供参考：

---

六、部署完成

完成配置后，你就拥有了一个 本地 AI 助手系统。

OpenClaw 支持：

• 多平台消息接入
• AI模型接入
• 自定义技能
• 自动化任务
• 本地化 AI 助手

非常适合用于：

• AI工具开发
• 自动化机器人
• 私有AI助手
• 企业内部AI系统