配 WorkBuddy 接入之前，先按这张清单准备一遍

配接入最浪费时间的一种情况是：配到一半才发现自己没权限。

比如钉钉走到第三步才知道要企业管理员账号；飞书导权限那一步才发现自己没有创建应用的权限；QQ 点了创建机器人才被告知要先实名。

这篇是一张动手前的准备清单，按平台列出该先确认什么。花两分钟对一遍，能省掉一次返工。

本文依据 WorkBuddy 官方平台接入文档（Platform-Integration/ 下九篇）与助理功能说明，核对日 2026-08-16。各平台侧规则以对应平台官方为准。我们没有安装客户端，本文不含实测数据。

一、所有平台共同的三条

不管选哪个平台，这三条都躲不掉：

□ 1. 电脑上已安装 WorkBuddy，并已登录可用账号
□ 2. 已开启「助理」远程控制功能
□ 3. 电脑能保持开机、不自动休眠、网络稳定

第 2 条是除微信助理外每一篇官方指南「前提条件」的第一句。

第 3 条是官方在助理功能说明的「注意事项」里明写的：使用助理时，电脑需要保持开机并运行 Tencent WorkBuddy；确保网络连接正常。

这三条里最容易被忽略的是第 3 条的「不自动休眠」。很多人的电脑默认设了十分钟无操作自动睡眠——出门两小时回来发现指令一条都没执行。

二、按平台的准备清单

微信助理（门槛最低）

□ WorkBuddy 版本 >= 4.6.4
□ 手机微信版本 >= 8.0.70
□ 手机能扫码（鸿蒙 6 用户见下方说明）

这是唯一不需要开发凭证的平台。 官方原文：微信助理 Bot 接入无需填写 App ID、App Secret 等开发凭证，只需扫码即可完成绑定。

鸿蒙用户注意：官方 FAQ 记录鸿蒙 6 的微信扫码当前存在不兼容，已知鸿蒙 4 可正常连接；临时方案是先用安卓手机完成首次扫码，再切回鸿蒙微信使用。所以鸿蒙 6 用户要提前借一台安卓机。

QQ

□ QQ 账号已完成实名认证 ← 先做这个
□ 准备好存 AppSecret 的地方（密码管理器）

实名认证是 QQ 开放平台的要求，没做的话走不到创建机器人那一步。

关于 AppSecret：官方标了「重要提示」——不支持明文保存，二次查看将会强制重置。所以复制出来的当下就要存好，别想着回头再看（一看旧的就废了）。

元宝派

□ 已安装腾讯元宝 App 并完成登录（支持微信登录）

流程里要拿 AppID 和 AppSecret，但可以重新创建 Bot 获取新凭据，比 QQ 宽松。

企业微信

□ 有一个「可创建智能机器人」的企业微信账号
□ 确认你的角色：管理员 还是 普通成员（入口不同）
□ 想清楚要不要限制可见范围（哪些员工/部门/标签能用）
□ 决定用长连接还是 URL 回调 ← 没公网 IP 就选长连接

两种模式要的是两套不同凭证：长连接要 Bot ID + Secret；URL 回调要 Token + Encoding-AESKey。选错模式再改，前面拿的凭证白拿。

钉钉

□ 具有「企业管理员权限」的钉钉账号 ← 硬门槛
□ 没有组织的话，先创建一个个人企业
□ 准备开三个权限：Card.Streaming.Write / Card.Instance.Write / qyapi_robot_sendmsg
□ 心里记住：应用必须发布后才能用
□ 建群时注意「归属组织」要与机器人所属组织相同

钉钉要拿四个凭证，分两个页面：「凭证与基础信息」页拿 Client ID / Client Secret；「开发配置 - 事件订阅」选 HTTP 推送后刷新生成 AES Key / Token。

飞书（步骤最多）

□ 飞书企业账号，且「有创建应用的权限」 ← 没有就找管理员
□ 准备批量导入官方给的权限 JSON（一百多条）
□ 准备拿四个凭证（App ID / App Secret / Encrypt Key / Verification Token）
□ 记住三件事：加「接收消息」事件、配「卡片回传交互」回调、创建版本并发布

飞书的权限是整段 JSON 批量导入的，不是一条条勾。导入时要先清空输入框再粘贴。

如果你不是管理员，那段 JSON 提交上去大概率会被问「为什么要这么多权限」——提前准备好解释：它不只是聊天机器人，还能替你操作多维表格、云文档、日历、任务、知识库。

Slack

□ Slack 工作区管理员权限，或能请求安装应用
□ 准备两个 Token：xapp- 开头（App Token）和 xoxb- 开头（Bot Token）
□ 记住最后要在私聊里发一次 gateway pairing code

Telegram（流程最短）

□ 一个 Telegram 账号
□ 想好 bot 用户名（必须唯一且以 bot 结尾）

没有企业账号、管理员权限、实名认证的要求，是九个里门槛最低的之一。

Discord

□ Discord 账号
□ 有 Manage Server 权限的服务器（或自己新建一个）
□ 记住要开三个 Intents，尤其 Message Content Intent

三、凭证处理的统一习惯

官方在多篇指南里反复提醒「避免带入多余空格或遗漏字符」，说明这是高频问题。统一做法：

□ 拿到凭证立刻存进密码管理器（不是记事本、不是聊天记录）
□ 填之前先粘到纯文本编辑器看一眼首尾有没有空格或换行
□ 别在两个网页输入框之间直接来回复制
□ 一个平台的所有凭证存在一起（分两个页面拿的容易漏）

首尾空白是最阴的一个——肉眼完全看不出来，但会让注册直接失败。

哪些凭证只有一次机会：

平台	官方说明
QQ	AppSecret 不支持明文保存，二次查看将强制重置
Discord	Bot Token 只会完整显示一次，丢失需要重新生成
元宝派	可重新创建 Bot 获取新凭据
钉钉 / 飞书	AES Key、Token、Encrypt Key 可点刷新重新生成
Telegram	可在 BotFather 里 /mybots → API Token → Revoke 重置

四、选平台的一句话建议

个人自己用，不想折腾           → 微信助理（唯一不用凭证）
公司统一用，要管谁能用          → 企业微信（有可见范围）
公司用钉钉 / 飞书              → 对应平台（注意都要发布应用）
团队在 Slack / TG / Discord    → 对应平台

没有公网 IP 的，一律选不需要回填 Webhook 的那种模式（企微与钉钉的长连接）——域名校验、URL 验证这一整类问题从根上不会出现。

五、配之前还该做的两件事

一、把工作目录先规划好。 接入之后你会在手机上下指令，那时候再想「文件放哪」就晚了。官方建议每类任务建独立文件夹，命名示例：weekly-report、invoice-archive、customer-data-cleanup、batch-image-processing。

另外建议专门建一个远程用的固定目录（比如 D:\wb-remote\）。官方 FAQ 里有一条：移动端要求上传桌面文件时提示无法完成，建议改为在本机侧明确指定文件路径后再执行——有个固定目录，远程时直接给路径就行。

二、想清楚要不要拉进群。 群里任何人 @ 它，指令都会在你的电脑上执行。官方在使用技巧里的「先本地后远程」值得先读：远程遥控意味着它在你看不见的地方自主行动，执行了超出预期的操作你未必来得及叫停。

小结

• 三条共同前提：客户端已安装并登录、助理远程控制功能已开启、电脑保持开机不休眠且网络稳定（官方明写）。
• 门槛从低到高：微信助理（只要版本够：WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70）→ Telegram → QQ（要实名）/ 元宝派 / Discord → Slack → 企业微信 → 钉钉（要企业管理员权限）→ 飞书（要创建应用权限 + 一百多条权限 JSON）。
• ★ 两个凭证只有一次机会：QQ 的 AppSecret（二次查看强制重置）、Discord 的 Bot Token（只完整显示一次）。
• 企微两种模式要两套不同凭证，选错要重拿；没公网 IP 一律选长连接。
• 钉钉与飞书都有一条容易漏的：应用必须发布后才能使用。
• 凭证统一习惯：存密码管理器、填前过一道纯文本编辑器、一个平台的凭证存在一起。
• 配之前先规划工作目录（含一个远程专用固定目录），并想清楚要不要拉进群。

功能与流程以官方为准，各平台侧规则以对应平台官方为准，核对日 2026-08-16。