目前国内还是很缺AI人才的，希望更多人能真正加入到AI行业，共同促进行业进步，增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程 http://blog.csdn.net/jiangjunshow，教程通俗易懂，高中生都能看懂，还有各种段子风趣幽默，从深度学习基础原理到各领域实战应用都有讲解，我22年的AI积累全在里面了。注意，教程仅限真正想入门AI的朋友，否则看看零散的博文就够了。

前言

最近OpenClaw简直是AI本地部署圈的“顶流”，能本地跑、能接各种IM、还能帮你干活，关键是Windows也能完美跑起来，不用折腾双系统或虚拟机。

今天这篇保姆级教程，从环境准备、OpenClaw安装、初始化配置，到飞书接入、常见坑点排查，全程照做就能成功，零编程基础也能跟着走，数学不好也完全没压力，主打一个快速落地、少走弯路。

先简单说下OpenClaw是啥，用大白话讲：它就是个本地优先的开源AI智能体（2026年2月最新稳定版v2026.2.3），不是只会聊天的机器人，能读写文件、执行命令、操控浏览器、处理办公任务，还能接入飞书、Telegram这些平台，数据存在本地，隐私安全拉满，学生写作业、职场人办公都能用，简直是AI入门实战的绝佳工具。

一、安装前必看：Windows环境准备（避坑第一步）

很多人安装OpenClaw失败，90%是环境没配好，先把基础环境搭稳，后面一路绿灯。

1. 系统与硬件要求

• 系统：Windows 10 21H2及以上、Windows 11（必须支持WSL2，官方原生推荐WSL2运行，兼容性最好）
• 硬件：内存≥8GB（推荐16GB，本地跑模型更流畅），硬盘剩余空间≥20GB，CPU支持虚拟化（BIOS里开启，默认大多是开启的）
• 网络：能正常访问GitHub、npm官方源，不用特殊工具，普通网络即可

2. 必装基础软件（2026最新稳定版）

OpenClaw官方要求Node.js≥22版本，这是核心运行环境，一步都不能错。

（1）安装Node.js 22+

• 打开Node.js官网（https://nodejs.org/），下载LTS版本22.x（长期支持版，稳定不踩坑）
• 安装时必须勾选“Add to PATH”（添加到系统环境变量），这是最关键的一步，没勾的话后面命令行识别不了node和npm
• 安装完打开PowerShell（管理员权限），输入以下命令验证：

node -v  # 输出v22.x.x说明成功
npm -v   # 输出对应版本号

（2）开启WSL2（Windows运行OpenClaw的核心）

OpenClaw官方明确：Windows下推荐通过WSL2运行，原生Linux环境兼容性拉满，避免Windows原生环境的各种依赖报错。

• 管理员PowerShell输入命令：

wsl --install

• 等待自动安装Ubuntu（默认发行版），重启电脑，设置Ubuntu用户名和密码（简单好记就行）
• 验证WSL2安装成功：

wsl -l -v  # 输出Ubuntu且VERSION为2即可

（3）安装pnpm（可选，提升安装速度）

pnpm比npm更快、更省空间，OpenClaw源码构建需要，新手直接用npm也能跑，推荐装一个：

npm install -g pnpm

环境准备到这就结束了，是不是超简单？没有复杂配置，没有数学公式，就装3个东西，接下来进入OpenClaw安装环节。

二、Windows下OpenClaw完整安装（3种方法，选最简单的）

OpenClaw官方提供3种安装方式，新手直接选第一种安装器脚本，一键搞定，不用手动配依赖，官方推荐，零失败。

方法1：PowerShell安装器脚本（新手首选，2026官方最新）

1. 关闭电脑上的杀毒软件、安全卫士（避免拦截安装脚本，安装完再打开）
2. 以管理员身份打开PowerShell，输入以下命令（直接复制粘贴，别手打，避免出错）：

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

3. 等待脚本自动运行，会自动下载OpenClaw最新版、配置环境、安装依赖，全程无需手动操作，大概3-5分钟（看网络速度）
4. 安装完成后，脚本会提示运行初始化命令，按提示操作即可

方法2：npm全局安装（适合会点命令行的小伙伴）

如果脚本安装失败，用npm手动安装，稳定可靠：

npm install -g openclaw@latest

安装完成后，运行初始化向导：

openclaw onboard --install-daemon

方法3：源码编译安装（适合想二次开发的同学）

适合有开发需求的小伙伴，普通用户不用选：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
openclaw onboard --install-daemon

安装后验证（必做！）

安装完一定要验证是否成功，输入命令：

openclaw doctor  # 官方诊断命令，检查环境是否正常
openclaw status  # 查看网关状态

如果输出“环境正常”“网关未启动”，说明安装成功，接下来做初始化配置。

三、OpenClaw初始化配置（5分钟搞定）

安装成功后，必须做初始化配置，才能连接AI模型、启动服务，全程交互式引导，跟着提示走就行。

1. 运行初始化向导

openclaw onboard

向导会一步步问你：

• 选择安装方式：选npm（默认）
• 配置AI模型：支持本地Ollama模型、云端OpenAI、DeepSeek、通义千问等（新手先选云端API，不用本地跑模型，简单）
• 设置网关端口：默认18789，不用改
• 安装后台服务：选是，开机自启，不用每次手动开

2. 配置AI模型（关键步骤）

OpenClaw本身不自带模型，需要对接模型接口，这里给新手推荐2种简单方案：

方案1：云端模型（零硬件要求，推荐）

• 去DeepSeek、通义千问官网注册账号，获取API Key
• 在向导中输入API Key、模型名称（如deepseek-chat），直接能用

方案2：本地模型（有GPU的同学选）

安装Ollama（https://ollama.com/），拉取轻量模型：

ollama pull qwen:7b

然后在OpenClaw向导中选择Ollama，自动对接，本地跑不用花钱，隐私性更好。

3. 启动OpenClaw网关

配置完成后，启动核心网关服务：

openclaw gateway start  # 启动网关
openclaw gateway status # 查看状态，显示running就是成功

启动后，访问Web UI：http://127.0.0.1:18789/，能打开页面就说明配置成功，接下来就是最实用的飞书接入环节。

四、OpenClaw接入飞书（官方原生支持，无需公网IP）

重点来了！OpenClaw官方原生支持飞书接入（2026年2月版本已正式支持），用WebSocket长连接，不需要公网IP、不需要回调地址、不会有封号风险，合规稳定，企业、个人都能用，这是官方主推的方案，放心用。

整个接入流程分4步：创建飞书应用→安装飞书插件→配置OpenClaw→测试对话，全程10分钟搞定。

第一步：飞书开放平台创建应用

1. 打开飞书开放平台（https://open.feishu.cn/），用飞书账号登录
2. 点击「创建企业自建应用」，填应用名称（如“我的AI助手”）、描述，提交创建
3. 在「凭证与基础信息」页面，复制App ID和App Secret（保存好，后面要用）

第二步：配置飞书应用权限（官方标准配置）

1. 进入「权限管理」，点击「批量导入」，粘贴以下官方JSON权限配置（直接复制，别改）：

{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"docs:document.content:read",
"im:chat",
"im:message",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
}
}

2. 进入「应用能力」→「机器人」，开启机器人能力，设置机器人名称
3. 进入「事件订阅」，选择使用长连接接收事件（WebSocket模式），添加事件im.message.receive_v1
4. 进入「版本管理与发布」，创建版本，提交发布（企业自建应用自动通过，无需审核）

第三步：OpenClaw安装飞书插件+配置

1. 回到Windows的WSL2终端，安装飞书官方插件：

openclaw plugins install @openclaw/feishu

2. 运行渠道添加命令，选择Feishu，粘贴之前复制的App ID和App Secret：

openclaw channels add

3. 重启网关，让配置生效：

openclaw gateway restart

第四步：飞书测试对话+授权配对

1. 打开飞书，搜索你创建的机器人，发送消息“你好”
2. 机器人会回复一个配对码，在终端输入命令授权（把<配对码>换成实际的）：

openclaw pairing approve feishu <配对码>

3. 再发消息，机器人正常回复，说明接入成功！

现在你就能在飞书里随时调用本地OpenClaw的AI能力，让它帮你写代码、整理文件、查资料，全程本地运行，安全又方便。

五、新手必看：常见坑点+排查方法（90%的问题都能解决）

我整理了安装和接入中最容易踩的坑，都是大家实测踩过的，照着排查秒解决：

1. 安装时报错“openclaw不是内部或外部命令”

• 原因：Node.js没添加到PATH，或没重启终端
• 解决：重启PowerShell，重新安装Node.js，勾选Add to PATH

2. WSL2安装失败

• 原因：BIOS未开启虚拟化，或系统版本太低
• 解决：重启电脑进BIOS开启虚拟化，升级Windows系统

3. 飞书机器人不回复消息

• 原因：网关未启动、事件订阅没选长连接、权限没配全
• 解决：运行openclaw gateway status检查网关，事件订阅确认长连接，重新导入权限

4. 模型对接失败

• 原因：API Key错误、模型名称写错、网络问题
• 解决：核对API Key，用官方推荐的模型名称，切换网络

5. Web UI打不开

• 原因：端口被占用、网关未启动
• 解决：运行openclaw gateway restart，或修改端口为其他数字

所有排查命令都是官方提供的，没有自定义脚本，直接运行就能用，新手也能轻松搞定。

六、OpenClaw基础用法（快速落地，马上能用）

接入成功后，给大家分享几个新手必用的功能，马上就能用起来：

1. 飞书私聊机器人，让它帮你写代码注释、生成测试用例
2. 发送文件给机器人，让它总结内容、提取关键信息
3. 命令行输入openclaw logs --follow，查看实时运行日志
4. 输入openclaw dashboard，打开可视化控制台，管理所有配置

OpenClaw的技能生态超丰富，700+官方技能，能自动处理邮件、整理文档、操控浏览器，慢慢探索就能发现更多玩法。

七、总结

Windows跑OpenClaw真的没那么难，不用懂复杂技术、不用怕数学、不用折腾双系统，跟着这篇教程，环境准备→安装→配置→飞书接入，全程照做就能成功，零失败率。

目前国内还是很缺AI人才的，希望更多人能真正加入到AI行业，共同促进行业进步，增强我国的AI竞争力。想要系统学习AI知识的朋友可以看看我精心打磨的教程 http://blog.csdn.net/jiangjunshow，教程通俗易懂，高中生都能看懂，还有各种段子风趣幽默，从深度学习基础原理到各领域实战应用都有讲解，我22年的AI积累全在里面了。注意，教程仅限真正想入门AI的朋友，否则看看零散的博文就够了。