WorkBuddy 接入了 QQ、企微、微信、飞书、钉钉，机器人却不回复怎么办

2026-08-08

配置流程一步没漏，WorkBuddy（Tencent WorkBuddy）里那张集成卡片明明白白写着「已连接」或「已绑定」，可是在 QQ、企业微信、微信、飞书、钉钉里发过去的消息石沉大海——机器人一声不吭。

这是助理接入之后最容易撞上的一类问题。麻烦的地方在于，它没有报错码，也没有明确的失败提示，五个平台的表现还长得一模一样：不回复、偶发断开、或者第一次能用、关掉再打开就失联了。上面这三种表现，官方文档是把它们合成同一个条目在讲的，适用范围写的就是 QQ、企业微信、微信、飞书、钉钉全部五个平台。

问题的根子在于，助理这套东西的本质是”手机发指令、电脑执行”。你在微信里敲的那句话，最终要落到你自己那台开着 WorkBuddy 的电脑上跑。链路比普通聊天机器人长得多，中间任何一环断了，表现出来都是同一个”不回复”。

所以别急着重新走一遍接入流程。下面这条分诊路径按”排查成本从低到高、命中率从高到低”排，官方文档是按平台分开写的，这里把它拧成一条通用顺序。

一、四步分诊路径

顺序	查什么	成本	为什么排在这个位置
1	电脑侧：WorkBuddy 在不在跑、助理服务开没开、网络通不通	十秒	最常见也最容易忽略，电脑没开一切白搭
2	连接状态：集成卡片是否仍显示已连接／已绑定	半分钟	配置成功不等于此刻在线
3	切换模型后再测一次	一分钟	官方在多个平台条目里都把这条列为优先手段
4	平台侧配置：各平台独有的坑	几分钟到半小时	前三步都正常才轮到它

前三步都是在你自己电脑上完成的，不用回开放平台、不用碰凭证。绝大多数”突然不回复”停在前三步就解决了。

二、第一步：先看电脑

官方在九个平台的接入指南里写的共同前提是同一句话：已在电脑上安装 Tencent WorkBuddy 并开启「助理」远程控制功能，使用助理时电脑需保持开机并运行 WorkBuddy，网络连接正常。

这句话平时读过去像是走个过场，但它恰恰是”不回复”最高频的真因。几个典型场景：

电脑休眠或自动睡眠了。你在外面用手机发指令，那台机器早就睡了
WorkBuddy 被关掉了，或者升级重启后没有自动拉起来
助理服务被关了——集成状态还挂着”已绑定”，但服务本身没在跑
换了网络环境，或者公司网络对出站连接有限制

微信那条官方常见问题写得最直白：微信发消息没响应，先确认 WorkBuddy 仍在运行且助理服务未关闭。钉钉页自带的 FAQ 里也把”电脑上 WorkBuddy 是否运行且助理服务已开启”列为四项必查之一。

判断方法很简单：走到那台电脑跟前（或者远程看一眼），确认 WorkBuddy 窗口还在、助理服务处于开启状态。如果这一步就不通过，后面三步一步都不用做。

顺带说一句官方在使用技巧里给的提醒：远程意味着它在你看不见的地方自主行动。涉及删除、覆盖、批量移动这类操作时，先让它给出预览再执行——这跟”不回复”无关，但既然你打算把这台电脑长期挂着当远程执行端，这个习惯值得一开始就养起来。

三、第二步：看连接状态还在不在

电脑确认没问题，下一步看集成卡片当前的状态。

这里要区分两件事：配置成功和此刻在线是两回事。你注册那天卡片变成了”已连接”，不代表今天它还连着。官方对这类问题给出的第一个动作就是”先确认当前连接状态是否仍在线”。

各平台成功后的状态文案不完全一样，照官方文档：微信是卡片显示「已绑定」，QQ 注册成功后「QQ 机器人集成」显示已连接、「助理」中能看到 QQ 图标，钉钉的 WebSocket 长连接模式点「注册」后显示「已连接」、URL 回调模式则显示「已注册」。

如果状态已经掉了，处理方式按平台分：

微信：官方明确说长时间无响应建议断开后重新连接，必要时解绑后重新扫码。注意二维码本身有时效限制，过期或扫码失败就重新点「配置」生成新的
其它平台：回到左下角头像 →「设置 - 助理设置」→「集成（BETA）」区域，找到对应平台重新配置

还有个和”不回复”很像但其实不是一回事的情况：找不到历史会话。官方的解释是，助理工作空间里只有最近产生对话的任务会在「助理」中展示，其他任务仅在工作空间列表展示。看不到会话不等于消息没送达，别把它误判成连接故障。

四、第三步：切换模型再测一次

这一步是整条路径里最反直觉、但性价比最高的一步。

翻官方文档会发现一个明显的模式：“优先切换模型后再次测试”这句话在多个平台条目里重复出现。QQ 机器人频繁断开或不回复，官方建议优先切换模型测试；五平台通用的那条”已完成接入但发送消息无响应”，官方给的处理顺序同样是确认连接状态之后优先切换模型（文档原话是部分无响应问题可通过切换模型缓解）；性能类问题里的”回复乱码、胡乱输出、长时间无响应”，官方归因是模型异常、任务过重或网络不稳定，第一个动作还是先切换模型测试。

同一条建议在不同章节反复出现，通常说明它在真实工单里的命中率不低。模型侧异常会表现成机器人完全不吭声——链路是通的，消息也收到了，但那一侧没能产出回复。从聊天窗口看，跟连接断了长得一模一样。

所以顺序上，切换模型应该排在回开放平台翻配置之前。花一分钟换个模型再发一条测试消息，比重新走一遍凭证流程划算得多。

如果切换模型之后能回复了，基本可以判定是模型侧的问题，接入配置本身没毛病。如果换了几个模型都不回，才继续往下走。

另外一条相关经验：如果不是完全不回复，而是任务发出去之后卡住不动，官方给的做法是点击右下角发送任务处的「停止任务」按钮，切换到其他模型，再重新执行历史任务。

五、第四步：各平台独有的坑

前三步都排除了，才轮到平台侧配置。这一步按你用的平台对号入座，别挨个试。

企业微信：Webhook 域名主体校验未通过

企业微信侧会对 Webhook 地址进行域名主体校验，校验不过就会给出提示。官方文档给的做法是核对 Webhook 地址是否完整、是否与当前配置要求一致；如果仍无法通过，保留报错截图提交排查。

值得一提的是，这个坑只在 URL 回调模式下会遇到。官方推荐的是长连接模式——只需要 Bot ID 加 Secret，无需回填 Webhook URL，也不需要 Token 或 Encoding-AESKey。如果你正卡在域名校验上，而业务上并不真的需要 Webhook 回调，改用长连接是更省事的路。

飞书：配置 Webhook 时提示无法检查链接

这个提示多半是重复输入同一个 Webhook 地址导致的。官方给的做法是重新创建或重新填写一次配置，避免重复输入同一地址；仍失败则保留提示信息反馈。

排查时先回想一下自己是不是反复粘贴过同一串地址——多次尝试反而更容易踩中这条。

钉钉：四项必查

钉钉那页文档自带一份 FAQ，机器人没响应时依次查这四项：

应用是否已发布并通过审批——这条最容易漏。钉钉的应用必须点页面上方「查看版本详情」，填版本描述后「确认发布」提交审核（通常很快自动审批），不发布就用不了
Webhook 地址是否正确且用 https——URL 回调模式下，官方特别强调回填时务必把地址中的 http 改为 https
电脑上 WorkBuddy 是否运行且助理服务已开启——就是第一步那条
三个权限是否都已开通——Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg，少一个都不行

还有一种情况是消息发不出去，因为群里根本找不到机器人。官方给的三个动作是：确认应用已发布、确认群的「归属组织」与机器人所属组织相同、尝试重启钉钉客户端。第二条尤其容易中招——群和机器人不在同一个组织下，搜索时是搜不到的。

微信：鸿蒙 6 扫码不兼容

如果你压根没能绑上，卡在扫码这一步，先看手机系统。官方说明：鸿蒙 6 的微信扫码当前存在不兼容情况，已知鸿蒙 4 可以正常连接。

临时方案是先用一台安卓手机完成首次扫码连接，之后再切回鸿蒙微信继续使用。

另外两条微信侧的常见问题也顺带记一下：一直停留在「绑定中…」，官方做法是确认 WorkBuddy 正在运行且网络正常，关闭配置窗口重进，仍不行则重启 WorkBuddy 后重新绑定；扫码后没显示「已绑定」，则确认扫的是目标微信账号，等几秒让状态同步，二维码失效就点「重试」重新生成。

顺带提一句版本要求，这也是扫不上码的可能原因之一：微信助理接入要求 WorkBuddy >= 4.6.4、手机微信 >= 8.0.70。

QQ：断开优先切模型

QQ 这边官方没有给出独有的配置类坑，对”频繁断开或不回复”给的做法就是优先切换模型测试；如果持续存在，记录错误码、发生时间与网络环境后再排查。

也就是说 QQ 场景里，第三步就是终点——不用回开放平台折腾 AppID 和 AppSecret。这里反倒要提醒一句反向的风险：QQ 的 AppSecret 不支持明文保存，二次查看将会强制重置。因为”不回复”跑回开放平台去点一次查看，会把原来那对凭证直接作废，反而把能用的连接搞断。没有确凿理由，别去碰它。

六、还是不行，怎么反馈才有用

四步走完仍然无解，就该带信息提反馈了。官方对这类无响应问题特别提了一条：如果是首次可用、后续失效，记录复现时间与平台类型，便于进一步排查。QQ 那条则要求记录错误码、发生时间与网络环境。

把这几项凑齐再提交，能省掉几轮来回：

哪个平台，什么时候开始不回复的
是一直不回复，还是首次可用后失效
切换过几个模型，分别是什么结果
电脑当时是否开着、助理服务是否开启
集成卡片当时显示什么状态
网络环境（家庭宽带 / 公司网络 / 移动热点）

日志的位置官方也给了：Mac 是 WorkBuddy 顶部「帮助」→「打开日志文件夹」，Windows 是左上角「帮助」下拉框 →「打开日志目录」，其中的压缩包就是日志文件。反馈入口在右上角「帮助」下拉框的 helpFeedback，或右下角头像 → 设置 - 帮助与反馈 - 意见反馈，描述问题、上传截图并勾选「上传日志」后提交。

一条来自官方文档本身的隐私提醒：日志仅用于排查问题，但可能包含对话记录、设备信息等数据。如果你的助理会话里涉及敏感内容，提交前心里要有数。

小结

助理机器人不回复，别从”重新接入”开始。按电脑侧、连接状态、切换模型、平台侧配置这个顺序走，前三步只需要在自己电脑上花两分钟，却覆盖了大多数情况。

记住那条链路：手机发指令、电脑执行。电脑没开着，其余全是白费功夫。而”优先切换模型”这条在官方文档里反复出现，说明它值得排在翻配置之前——先花一分钟换个模型试试，比回开放平台重走凭证流程划算得多。

真到了第四步，各平台的坑各不相同：企微是域名主体校验（用长连接模式可以绕开）、飞书是重复地址、钉钉是应用未发布与组织不一致、微信是鸿蒙 6 扫码不兼容、QQ 则基本停在切模型这一步——而且别为了排查去二次查看 AppSecret，那会强制重置。