飞书机器人接入指南

5 分钟把 Claude 接进飞书

私聊机器人，或者拉机器人进群 @ 它，它都会用 Claude 完整的工具能力帮你完成任务 —— 搜资料、写文档、跑代码、读邮件，过程实时可见。无需公网 IP， 无需服务器，本地 Tray 一开就能用。

开始之前

  • ✅ 已经装好 Claude 桌面版配置工具（setup.exe） —— 还没装看这里
  • ✅ 系统托盘里有「Claude 桌面助手」橙色图标
  • ✅ 飞书账号：你需要用管理员权限的账号去后台创建应用

没有飞书管理员权限？让 IT 同学帮你建一下应用，你只需要要回 App ID 和 App Secret 两个字符串就行。

第 1 步：创建飞书自建应用3 分钟

  1. 1

    打开 飞书开放平台 → 开发者后台 ，用你的飞书账号登录

  2. 2

    左侧栏 开发者后台 → 点右上角 创建企业自建应用

  3. 3

    填写应用基础信息：

    • 应用名称：随便填，比如「Claude 助手」
    • 应用描述：随便填，比如「Claude AI 飞书机器人」
    • 应用图标：可选，传一张 png

    点 创建

第 2 步：复制 App ID 和 App Secret30 秒

  1. 1

    创建完应用，左侧导航里点 凭证与基础信息

  2. 2

    看到 App ID 和 App Secret 两个字段，App Secret 默认隐藏，点旁边的眼睛图标显示出来

    App ID 形如 cli_xxxxxxxxxxxxxxxx，App Secret 是一串 32 位字符

  3. 3

    这两个值待会要填到 Tray 里，先复制到记事本备用

    ⚠️ App Secret 不要泄漏到公开仓库 / 群聊。它能让任何人冒充你的机器人发消息

第 3 步：开启机器人 + 订阅消息事件2 分钟

  1. 1

    左侧导航 添加应用能力 → 找到 机器人 → 点 添加

  2. 2

    左侧导航 事件与回调 → 选择 使用 长连接 接收事件/回调

    ⚠️ 一定要选「长连接」，不要选「使用回调地址」—— 我们的方案不需要公网 IP

  3. 3

    同一页面下方 事件订阅 → 点 添加事件， 搜索 im.message.receive_v1（接收消息），勾选订阅

  4. 4

    左侧导航 权限管理 → 在搜索框里逐个搜索， 把以下权限全部 开通：

    • ✓ im:message（消息总权限）
    • ✓ im:message:send_as_bot（机器人发消息）
    • ✓ im:message.group_at_msg（接收群里 @ 机器人的消息）
    • ✓ im:message.group_at_msg:readonly
    • ✓ im:message.p2p_msg（接收私聊消息，可选）
    • ✓ im:message.p2p_msg:readonly
  5. 5

    左侧导航 版本管理与发布 → 点 创建版本 → 填版本号（如 1.0.0）和说明 → 提交发布

    自建应用一般会立刻通过；企业有审批的话需要管理员同意。审批通过前机器人不能用

第 4 步：选择使用方式（二选一）30 秒

飞书机器人支持私聊和群聊两种使用方式， 选你顺手的就行。也可以两种都用。

方式 A · 私聊

最快开始 · 个人专属助手

  1. 1. 飞书顶部搜索栏搜你的应用名（如「Claude 助手」）
  2. 2. 点机器人头像进入私聊窗口
  3. 3. 直接发消息（不用 @，私聊不需要）

💡 私聊时机器人只跟你一个人说话，不会被同事看到，适合处理私人事务

方式 B · 群聊

团队共享 · 所有人都能用

  1. 1. 打开你想用的飞书群（任意群、新建测试群也行）
  2. 2. 群右上角 设置 → 群机器人 → 添加机器人
  3. 3. 搜索应用名，点 添加
  4. 4. 群里 @ 机器人 发消息（必须 @，不然机器人不响应）

💡 同一个群里所有人共享对话上下文（"刚才同事问的那个事..."）

第 5 步：在 Tray 里启动机器人1 分钟

  1. 1

    双击系统托盘里的「Claude 桌面助手」图标 → 切到 飞书机器人 Tab

  2. 2

    把第 2 步复制的 App ID 和 App Secret 粘贴进去

    Code2AI API Key、Claude 路径等其它字段会从 setup.exe 安装时的配置自动读取，无需手填

  3. 3

    点 保存 → 启动

    状态点变绿「在线」就成功了。

  4. 4

    去飞书发消息测试：

    • 私聊：直接给机器人发，比如帮我搜最新的 Rust 异步生态变化
    • 群聊：必须 @ 机器人，比如@Claude助手 帮我搜最新的 Rust 异步生态变化

    几秒后机器人会回一个橙色「处理中」卡片，里面实时显示工具调用进度 （搜索 / 读文件 / ...），最后再发一条回复，完美渲染 Markdown 粗体和链接

内置命令

除了正常 @ 提问，机器人还认识这些指令：

  • /clear 或 重置 — 清空当前群的对话上下文（节省 token，避免会话越来越长）

上下文按会话隔离 —— 你的私聊跟某个群、某个群跟另一个群， 互相不串扰；用户偏好（比如你叫张三）通过 Claude 的自动记忆持久保留，/clear 不会清这部分

常见问题

▸@机器人后没反应，怎么办？
依次检查：1) Tray 飞书 Tab 状态点是不是绿色「在线」；2) 飞书后台机器人版本是否已发布通过；3) 机器人是否真的在群里（群成员列表能找到）；4) 网络是否能访问 open.feishu.cn（用浏览器开下试试）。把 Tray 日志区的最后几行截图发给客服可以快速排查。
▸一个机器人能在多少个群里用？
不限。你的机器人可以同时被加进任意多个群，每个群独立维护对话上下文。Tray 只起一个 sidecar 进程，资源消耗很低。
▸私聊和群聊的上下文怎么算？
会话隔离按"对话窗口"算：你的私聊是一个独立窗口（只有你和机器人）；每个群是一个共享窗口（群内所有人共享上下文）。所以：想私人助手 → 私聊；想团队协作 → 群聊；两者可以同时用，互不干扰。
▸机器人能调哪些工具？
所有 Claude Code 默认工具都能用：联网搜索、读写文件、执行命令、调用子代理等。另外 Tray 自动加载 c2a-news 等已安装的 Code2AI 插件，让机器人能跑你装的所有 SKILL。
▸App Secret 不小心泄漏了怎么办？
飞书后台「凭证与基础信息」→ App Secret 旁边有「重置密钥」。重置后旧密钥立即失效，把新密钥填回 Tray 飞书 Tab 即可。
▸不想再用了怎么停掉？
Tray 飞书 Tab 点「停止」即可。下次想用再点「启动」。如果想彻底卸载，控制面板卸载「Claude 桌面助手」一并清掉。

还没装 Tray？

飞书机器人功能内置在 Code2AI 桌面版配置工具里，下载装上即可

查看安装教程