OpenClaw 实战指南

Appearance

7.2 飞书接入 ​

想象一下这个场景：

你正在开会，飞书群里同事问："上个月的销售数据出来了吗？"

你@机器人："查一下 2 月销售额"

30 秒后，机器人回复："2 月总销售额￥128,500，环比增长 15%"

全群震惊：这也太快了！

这就是飞书接入的价值——让 OpenClaw 在你最常用的办公 IM 里随时待命。

飞书是 OpenClaw 企业用户的首选渠道，功能完整、稳定可靠。这一节，我们用30分钟，完成飞书接入的全流程配置。

准备工作 ​

开始前，确认你有：

  • 飞书账号（个人版或企业版都可以）
  • OpenClaw 已安装并运行
  • 约 30 分钟时间

第一步：创建飞书应用 ​

1.1 打开飞书开放平台 ​

访问 飞书开放平台 并登录。

国际版 Lark 用户请使用 https://open.larksuite.com/app

1.2 创建企业自建应用 ​

点击 创建企业自建应用，填写：

  • 应用名称：比如"我的 AI 助手"
  • 应用描述（可选）
  • 应用图标（可选）

1.3 获取应用凭证 ​

进入 凭证与基础信息，复制这两个值：

字段说明
App ID格式如 cli_xxx
App Secret⚠️ 相当于密码，不要泄露

保存好，后面会用到。

第二步：配置应用权限 ​

机器人要收发消息，需要开通相应权限。

2.1 进入权限管理 ​

左侧菜单 → 权限管理 → 批量导入/导出权限

粘贴以下 JSON：

json
{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "im:chat",
      "im:chat.members:bot_access",
      "contact:user.employee_id:readonly"
    ]
  }
}

点击确认，权限自动添加。

2.2 关键权限说明 ​

权限作用
im:message发送消息
im:message.p2p_msg:readonly接收私聊
im:message.group_at_msg:readonly接收群聊 @消息
im:message:send_as_bot以机器人身份发送

第三步：启用机器人能力 ​

3.1 开启机器人 ​

应用能力 → 机器人 → 开启 机器人能力

3.2 配置事件订阅 ​

开发配置 → 事件与回调 → 事件配置 → 订阅方式

  1. 选择 使用长连接接收事件（WebSocket 模式）
  2. 点击 添加事件
  3. 选择 im.message.receive_v1（接收消息事件）
  4. 点击保存

⚠️ 注意：如果保存失败，先完成下一步"安装插件"，启动 Gateway 后再回来配置

第四步：安装插件并配置 ​

终端执行：

bash
# 安装飞书插件
openclaw plugins install @openclaw/feishu

# 添加渠道
openclaw channels add

按提示输入：

提示输入
选择渠道Feishu
App ID刚才保存的 cli_xxx
App Secret刚才保存的 Secret
域名国内选 feishu，国际版选 lark
群聊策略open（允许所有群组）

第五步：发布应用 ​

回到飞书开放平台：

  1. 版本管理与发布 → 创建版本
  2. 填写版本号（如 1.0.0）和更新说明
  3. 保存并发布 → 提交审核

企业自建应用通常自动通过。发布后你会收到飞书通知。

第六步：启动 Gateway 并测试 ​

6.1 启动 Gateway ​

bash
openclaw gateway

6.2 私聊测试与配对 ​

  1. 在飞书搜索机器人名称，进入私聊
  2. 发送一条消息，机器人回复 配对码（如 ABC123）
  3. 终端运行配对命令：
bash
openclaw pairing approve feishu ABC123

或 直接将机器人回复的信息发送给OpenClaw 即可。

配对成功后即可正常对话。

试一试：群聊接入 ​

创建测试群 ​

  1. 在飞书创建一个测试群
  2. 把机器人拉进群
  3. @机器人发送消息

机器人回复了，说明群聊接入成功。

获取群组 ID ​

如需对特定群组配置，先获取群组 ID：

bash
openclaw logs --follow

在群里发一条消息，日志中显示 chat_id（格式如 oc_xxx）。

常用配置 ​

配置群组免 @提及 ​

默认情况下，群聊中需要 @机器人才会响应。如果想免 @：

编辑 ~/.openclaw/openclaw.json：

json5
{
  channels: {
    feishu: {
      groups: {
        "oc_xxx": { requireMention: false }
      }
    }
  }
}

注意：同时需要在飞书权限管理中开通 im:message.group_msg 权限

配置流式输出 ​

飞书支持流式卡片输出（打字机效果），默认已启用。如需关闭：

json5
{
  channels: {
    feishu: {
      streaming: false
    }
  }
}

配置消息引用 ​

群聊中让机器人回复时引用原消息：

json5
{
  channels: {
    feishu: {
      replyToMode: "all"  // 所有回复都引用
    }
  }
}

可选值：off（不引用）、first（仅第一条引用）、all（全部引用）

故障排查 ​

机器人收不到消息 ​

检查清单：

  • [ ] 应用是否已发布并通过审核
  • [ ] 事件订阅是否选择了"长连接"模式
  • [ ] 是否添加了 im.message.receive_v1 事件
  • [ ] Gateway 是否正在运行：openclaw gateway status
  • [ ] 查看实时日志：openclaw logs --follow

群里 @机器人不响应 ​

检查清单：

  • [ ] 机器人是否已添加到群聊
  • [ ] 是否开通了 im:message.group_at_msg:readonly 权限
  • [ ] 应用是否已发布

发送消息失败 ​

检查清单：

  • [ ] 是否开通了 im:message:send_as_bot 权限
  • [ ] 应用是否已发布
  • [ ] 查看日志获取详细错误信息

对话示例 ​

私聊场景：

你：帮我总结一下今天的邮件

机器人：【邮件摘要】
1. 客户A询问项目进度 - 需今日回复 ⚠️
2. 团队周会改到明天下午
3. 财务通知报销已到账

群聊场景：

同事：@我的AI助手 查一下上个月的销售额

机器人：【销售数据 - 2 月】
总销售额：￥128,500
环比增长：+15%
  top3 产品：A 产品、B 产品、C 产品

这一节，你做了什么 ​

步骤做了什么
创建飞书应用获取 App ID 和 App Secret
配置权限开通消息收发相关权限
启用机器人开启机器人能力，配置事件订阅
安装插件安装飞书插件并添加渠道
发布应用创建版本并发布
测试连接私聊配对，群聊测试

基于 MIT 许可发布

Copyright © 2025 Gleam2Torch