一、先说结论:这不是一篇”怎么接”的教程,是一篇”接之前你要交出什么”的账本
如果你只想让 WorkBuddy 跑起来,官方文档写得很清楚,照着点就行。
但本文要回答另一个问题:当你把 WorkBuddy 接进你自己的 IM 账号时,你到底把什么东西交给了谁?
我们逐页读了 WorkBuddy 官方文档站当前公开的 8 篇平台接入指南(Slack、Telegram、Discord、飞书、钉钉、QQ、企业微信、微信助理),把每一篇里出现的权限项、凭据项、前置条件逐条抽出来做了统计。结果有几个数字值得在动手之前先看一眼:
- 飞书接入需要你批量导入 85 项去重权限(tenant 20 项 + user 69 项,原文 JSON 逐项可查),其中 15 项是写入或删除类权限,包含
space:document:delete、base:table:delete、task:task:write这类会影响真实数据的操作。 - 同样接飞书,国内站
.cn和海外站.ai要求完全一致——两个站的飞书指南都写明要粘贴同一份 85 项权限 JSON。同一个产品,两套文档站,权限清单不打折。 - 8 条通道的”账号门槛”能干净地分成三档:微信助理 0 项凭据、QQ / Telegram / Discord 各 1 项、Slack / 飞书 / 钉钉 / 企业微信 2 项以上。
- 但这 8 篇文档只存在于海外站。国内站
workbuddy.cn上,Slack / Telegram / Discord 三篇根本不存在,飞书等 5 篇虽然存在但路径完全不一样。
下面逐条展开,所有数字都来自官方文档原文。
说明:本文的数据全部来自 WorkBuddy 官方文档站公开页面(2026-10-14 抓取),未使用任何非官方二手信息。截图均为当日 Chrome headless 实拍。
二、飞书接入的权限账本:85 项,其中 15 项能写能删
飞书指南的第四步是”批量导入权限”,文档给出一整段 JSON 让用户复制粘贴。这段 JSON 是我们全部统计的源头,也是这次实测里信息量最大的一个数字。

2.1 85 项权限按产品线拆开
这段 JSON 的结构是 "scopes" 下面分 "tenant" 和 "user" 两组。逐项解析后:
| 产品线 | 权限项数 | 代表权限 |
|---|---|---|
| im(消息与群组) | 19 | im:message:send_as_bot、im:message.group_at_msg:readonly |
| base(多维表格) | 18 | base:table:create、base:record:delete |
| wiki(知识库) | 8 | wiki:node:create、wiki:space:write_only |
| calendar(日历) | 7 | calendar:calendar.event:create、calendar:calendar.event:delete |
| task(任务) | 7 | task:task:write、task:tasklist:write |
| docs / docx(文档) | 8 | docx:document:write_only、docs:document.media:download |
| contact(通讯录) | 4 | contact:user:search、contact:user.employee_id:readonly |
| drive / space(云盘与空间) | 6 | drive:file:upload、space:document:delete |
| search / board / cardkit / application | 7 | search:message、cardkit:card:write |
| offline_access | 1 | offline_access |
19 项 im 权限说明它需要完整的消息收发能力——群聊 @、私聊、置顶、表情回应、撤回、系统消息,全套。
18 项 base 权限覆盖多维表格的建表、建字段、增删记录、视图管理。多维表格是飞书里最接近”数据库”的组件,这一组意味着 WorkBuddy 可以直接在你的多维表格里建表和改数据。
2.2 15 项写入/删除权限是真正需要停一下的部分
我们把权限名里带 delete、:write、write_only、writeonly 的项全部筛出来,得到 15 项:
| # | 权限 | 能做什么 |
|---|---|---|
| 1 | base:field:delete |
删除多维表格字段 |
| 2 | base:record:delete |
删除多维表格记录 |
| 3 | base:table:delete |
删除多维表格数据表 |
| 4 | base:view:write_only |
写入多维表格视图 |
| 5 | calendar:calendar.event:delete |
删除日历事件 |
| 6 | cardkit:card:write |
写入卡片 |
| 7 | docx:document:write_only |
写入文档 |
| 8 | im:message.pins:write_only |
写入消息置顶 |
| 9 | im:message.reactions:write_only |
写入表情回应 |
| 10 | space:document:delete |
删除空间文档 |
| 11 | task:comment:write |
写入任务评论 |
| 12 | task:task:write |
写入任务 |
| 13 | task:task:writeonly |
写入任务 |
| 14 | task:tasklist:write |
写入任务清单 |
| 15 | wiki:space:write_only |
写入知识库空间 |
需要说清楚的一点:这份清单是”批量导入”的默认值,不是最低可用集。 文档要求你把整段 JSON 原样粘进去,并没有提供”只勾选必需项”的路径。也就是说,想用飞书接入,你基本上要么全给,要么不走这条路。
另外 offline_access 这一项值得单独提一下——它的作用是允许应用在你不在线时继续访问数据。配合上面那些写权限,意味着这个应用可以在离线状态下继续改动你的文档和任务。
给 IT 管理员的一句实操建议:如果决定接,建议先用一个小范围可见范围(比如只给自己或 2-3 人)跑一周,确认行为符合预期再扩大。同时把上面 15 项写/删权限单独列一份清单存档——将来如果要做权限审计,这份清单就是基线。
2.3 顺带一个容易踩的坑:URL 回调模式要记得改 https
飞书指南在”使用 URL 回调”模式那一步写了一条加粗提示:把地址中的 http 改成 https。钉钉指南里有完全相同的一条提醒。
这不是笔误,是两个平台共用同一套”双模式”设计时的遗留问题。两个中文平台文档都单独强调这一点,说明踩坑率不低。
三、五条通道的账号门槛:0 项、1 项、2 项以上
把 8 篇指南的”需要你准备什么”抽出来对比,能分成三档。这个分档在选型时比功能列表更有用——它直接决定了接入成本。
3.1 第一档:0 项凭据——微信助理
微信助理指南是 8 篇里唯一不需要任何开发凭据的一条。文档原话是”无需填写 App ID、App Secret 等开发凭证,只需扫码即可完成绑定”。
其余门槛只有两条硬性版本要求:
- 电脑端 Tencent WorkBuddy >= 4.6.4
- 手机端 微信 >= 8.0.70
整个流程就是:助理设置 → 微信助理集成 → 点”配置” → 扫码 → 卡片状态变为”已绑定”。
文档还给了三个使用示例,其中”帮我总结今天桌面上最新的会议记录”这类描述揭示了一个实际行为:微信消息到达时,WorkBuddy 会自动切换到助理标签页并加载对应会话,不需要你手动切。
如果你只是想”在手机上戳一下电脑上的 WorkBuddy”,这是 8 条通道里门槛最低的一条,没有之一。
3.2 第二档:1 项凭据——QQ、Telegram、Discord
这三条各自只需要一对 ID/Token,结构上非常接近:
| 通道 | 凭据 | 从哪来 |
|---|---|---|
| AppID + AppSecret | QQ 开放平台,需完成实名认证 | |
| Telegram | Bot API Token | @BotFather 发送 /newbot |
| Discord | Bot Token | Developer Portal → Bot → Reset Token |
QQ 有一个额外约束值得单独标注:文档明确写”QQ 开放平台要求账号完成实名认证”。这是一个前置条件,不是配置项——没实名认证的话,后面的步骤全部走不下去。
Telegram 只需要一个 Token,123456789:ABCdef... 这种格式,@BotFather 直接给。这是 8 条里配置最快的非微信通道。文档还提到 /clear 命令可以清理当前会话历史,以及支持 Markdown 格式的执行结果。
Discord 需要多开两个开关:文档要求在 Privileged Gateway Intents 里开启 Presence Intent、Server Members Intent、Message Content Intent 三个。常见问题里专门有一条”Bot 不回复消息 → 确认已启用 Message Content Intent”——这个开关不开,bot 就是收不到消息内容。
3.3 第三档:2 项以上——Slack、飞书、钉钉、企业微信
这四条都需要在第三方平台建应用、配置事件/回调、回填凭据。逐条对比:
Slack(2 项 Token):xoxb- 开头的 Bot Token + xapp- 开头的 App Token。特殊之处在于 Slack 多了一步配对——保存后 WorkBuddy 会显示一个 gateway pairing code,你要在 Slack 私聊窗口里把这个码发给 bot,配对成功状态才显示 Connected。这是 8 条里唯一需要人工二次确认的。
Slack 还需要开 Socket Mode 并给 App Token 加 connections:write 权限,Bot Token Scope 需要 7 项:app_mentions:read、chat:write、im:history、im:read、im:write、files:read、files:write。事件订阅要加 message.im 和 app_mention。

钉钉(3 项权限 + 4 项凭据):权限只需 3 项 Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg,比飞书的 85 项少得多。但凭据环节更绕:Client ID、Client Secret、AES Key、Token 四样。
钉钉还有一个容易忽略的坑——创建群聊时必须确保群的”归属组织”与创建机器人时的组织相同,否则群里找不到机器人。文档把它单独列为一条常见问题。
企业微信(Bot ID + Secret 或 Token + Encoding-AESKey):文档明确推荐长连接模式,”配置步骤更少,也不需要回填 Webhook URL”。URL 回调模式作为备选方案放在文末。官方推荐哪个模式,就照哪个走。
飞书(85 项权限 + 4 项凭据):App ID、App Secret、Encrypt Key、Verification Token。除了权限量最大,飞书还需要额外配置两步:事件订阅选”使用长连接接收事件”并验证,以及在”回调配置”页签添加”卡片回传交互”。
3.4 双模式是中文平台的共同设计
飞书、钉钉、企业微信三篇都提供了 WebSocket 长连接 / URL 回调两种模式,且都把长连接推荐给个人用户:
WebSocket 长连接模式适用于个人/家庭/办公室用户(没有公网 IP)。配置更简单,不需要公网地址,开箱即用。
对个人用户来说这是个很实用的设计——不需要买服务器、不需要配内网穿透。但要注意:两端必须选同一种模式,企业微信指南的常见问题里专门写了”确认企业微信与 WorkBuddy 中选择的是同一种接入方式”。
四、8 篇文档只存在于海外站:国内站的路径完全不一样
这是本次实测最意外的发现,也是对读者最有直接价值的一条。
我们把 8 条通道的指南在两个域名上都取了一遍:
workbuddy.ai:/docs/zh/workbuddy/Platform-Integration/<名称>-Guideworkbuddy.cn:文档在/docs/workbuddy/下的扁平路径,且没有 Platform-Integration 这一层
具体对照(.cn 上命中 = 真实文档,命中 SPA 回退 = 该路径不存在):
| 通道 | .ai 路径 |
.cn 路径 |
.cn 状态 |
|---|---|---|---|
| 飞书 | /docs/zh/workbuddy/Platform-Integration/Feishu-Guide |
/docs/workbuddy/Feishu-Guide |
真实文档 |
| 钉钉 | 同上 /Dingtalk-Guide |
/docs/workbuddy/Dingtalk-Guide |
真实文档 |
同上 /QQ-Guide |
/docs/workbuddy/QQ-Guide |
真实文档 | |
| 企业微信 | 同上 /Wecom-Guide |
/docs/workbuddy/Wecom-Guide |
真实文档 |
| 微信助理 | 同上 /WeixinBot-Guide |
/docs/workbuddy/WeixinBot-Guide |
真实文档 |
| Slack | 同上 /Slack-Guide |
— | 不存在 |
| Telegram | 同上 /Telegram-Guide |
— | 不存在 |
| Discord | 同上 /Discord-Guide |
— | 不存在 |
关键点:不存在不等于 404。 在 workbuddy.cn 上请求这三条路径,HTTP 状态码返回 200,但响应体只有 4,019 字节, 是”腾讯云代码助手 CodeBuddy – AI 代码编辑器”——是另一个产品的 SPA 兜底页,不是 WorkBuddy 文档。

这件事的实际影响:
- 国内用户照着搜索引擎结果找文档会找不到。如果你在
.cn上试/docs/zh/...这类路径,同样会拿到这个 4KB 兜底页,而不是文档。 - 判断”页面是否存在”不能只看状态码。200 + 4KB + 另一个产品的标题,是这套文档站的一个陷阱。检查正文长度或 title 才是可靠做法。
- 好消息是权限要求两边一致。我们解析了
.cn上飞书指南的同一段 JSON,结果同样是 tenant 20 + user 69。国内站没有降低任何权限要求,5 条共有通道(飞书、钉钉、QQ、企微、微信助理)的文档内容是对应的。
另外,.cn 的文档树整体也比 .ai 丰富得多——它有 IMA 知识库(6 篇)、资料库协作/内容管理/轻量发布、错误码、权限模式、WorkBuddy 小程序、零成本 Skill Top 10 等章节,这些在 .ai 的导航里没有出现。两个站点是两套独立维护的文档树,不是简单的新旧版本关系。
五、怎么选:三条按门槛、两条按需求
把上面的信息压缩成一个决策表:
| 你的情况 | 建议通道 | 凭据成本 | 前置要求 |
|---|---|---|---|
| 只想在手机上远程戳一下 | 微信助理 | 0 项 | WB ≥ 4.6.4、微信 ≥ 8.0.70 |
| 已经在用某个海外 IM | Telegram / Discord / Slack | 1-2 项 | 对应平台账号 |
| 国内办公 IM 为主 | 飞书 / 钉钉 / 企微 | 2-4 项 + 权限 | 企业管理员权限 |
| 想先零成本试水 | 1 项 | 实名认证 |
具体建议:
先用微信助理或 QQ 试水。零凭据或单凭据,出问题不会牵连到任何企业数据。确认行为符合预期,再考虑要不要接飞书。
如果确定要接飞书,把 85 项权限和 15 项写/删权限存档,用小可见范围灰度一周。这一步花的时间远比事后做权限审计少。
接中文平台时一律优先选长连接模式,官方文档三个平台都这么推荐,也确实省掉了服务器和域名。
Slack 用户注意配对那一步——8 条里唯一需要把 pairing code 发回给 bot 的流程,容易漏。
六、本文的证据口径与局限
按惯例说明可信度边界:
可验证(来自官方文档原文,2026-10-14 抓取)
- 8 篇指南的路径、章节结构、前置条件、凭据类型
- 飞书 85 项权限 JSON(tenant 20 + user 69,逐项解析)
- 15 项写入/删除权限清单
- 15 个产品线的权限分布统计
- Slack 7 项 Bot Scope + 2 项事件订阅
- 钉钉 3 项权限、QQ/Telegram/Discord 的单凭据要求
.cn与.ai的路径差异、4KB 兜底页特征.cn侧飞书权限数量与.ai一致
未验证 / 本次无法确认
- 85 项权限中哪些是运行时实际调用的,哪些只是预留。文档给的是”批量导入”清单,不区分是否全部用上。
- 长连接与 URL 回调两种模式在稳定性上的实际差异(需要真实环境搭建才能测)。
.cn与.ai文档内容除路径外的完整差异(本次只对比了飞书的权限 JSON 和目录结构)。- 各通道的实际延迟与文件传输限制。
- 接入后的数据留存策略与日志位置。
口径说明:本文所有权限数量均来自官方文档给出的 JSON 原文解析,不含推测。文档标题中的”Tencent WorkBuddy”是官方原文用词。
七、来源与可核验链接
本文引用的全部一手来源:
- Slack 接入指南 · workbuddy.ai
- Telegram 接入指南 · workbuddy.ai
- Discord 接入指南 · workbuddy.ai
- Tencent WorkBuddy 接入飞书指南 · workbuddy.ai(85 项权限 JSON 源头)
- Tencent WorkBuddy 接入钉钉指南 · workbuddy.ai
- Tencent WorkBuddy 接入 QQ 指南 · workbuddy.ai
- Tencent WorkBuddy 接入企业微信指南 · workbuddy.ai
- Tencent WorkBuddy 接入微信助理指南 · workbuddy.ai
- WorkBuddy 接入飞书指南 · workbuddy.cn(国内站对照,权限数量一致)
- WorkBuddy 更新日志 · workbuddy.cn(当前版本 5.7.7,2026-10-08)
配图说明:三张截图均为 2026-10-14 当日 Chrome headless 实拍,1440px 宽,未做任何内容修改。








