这是一份最新的 OpenClaw 进阶指南，带你绕开各种坑，真正把它用起来。无需科学上网，国内环境也能跑通。

OpenClaw 近期更新了不少功能，整体能力比之前强了一大截，是时候出一版全新的安装教程了。

这篇文章没有废话，从零开始，手把手带你装好、配好、真正跑起来。

你只需要具备一项技能：会复制粘贴。

简单说，OpenClaw 是一个能替你干活的 AI 助手。

它可以接管你的电脑，帮你写代码、查文件、发邮件、自动操作软件——和那些只能聊天的 AI 完全不同，OpenClaw 真的能执行任务。

它不是“陪聊型选手”，而是“打工型选手”。

⚠️ 这一步没做好，后面基本全是报错。请务必按顺序完成。

以下教程仅针对 Windows 系统。

小白用户可以看这里：OpenClaw 到底怎么装？一篇纯小白也能成功部署的超详细教程

以管理员身份运行 PowerShell，执行：

iwr-useb https://openclaw.ai/install.ps1 | iex 

• 没有报错 → 直接进入第三章。
• 出现错误 → 不要慌，按以下步骤处理。

打开控制面板，卸载当前已安装的 Node.js，然后按「2.4 完整安装步骤」重新安装。

第一步：安装 Node.js

官网下载：https://nodejs.org/zh-cn/download/current

选择 v24.14.0 LTS 版本，下载 Windows 安装程序，一路 Next 即可。

安装完成后验证：

GPT plus 代充 只需 145node -v npm -v 

第二步：配置 npm 国内镜像

以管理员身份运行 PowerShell，执行：

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

第三步：安装 pnpm

GPT plus 代充 只需 145npm install -g pnpm 

验证：

pnpm -v 

第四步：安装 Git

官网下载：https://git-scm.com/download/win

全部默认安装即可。

第五步：安装 C++ 编译环境（关键，不能跳过）

下载地址：https://aka.ms/vs/stable/vs_BuildTools.exe

1. 打开安装程序
2. 勾选「使用 C++ 的桌面开发」
3. 点击安装

⚠️ 跳过这一步， pnpm install 阶段必报错，无一例外。

环境准备完毕，正式开始安装。

方式一：Git clone（推荐有代理的用户）

GPT plus 代充 只需 145git clone https://github.com/openclaw/openclaw.git 

方式二：网盘下载（推荐国内用户）

整理好的打包源码：https://pan.quark.cn/s/59a02a8324a4

下载 openclaw-2026.3.2.zip，解压到 D 盘或任意目录。

搜索「Git Bash」，以管理员身份运行，执行：

cd D:\openclaw-2026.3.2\ pnpm install 

如果没有安装 C++ 编译环境，这一步会直接报错。

出现如下界面，说明依赖安装成功：

在当前终端依次执行：

GPT plus 代充 只需 145pnpm ui:build

pnpm build

pnpm openclaw onboard –install-daemon

等待几分钟，出现初始化向导后，按以下顺序操作：

1. 选择 Yes
2. 选择 QuickStart
3. 选择模型（推荐选 Custom Provider，可接入自己的 API）
4. 填入 API 地址和 Key
5. 飞书配置 → 暂时跳过
6. Skills 配置 → 暂时跳过
7. Hooks 配置 → 暂时跳过
8. 选择 Open Web UI

配置完成，OpenClaw 正式上线。

权限配置参考：

{“scopes”:{“tenant”:[“docx:document.block:convert”,“aily:file:read”,“aily:file:write”,“application:application.app_message_stats.overview:readonly”,“application:application:self_manage”,“application:bot.menu:write”,“cardkit:card:write”,“contact:contact.base:readonly”,“contact:user.employee_id:readonly”,“corehr:file:download”,“docs:document.content:read”,“docx:document”,“docx:document:readonly”,“event:ip_list”,“im:chat”,“im:chat.access_event.bot_p2p_chat:read”,“im:chat.members:bot_access”,“im:chat:readonly”,“im:message”,“im:message.group_at_msg:readonly”,“im:message.group_msg”,“im:message.p2p_msg:readonly”,“im:message.reactions:read”,“im:message:readonly”,“im:message:recall”,“im:message:send_as_bot”,“im:message:send_multi_depts”,“im:message:send_multi_users”,“im:message:send_sys_msg”,“im:message:update”,“im:resource”,“sheets:spreadsheet”,“wiki:wiki:readonly”],“user”:[“aily:file:read”,“aily:file:write”,“contact:user.base:readonly”,“im:chat.access_event.bot_p2p_chat:read”]}} 

关闭终端，重新运行：

GPT plus 代充 只需 145pnpm openclaw gateway 

常用命令速查：

pnpm openclaw help# 查看帮助 pnpm openclaw status # 查看状态 pnpm openclaw gateway status # 查看网关状态 pnpm openclaw health # 健康检查 pnpm openclaw configure # 重新配置 pnpm openclaw logs # 查看日志 pnpm openclaw update # 更新 pnpm openclaw doctor # 问题诊断 

把机器人添加到飞书群，即可在群里直接与 OpenClaw 对话。

如果提示权限不足，按提示说明逐项修复即可。

OpenClaw 默认为单 Agent 模式，可通过命令新增：

GPT plus 代充 只需 145pnpm openclaw agents add CTO 

配置完成后，打开以下文件：

C:\Users\agent\.openclaw\openclaw.json 

按以下示例修改 Agent 绑定关系

GPT plus 代充 只需 145 “tools”: {

"agentToAgent": { "enabled": true, "allow": [ "bot_1", "bot_2" ] } 

}, “bindings”: [

GPT plus 代充 只需 145{ "agentId": "main", "match": { "channel": "feishu", "accountId": "bot_1" } }, { "agentId": "cto", "match": { "channel": "feishu", "accountId": "bot_2" } } 

], “channels”: {

"feishu": { "enabled": true, "connectionMode": "websocket", "domain": "feishu", "accounts": { "bot_1": { "appId": "", "appSecret": "" }, "bot_2": { "appId": "", "appSecret": "" }, "default": { "groupPolicy": "open" } } } 

},

重启后即可看到多个 Agent 同时在线。

让 Agent 知道自己是谁、该干什么，有两种方式：

方式一：在群里直接设定角色

GPT plus 代充 只需 145你是一个资深技术专家，负责所有技术相关工作，风格幽默但认真负责。 

方式二：在 Web 页面修改配置文件

以管理员身份运行：

npm i -g clawhub 

官网：https://clawhub.ai/

安装完成后，直接在群里让 Agent 帮你安装所需技能即可。

未正确安装或未加入环境变量。

GPT plus 代充 只需 145npm install -g pnpm 

执行后重新打开 Git Bash。

大概率是没有安装 C++ 编译环境，回到「2.4 第五步」补装。

改用 Git Bash 执行命令。

使用「3.1 方式二」的网盘源码下载。

依次排查：

• 机器人是否已被拉入群聊
• 消息是否有 @ 机器人
• 飞书应用权限是否完整配置
• 查看日志是否有报错：pnpm openclaw logs

需要在飞书后台补充以下权限：

docx:document.block:convert docs:document.content:read docs:document 

完成本篇教程后，你已经掌握了：

1. 环境准备：Node.js + Git + pnpm + C++ 编译环境
2. 完整安装流程：从源码到启动
3. 飞书接入：配置机器人并拉群对话
4. 多 Agent 协同：新增 Agent 并注入角色设定
5. 常见问题排查：覆盖高频报错场景

OpenClaw 确实有一定上手门槛，但一旦跑通，它的能力远超普通聊天型 AI。按这篇一步一步来，别跳步骤，基本不会出问题。

我是阿咕噜，一个 AI 科技博主。关注我，带你把 AI 真正用起来。