Windows 下安装 OpenClaw 并接入飞书机器人

常见问题：如果执行 openclaw 命令提示无法识别，只需关闭当前 PowerShell，重新用管理员权限打开一个新窗口即可。这是因为环境变量还未刷新。

2.3 启动服务并验证

# 启动网关服务
openclaw gateway start
# 访问 Web 控制台（会自动打开浏览器）
openclaw dashboard

浏览器会自动打开控制台地址：http://127.0.0.1:18789/。发一条消息测试，有回复就说明安装成功。

第三部分：配置大模型 API（核心前提）

OpenClaw 的自然语言理解能力依赖大模型，需要先配置 API 密钥。这里以阿里云百炼为例：

1. 访问阿里云百炼控制台，进入密钥管理页面
2. 点击创建 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

第四部分：飞书机器人配置（核心步骤）

4.1 安装飞书插件

在管理员 PowerShell 中执行：

openclaw plugins install @m1heng-clawd/feishu

插件安装可能需要几分钟，期间可以继续后续的飞书开放平台配置。

4.2 创建飞书企业自建应用

1. 登录飞书开放平台，进入开发者后台
2. 点击创建企业自建应用，填写基本信息：
   • 应用名称：如 OpenClaw 智能助手
   • 应用描述：简要说明用途
   • 应用图标：上传一个图标（可选）
3. 点击创建

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 配置事件订阅

1. 进入事件与回调页面 → 事件配置页签
2. 订阅方式：选择使用长连接接收事件 → 点击保存

注意：如果报错未建立长连接，说明 OpenClaw 网关未正常运行。返回 PowerShell 执行 openclaw gateway restart，等 1-2 分钟再重试。

3. 保存成功后，点击添加事件，搜索并添加 im.message.receive_v1（接收消息事件）
4. 如果不添加此事件，机器人将无法收到任何消息

4.7 在 OpenClaw 中配置飞书凭证

方式一：通过命令行配置

# 配置 App ID 和 App Secret（替换为实际值）
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
# 重启网关
openclaw gateway restart

方式二：通过 Web UI 配置

1. 访问 OpenClaw 控制台 http://127.0.0.1:18789/
2. 进入 Channels 或通道设置页面
3. 找到飞书配置，填入 App ID 和 App Secret

4.8 发布应用版本

1. 回到飞书开放平台，进入版本管理与发布页面
2. 点击创建版本
3. 填写版本号（如 v1.0.0）和更新说明
4. 选择应用可见范围（可先选指定部门用于测试）
5. 点击保存并提交审批
6. 若自己就是管理员，可直接审批通过

4.9 配对操作

1. 在飞书客户端（电脑端或手机端）搜索并添加刚刚创建的机器人
2. 向机器人发送任意消息（如你好）
3. 机器人会自动回复一个配对码

复制这个配对码，在 OpenClaw 控制台中执行：

openclaw pairing approve feishu 配对码

或者通过 Web UI 输入配对码完成绑定

配对成功后，你就可以在飞书中与 OpenClaw 愉快交流了！也可以把机器人添加到公司群里，让所有小伙伴都能用。

第五部分：常用排错命令

在配置过程中遇到问题，优先使用以下命令自查：

常见问题及解决方案

Q1：安装插件时报错怎么办？

A：先执行 openclaw gateway restart 重启网关，再重试安装。如果仍失败，查看日志 openclaw logs follow 定位具体原因。

Q2：飞书配置时报未建立长连接？

A：这通常是 OpenClaw 网关未正常运行或网络不通。按顺序检查：

1. openclaw gateway status 确认网关运行中
2. 18789 端口是否被防火墙阻止
3. 在飞书开放平台等待 1-2 分钟后重试保存

Q3：机器人收不到消息？

A：检查三点：

1. 是否已添加 im.message.receive_v1 事件
2. 应用版本是否已成功发布
3. 是否已完成配对操作

Q4：Node.js 版本不兼容？

A：OpenClaw 要求 Node.js 22+，执行 node --version 查看版本。如版本过低，用 nvm 切换：nvm install 22 → nvm use 22.22.0。

进阶技巧：让 AI 学会发图片

OpenClaw 默认的 message 工具在飞书上发送本地图片时可能存在问题（飞书收到的是文件路径而非图片）。解决方法是利用 OpenClaw 的 TOOLS.md 机制：

在 OpenClaw 工作区的 TOOLS.md 文件中，加入以下内容（可直接在对话中发给 OpenClaw）：

# 飞书发图片方法
用 exec 工具执行 curl 调飞书 API，分三步：
1. 获取 tenant_access_token
2. 上传图片获取 image_key
3. 发送图片消息
具体命令参考飞书开放平台文档。

OpenClaw 的 AI 助手每次启动都会读取 TOOLS.md，学会这个新技能。

总结

通过本文的详细步骤，你应该已经成功在 Windows 上安装了 OpenClaw，并接入了飞书机器人。整个过程虽然步骤较多，但只要按顺序操作，就能顺利实现飞书聊天窗口下达指令，OpenClaw 自动执行任务的高效协作模式。

如果在配置过程中遇到问题，记得善用 openclaw logs follow 查看日志，它能帮你定位 90% 的问题。