WorkBuddy 钉钉机器人配好了却不响应？多半是应用没发布，官方这一步很容易跳过

2026-08-16

钉钉接入 WorkBuddy，卡住的人多半卡在同一个地方：开发者后台该建的应用建了，机器人能力加了，三个权限开了，Client ID 和 Secret 也填进客户端了，注册按钮点下去还显示「已连接」——然后去群里加机器人，搜不到；或者加进去了，@ 它没反应。

官方文档里有一句话直接回答了这个：

应用必须发布后才能在钉钉中使用。

这句话在整篇接入指南的第六节，前面五节全是配置，很多人配到「已连接」就以为结束了，直接跳去第七节看怎么用。发布是一个独立的、必须手动做的动作，不会因为你配好了凭证就自动完成。

本文依据 WorkBuddy 官方文档《接入钉钉指南》（Platform-Integration/Dingtalk-Guide），核对日 2026-08-16。我们没有安装客户端，界面文案与后台路径以官方文档和你实际看到的版本为准，本文不含实测数据。

一、先确认你是不是卡在这一步

对照下面三个症状，命中任意一条都优先怀疑没发布：

症状	官方在常见问题里给的排查项
群里搜不到你创建的机器人	确认机器人应用已发布
机器人加进群了但 @ 它没反应	检查应用状态：确认应用已发布并通过审批
单聊搜索框里搜不到机器人名字	同上

官方在「机器人没有响应怎么办」这一节里，把「检查应用状态：确认应用已发布并通过审批」放在第一条，排在 Webhook 配置、客户端运行状态、权限之前。这个排序本身就是提示。

二、发布这一步怎么做

官方给的是两步：

1）创建版本

点页面上方的「查看版本详情」
填写版本描述信息

2）提交发布

点「确认发布」提交审核
等待审核通过（官方原文：通常会很快自动审批）

就这么两步，但入口藏在「查看版本详情」后面——如果你一直在「凭证与基础信息」「权限管理」这些页面之间来回，很可能压根没点进过这个入口。

这里要留意一个容易混的点：在第三步添加机器人能力的时候，页面上也有一个「确认发布」按钮（填完机器人名称、描述、预览图之后点的那个）。那个是发布机器人能力，不是发布应用。两个动作、两个位置，都得做。这大概是这条坑最主要的成因——很多人点过一次「确认发布」，就以为发布过了。

三、发布之前，先把该配的配完

发布是最后一步，前面漏了哪一项，发布了也用不了。按官方文档的顺序核一遍：

前提条件（两条）

电脑上已安装 WorkBuddy，并开启了助理远程控制功能；
有一个具备企业管理员权限的钉钉账号。

第二条是硬门槛。个人钉钉账号进不了开发者后台的应用创建流程；如果提示「该账号还未加入组织」，官方给的办法是创建一个个人企业，按需填写信息即可。

三个权限（名字必须对上）

在应用详情页左侧「权限管理」里，搜索并逐个「立即开通」：

Card.Streaming.Write
Card.Instance.Write
qyapi_robot_sendmsg

这三个是官方原文列出的，一个都不能少。前两个管卡片消息的写入，第三个管机器人发消息。少开一个的表现往往不是报错，而是消息发得出去、回不来，或者回来了但卡片渲染不出来——很难从现象反推是权限问题，所以配的时候就一次开齐。

两组凭证（在两个不同页面）

「凭证与基础信息」页：Client ID（也叫 AppKey）、Client Secret（也叫 AppSecret）；
「开发配置 - 事件订阅」页，推送方式选「HTTP推送」，点刷新按钮自动生成：AES Key 和 Token。

官方对这两组都写了「请务必妥善保管，不要泄露给他人」。实际操作上建议存进密码管理器，别放在聊天记录或者便签里——这类凭证一旦外泄，别人就能以你的机器人身份收发消息。

四、两种连接模式，选错了会连带出别的问题

在 WorkBuddy 客户端里（左下角头像 →「设置 - 助理设置」→「钉钉集成」）填完 Client ID 和 Client Secret 之后，要选连接模式：

模式	官方描述的适用人群	配置复杂度
WebSocket 长连接	个人 / 家庭 / 办公室用户（没有公网 IP）	配置更简单，不需要公网地址，开箱即用
URL 回调	有服务器、有公网 IP 的用户	需要额外回钉钉开发者后台填写生成的 Webhook 地址

绝大多数人应该选 WebSocket 长连接。点「注册」，配置成功后显示「已连接」。

选了 URL 回调的话，注册后显示「已注册」并生成一个 Webhook 地址，然后还要回钉钉开发者后台做四件事：

进入机器人配置页面，下滑到底部找到消息接收配置；
把「Stream 模式」切换为「HTTP 模式」；
在「消息接收地址」粘贴 Webhook 地址；
把地址里的 http 改成 https——官方专门标了「重要」；
点「发布」保存配置。

第 4 步是这条路径上最阴的坑：地址是系统生成的，你直接复制粘贴，协议头可能就是 http，钉钉那边不认。而且它不会给你一个「协议错误」的提示，表现出来就是机器人不回消息。

注意第 5 步这个「发布」是保存消息接收配置的，跟第二节说的发布应用又不是一回事。这一套流程里「发布」这个词出现了三次，位置和含义都不同——这也是为什么这么多人以为自己已经发布过了。

五、群里用还是单聊用，前提不一样

群聊使用的三步：

创建或选择一个群聊——创建群聊时要确保群的「归属组织」与创建机器人时的组织相同；
群右上角设置 →「机器人」→「添加机器人」→ 搜索并选择你创建的机器人 → 确认添加；
在群里 @机器人发需求。

第 1 步里的归属组织是第二个高频坑。你可能有多个组织（尤其是按官方建议临时创建了「个人企业」之后），随手建的群归属到了另一个组织，机器人就是搜不出来。官方在常见问题里也把它列成了「在群里找不到机器人」的排查项之一。

单聊使用更简单：钉钉顶部搜索框搜机器人名称，点进对话窗口直接发消息。

六、还是不响应，按这个顺序查

官方给的排查清单，原样照录并补上各条的验证成本：

顺序	检查项	怎么确认
1	应用已发布并通过审批	回开发者后台看版本状态
2	Webhook 配置（仅 URL 回调模式）	地址正确、且是 https
3	WorkBuddy 正在运行，助理服务已开启	看客户端状态，不是最小化就行——进程得活着
4	三个权限都已正确开通	权限管理页逐个核对名字

第 3 条经常被忽略：钉钉这条链路的终点是你自己电脑上运行的那个客户端。电脑关机、休眠、客户端退出，机器人都不会有反应——这不是钉钉侧的问题，查后台配置查不出来。

「在群里找不到机器人」还有第三条：尝试重启钉钉客户端。发布刚生效时客户端缓存可能没刷新，重启一次比反复搜索有用。

七、几个我们不写的东西

诚实标一下边界：

审核具体要多久——官方只写了「通常会很快自动审批」，没给时间数字，我们不编。
审核被拒了怎么办、有哪些拒绝理由——官方文档没写。
发布之后改配置要不要重新发版——官方文档没写这一条。
官方这篇指南里多处写的是「完成编程任务」（措辞沿用了同门产品的口径），但它描述的是远程操控你电脑上的 WorkBuddy 执行任务这条链路，具体能执行什么以你客户端的能力为准。

小结

官方原文：应用必须发布后才能在钉钉中使用，这是独立的手动步骤。
「确认发布」在流程里出现多次：发布机器人能力 ≠ 发布应用 ≠ 保存消息接收配置。发布应用的入口在「查看版本详情」。
三个权限一次开齐：Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。
两组凭证在两个页面：Client ID / Client Secret 在「凭证与基础信息」；AES Key / Token 在「开发配置 - 事件订阅」。
没有公网 IP 就选 WebSocket 长连接；选 URL 回调必须把地址的 http 改成 https。
群里搜不到机器人：先查发布状态，再查群的「归属组织」是否与机器人一致，最后重启钉钉。
这条链路的终点是你自己电脑上的客户端，它得活着。

功能与界面以官方为准，核对日 2026-08-16。