OpenClaw 是一个强大的开源 AI Agent 框架，与飞书结合能显著提升办公自动化效率。本文基于实测经验，梳理在 Windows 系统上完成 OpenClaw 安装及飞书机器人接入的完整流程，包含关键配置细节与常见坑点排查。
⚠️ 隐私安全提醒
由于自动化工具涉及系统权限与数据访问，若电脑存有敏感商业或个人信息，强烈建议使用备用机或云端虚拟机（VPS）运行。这既能隔离风险，也能避免本地环境冲突。
一、Windows 环境准备
1. 系统要求
- 操作系统：Windows 10/11 64 位（专业版或企业版体验更佳）
- 权限：全程需使用管理员权限运行 PowerShell
- 网络：确保能稳定访问 GitHub 及 npm 源
2. 安装 Node.js 环境
推荐使用 nvm 管理版本，避免冲突。
- 下载 nvm-windows 安装包并安装。
- 以管理员身份打开 PowerShell，执行以下命令：
# 安装 Node.js 22.x 版本
nvm install 22
# 切换至指定版本
nvm use 22.22.0
看到 Now using node v22.22.0 提示即表示成功。若下载受阻，可前往 Node.js 官网手动安装。
3. 验证版本：
node --version
npm --version
二、安装 OpenClaw
1. 执行一键脚本
在管理员 PowerShell 中运行：
# 如遇执行策略报错，先解除限制
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 执行安装脚本
iwr -UseBasicParsing https://openclaw.ai/install.ps1 | iex
若网络不稳定，可尝试国内镜像地址替换 URL。安装过程会自动配置依赖，通常耗时 5-10 分钟。
2. 初始化配置
安装完成后会自动进入配置向导。若中断，可重新执行：
openclaw onboard --flow quickstart
按提示操作：
- 风险提示确认输入
Yes - 初始化模式选择
QuickStart - 模型提供商与通讯渠道建议先选
Skip for now，后续单独配置 - 技能配置选
No
注意：若提示 无法识别 openclaw，请关闭当前窗口，重新打开管理员 PowerShell，环境变量刷新需要重启会话。
3. 启动服务
# 启动网关
openclaw gateway start
# 打开控制台（浏览器自动跳转）
openclaw dashboard
访问 http://127.0.0.1:18789/，发送测试消息有回复即代表安装成功。
三、配置大模型 API
OpenClaw 依赖大模型理解指令，需提前配置密钥。以阿里云百炼为例：
- 登录阿里云百炼控制台，创建 API-Key 并复制。
- 在命令行配置：
# 设置 API Key
openclaw config set models.providers.bailian.apiKey "你的百炼 API-Key"
# 设置默认模型
openclaw config set agents.defaults.model.primary "bailian/qwen3-plus"
# 重启生效
openclaw gateway restart
四、飞书机器人配置
1. 安装插件
openclaw plugins install @m1heng-clawd/feishu
安装期间可继续配置飞书开放平台。
2. 创建应用
登录飞书开放平台，创建企业自建应用，填写名称与描述后提交。
3. 添加能力与权限
- 在应用详情页左侧添加'机器人'能力。
- 进入'凭证与基础信息'，记录 App ID 和 App Secret。
- 在'权限管理'中批量导入以下 JSON 权限：
{"scopes":{"tenant":["aily:file:read","aily:file:write","contact:user.employee_id:readonly","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","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"]}}
此配置涵盖机器人所需的 8 项核心权限。
4. 事件订阅
进入'事件与回调'页面：
- 订阅方式选择'使用长连接接收事件'并保存。
- 注意：若报错'未建立长连接'，说明网关未运行，请先执行
openclaw gateway restart等待 1-2 分钟。 - 添加事件
im.message.receive_v1，否则机器人无法接收消息。
5. 凭证绑定
在 OpenClaw 中配置飞书凭证（命令行示例）：
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw gateway restart
也可通过 Web 控制台 Channels 页面填入。
6. 发布与配对
- 在飞书开放平台提交应用版本审批。
- 在飞书客户端搜索并添加机器人，发送任意消息获取配对码。
- 在 OpenClaw 控制台或命令行执行配对：
openclaw pairing approve feishu 配对码
配对成功后，即可在飞书中与 AI 交互，或将其拉入群组共享使用。
五、排错与进阶
常用诊断命令
| 命令 | 作用 |
|---|---|
openclaw gateway status | 查看网关状态 |
openclaw gateway restart | 重启网关 |
openclaw doctor | 环境诊断 |
openclaw logs follow | 实时日志监控 |
常见问题
- 插件安装失败：重启网关后重试，配合日志定位。
- 长连接报错：检查网关状态及防火墙是否拦截 18789 端口。
- 收不到消息：确认已添加
im.message.receive_v1事件且应用已发布。 - Node.js 版本低：执行
nvm install 22切换版本。
进阶技巧：发送图片
飞书原生支持有限，可通过 TOOLS.md 扩展能力。在工作区 TOOLS.md 中添加如下说明，AI 启动时会自动读取：
# 飞书发图片方法
用 exec 工具执行 curl 调飞书 API，分三步：
1. 获取 tenant_access_token
2. 上传图片获取 image_key
3. 发送图片消息
具体命令参考飞书开放平台文档。
这种自然语言说明书机制是 OpenClaw 的核心设计，灵活且易于维护。
总结
按照上述步骤，你已在 Windows 上完成了 OpenClaw 部署与飞书集成。虽然流程稍多，但掌握后能实现高效的聊天窗口指令自动化。遇到疑难杂症时，善用 openclaw logs follow 查看日志，通常能解决 90% 的问题。
