Windows傻瓜式安装OpenClaw！全网最完整安装教程 + 飞书接入，全程避坑(建议先收藏)

引言

随着OpenClaw爆火，网上各种安装文也层出不穷，可惜参考下来，许多教程还是跳过了一些细节，对小白来说，使用门槛还是较高。周末抽了些时间，将自己亲自在Window从0到1搭建OpenClaw教程梳理了一下，跟着本教程走，99%的小白能在自己电脑上搭建出OpenClaw，并集成到飞书使用。

文章大纲如下：

1. 安装WSL环境
2. 执行一键安装OpenClaw脚本
3. 配置AI模型
4. 集成到飞书
5. 常用命令

安装OpenClaw

WSL环境背景说明：

• Window系统没有安装WSL就开始安装OpenClaw，会出现各种：npm error code 3221225477、npm error code 128异常，尝试过更换Node版本、设置Windows的系统参数等多种方案，这些异常依然无法解决，为了避免在这上面浪费时间，最好的方式是安装OpenClaw前，先安装WSL。
• WSL(Windows Subsystem for Linux) 是 Windows10、11 的一个功能，允许用户在 Windows 系统上运行 Linux 命令行工具。Windows 原生安装 Node 环境兼容性差，技能（skills）和二进制依赖经常出问题，WSL2 提供完整的 Linux 环境，运行稳定、性能好、容易做成后台服务。

一、安装WSL环境：执行如下命令

# 一键安装 WSL2 和默认 Ubuntu（强烈推荐使用这种方式）
wsl --install

# 如果想指定 Ubuntu 24.04 LTS（更稳定）
wsl --list --online
wsl --install -d Ubuntu-24.04

1、重启电脑后，电脑会自动弹出下载ubuntu系统，等待下载完成后，创建默认用户 diary(用户名可以自己定义)：

2、使用管理员身份打开PowerShell，并输入以下命令进入Ubuntu系统：

wsl -d Ubuntu

3、更新Ubuntu系统和安装curl、git工具(推荐)，后续安装OpenClaw用到

# 升级系统已经安装的软件工具
sudo apt update && sudo apt upgrade -y

# 安装curl和git工具 
sudo apt install curl git -y

二、启动WSL系统中的systemd，这样后续可以像Linux系统一样管理OpenClaw，启动进程更加方便，步骤如下：

2、在 WSL终端 中执行，【按Esc + :键 + q 】保存退出：

sudo tee /etc/wsl.conf > /dev/null <<'EOF'
[boot]
systemd=true
EOF

3、然后在 Windows PowerShell 中重启WSL：

wsl --shutdown

4、重新进入WSL，验证 systemd 已启用：

wsl -d Ubuntu # 进入WSL系统

systemctl --user status   # 查看设置状态，能看到正常输出则表示成功

三、以管理员身份运行：WSL终端，切换到：/home/用户名(具体看你上面创建的用户名，我这里是diary)，直接运行下面的一键安装OpenClaw命令：

curl -fsSL https://openclaw.ai/install.sh | bash

说明：上述脚本执行后做的事情：
  - 自动检测、安装 Node.js 22+
  - 全局安装 openclaw@latest 
  - 启动 onboarding 向导

1、跟着提示一直选择YES，看到下面图片表示安装完成：

2、执行进入新手向导界面命令(并将OpenClaw服务设置为系统服务)，配置各种信息：

openclaw onboard --install-daemon # 默认将OpenClaw 安装为系统服务（daemon），方便一键启动和关闭

3、这一步主要是告诉你，使用OpenClaw可能会有一些风险。请问你是否继续？ 按 向左方向键 ←，选择 Yes，按 Enter 回车确认

选择 QiuickStart 模式

• qwen-portal/coder-model：千问的免费模型，适合日常文本问答、代码辅助和通用助手能力

• qwen-portal/vision-model：千问的免费模型，适合图像识别能力

5、连接即时通讯平台：配置完AI模型后，OpenClaw 会询问你要连接哪个通讯平台，这一步配置比较麻烦，先选择Skip for now跳过，后续会讲解如何接入飞书

6、联网配置：先Skip for now跳过，后续再进行配置

7、skill和hooks(钩子，高级功能，用于在启动时加载文档、记录日志等)配置：先Skip for now跳过，后续再进行配置

8、启动openclaw服务

9、安装完成，复制Dashboard Url使用网页打开即可

配置AI模型

说明：经过上面步骤，我们已经安装好OpenClaw，接下来只需配置AI模型，OpenClaw就可以只能回答问题了(此处以千问的免费模型为例，如果要使用其他模型，请自行配置)

wsl -d Ubuntu # 进入WSL系统

openclaw onboard # 进入OpenClaw新手向导

配置飞书

说明：接入AI模型后，我们可以通过OpenClaw网页跟AI进行交流，但想通过飞书跟OpenClaw进行交流，还差一步，配置飞书

3、添加机器人

4、配置权限：点击左侧【权限管理】，在【开通权限】搜索框中输入：im:,然后将所有出现的权限全部勾选，点击【批量开通】

5、发布版本：进入【版本管理和发布】 =》 【创建版本】，填写版本信息，点击【保存】

6、回到openclaw新手向导，配置通信渠道，选择飞书

1、进入openclaw面板，输入：openclaw config

2、选择local(本地配置)

10、配置私聊访问策略，新手可以先选择 No 跳过

11、配置完成

12、进入【飞书开发者后台】，配置订阅方式为【长连接】

13、添加【接收事件】

14、发布新版本，配置生效

15、重启openclaw服务，使配置生效

停止：openclaw daemon stop

重启：openclaw daemon start

测试连接：到飞书客户端回复任意一个内容，即可看到openclaw回复，然后拿最后一个配置指令到窗口执行配对即可

大功告成，此时你可以跟openclaw进行交流了

常用命令

openclaw status          # 查看整体状态

openclaw gateway status  # 查看 Gateway 运行状态

openclaw health          # 健康检查

openclaw configure       # 重新配置（修改模型、频道等）

openclaw daemon restart  # 重启后台服务

openclaw daemon logs     # 查看运行日志

openclaw onboard # 随时可以重新运行向导/新手指引

写在最后

恭喜你，OpenClaw安装成功啦，已经战胜90%的人(赚了499元)，接下来，你可以开始使用OpenClaw协助你工作和生活了！

但要先给你泼一盆冷水，这只是万里长征的第一步，怎么才能培养openclaw更懂你呢，下一篇文章我们将来介绍openclaw的灵魂配置，让openclaw成为真正智能，懂你的的AI助手！