OpenClaw 安装与配置完整教程（本地AI助手部署指南）
本教程为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-vnpm-v如果成功输出版本号，则说明安装成功。
2. 安装 pnpm 包管理器
pnpm 是 OpenClaw 推荐使用的包管理工具。
执行以下命令即可安装：
curl-fsSLhttps://get.pnpm.io/install.sh|sh-安装完成后重新加载环境变量：
如果使用zsh
source~/.zshrc如果使用bash
source~/.bashrc验证是否安装成功：
pnpm--version二、OpenClaw 源码拉取与构建
OpenClaw 推荐通过源码方式安装，主要包含：
- 克隆仓库
- 安装依赖
- 构建 UI
- 编译项目
1. 克隆源码仓库
打开终端执行：
gitclone https://github.com/openclaw/openclaw.git2. 进入项目目录
cdopenclaw后续所有命令都在此目录执行。
3. 安装项目依赖
执行：
pnpminstall安装项目所需的全部依赖。
4. 构建 UI 界面
执行：
pnpmui:build首次运行会自动安装 UI 相关依赖并编译前端界面。
5. 编译项目核心代码
执行：
pnpmbuild编译完成后会生成dist目录，为后续运行做好准备。
三、OpenClaw 启动与配置向导
构建完成后，即可启动OpenClaw 配置向导。
该向导会引导完成：
- 模型配置
- API连接
- 消息渠道
- 技能系统
- 网关配置
1. 启动 Onboarding 配置向导
执行：
openclaw onboard --install-daemon该命令会：
- 启动配置向导
- 自动安装守护进程（launchd / systemd）
- 让 OpenClaw 后台常驻运行
如果提示命令不存在
若出现：
command not found: openclaw先执行：
pnpmlink--global然后重新运行启动命令。
四、配置向导填写步骤
启动后会进入交互式配置流程。
按以下固定选项填写即可一次性完成配置。
1 安装守护进程
Install daemon?选择：
yes2 Onboarding 模式
Onboarding mode选择：
QuickStart（第一个选项）
3 模型服务提供商
Model/auth provider选择：
Custom Provider即：
Any OpenAI or Anthropic compatible endpoint4 API Base URL
输入：
https://api.zhangsan.cool/v15 API Key
输入你在控制台获取的 API Key：
https://api.zhangsan.cool/console/token
6 接口兼容模式
选择：
OpenAI-compatible7 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系统