OpenClaw 飞书机器人配置学习笔记

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

一、为什么对接飞书

OpenClaw 采用 Channels（通道层）+ Agents（智能体层）+ Tools（工具层） 的三层架构。飞书作为消息通道之一，扮演着“交互前端”的角色。对接飞书后，你可以在飞书聊天窗口直接发送自然语言指令，由 OpenClaw 自动拆解任务、操控电脑执行操作，实现“飞书端下达指令、OpenClaw 端执行任务”的远程 AI 自动化效果。

# 核心工作流程

用户通过飞书发送消息 → OpenClaw 接收并解析 → 调用大模型分析意图 → 执行相应操作（文件管理、浏览器自动化、代码开发等）→ 将结果返回至飞书聊天窗口。整个过程，用户感觉就像在和一个全能的飞书 AI 助手对话。

二、飞书平台端操作

# 2.1 准备工作

- 拥有飞书个人或企业账号（企业账号需确保具备应用开发相关权限）

- OpenClaw 已部署并保持正常运行（Gateway 处于在线状态）

# 2.2 通过一键链接创建机器人

飞书官方提供了一键生成飞书机器人的快捷链接：

> https://open.feishu.cn/page/openclaw?form=multiAgent

访问该链接后，系统会自动引导完成飞书机器人的创建。与传统手动创建方式相比，一键链接大幅简化了下列操作流程，以下步骤仅作参考了解。

（1）登录飞书开放平台

打开飞书开放平台官网（https://open.feishu.cn），使用飞书账号登录，进入开发者后台。

（2）创建企业自建应用

在开发者后台首页，点击“创建应用”，应用类型选择“企业自建应用”（内部使用，无需上架审核）。填写应用名称（建议便于识别，如“OpenClaw 机器人”）、应用描述，并上传应用图标（≥240×240px，≤2MB）。

（3）添加机器人能力

进入应用配置页面，在左侧菜单栏找到“添加应用能力”，选择“机器人”并添加。

（4）配置事件订阅（长连接模式）

进入“事件与回调”页面，订阅方式选择“使用长连接接收事件”。然后添加事件，搜索并选择“接收消息 v2.0”（im.message.receivev1）。

注意：飞书要求先验证 App ID/Secret 才能配置长连接，因此配置顺序建议为：先完成 OpenClaw 端的 CLI 配置并重启 Gateway，再回到飞书开放平台配置长连接。

（5）发布应用

进入“版本管理与发布”，点击“创建版本”，填写版本号（如 1.0.0）和更新说明，保存后点击确认发布。个人账号发布后直接生效，企业账号需由管理员审核后生效。

（6）获取应用凭证

在左侧导航栏找到“凭证与基础信息”，在“应用凭证”区域找到 App ID（格式以 `cli` 开头）和 App Secret，妥善保存，后续 OpenClaw CLI 配置中需要用到。

三、OpenClaw CLI 配置

bash

# 1. 启用飞书渠道

openclaw config set channels.feishu.enabled true

# 2. 配置应用凭证（替换为实际值）

openclaw config set channels.feishu.appId “cli_你的AppID”

openclaw config set channels.feishu.appSecret “你的AppSecret”

# 3. 配置长连接模式

openclaw config set channels.feishu.connectionMode websocket

# 4. 配置开放策略

openclaw config set channels.feishu.allowFrom ‘[“*”]’

openclaw config set channels.feishu.dmPolicy open

openclaw config set channels.feishu.groupPolicy open

openclaw config set channels.feishu.requireMention true

# 5. 重启服务

openclaw gateway restart

# 6. 检查状态

openclaw status

四、验证与使用

配置完成后，在飞书 PC 端或手机端搜索应用名称，进入聊天窗口，发送一条简单指令即可测试，例如“你好”或“帮我整理当前目录”。机器人正常回复即代表配置成功。

常用指令示例：

- “帮我整理 D 盘下载文件夹，按类型分类”

- “打开浏览器搜索 2026 AI 智能体趋势并整理成文档”

- “制作 Excel 工作汇报表并保存到桌面”

五、常见问题排查

| 问题现象 | 可能原因 | 解决建议 |

|———|———|———|

| 机器人无响应 | 应用未发布或权限未开通 | 检查版本管理与发布，确认应用已发布；检查权限管理中的权限是否已开通 |

| 消息不接收 | 事件订阅未正确配置 | 确认事件订阅方式为“长连接”，已添加 im.message.receive_v1 事件 |

| 配置不生效 | App ID/Secret 填写错误 | 检查凭证是否复制正确，确认无多余空格；重启 OpenClaw 使配置生效 |

| Gateway 离线 | OpenClaw 服务未启动 | 重新启动 OpenClaw 服务 |

| 长连接建立失败 | App ID/Secret 验证未通过 | 确认飞书平台已正确配置 App ID/Secret，并已发布应用；按正确顺序：先配置 CLI 并重启 Gateway，再回到飞书平台配置长连接 |

这篇学习笔记由 AI 辅助生成，内容仅供学习交流与配置参考。实际使用时请以 OpenClaw 官方文档和飞书开放平台的最新指引为准。

OpenClaw 飞书机器人配置学习笔记

相关推荐