简介
OpenClaw 是一个强大的开源 AI Agent 框架，结合飞书能显著提升办公效率。以下是在 Windows 系统上完成 OpenClaw 安装并接入飞书机器人的实测步骤，包含排错命令和环境配置细节。
⚠️ 隐私安全提示
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
以管理员身份打开 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 -UseBasicParsing https://openclaw.ai/install.ps1 | iex
# 或使用国内镜像
# iwr -UseBasicParsing 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
若 openclaw 命令提示无法识别，关闭当前窗口重开即可，环境变量需刷新。
2.3 启动服务
openclaw gateway start
openclaw dashboard
浏览器自动打开 http://127.0.0.1:18789/，发送消息测试有回复即成功。
三、配置大模型 API
OpenClaw 依赖大模型理解自然语言，需配置 API 密钥。以阿里云百炼为例：
- 访问阿里云百炼控制台创建 API-Key 并复制
- 在 OpenClaw 中配置：
openclaw config set models.providers.bailian.apiKey "你的百炼 API-Key"
openclaw config set agents.defaults.model.primary "bailian/qwen3-plus"
openclaw gateway restart
四、飞书机器人配置
4.1 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu
安装期间可继续配置飞书开放平台。
4.2 创建企业自建应用
登录飞书开放平台，创建企业自建应用，填写名称、描述及图标。
4.3 添加机器人能力
在应用详情页左侧导航栏选择'添加应用能力' → '机器人'。
4.4 获取核心凭证
进入'凭证与基础信息'，复制 App ID 和 App Secret。
4.5 批量导入权限
进入'权限管理'，粘贴以下 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.6 配置事件订阅
- 进入'事件与回调' → '事件配置'
- 订阅方式选'使用长连接接收事件' → 保存
- 若报错'未建立长连接'，检查网关状态
openclaw gateway status，重启后重试 - 添加事件
im.message.receive_v1（否则收不到消息）
4.7 配置飞书凭证
命令行方式：
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw gateway restart
或通过 Web UI 在通道设置页面填入。
4.8 发布应用版本
- 进入'版本管理与发布' → 创建版本
- 填写版本号与说明，选择可见范围
- 提交审批，管理员可直接通过
4.9 配对操作
- 飞书客户端搜索并添加机器人
- 发送任意消息，机器人回复配对码
- 在 OpenClaw 控制台执行：
openclaw pairing approve feishu 配对码
绑定成功后即可在飞书中交流或拉入群聊。
五、常用排错命令
| 命令 | 作用 |
|---|---|
openclaw gateway status | 查看网关服务运行状态 |
openclaw gateway restart | 重启网关（修改配置后必须执行） |
openclaw doctor | 全面诊断系统环境 |
openclaw logs follow | 实时查看日志，定位 Bug |
openclaw config | 交互式修改配置 |
openclaw --version | 查看版本 |
六、常见问题
Q1：安装插件时报错？
先执行 openclaw gateway restart，再重试。失败则查看日志 openclaw logs follow。
Q2：飞书配置时报"未建立长连接"？
检查网关是否运行，18789 端口是否被防火墙阻止，或在飞书平台等待 1-2 分钟重试。
Q3：机器人收不到消息？
检查是否添加 im.message.receive_v1 事件，应用版本是否发布，是否完成配对。
Q4：Node.js 版本不兼容？
OpenClaw 要求 Node.js 22+，执行 node --version 查看。如过低，用 nvm install 22 切换。
七、进阶技巧：让 AI 学会发图片
OpenClaw 默认工具在飞书发送本地图片可能仅返回路径。利用 TOOLS.md 机制解决：
在工作区 TOOLS.md 中加入指令，指导 AI 调用 exec 工具执行 curl 调飞书 API（分三步：获取 token、上传图片、发送消息）。OpenClaw 每次启动会读取该文件学习新技能。
八、总结
按上述步骤操作，即可在 Windows 上实现飞书聊天窗口下达指令，OpenClaw 自动执行任务的高效协作。配置遇阻时，善用 openclaw logs follow 查看日志，通常能定位 90% 的问题。