Windows原生安装OpenClaw中国版保姆级教程｜新手零失败+实战踩坑全解
最近在尝试部署OpenClaw中国社区版，这款本地AI助手原生支持DeepSeek、飞书通道 ，不用折腾Linux环境，Windows直接就能跑。我严格跟着官方教程操作，全程踩坑、报错、解决一气呵成，现在把完整安装步骤+核心报错解决方案整理成这篇博客，新手照着做就能成功。
前言
OpenClaw提供两种安装方式：WSL2（稳定但需配置子系统）、原生Windows（上手快但对终端环境挑剔）。本文只讲原生Windows安装，也是官方推荐的快速上手方案，全程无需复杂配置，适合普通用户。
一、安装前必备工具（3个，一键安装）
OpenClaw基于Node.js 开发，需要提前准备3个基础工具，全程默认安装即可：
Node.js：程序运行核心环境，必须选LTS长期支持版（推荐22.x版本）
Git：用于拉取源码、执行Shell脚本，Windows默认没有bash环境，全靠Git
pnpm：项目依赖包管理工具，比npm更快，官方指定使用
二、原生Windows安装全步骤（大白话版）
第1步：安装Node.js
打开Node.js中文官网：https://nodejs.org/zh-cn/download/
下载Windows .msi安装包，选择LTS长期版，别选测试版
双击安装包，全程点下一步，无需修改任何配置
验证安装：打开PowerShell，输入node --version和npm --version，能显示版本号就成功
第2步：安装Git
下载Git Windows安装包，双击运行
全程默认安装，安装完成后，文件夹右键会出现Git Bash Here选项
这一步是关键！后续构建项目全靠Git自带的bash工具
第3步：安装pnpm并配置国内镜像
在任意空文件夹右键 → Git Bash Here，打开Git终端
安装pnpm：npm install -g pnpm
配置国内镜像（解决依赖下载慢/失败）：pnpm config set registry https://registry.npmmirror.com/
第4步：拉取源码并安装依赖
找一个空文件夹，右键打开Git Bash，拉取中国版源码：
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
进入项目目录：cd openclaw-cn
安装项目依赖：pnpm install（等待加载完成，不要关闭终端）
第5步：构建项目（核心步骤）
先构建UI界面：pnpm ui:build（这一步基本不会报错）
整体项目构建：pnpm build（我就是这一步踩坑了！）
第6步：启动安装向导（必须用PowerShell）
官方特别提醒：Git Bash无法操作交互式菜单，上下键会失灵，必须切换到PowerShell
以管理员身份打开Windows PowerShell
进入项目目录（我的路径：cd D:\OpenClaw，替换成你的路径）
启动向导：pnpm openclaw onboard --install-daemon
第7步：向导快速配置（一路选就行）
安全提示输入yes确认
选择QuickStart快速开始
选择AI模型（如DeepSeek），输入你的API Key
沟通通道选Skip for now（后续再配置飞书/微信）
最后选择Open the Web UI，自动打开浏览器界面即安装成功
三、官方常见问题汇总（提前避坑）
权限不足：全程用管理员身份运行PowerShell，否则安装失败
端口冲突：默认端口18789被占用，用netstat -ano | findstr 18789查看占用程序并关闭
杀毒软件拦截：暂时关闭360、电脑管家、Windows防火墙，安装完成后再开启
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. 配置飞书机器人（可选）
飞书开放平台创建企业自建应用，启用机器人权限
获取App ID、App Secret，填回OpenClaw后台
配置事件监听，发布应用后即可在飞书和AI对话
总结
Windows原生安装OpenClaw中国版并不复杂，核心坑点就是bash环境配置，只要把Git的bin目录加入系统环境变量，就能完美解决构建报错。整个流程下来，新手也能轻松部署本地AI助手，后续搭配大模型 和飞书通道，办公效率直接拉满！
