📘 飞书 OpenClaw 配置教程
更新于：2026年4月
📋 准备工作
| 项目 | 说明 |
|---|---|
| 飞书账号 | 个人或企业飞书账号均可 |
| 浏览器 | Chrome / Edge / Safari |
| 费用 | 免费额度，无需付费 |
🚀 5 分钟配置教程
浏览器访问：
https://openclaw.feishu.cn/home
你会看到飞书 OpenClaw 的欢迎页面。
点击页面上的"登录"按钮，使用你的飞书账号扫码或账号密码登录。
登录成功后，在首页或控制台点击"创建 Agent"。
- 名称：给你的 Agent 取个名字（如"我的助手"）
- 描述：简单说明它的用途（可选）
- 模型：选择驱动模型（默认内置，无需额外配置）
点击"确定"即可完成创建。
创建完成后，进入 Agent 对话界面，输入消息即可与 AI 交互。
飞书 OpenClaw 无需手动配置 LLM API Key — 系统已内置默认模型，开箱即用。
🔌 在飞书中使用 OpenClaw
飞书 OpenClaw 可以直接添加到飞书聊天中，有两种方式：
方式一：在飞书桌面端/移动端直接使用
打开飞书桌面端或移动端 App。
在飞书搜索栏搜索"OpenClaw"，找到 OpenClaw 机器人。
点击"添加"即可将 OpenClaw 机器人添加到你的飞书联系人中。之后可以直接在飞书聊天中和它对话。
方式二：添加到飞书群聊
在飞书群聊中，点击右上角的">"菜单，进入"群设置"。
在群设置中找到"机器人" → "添加机器人" → 搜索"OpenClaw" → 点击"添加"。
现在群成员都可以通过 @OpenClaw 来唤醒 Agent 进行对话。
🛠️ 配置 Agent 能力
在 Agent 设置页面，你可以配置以下能力：
| 功能 | 说明 | 配置位置 |
|---|---|---|
| 系统提示词 | 设定 Agent 的角色和行为准则 | Agent 设置 → 系统提示 |
| 长期记忆 | Agent 能记住过去聊天的内容 | 默认开启 |
| 飞书插件 | 使用飞书内置插件（日历、文档、审批等） | Agent 设置 → 插件 |
| 知识库 | 上传文档让 Agent 学习特定知识 | Agent 设置 → 知识库 |
| 技能市场 | 安装 Skills 扩展能力 | Agent 设置 → 技能 |
推荐：开启飞书插件
在 Agent 设置中，找到「插件」标签页，勾选以下常用插件：
- 飞书文档 — 让 Agent 帮你创建、查找、编辑文档
- 飞书日历 — 让 Agent 帮你查看和创建日程
- 飞书审批 — 让 Agent 帮你提交和查询审批
- 飞书搜索 — 让 Agent 搜索飞书内的信息
🦀 配置飞书 OpenClaw 到 Hermes Agent（进阶）
如果你同时在使用 Hermes Agent，也可以通过飞书 Bot 的方式让 Hermes 接入飞书消息平台。
访问 飞书开放平台，点击"创建应用" → "企业自建应用"。
填写应用名称（如 "HermesAgent"）和描述，点击"确定创建"。
在应用详情页 → "凭证与基础信息"，记下：
App ID（以 cli_ 开头）App Secret
在"应用功能" → "机器人" → 开启"机器人"开关。
配置消息卡片回调 URL（可选，按需设置）。
在"权限管理"中添加以下权限：
| 权限名称 | 权限代码 |
|---|---|
| 获取单聊消息 | im:message |
| 获取群聊消息 | im:message:group_at_msg |
| 读取用户信息 | contact:user.base:readonly |
| 发送消息 | im:message:send_as_bot |
在"版本管理与发布"中创建版本，填写更新说明。"发布"按钮会提示你提交审核（企业自建应用一般即时通过）。
打开你的 Hermes Agent config.yaml，找到 platforms 段，添加飞书配置：
platforms:
feishu:
enabled: true
app_id: "cli_xxxxxxxxxxxxxxx"
app_secret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# 订阅事件（可选，用于接收消息）
event_encrypt_key: ""
event_verification_token: ""
将 app_id 和 app_secret 替换为你在步骤 2 中获取的值。
在飞书开放平台 → 事件订阅 → 添加事件：
im.message.receive_v1— 接收消息事件
配置回调地址为 Hermes Agent 的 Webhook 地址：
https://你的服务器地址:端口/feishu/webhook
如果你在本地运行（没有公网 IP），可以使用 ngrok 暴露本地端口：
ngrok http 你的Hermes端口
将 ngrok 生成的 https 地址填入飞书回调地址。
pm2 restart hermes
或
npm start
在飞书中搜索你的 Hermes Bot，发送消息测试是否能正常回复。
🔧 常见问题
飞书 OpenClaw 和飞书 Bot 配置冲突吗？
不冲突。飞书 OpenClaw 是字节官方提供的云端 Agent 平台。飞书 Bot 接入 Hermes Agent 是自托管方式，两者可以同时使用。
飞书 OpenClaw 免费额度有多少？
飞书 OpenClaw 提供免费额度，足以满足轻度日常使用。具体额度以飞书官方最新政策为准。
创建飞书应用时提示"无权限"
需要飞书管理员权限来创建自建应用。如果你不是管理员，联系你的飞书管理员操作或在飞书服务台提交申请。
配置了飞书 Bot 但 Hermes 不回复
检查以下可能：
- 飞书开放平台的事件回调地址是否正确？
- Hermes Agent 日志是否有错误？运行
pm2 logs hermes查看 - 飞书权限是否已审批通过？
- 应用是否已发布上线？
📖 下一步
xia007 · 养虾人的导航站