OpenClaw 是一个强大的开源 AI Agent 框架，将其与飞书结合能显著提升办公自动化效率。本文基于实测环境，分享在 Windows 系统上部署 OpenClaw 并对接飞书机器人的完整流程，涵盖环境搭建、配置细节及常见坑点排查。
⚠️ 安全提示
OpenClaw 具备深度系统操作能力，涉及隐私数据交互。若电脑存有敏感商业资料，建议优先使用独立备用机或云端虚拟机（VPS）运行，避免本地环境冲突或信息泄露。
一、Windows 环境准备
1. Node.js 环境配置
OpenClaw 依赖 Node.js 22.x 及以上版本。推荐使用 nvm-windows 管理版本，避免全局污染。
- 下载
nvm-setup.exe安装包并完成安装。 - 管理员身份打开 PowerShell，执行以下命令：
# 安装 Node.js 22.x 版本
nvm install 22
# 切换至指定版本
nvm use 22.22.0
看到 Now using node v22.22.0 即表示成功。验证安装：
node --version
npm --version
若下载失败，可前往 Node.js 官网 手动下载安装包。
二、安装 OpenClaw
1. 一键安装脚本
在管理员 PowerShell 中执行以下命令。如遇执行策略报错，先解除限制：
# 允许本地脚本运行
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 官方安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex
网络不稳定时可使用国内镜像：
iwr -useb https://clawd.org.cn/install.ps1 | iex
安装过程会自动拉取核心文件，通常需等待 5-10 分钟。
2. 初始化与启动
安装完成后自动进入配置流程。若意外退出，可重新执行：
openclaw onboard --flow quickstart
按提示操作：
- 风险提示确认输入
Yes - 初始化模式选
QuickStart - 模型提供商与通讯渠道暂时选
Skip for now，后续单独配置
启动网关服务：
openclaw gateway start
openclaw dashboard
浏览器将自动打开控制台 http://127.0.0.1:18789/，发送消息测试有回复即表示安装成功。
三、配置大模型 API
OpenClaw 的 NLU 能力依赖大模型，需预先配置密钥。以阿里云百炼为例：
- 访问 阿里云百炼控制台 创建 API-Key。
- 在 OpenClaw 中配置：
# 设置百炼 API-Key（替换实际值）
openclaw config set models.providers.bailian.apiKey "你的百炼 API-Key"
# 设置默认模型
openclaw config set agents.defaults.model.primary "bailian/qwen3-plus"
# 重启网关生效
openclaw gateway restart
