OpenClaw接入飞书实践演练

将OpenClaw接入飞书，让它成为一个真正的“24小时在线”的科研助手——在飞书上@它，它就能帮查文献、分析数据、整理资料，无需打开任何额外界面。

---

一、为什么选择飞书？

相比其他通讯工具，飞书接入OpenClaw有三大优势：

优势	说明
长连接模式	无需公网服务器，飞书WebSocket直接与本地OpenClaw通信
企业级稳定	消息必达，适合团队协作场景
国内直连	无需代理，配置简单

对科研团队而言，你可以把OpenClaw机器人拉进项目群，成员随时@它完成资料查询、文献整理等任务。

---

二、准备工作

2.1 环境要求

• OpenClaw已部署并正常运行（参照第一讲）
• 飞书企业账号（个人飞书也可，但需创建企业自建应用）
• 管理员权限（用于创建应用和配置权限）

2.2 整体流程预览

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│  飞书开放平台    │───▶│  OpenClaw配置   │───▶│   验证与使用     │
│ 创建应用、获取   │    │  安装插件、      │    │  飞书端测试      │
│ App ID/Secret   │    │  填写凭证        │    │  群聊/私聊交互   │
└─────────────────┘    └─────────────────┘    └─────────────────┘

---

三、步骤一：飞书开放平台配置

3.1 创建企业自建应用

1. 访问飞书开放平台，点击右上角「登录」
2. 使用企业管理员账号登录
3. 点击右上角「开发者后台」，选择你的企业
4. 点击「创建企业自建应用」，填写：
   • 应用名称：OpenClaw科研助手（可自定义）
   • 应用描述：AI科研智能体
   • 上传应用图标（可选）

3.2 添加机器人能力

1. 进入应用详情页
2. 点击左侧「添加应用能力」
3. 选择「机器人」，点击「添加」

3.3 配置权限

这一步是关键——机器人需要足够权限才能收发消息。

在左侧导航栏点击「权限管理」，点击「批量导入/导出权限」，粘贴以下JSON配置：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "contact:user.base:readonly"
    ],
    "user": []
  }
}

点击「下一步」→「确认新增」→「申请开通」。

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

1. 左侧点击「事件与回调」
2. 在「订阅方式」中选择「使用长连接接收事件」
3. 点击「保存」
4. 点击「添加事件」，搜索 im.message.receive_v1（接收消息事件）
5. 勾选后点击「确认添加」

3.5 获取App ID和App Secret

1. 左侧点击「凭证与基础信息」
2. 在「应用凭证」区域找到：
   • App ID：格式 cli_xxxxxxxxxxxxx，点击复制保存
   • App Secret：点击「显示」后复制保存

⚠️ 安全提示：App Secret相当于应用密码，请妥善保管，不要泄露。

3.6 发布版本

1. 点击左侧「版本管理与发布」
2. 点击「创建版本」，填写版本号（如 1.0.0）
3. 填写更新说明
4. 点击「保存」→「确认发布」
5. 提交审核（如果是企业内部应用，通常自动通过）

---

四、步骤二：OpenClaw端配置

4.1 安装飞书插件

有两种插件可选，推荐使用 openclaw-feishu（NPM官方包）：

# 安装飞书插件
openclaw plugins install openclaw-feishu

4.2 配置openclaw.json

编辑配置文件 ~/.openclaw/openclaw.json：

# 用你喜欢的编辑器打开
nano ~/.openclaw/openclaw.json

在 channels 下增加飞书配置，并确保插件已启用：

{
  "channels": {
    "openclaw-feishu": {
      "enabled": true,
      "appId": "cli_你的AppID",
      "appSecret": "你的AppSecret",
      "dmPolicy": "open",
      "groupPolicy": "open",
      "requireMention": true
    }
  },
  "plugins": {
    "entries": {
      "openclaw-feishu": { "enabled": true }
    }
  }
}

配置项说明：

配置项	说明	推荐值
enabled	是否启用飞书通道	true
appId	飞书应用的App ID	从开放平台获取
appSecret	飞书应用的App Secret	从开放平台获取
dmPolicy	私聊策略：open/pairing/allowlist	open（测试用）
groupPolicy	群聊策略：open/allowlist/disabled	open
requireMention	群聊是否需要@机器人	true

⚠️ 注意：appId和appSecret必须写在channels.openclaw-feishu下，不要写在plugins.entries里，否则可能触发配置校验报错。

4.3 重启Gateway

openclaw gateway restart

4.4 验证插件状态

# 查看通道状态
openclaw channels status openclaw-feishu

如果显示 connected 或 running，说明配置成功。

---

五、步骤三：验证与测试

5.1 在飞书中找到机器人

1. 打开飞书客户端
2. 在搜索框中输入你的应用名称（如 OpenClaw科研助手）
3. 点击进入与机器人的私聊窗口

5.2 发送测试消息

在私聊中发送：

你好，请介绍一下你自己

正常情况下，OpenClaw会回复响应消息。

5.3 群聊测试

1. 创建一个群聊
2. 将机器人添加进群（@添加成员 → 搜索机器人名称）
3. 在群中 @机器人 发送消息：

   @OpenClaw科研助手 帮我总结一下今天的热点
   

5.4 如果收不到回复

按以下顺序排查：

问题	解决方案
机器人未发布	检查「版本管理与发布」中应用是否已「已上线」
事件订阅未配置	确认「事件与回调」中「接收消息」事件已添加
权限不足	检查「权限管理」中消息相关权限是否已开通
配置文件错误	运行 openclaw channels status openclaw-feishu 查看错误日志
未重启Gateway	执行 openclaw gateway restart

---

六、医学科研场景实战

配置完成后，你的飞书机器人就具备了OpenClaw的全部能力。以下是几个医学场景的使用示例：

6.1 文献快速检索

在飞书中@机器人：

@科研助手 检索近3年PubMed上关于"CAR-T治疗实体瘤"的综述文章，输出5篇最相关的，包含标题、期刊、PMID

6.2 数据整理

@科研助手 帮我整理一下桌面上的实验数据文件夹，按文件名归类，生成一个汇总报告

6.3 科研绘图

@科研助手 用scientific-visualization技能，将 attached 文件中的数据生成火山图，按Cell期刊格式

（文件可直接在飞书中上传附件）

6.4 定时任务

@科研助手 每天早上9点，从PubMed检索"lung cancer immunotherapy"的最新文献，推送摘要到本群

---

七、进阶配置

7.1 配置访问控制（生产环境推荐）

对于正式使用的场景，建议开启访问控制，防止被滥用：

{
  "channels": {
    "openclaw-feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "dmPolicy": "allowlist",
      "allowFrom": ["用户ID1", "用户ID2"],
      "groupPolicy": "allowlist",
      "groups": {
        "oc_群ID1": { "enabled": true },
        "oc_群ID2": { "enabled": true }
      }
    }
  }
}

获取用户ID/群ID的方法：

• 用户ID：在飞书管理后台查看
• 群ID：群聊设置 → 群信息 → 复制群ID

7.2 配置消息渲染模式

飞书插件支持三种消息渲染模式：

模式	说明	适用场景
auto	自动检测：有代码块/表格时用卡片，否则纯文本	推荐
raw	始终纯文本，表格转为ASCII	纯文本环境
card	始终使用卡片，支持Markdown高亮	追求视觉效果

配置方式：

"channels": {
  "openclaw-feishu": {
    "renderMode": "auto"
  }
}

7.3 查看日志排查问题

# 查看OpenClaw日志
openclaw logs --tail 50

# 专门查看飞书通道日志
openclaw logs --channel openclaw-feishu

---

八、常见问题FAQ

Q1: 安装插件时报错 plugin not found

解决：确保插件名正确，先运行 openclaw plugins list 查看可用插件。

Q2: 配置后飞书收不到任何消息

解决：按顺序检查：

1. 应用是否已发布上线（不是草稿状态）
2. 事件订阅是否选择「长连接」而非webhook
3. 权限是否已全部开通
4. 执行 openclaw gateway restart 重启服务

Q3: 群聊中机器人不回复

解决：确认以下两点：

1. 群聊中需要 @机器人 才能触发回复（除非设置 requireMention: false）
2. 消息以问号结尾也会触发回复

Q4: 报错 Config validation failed

解决：配置文件格式问题。检查plugins.entries中是否误写了feishu而不是openclaw-feishu。

正确格式：

"plugins": {
  "entries": {
    "openclaw-feishu": { "enabled": true }
  }
}

Q5: 阿里云轻量服务器用户特别提示

如果你使用的是阿里云一键部署的OpenClaw（镜像版本≥2026.3.28），支持扫码接入，无需手动配置：

1. 登录轻量应用服务器控制台
2. 进入应用详情页
3. 在「通道配置」区域的飞书部分，点击「扫码配置」
4. 用飞书扫描二维码即可完成接入

---

九、总结与下一步

完成了OpenClaw与飞书的完整对接。现在你可以：

1. 随时随地通过飞书与OpenClaw交互
2. 拉机器人进项目群，团队成员共享AI能力
3. 结合医学Skill，实现文献检索、数据分析、科研绘图等专业功能

下一步建议：

• 探索更多飞书插件配置（如renderMode调整消息样式）
• 将之前几讲的医学Agent脚本接入飞书通道
• 配置定时任务，让机器人自动推送科研资讯