Windows原生安装OpenClaw中国版保姆级教程｜新手零失败+实战踩坑全解

最近在尝试部署OpenClaw中国社区版，这款本地AI助手原生支持DeepSeek、飞书通道，不用折腾Linux环境，Windows直接就能跑。我严格跟着官方教程操作，全程踩坑、报错、解决一气呵成，现在把完整安装步骤+核心报错解决方案整理成这篇博客，新手照着做就能成功。

前言

OpenClaw提供两种安装方式：WSL2（稳定但需配置子系统）、原生Windows（上手快但对终端环境挑剔）。本文只讲原生Windows安装，也是官方推荐的快速上手方案，全程无需复杂配置，适合普通用户。

---

一、安装前必备工具（3个，一键安装）

OpenClaw基于Node.js开发，需要提前准备3个基础工具，全程默认安装即可：

1. Node.js：程序运行核心环境，必须选LTS长期支持版（推荐22.x版本）
2. Git：用于拉取源码、执行Shell脚本，Windows默认没有bash环境，全靠Git
3. pnpm：项目依赖包管理工具，比npm更快，官方指定使用

---

二、原生Windows安装全步骤（大白话版）

第1步：安装Node.js

1. 打开Node.js中文官网：https://nodejs.org/zh-cn/download/
2. 下载Windows .msi安装包，选择LTS长期版，别选测试版
3. 双击安装包，全程点下一步，无需修改任何配置
4. 验证安装：打开PowerShell，输入node --version和npm --version，能显示版本号就成功

第2步：安装Git

1. 下载Git Windows安装包，双击运行
2. 全程默认安装，安装完成后，文件夹右键会出现Git Bash Here选项
3. 这一步是关键！后续构建项目全靠Git自带的bash工具

第3步：安装pnpm并配置国内镜像

1. 在任意空文件夹右键 → Git Bash Here，打开Git终端
2. 安装pnpm：npm install -g pnpm
3. 配置国内镜像（解决依赖下载慢/失败）：pnpm config set registry https://registry.npmmirror.com/

第4步：拉取源码并安装依赖

1. 找一个空文件夹，右键打开Git Bash，拉取中国版源码：
   git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
2. 进入项目目录：cd openclaw-cn
3. 安装项目依赖：pnpm install（等待加载完成，不要关闭终端）

第5步：构建项目（核心步骤）

1. 先构建UI界面：pnpm ui:build（这一步基本不会报错）
2. 整体项目构建：pnpm build（我就是这一步踩坑了！）

第6步：启动安装向导（必须用PowerShell）

官方特别提醒：Git Bash无法操作交互式菜单，上下键会失灵，必须切换到PowerShell

1. 以管理员身份打开Windows PowerShell
2. 进入项目目录（我的路径：cd D:\OpenClaw，替换成你的路径）
3. 启动向导：pnpm openclaw onboard --install-daemon

第7步：向导快速配置（一路选就行）

1. 安全提示输入yes确认
2. 选择QuickStart快速开始
3. 选择AI模型（如DeepSeek），输入你的API Key
4. 沟通通道选Skip for now（后续再配置飞书/微信）
5. 最后选择Open the Web UI，自动打开浏览器界面即安装成功

---

三、我的实战踩坑实录：bash报错完美解决

1. 报错现象

执行pnpm build时，终端直接报错：
'bash' 不是内部或外部命令，也不是可运行的程序或批处理文件

2. 报错原因

• Windows系统默认没有bash工具，OpenClaw构建需要执行.sh脚本，必须依赖Git的bash
• 我虽然安装了Git，但Git的bin目录没有加入系统环境变量，PowerShell找不到bash程序
• 我的Git安装路径：D:\Program Files\Git

3. 一步到位解决方法

1. 添加环境变量
   • 按Win+R输入sysdm.cpl → 高级 → 环境变量
   • 系统变量中找到Path，双击 → 新建 → 粘贴路径：D:\Program Files\Git\bin
   • 所有窗口都点确定保存（必须全点，否则不生效）
2. 重启终端（关键！）
   关闭所有PowerShell、Git Bash窗口，重新打开管理员PowerShell
3. 验证bash
   输入bash --version，显示版本号即配置成功
4. 重新构建
   进入项目目录，再次执行pnpm build，完美通过！

---

四、官方常见问题汇总（提前避坑）

1. 权限不足：全程用管理员身份运行PowerShell，否则安装失败
2. 端口冲突：默认端口18789被占用，用netstat -ano | findstr 18789查看占用程序并关闭
3. 杀毒软件拦截：暂时关闭360、电脑管家、Windows防火墙，安装完成后再开启
4. Git Bash按键失效：启动向导绝对不用Git Bash，只能用PowerShell

---

五、安装成功验证

打开浏览器访问：127.0.0.1:18789/chat，能看到OpenClaw的Web UI界面，可正常和AI对话，就是彻底安装成功了！

---

六、后续基础配置（让AI真正用起来）

1. 配置AI大脑

在Web UI中绑定DeepSeek、GLM等大模型API Key，让AI具备思考能力

2. 配置飞书机器人（可选）

1. 飞书开放平台创建企业自建应用，启用机器人权限
2. 获取App ID、App Secret，填回OpenClaw后台
3. 配置事件监听，发布应用后即可在飞书和AI对话

---

总结

Windows原生安装OpenClaw中国版并不复杂，核心坑点就是bash环境配置，只要把Git的bin目录加入系统环境变量，就能完美解决构建报错。整个流程下来，新手也能轻松部署本地AI助手，后续搭配大模型和飞书通道，办公效率直接拉满！