WorkBuddy怎么和钉钉集成?企业微信能用吗
WorkBuddy 接入钉钉的方法:在钉钉开发者后台创建应用并添加机器人、开通 Card.Streaming.Write 等三个权限,拿到 Client ID/Secret 后在 WorkBuddy「设置 → 助理设置 → 钉钉集成」注册,支持 WebSocket 长连接和 URL 回调两种模式;企业微信同样支持,创建 API 模式智能机器人后填 Bot ID 和 Secret 即可。本文含6张真实界面截图、权限对照表和常见失败排查。

更新时间:2026-11-16 | 适用:WorkBuddy ≥ 4.6.4(企微助理要求)| Windows / macOS | 界面以实际版本显示为准
WorkBuddy 的钉钉/企微集成是什么原理?
WorkBuddy 的远程控制功能叫「助理」:电脑保持运行 WorkBuddy,你在手机上的钉钉、企业微信(也支持微信、QQ、飞书)里给机器人发一条任务指令,电脑端自动执行,执行完把结果发回聊天窗口。官方文档把它比作「遥控器」——手机发消息,电脑干活,结果回手机。常见用法包括:群聊里 @机器人 下发团队协作任务、跟进任务进度、任务完成后自动通知群聊、把待办和验收事项同步到群,以及批准需要确认的高风险操作。
两种 IM 的接入都支持两种网络模式,按有没有公网 IP 选:
| 模式 | 适用场景 | 特点 |
|---|---|---|
| WebSocket 长连接(推荐) | 个人/家庭/办公室,无公网 IP | 只填凭证即可,无需回填 Webhook 地址,开箱即用 |
| URL 回调 | 有服务器、有公网 IP 的团队 | 把 WorkBuddy 生成的 Webhook 地址回填到钉钉/企微后台;地址必须是 https |
WorkBuddy 怎么和钉钉集成?(完整步骤)
钉钉接入需要在开发者后台操作,需要一个具有企业管理员权限的钉钉账号;还没有钉钉组织的话,先去钉钉官网下载客户端并创建团队。
① 创建钉钉应用
- 浏览器打开钉钉开发者后台,用管理员账号登录(首次提示「未加入组织」时创建一个个人企业即可);
- 在首页点「应用开发 → 创建应用」,填写应用名称等信息,点「保存」。
② 添加机器人能力
- 应用创建成功后自动进入「添加应用能力」页面,找到「机器人」点「添加机器人」;
- 填写机器人名称、描述,上传预览图,点「确认发布」。
③ 开通应用权限
在应用详情页左侧「权限管理」中分别搜索并开通以下三个权限:
| 权限 | 用途 |
|---|---|
| Card.Streaming.Write | 机器人卡片流式输出 |
| Card.Instance.Write | 机器人卡片实例写入 |
| qyapi_robot_sendmsg | 机器人发送消息 |
④ 获取应用凭证
- 在应用详情页左侧点「凭证与基础信息」,复制 Client ID(即 AppKey)和 Client Secret(即 AppSecret);
- 选 URL 回调模式的话,还要在「开发配置 → 事件订阅」的推送方式里获取 AES Key 和 Token(可点刷新自动生成)。

▲ 图1:钉钉「凭证与基础信息」页——复制 Client ID(AppKey)与 Client Secret(AppSecret)
⑤ 在 WorkBuddy 中注册钉钉机器人
- 打开 WorkBuddy,点击助理的设置 ⚙️ 图标进入「助理设置」,选择「钉钉集成」;
- 把 Client ID 和 Client Secret 填入对应输入框;
- 选「WebSocket 长连接」点「注册」,显示「已连接」即配置成功;
- 选「URL 回调」的话,点「注册」后会生成一个 Webhook 地址——复制它,回到钉钉开发者后台的机器人配置页,把「消息接收配置」从 Stream 模式切换为 HTTP 模式,粘贴 Webhook 地址(注意把 http 改成 https),点「发布」保存。

▲ 图2:WorkBuddy「设置 → 助理设置」——集成列表中的钉钉机器人(点「配置」进入)

▲ 图3:钉钉集成注册界面——WebSocket 长连接模式只需填 Client ID 和 Client Secret
⑥ 发布应用并开始使用
- 回到钉钉开发者后台,点上方「查看版本详情」,填写版本描述后「确认发布」提交审核(通常很快自动审批通过);
- 群聊使用:创建或打开一个群(群的「归属组织」要与机器人所属组织相同),群右上角设置 → 机器人 → 添加机器人,搜索并选择你创建的机器人;之后在群里 @机器人 发需求即可;
- 单聊使用:在钉钉顶部搜索框搜机器人名称,进入对话窗口直接发消息。

▲ 图4:钉钉群聊使用效果——@机器人下发任务,WorkBuddy 执行后把结果回复到群里
企业微信能用吗?(企微助理集成)
能用。企业微信走的是「企微助理集成」,要求 WorkBuddy ≥ 4.6.4,并拥有一个可创建智能机器人的企业微信账号(没有就去企业微信官网免费注册)。接入分三步:
① 创建企微智能机器人(API 模式)
| 角色 | 入口 |
|---|---|
| 管理员 | 企业微信管理后台 →「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」 |
| 普通成员 | 企业微信客户端 →「工作台」→「智能机器人应用」→「创建机器人」 |
- 如果先进入 AI 自动生成页面,点左下角「手动创建」;
- 选择「API 模式创建」;
- 填写机器人名称(如「WorkBuddy 助手」)和可见范围(选择哪些成员/部门能用),保存;
- 在「API 配置」区域选择「使用长连接」(推荐:步骤更少,不需要回填 Webhook URL)。

▲ 图5:企业微信管理后台创建智能机器人——手动创建并选择「API 模式创建」
② 获取 Bot ID 和 Secret
在「API 配置」区域选择「使用长连接」后,复制 Bot ID,点「获取」生成 Secret 并妥善保存。长连接模式不需要再填 URL、Token 或 Encoding-AESKey。
③ 在 WorkBuddy 中完成绑定
- 打开 WorkBuddy,点左下角头像菜单 →「设置 → 助理设置」;
- 在「集成(BETA)」区域找到「企微助理集成」,点「配置」;
- 弹窗选「WebSocket 长连接」,两种绑法任选:手动填 Bot ID 和 Secret 点「注册」;或用「快捷绑定」企微扫码完成;
- 绑定成功后,在企业微信通讯录「企业创建的」分组下找到机器人,发条「你好」测试联通。

▲ 图6:WorkBuddy「设置 → 助理设置 → 集成(BETA)」——企微助理集成点「配置」进入绑定
接入后能做什么?
| 场景 | 在钉钉/企微里怎么说 |
|---|---|
| 群协作 | 群里 @机器人:「帮我把桌面上的发票按月份归类」 |
| 跟进进度 | 直接给机器人发:「今天那个数据处理任务跑完了吗」 |
| 发文件/图片 | 直接把文件发到对话,WorkBuddy 会作为任务材料处理 |
| 高风险确认 | 涉及删除文件、执行脚本时,机器人会发确认消息,你确认后才继续 |
| 定时推送 | 配合 WorkBuddy 定时任务,把执行结果自动推送到企业微信群 |
另外,WorkBuddy 还支持微信助理、微信客服号、QQ 机器人、飞书等更多渠道,都在同一个「助理设置」页里分别配置;搭配定时任务使用时,任务执行结果可以自动推送到企业微信,实现「电脑干活、群里收结果」。
常见问题(FAQ)
WorkBuddy 接钉钉一定要企业管理员吗?
创建应用、开通权限、发布版本都在开发者后台操作,需要企业管理员权限的账号;个人可以先创建一个「个人企业」来完成接入。
企业微信接入需要管理员吗?
不一定:管理员在管理后台创建机器人,普通成员也可以在企微客户端「工作台 → 智能机器人应用」里创建,两种入口的后续配置一致。
WebSocket 长连接注册后显示什么?
钉钉显示「已连接」,企微绑定成功后卡片状态变为已绑定;URL 回调模式则显示「已注册」并生成 Webhook 地址,需要回填到对应平台后台。
钉钉 URL 回调模式下 Webhook 地址填在哪里?
钉钉开发者后台 → 机器人配置页 → 消息接收配置,把 Stream 模式切换为 HTTP 模式后粘贴,注意把地址里的 http 改成 https,再点发布保存。
接入后电脑要一直开机吗?
是的。远程指令由电脑上的 WorkBuddy 执行,电脑需要保持开机并运行 WorkBuddy,网络也要正常;可以在设置里开启「运行时防休眠」避免任务被打断。
一个 WorkBuddy 能同时接钉钉和企微吗?
可以。助理支持微信、微信客服号、企微、QQ、飞书、钉钉多渠道并行接入,各自独立配置和绑定,按需开启。
企微里能收到定时任务的结果吗?
能。新建定时任务时打开「消息推送到企业微信」开关,长连接绑定过的会直接开启;未绑定时会引导你扫码接入机器人,绑定成功后推送开关自动打开。
不想用了怎么解绑?
在 WorkBuddy 助理设置里停止/清除对应平台的集成配置;钉钉侧还可在开发者后台停用或删除应用,企微侧可在机器人管理中调整可见范围。
注意事项
- 凭证安全:Client Secret、AES Key、Token、Bot Secret 都等同于账号钥匙,不要发到群里或交给他人;
- 钉钉应用必须发布并在审批通过后才能在钉钉里使用;
- 群聊里用机器人时,群的「归属组织」必须与机器人所属组织一致,否则搜索不到;
- URL 回调地址必须 https 协议,http 会被拦截;
- WorkBuddy 传输走企微/钉钉内置的 WebSocket 通道加密通信,不需要在企业防火墙上开放额外端口;
- 移动端远程下发任务时,桌面本地文件上传可能受设备权限与平台能力限制,重要文件建议提前放进工作空间。
- 钉钉:开发者后台创建应用 → 添加机器人 → 开 3 个权限 → Client ID/Secret → WorkBuddy 助理设置 → 钉钉集成 → 注册 → 发布应用
- 企微:创建智能机器人(API 模式、长连接)→ Bot ID + Secret → 助理设置 → 集成(BETA)→ 企微助理集成 → 注册/扫码
- 模式选择:无公网 IP 用 WebSocket 长连接;有服务器用 URL 回调(https)
- 钉钉权限:Card.Streaming.Write + Card.Instance.Write + qyapi_robot_sendmsg
- 群聊用 @机器人,单聊直接搜机器人名称发消息
- 没响应排查:应用已发布?https?WorkBuddy 在运行?权限齐全?
































