WorkBuddy对接腾讯会议钉钉配置教程

WorkBuddy虽不直接集成腾讯会议，却能通过钉钉作为智能桥梁，实现“发指令—启会议—返结果”的完整闭环：只需在钉钉应用中严格开通三项关键权限（Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg）并完成人工发布，将默认http的Webhook地址手动升级为https，并在Claw中正确填入Client ID与Client Secret（而非Webhook），即可轻松触发本地腾讯会议启动、屏幕共享及链接跳转等操作——配置成败的核心不在WorkBuddy本身，而在于钉钉侧权限、协议与凭证的精准对齐，避开“只开通不发布”和“http未改https”这两大高频陷阱，就能让跨平台协同真正丝滑落地。

WorkBuddy 本身不直接集成腾讯会议，但能通过钉钉（或企业微信、飞书）作为消息入口，间接触发本地操作——比如启动腾讯会议、共享屏幕、打开指定会议链接。钉钉是目前唯一支持完整双向通信（收指令 + 发结果）的第三方 IM 平台，配置成败关键不在 WorkBuddy 端，而在钉钉应用权限和回调地址是否严格对齐。

钉钉应用必须开通这三个 API 权限

缺一不可，且必须「发布生效」后才起作用。常见错误是只开通没发布，或只在测试环境开通却未同步到正式版。

• Card.Streaming.Write：用于流式返回执行过程（比如“正在打开腾讯会议…”）
• Card.Instance.Write：用于发送带按钮/卡片的结构化响应（如会议链接卡片）
• qyapi_robot_sendmsg：基础消息发送能力，没有它连“收到”都回不了

权限开通后，务必点击「提交审核」→「发布」，不能只停留在“已开通”状态。钉钉后台不会自动发布，必须人工点两次确认。

Webhook 地址必须手动改 http → https

WorkBuddy 注册后生成的 Webhook 地址默认以 http:// 开头，但钉钉 HTTP 模式强制要求 https。直接粘贴会报错“回调地址协议不合法”，且错误提示非常模糊，容易卡住。

• 复制 Webhook 后，手动把开头的 http:// 替换为 https://
• 确保钉钉后台「消息接收地址」栏里最终显示的是 https:// 开头的完整地址
• 如果用的是自建域名或内网穿透，需额外配置 SSL 证书；否则只能用钉钉官方提供的测试域名（含有效期）

Claw 设置里填的是 Client ID / Client Secret，不是 Webhook

新手最常混淆的点：把 Webhook 当成凭证填进 Claw 的「钉钉集成」表单。实际这里只接受 Client ID 和 Client Secret（即 AppKey / AppSecret），用于 WorkBuddy 向钉钉 API 认证身份。

• Client ID 和 Client Secret 在钉钉后台「凭证与基础信息」页获取
• Webhook 是钉钉用来反向调用 WorkBuddy 的入口，只用在钉钉后台的「消息接收地址」配置项
• 两者角色相反：Client ID/Secret 是 WorkBuddy 主动调钉钉；Webhook 是钉钉主动推消息给 WorkBuddy

整个链路依赖双向通信闭环，任意一端协议、权限、地址写错，都会表现为“钉钉发消息没反应”或“WorkBuddy 执行完不回结果”。尤其注意钉钉应用发布状态和 HTTPS 强制要求，这两个点踩中一个，就完全走不通。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《WorkBuddy对接腾讯会议钉钉配置教程》文章吧，也可关注golang学习网公众号了解相关技术文章。