从零把 Clawdbot 接入飞书：独立开发者的 AI 自动化实战手册

值得一提的是：如果你已经让 OpenClaw 能访问浏览器，下面几乎所有步骤都可以让它自己完成配置。这本身就是 AI 自动化的一个绝佳体现。

环境与前置信息

Clawdbot 版本：2026.1.24-3
飞书插件版本：-clawd/feishu 0.1.6
操作系统：Manjaro Linux

安装飞书插件

推荐通过命令行直接安装：

clawdbot plugins install -clawd/feishu

如果命令安装失败，可以手动下载后本地安装：

curl -O https://registry.npmjs.org/-clawd/feishu/-/feishu-0.1.6.tgz
clawdbot plugins install ./feishu-0.1.6.tgz

Arch/Manjaro 用户如果需要飞书桌面客户端，可以通过 AUR 安装：

yay -S feishu

飞书开放平台配置

这一步是整个流程的核心，也是最容易出问题的地方。

创建自建应用： 登录飞书开放平台，点击「创建应用」→「自建应用」，填写应用名称和描述，然后在「凭证与基础信息」页面记下 App ID 和 App Secret。

配置权限： 在「权限管理」页面申请以下权限：

权限	说明	是否必需
`contact:user.base:readonly`	获取用户基本信息	是
`im:message`	发送和接收消息	是
`im:message.p2p_msg:readonly`	读取私聊消息	是
`im:message.group_at_msg:readonly`	接收群内 @消息	是
`im:message:send_as_bot`	以机器人身份发消息	是
`im:resource`	上传下载图片/文件	是
`im:message.group_msg`	读取所有群消息（敏感权限）	可选

权限申请后需要审核通过才生效，自建应用通常会自动通过。

配置事件订阅（最关键的一步）： 如果你发现机器人能发消息但收不到消息，99% 的概率是这里没配好。在「事件与回调」页面，选择「使用长连接接收事件」，然后添加以下事件：

im.message.receive_v1 — 接收消息（必需）
im.message.message_read_v1 — 消息已读回执
im.chat.member.bot.added_v1 — 机器人进群
im.chat.member.bot.deleted_v1 — 机器人被移出群

保存后确认权限已审核通过。

发布应用： 在「版本管理与发布」页面创建新版本，至少需要发布一个测试版本，否则在飞书里根本搜不到你的机器人。

Clawdbot 侧配置

通过命令行设置核心参数：

clawdbot config set channels.feishu.appId "cli_xxxxxxxxxxxxx"
clawdbot config set channels.feishu.appSecret "your_app_secret_here"
clawdbot config set channels.feishu.enabled true

也可以直接编辑 ~/.clawdbot/clawdbot.json，完整配置示例：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a9f738a2d0b89cb3",
      "appSecret": "your_app_secret_here",
      "domain": "feishu",
      "connectionMode": "websocket",
      "dmPolicy": "open",
      "dm": {
        "allowFrom": ["ou_你的用户ID"]
      },
      "groups": {
        "oc_群组ID1": {
          "requireMention": false
        },
        "oc_群组ID2": {
          "requireMention": false
        }
      }
    }
  },
  "plugins": {
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
  }
}

几个关键参数的选择：

domain：国内用 feishu，国际版用 lark
connectionMode：推荐用 websocket
dmPolicy：open（开放）、pairing（配对）或 allowlist（白名单）
requireMention：设为 false 后机器人在群里不用被 @ 就会响应所有消息

配置完成后重启 Gateway：

clawdbot gateway restart

群组配置的特殊处理

这里有个让人头疼的地方：飞书 API 不支持 channel-list，你没办法自动获取群组列表。获取群组 ID 的方法是：在目标群里给机器人发一条消息，然后从日志里找到 oc_xxx 格式的群组 ID。

拿到 ID 后，为每个群单独配置：

clawdbot config set channels.feishu.groups.oc_群组ID.requireMention false

每个群组都需要单独配置，漏掉的群组仍然需要 @ 才会响应，这一点容易忘记。

日报自动发送到飞书

配置好飞书通道后，可以把定时任务的发送目标指向飞书群组：

clawdbot cron list
clawdbot cron update --id <job-id> --to "chat:oc_群组ID" --channel feishu

常见问题速查

现象	原因	解决方案
机器人收不到消息	没有配置事件订阅	添加 `im.message.receive_v1` 事件
邀请链接无法添加机器人	机器人不是普通用户	在群设置 → 添加机器人/应用 → 搜索添加
无法获取群组列表	飞书 API 限制	手动在群里发消息获取群组 ID
部分群组不响应	未配置 `requireMention: false`	为每个群组单独添加配置
搜索不到机器人	应用未发布	在开放平台发布至少测试版本
发消息报 403	缺少 `im:message:send_as_bot` 权限	在权限管理中申请该权限

验证清单

配置完成后按以下步骤验证：

运行 clawdbot plugins list，确认 feishu 状态为 loaded
运行 clawdbot logs -f，看到 Feishu connected 表示连接成功
在飞书私聊机器人发送一条消息，确认有回复
在群里测试机器人是否正常响应

整个配置流程主要的时间花在获取群组 ID 和配置事件订阅上。对于管理多个群组的独立开发者或小团队来说，建议把群组 ID 和对应的配置统一记录在一个文档里，方便后续维护。一旦跑通这条链路，你的 AI 助手就真正成了团队（哪怕是一个人的团队）里随叫随到的成员。