前言
OpenClaw 是一个强大的开源 AI Agent 框架，与飞书结合能显著提升办公自动化效率。本文基于实测环境，详细记录在 Windows 系统上部署 OpenClaw 并对接飞书机器人的完整流程，包含常见坑点的排查方案。
⚠️ 重要提示：隐私安全优先
由于自动化工具会深度接触系统和数据，若电脑存有敏感商业资料或个人隐私，强烈建议使用备用机或云端虚拟机（VPS）运行。这既能隔离风险，也能避免本地环境冲突。
第一部分：Windows 环境准备
1.1 系统要求
- 操作系统：Windows 10/11 64 位（专业版或企业版更佳）
- 权限要求：全程需使用管理员权限运行 PowerShell
- 网络要求：确保能访问 GitHub 和 npm 源
1.2 安装 nvm for Windows（推荐）
使用 nvm 管理 Node.js 版本能有效避免依赖冲突。
- 访问 nvm-windows GitHub 发布页下载
nvm-setup.exe - 一路点击 Next 完成安装
1.3 安装 Node.js 22.x 版本
OpenClaw 依赖 Node.js 22 及以上版本。以管理员身份打开 PowerShell，执行以下命令：
# 安装指定版本
nvm install 22
# 切换至该版本
nvm use 22.22.0
看到 Now using node v22.22.0 即表示成功。若下载失败，可前往 Node.js 官网手动安装。
验证安装：
node --version
npm --version
第二部分：安装 OpenClaw
2.1 一键安装脚本（推荐）
在管理员 PowerShell 中执行以下命令。如遇执行策略报错，先解除限制：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
随后执行安装脚本：
iwr -useb https://openclaw.ai/install.ps1 | iex
若网络不稳定，可使用国内镜像：
iwr -useb https://clawd.org.cn/install.ps1 | iex
安装过程会自动配置 Node.js 和核心文件，通常耗时 5-10 分钟。
2.2 初始化配置
安装完成后会自动进入配置流程。若意外关闭，可重新执行：
openclaw onboard --flow quickstart
交互配置步骤（按提示操作）：
- 风险提示：输入
Yes确认理解风险 - 初始化模式：选择
QuickStart（直接回车） - 模型提供商：建议选
Skip for now跳过，后续单独配置 - 通讯渠道：同样选
Skip for now跳过（飞书稍后配置） - 技能配置：选
No跳过，按需安装
：若执行 提示无法识别，请关闭当前窗口，重新用管理员权限打开新窗口刷新环境变量。
