壹
渠道接入总览 · 两种接入路径
WorkBuddy 渠道接入存在两条完全不同的路径，对应不同的使用场景和操作角色。很多企业落地时容易混淆，先把两条路径看清楚，再选对应的实操章节。
1.1 路径对比流程图
A
路径A · 个人助理集成
员工远程操控本机WorkBuddy
员工在自己电脑上安装WorkBuddy，通过IM渠道给机器人发指令，由本机WorkBuddy执行任务后回复到IM。
依赖电脑开机
个人远程办公
4 渠道通用
↓
→
B
路径B · 企业智能体渠道接入
管理员发布Agent云端服务
管理员在企业后台把已发布的Agent接入IM渠道，员工在IM中直接与Bot对话，云端沙箱执行任务，7*24H在线。
7×24 在线
云端执行
企业版专属
↓
云端沙箱执行
Agent 在云端 Session 中执行，
员工不需要安装客户端。
文档阅读顺序建议
先读板块壹理清两条路径的定位差异，再根据目标场景选读板块贰（路径B：企业Agent）或板块叁到板块柒（路径A：4种IM渠道接入）。最后看板块捌的速查表和板块拾的边界清单做落地前的风险排查。
1.2 两条路径核心对比
| 维度 | 路径A · 个人助理集成 | 路径B · 企业智能体渠道接入 |
|---|
| 定位 | 个人级远程控制，员工用自己的IM账号远程操控本机WorkBuddy | 企业级Agent分发，管理员把Agent接入IM渠道，全员直接对话 |
| 谁配置 | 员工自己（个人助理设置） | 企业管理员（企业后台→企业智能体→渠道接入） |
| 消息路由 | IM消息→本机WorkBuddy助理→执行→回复IM | IM消息→云端Agent Session→云端沙箱执行→回复IM |
| 执行环境 | 员工本地电脑（依赖电脑开机+WorkBuddy运行） | 云端沙箱（不依赖任何员工电脑） |
| 适用场景 | 个人远程编程、出差时继续工作、手机端审批 | 7×24数字员工、企业统一问答Bot、数据巡检、审批助手 |
| 前提条件 | 电脑开机 + WorkBuddy运行 + 助理服务开启 | 企业旗舰版/专享版 + 已创建Agent + 已发布 |
| 四种渠道 | 企微助理、飞书、QQ、钉钉 | 企微AIBot、飞书、QQ机器人、钉钉 |
贰
企业智能体渠道接入 · 路径B
管理员在企业后台把已发布的Agent接入即时通讯渠道（企微AIBot、QQ机器人、飞书、钉钉），员工无需安装WorkBuddy客户端即可在IM中直接与Agent对话。
2.1 是什么
企业智能体渠道接入是管理员在企业后台将已发布的Agent接入即时通讯渠道，使员工无需安装WorkBuddy客户端即可在IM中直接与Agent对话。
核心机制：每条渠道接入记录 = 一个Bot → 一个Session的绑定关系。员工在IM中发送消息 → 消息通过Bot路由到绑定的Session → Agent在云端沙箱执行 → 结果回复到IM。
2.2 怎么配（后台实操步骤）
前提条件：
- 企业旗舰版或专享版已激活
- 已创建Agent并已发布
- Agent至少有一个运行中的Session
后台操作路径：
- 登录企业管理后台（copilot.tencent.com/admin）
- 左侧导航 → 企业智能体 → Agent列表
- 点击目标Agent的「接入」操作
- 选择「渠道接入」类型（企微AIBot / QQ机器人 / 飞书 / 钉钉）
以企微AIBot为例的完整配置链路：
选择渠道类型
在Agent渠道接入页面选择「企微AIBot」。
获取Token和EncodingAESKey
在企微AIBot后台选择「使用URL回调」连接方式，随机获取Token和EncodingAESKey。
回填凭据到Agent
将Token和EncodingAESKey填入Agent渠道配置对应位置。
绑定Session
选择一个Session与此渠道绑定，消息将路由到该Session。
复制Webhook地址
复制生成的Webhook地址，填入企微AIBot连接方式的URL位置。
保存完成接入
渠道接入完成，员工在企微中与Bot对话即可触发Agent。
注意：企微AIBot渠道接入目前仅支持URL回调模式。如需长连接模式，需使用路径A（个人助理集成）方式。
2.3 配置后效果
- 员工在IM中直接与Bot对话，无需安装WorkBuddy客户端
- 每人打开分享链接或与Bot对话时自动获得专属独立Session
- Agent在云端沙箱执行，不依赖任何员工电脑开机
- 对话结果直接在IM聊天窗口展示（支持流式输出）
2.4 企业落地常见场景
| 场景 | 痛点 | Agent渠道接入怎么解决 |
|---|
| 7×24 客服 / 问答 | 人工客服时效限制，员工重复问相同问题 | Agent接入企微Bot，员工随时@Bot提问，自动回答，不依赖任何人电脑开机 |
| 数据巡检通知 | 每天手动检查系统状态 | Agent自动运行巡检，发现异常通过IM渠道主动推送通知给指定群 |
| 审批助手 | 审批流程需人工逐条查看 | 员工在IM中发送审批请求，Agent自动比对规则返回建议结果 |
| 移动端任务下发 | 出差/外出时无法操作电脑 | 手机端IM直接发指令，Agent在云端执行，结果即时回复 |
| 企业统一服务入口 | 各部门工具散落、入口不统一 | 一个Agent接入企微，全公司统一入口，按Skill/专家分工处理 |
2.5 边界和坑
- 企微AIBot渠道接入仅支持URL回调模式，长连接模式是个人助理集成功能，不是Agent渠道接入
- 渠道接入需要外部平台同步配置，企微需在企微后台同步配置Token/Webhook，飞书需在飞书开放平台配置，不是WorkBuddy单边操作就能完成
- 一条渠道接入记录绑定一个Session，如果需要多个独立对话，需创建多条接入记录或使用分享链接
- 凭据不能硬编码在Manifest，通过安全通道注入，不写入沙箱文件
- Agent渠道接入仅企业旗舰版/专享版可用，个人版和标准版无法创建CloudAgent
叁
企微AIBot · 长连接模式 · 路径A
员工通过企微远程操控自己电脑上的WorkBuddy。长连接模式是推荐方式，配置更简单，无需公网IP，无需回填Webhook URL。
3.1 是什么
企微助理集成让员工在企业微信中向机器人发送任务指令，WorkBuddy在员工电脑上自动执行，并将结果同步回企业微信聊天窗口。
核心特性：
- 群聊中@机器人下发团队协作任务
- 跟进任务进度，随时发送指令查看执行进度
- 创建专属任务群，长期绑定WorkBuddy处理团队日常工作
- 任务完成后自动通知群聊相关人员
- 确认操作，批准命令执行、文件修改等需要确认的操作
- 跨设备接续，企微中发起任务后，可在电脑WorkBuddy助理页面查看完整执行记录
3.2 前提条件
| 要求 | 说明 |
|---|
| WorkBuddy 版本 | ≥ 4.6.4 |
| 企业微信账号 | 拥有可创建智能机器人的企业微信账号 |
| 网络连接 | 电脑和手机均能正常访问互联网 |
| WorkBuddy 运行 | 电脑保持开机并运行WorkBuddy，助理服务已开启 |
3.3 怎么配（管理员+成员+WorkBuddy绑定）
3.3.1 管理员操作路径（创建机器人）
进入管理后台创建机器人
- 访问 work.weixin.qq.com/wework_admin/frame，管理员账号登录
- 安全与管理 → 管理工具 → 智能机器人 → 创建机器人
- 如先进入AI自动生成页面，点击左下角「手动创建」
- 选择「API模式创建」
填写基本信息
- 点击「可见范围」→「添加」→ 选择成员/部门/标签
- 点击「保存」
- 在右侧「API配置」区域选择「使用长连接」
获取凭证并完成绑定
- 在「API配置」区域选择「使用长连接」
- 复制 Bot ID
- 点击「点击获取」获取 Secret，并妥善保存
| 配置项 | 说明 |
|---|
| 机器人名称 | 建议填写容易识别的名字，如「WorkBuddy 助手」 |
| 可见范围 | 选择哪些员工、部门或标签可以使用这个机器人 |
⚠️ 长连接模式不需要填写URL、Token或Encoding-AESKey。
3.3.2 普通成员操作路径
在企业微信客户端创建机器人
- 打开企业微信客户端 → 工作台 → 智能机器人应用 → 创建机器人
- 如先进入AI自动生成页面，点击左下角「手动创建」
- 选择「API模式创建」
填写基本信息
- 点击「可使用成员」→「修改」→ 选择成员/部门/标签
- 在下方「API配置」区域选择「使用长连接」
获取凭证
- 复制 Bot ID
- 点击「点击获取」获取 Secret
| 配置项 | 说明 |
|---|
| 机器人名称 | 建议填写容易识别的名字，如「WorkBuddy 助手」 |
| 可使用成员 | 选择哪些员工、部门或标签可以使用这个机器人 |
3.3.3 在WorkBuddy中完成绑定（两种角色共用）
- 打开WorkBuddy → 点击左下角头像菜单 → 设置 → 助理设置
- 在「集成（BETA）」区域找到「企微助理集成」 → 点击「配置」
- 在弹窗中选择「WebSocket长连接」
- 方式1：手动填写Bot ID和Secret → 点击「注册」
- 方式2：点击快捷绑定接入 → 使用企微扫码完成绑定
3.4 联通验证与日常使用
联通验证：在企业微信中向机器人发送一条简单消息（如「你好」），如果配置正确，WorkBuddy会接收并回复。
日常使用效果：
- 在企业微信通讯录「企业创建的」分组下找到机器人 → 点击「发消息」开始下发任务
- 群聊中@机器人 → 发送任务指令 → WorkBuddy自动执行 → 结果回复到群聊
- 企微中发起的任务 → 可在电脑WorkBuddy助理页面查看完整执行记录（思考过程、操作步骤、生成文件及最终结果）
- 可在电脑上继续追问、细化任务，或在企微中随时查看进度
3.5 远程任务 vs 普通任务
| 对比项 | 普通任务 | 助理（远程任务） |
|---|
| 工作目录 | 自由指定 | 固定使用助理专属文件夹 |
| 新建对话 | 支持多个并行任务 | 仅一个会话，所有远程指令集中处理 |
| 上下文管理 | 可清空历史重新开始 | 保留完整对话历史，不可清空 |
使用建议
本地操作优先使用主界面的普通任务，需要远程触发或统一查看记录时，再使用助理。
3.6 典型场景
| 场景 | 痛点 | 企微长连接怎么解决 |
|---|
| 出差远程编程 | 出差时无法操作办公室电脑 | 手机企微发指令，办公室电脑WorkBuddy自动执行，结果即时回复 |
| 审批确认 | 需手动确认操作审批 | 企微中收到确认请求，一键批准，电脑端自动执行 |
| 团队协作群 | 多人需同时看任务结果 | 群聊@机器人，所有人实时看到执行结果和通知 |
| 移动端任务跟进 | 离开电脑后想继续跟进任务 | 企微随时发消息跟进，查看进度，补充指令 |
3.7 边界和坑
- 依赖电脑开机 + WorkBuddy运行，企微助理是远程控制本地电脑，电脑关机或WorkBuddy未运行则无法响应
- 远程任务只有单一会话，所有远程指令集中在一个Session中处理，不支持并行多任务
- 长连接模式不支持URL回调，两种模式互斥，选定后需保持一致
- Secret仅一次查看机会，企微后台获取Secret后不可二次明文查看，需妥善保存
- 可见范围需提前配置，创建机器人时就需设置可见范围，后续可修改但需在企微后台操作
- 企微AIBot是个人级集成，不是企业Agent渠道接入，接入后是操控自己电脑的WorkBuddy，不是企业级Agent服务
肆
企微AIBot · URL回调模式 · 路径A
URL回调模式是企微接入的备选方案，适用于需要Webhook回调的场景或有网络/部署限制的企业。配置比长连接模式复杂。
4.1 怎么配（3步实操）
在企业微信中生成回调凭据
- 在「API配置」区域选择「使用URL回调」
- 点击Token输入框右侧「随机获取」 → 生成Token
- 点击Encoding-AESKey输入框右侧「随机获取」 → 生成EncodingAESKey
- 保存这两个参数
在WorkBuddy中生成Webhook URL
- 打开WorkBuddy → 设置 → 助理设置 → 企微AIBot集成 → 配置
- 在注册弹窗中切换到「使用URL回调」
- 填入刚才获取的Token和Encoding-AESKey
- 点击「注册」
- 注册成功后，复制生成的Webhook URL
回填URL并保存
- 回到企微机器人创建页面
- 将Webhook地址粘贴到URL输入框
- 点击「保存」完成配置
⚠️ 请务必保存好Token和Encoding-AESKey，否则后续无法完成注册。
4.2 两种模式对比
| 维度 | 长连接模式（推荐） | URL回调模式 |
|---|
| 配置复杂度 | 3步，无需公网IP | 4步，需双向回填URL |
| 需要公网IP | 不需要 | 需要（或通过代理） |
| 凭证 | Bot ID + Secret | Token + EncodingAESKey + Webhook URL |
| 适用对象 | 个人/家庭/办公室 | 有服务器、有公网IP的企业 |
| 稳定性 | WebSocket常连接 | HTTP回调，依赖URL可达性 |
4.3 常见问题排查
| 问题 | 排查步骤 |
|---|
| 机器人没有响应 | 1. 确认WorkBuddy运行且助理服务已开启 2. 核对接入方式一致 3. 核对凭据 4. 检查网络 |
| URL验证失败 | 1. 确认WorkBuddy运行 2. 确认助理服务启动 3. 重新复制Webhook URL 4. 确认Token/EncodingAESKey一致 |
| 长连接注册失败 | 1. 确认企微侧已选择「使用长连接」 2. 重新复制Bot ID和Secret 3. 避免带入多余空格 |
伍
飞书接入 · 9步完整配置 · 路径A
员工通过飞书远程操控自己电脑上的WorkBuddy。飞书接入配置步骤最多（9步），权限配置较复杂，适合飞书为主要IM的企业。
5.1 是什么
飞书集成让员工在飞书中与WorkBuddy机器人对话，远程操控电脑上的WorkBuddy完成编程任务。与企微助理类似，核心依赖本地电脑运行WorkBuddy。
5.2 前提条件
- 已在电脑上安装WorkBuddy，并开启助理远程控制功能
- 拥有飞书企业账号（需要有创建应用的权限）
5.3 怎么配（9步实操）
登录飞书开发者后台
- 访问 open.feishu.cn/app
- 使用企业账号登录 → 点击「创建企业自建应用」
添加机器人能力
- 进入应用详情页 → 「添加应用能力」区域 → 找到「机器人」卡片 → 点击「添加」
配置应用权限（核心步骤）
- 左侧菜单 → 权限管理 → 批量导入/导出权限
- 清空输入框 → 将权限列表完整复制粘贴进去 → 点击「确定新增权限」
需要导入的权限包含两大类：tenant级权限（20个）：contact:contact.base:readonly、im:message:send_as_bot、im:chat:read等；user级权限（55个）：docx:document:readonly、im:message.group_at_msg:readonly、wiki:node:read等。
获取应用凭证
- 左侧菜单 → 凭证与基础信息
- 记录 App ID（应用唯一标识）
- 点击查看 App Secret → 妥善保存
获取Encrypt Key和Verification Token
- 左侧菜单 → 事件与回调 → 选择加密策略
- 点击刷新按钮自动生成Encrypt Key和Verification Token（也可点击编辑按钮自定义）
在WorkBuddy中配置飞书凭证
- WorkBuddy → 设置 → 助理设置 → 飞书集成 → 配置
- 填入App ID、App Secret、Encrypt Key
- 选择接入方式：WebSocket长连接（无公网IP，配置简单）/ URL回调（有公网IP，需额外填写Webhook地址）
- 点击「注册」
配置飞书事件回调
- 返回飞书开放平台 → 应用详情页
- 配置事件订阅：长连接选「使用长连接接收事件」→ 验证；URL回调选「将事件发送至开发者服务器」→ 粘贴Webhook地址
- 添加消息接收事件：「添加事件」→ 搜索并添加「接收消息」
- 配置卡片回调：「回调配置」页签 → 搜索「卡片回传交互」 → 确认添加
发布应用
- 点击页面上方「创建版本」 → 填写版本号（如1.0.0）和版本描述 → 点击「确定」
- 点击版本右侧「发布」 → 等待审批（企业管理员通常自动审批通过）
⚠️ 权限必须完整导入，缺少任何一个可能导致机器人无法正常收发消息。
⚠️ App Secret 非常重要，不要泄露给他人。
⚠️ 妥善保管 Encrypt Key 和 Verification Token。
5.4 配置后效果
- 在飞书搜索框输入机器人名称 → 搜索到机器人
- 点击机器人进入对话窗口 → 或点击「打开应用」
- 直接发送需求（如「帮我写一个待办事项应用」）→ WorkBuddy在电脑上自动执行 → 结果返回飞书
- 跨设备接续：飞书中发起任务 → 电脑WorkBuddy助理页面查看完整执行记录
5.5 应用信息与典型场景
| 配置项 | 说明 |
|---|
| 应用名称 | 如「WorkBuddy 助手」 |
| 应用描述 | 简单描述功能 |
| 应用图标 | 上传图标 |
| 场景 | 痛点 | 飞书集成怎么解决 |
|---|
| 飞书为主要IM的企业 | 公司全员在飞书上，但WorkBuddy只能在电脑端用 | 飞书直接对话机器人，无需切换工具，手机端也能发指令 |
| 飞书文档+编程联动 | 飞书文档中提到需求，想立即开始编码 | 飞书中直接发指令，WorkBuddy自动开始编码，结果返回 |
| 飞书群聊协作 | 多人讨论技术方案，需要即时验证 | @机器人发指令，群内所有人看到结果，加速决策 |
5.6 边界和坑
- 权限导入必须完整，缺少任何一个权限可能导致机器人无法正常收发消息
- 飞书应用必须发布，未发布的应用在飞书中不可见、不可用
- Encrypt Key 和 Verification Token 需妥善保存，泄露会导致安全问题
- 飞书集成是路径A（个人助理），操控的是员工自己电脑上的WorkBuddy，不是企业级Agent
- 两种接入方式互斥，选定WebSocket长连接或URL回调后，飞书和WorkBuddy两侧必须一致
- 依赖电脑开机 + WorkBuddy运行，与企微助理一样，飞书集成也依赖本地电脑
- 飞书权限列表很长（75个），批量导入时确保完整复制粘贴，不要遗漏
陆
QQ机器人接入 · 3步极简配置 · 路径A
员工通过QQ远程操控自己电脑上的WorkBuddy。QQ接入是四种渠道中配置最简单的，3步即可完成。
6.1 是什么
QQ机器人集成让员工在QQ中与WorkBuddy机器人对话，远程操控电脑上的WorkBuddy完成任务。配置步骤极简，3步即可完成。
6.2 前提条件
- 已在电脑上安装WorkBuddy，并开启助理远程控制功能
- 拥有已完成实名认证的QQ账号
⚠️ QQ开放平台要求账号完成实名认证，如未认证需先在QQ中完成。
6.3 怎么配（3步实操）
注册并创建机器人
- 访问 q.qq.com/qqbot/openclaw/login.html
- 使用QQ扫码登录
- 点击「创建机器人」 → 立刻成功 → 机器人会给QQ发一条成功消息
- 头像昵称可按喜好自定义编辑
配置凭证
- 复制机器人的AppID
- 复制AppSecret（点击查看）
在WorkBuddy中完成连接
- 打开WorkBuddy → 设置 → 助理设置 → QQ机器人集成
- 三种连接方式可选：
- 方式1：QQ扫码连接，最简单，直接扫码绑定
- 方式2：WebSocket长连接，填入AppID和AppSecret → 点击「注册」
- 方式3：URL回调，填入AppID和AppSecret → 注册后复制Webhook地址 → 回填到QQ开放平台
配置成功验证：
- 助理设置中QQ机器人集成显示「已连接」
- 助理页面中可以看到QQ图标
⚠️ 出于安全考虑，AppSecret 不支持明文保存，二次查看将会强制重置。请自行妥善保存。
6.4 配置后效果
- 在QQ中找到创建的机器人 → 直接对话发送任务指令
- WorkBuddy在电脑上自动执行 → 结果返回QQ聊天窗口
- 跨设备接续：QQ中发起任务 → 电脑WorkBuddy助理页面查看完整记录
6.5 应用信息与典型场景
| 配置项 | 说明 |
|---|
| 应用名称 | 自定义名称 |
| 应用描述 | 简单描述用途 |
| 应用类型 | 可暂时不传 |
| 场景 | 痛点 | QQ集成怎么解决 |
|---|
| 个人开发者远程编程 | 不在电脑旁时想继续开发 | QQ发指令，电脑WorkBuddy自动执行，手机看结果 |
| 小团队轻量协作 | 不想配置复杂的企业IM | QQ最简单，3步完成，即刻可用 |
| QQ为主要沟通工具 | 日常在QQ上沟通，切换工具成本高 | QQ直接发指令，无需切换，开发沟通一体化 |
6.6 边界和坑
- QQ账号必须实名认证，未认证无法在QQ开放平台创建机器人
- AppSecret只可查看一次，二次查看强制重置，必须首次就保存
- 依赖电脑开机 + WorkBuddy运行，与所有个人助理集成一样
- QQ机器人目前功能较基础，不支持群聊@机器人等高级功能，以私聊为主
- QQ开放平台稳定性，QQ机器人API相对企微/飞书/钉钉较新，可能存在偶发不稳定
柒
钉钉接入 · 7步完整配置 · 路径A
员工通过钉钉远程操控自己电脑上的WorkBuddy。钉钉接入是企业管理员必走流程，4种渠道中唯一必须管理员权限的渠道。
7.1 是什么
钉钉集成让员工在钉钉中与WorkBuddy机器人对话，远程操控电脑上的WorkBuddy完成编程任务。支持群聊@机器人使用和单聊使用两种方式。
7.2 前提条件
- 已在电脑上安装WorkBuddy，并开启助理远程控制功能
- 拥有具有企业管理员权限的钉钉账号
⚠️ 钉钉接入需要企业管理员权限，普通成员无法自行配置。
7.3 怎么配（7步实操）
登录钉钉开发者后台
- 访问 open.dingtalk.com/
- 使用管理员账号登录
- 首次使用提示：如系统提示「该账号还未加入组织」，可创建一个个人企业
创建应用
- 开发者后台首页 → 应用开发 → 创建应用
- 点击「保存」
添加机器人能力
- 应用创建成功 → 自动跳转到「添加应用能力」页面
- 找到「机器人」选项 → 点击「添加机器人」
- 填写机器人名称、描述、预览图 → 点击「确认发布」
配置应用权限
- 左侧菜单 → 权限管理
- 搜索以下3个权限并逐一点击「立即开通」：
- Card.Streaming.Write
- Card.Instance.Write
- qyapi_robot_sendmsg
获取应用凭证
- 左侧菜单 → 凭证与基础信息
- 记录 Client ID（也叫AppKey）
- 记录 Client Secret（也叫AppSecret）
- 左侧菜单 → 开发配置 → 事件订阅 → 推送方式选择「HTTP推送」
- 点击刷新按钮自动生成 AES Key 和 Token
在WorkBuddy中配置钉钉
- WorkBuddy → 设置 → 助理设置 → 钉钉集成
- 填入Client ID和Client Secret
- 选择接入方式：WebSocket长连接（无公网IP）/ URL回调（有公网IP，需额外回填Webhook）
- 点击「注册」
URL回调模式额外步骤：注册后复制生成的Webhook地址 → 返回钉钉开发者后台 → 机器人配置页面 → 下滑到底部 → 将「Stream模式」切换为「HTTP模式」 → 在「消息接收地址」中粘贴Webhook地址（注意将 http 改为 https）→ 点击「发布」保存。
发布应用
- 点击页面上方「查看版本详情」 → 填写版本描述
- 点击「确认发布」提交审核 → 等待审核通过（通常自动审批）
⚠️ 3个权限必须全部开通，缺少任何一个机器人无法正常工作。
⚠️ Client ID、Client Secret、AES Key、Token 四个凭证必须全部妥善保存。
⚠️ 粘贴Webhook地址时，将地址中的 http 改为 https。
7.4 配置后效果
方式1：群聊使用
- 创建或选择一个群聊（确保群归属组织与机器人组织相同）
- 群设置 → 机器人 → 添加机器人 → 搜索并选择 → 确认添加
- 在群里@机器人 + 发送需求 → WorkBuddy自动执行 → 结果回复到群聊
方式2：单聊使用
- 钉钉顶部搜索框 → 搜索机器人名称 → 点击进入对话窗口
- 直接发送消息 → WorkBuddy执行 → 结果回复
7.5 典型场景
| 场景 | 痛点 | 钉钉集成怎么解决 |
|---|
| 钉钉为主要IM的企业 | 公司全员在钉钉，切换工具成本高 | 钉钉直接对话机器人，无需切换，手机也能发指令 |
| 钉钉群聊协作 | 多个部门需看同一任务结果 | @机器人发指令，群内所有人看到，加速协作 |
| 审批确认 | 钉钉中收到审批需确认 | 钉钉中一键确认，电脑端自动执行，效率提升 |
7.6 边界和坑
- 需要企业管理员权限，钉钉是四种渠道中唯一需要管理员权限才能配置的，普通成员无法自行操作
- 群归属组织必须一致，群聊的归属组织必须与机器人所属组织相同，否则群里找不到机器人
- Webhook地址必须用https，钉钉不支持http回调地址，粘贴时务必将http改为https
- 3个权限必须全部开通，Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg缺一不可
- 依赖电脑开机 + WorkBuddy运行，与所有个人助理集成一样
- 应用必须发布，未发布的钉钉应用不可见不可用
捌
四种渠道对比速览
把路径A和路径B下的4种渠道放在一起对比，作为落地选型的速查表。
8.1 路径A · 个人助理集成对比
| 维度 | 企微 | 飞书 | QQ | 钉钉 |
|---|
| 配置步骤数 | 3步（长连接） | 9步 | 3步 | 7步 |
| 推荐接入方式 | WebSocket长连接 | WebSocket长连接 | QQ扫码 | WebSocket长连接 |
| 是否需要管理员权限 | 管理员/成员均可 | 需创建应用权限 | 仅需实名认证 | 必须企业管理员 |
| 核心凭证 | Bot ID + Secret | App ID + App Secret + Encrypt Key | AppID + AppSecret | Client ID + Client Secret + AES Key + Token |
| 支持群聊@机器人 | ✅ | ✅ | ❌（仅私聊） | ✅ |
| 权限配置 | 可见范围选择 | 75个权限批量导入 | 无额外权限 | 3个权限开通 |
| 是否需要发布应用 | 不需要 | 需要（创建版本+发布） | 不需要 | 需要（创建版本+发布） |
| 依赖电脑开机 | ✅ | ✅ | ✅ | ✅ |
| 官方指南链接 | codebuddy.cn/docs/workbuddy/Wecom-Guide | codebuddy.cn/docs/workbuddy/Feishu-Guide | codebuddy.cn/docs/workbuddy/QQ-Guide | codebuddy.cn/docs/workbuddy/Dingtalk-Guide |
8.2 路径B · 企业Agent渠道接入对比
| 维度 | 企微AIBot | 飞书 | QQ机器人 | 钉钉 |
|---|
| 接入方式 | URL回调（目前仅支持） | 待官方文档补充 | 待官方文档补充 | 待官方文档补充 |
| 配置位置 | 企业后台→企业智能体→渠道接入 | 企业后台→企业智能体→渠道接入 | 企业后台→企业智能体→渠道接入 | 企业后台→企业智能体→渠道接入 |
| 消息路由 | Bot→Session绑定 | Bot→Session绑定 | Bot→Session绑定 | Bot→Session绑定 |
| 依赖电脑开机 | ❌（云端沙箱执行） | ❌ | ❌ | ❌ |
| 是否需要外部平台配置 | 企微后台同步配置Token/Webhook | 飞书开放平台配置 | QQ开放平台配置 | 钉钉开发者后台配置 |
⚠️ 路径B（企业Agent渠道接入）目前官方文档仅详细覆盖企微AIBot的配置步骤，飞书/QQ/钉钉三种渠道的Agent级渠道接入具体操作步骤待官方补充完善。
玖
场景与效果 · 配置后员工怎么用
把"配置"和"使用"打通，按场景给推荐路径，再给出完整的"配置→使用"链路图作为最终落地参考。
9.1 企业落地常见6大场景
| 场景 | 推荐路径 | 推荐渠道 | 配置后效果 |
|---|
| 7×24 智能客服/问答 | 路径B（Agent渠道接入） | 企微AIBot | 员工@Bot提问，Agent云端执行，即时回复，不依赖任何人电脑 |
| 出差远程编程 | 路径A（个人助理集成） | 企微/飞书/钉钉 | 手机发指令，电脑WorkBuddy执行，结果回复到IM，跨设备接续 |
| 团队协作群 | 路径A或B | 企微/钉钉/飞书 | 群聊@机器人，所有人看到结果，加速决策 |
| 审批确认 | 路径A | 企微 | 企微中收到确认请求，一键批准，电脑端执行 |
| 数据巡检+自动通知 | 路径B | 企微AIBot/飞书 | Agent定时巡检，发现异常，主动推送通知到群 |
| 新人入职问答 | 路径B | 企微AIBot/飞书 | 新人@Bot问制度/流程，Agent从知识库检索，精准回答 |
9.2 配置 → 使用 完整链路图
| 路径 | 配置动作 | 员工调用方式 | 消息路由 | 执行环境 |
|---|
| 路径A · 企微长连接 | 企微后台创建Bot → WorkBuddy填Bot ID+Secret注册 | 企微中@Bot/私聊发消息 | 企微 → 本机WorkBuddy助理 → 执行 → 回复企微 | 员工本地电脑 |
| 路径A · 企微URL回调 | 企微后台获取Token+AESKey → WorkBuddy注册 → 生成Webhook → 回填企微 | 企微中@Bot/私聊发消息 | 同上（HTTP回调方式） | 员工本地电脑 |
| 路径A · 飞书 | 飞书9步 → WorkBuddy填App ID+App Secret+Encrypt Key注册 | 飞书中搜索机器人 → 对话 | 飞书 → 本机WorkBuddy助理 → 执行 → 回复飞书 | 员工本地电脑 |
| 路径A · QQ | QQ开放平台创建Bot → WorkBuddy填AppID+AppSecret或扫码 | QQ私聊发消息 | QQ → 本机WorkBuddy助理 → 执行 → 回复QQ | 员工本地电脑 |
| 路径A · 钉钉 | 钉钉7步 → WorkBuddy填Client ID+Client Secret注册 | 钉钉群@Bot或单聊 | 钉钉 → 本机WorkBuddy助理 → 执行 → 回复钉钉 | 员工本地电脑 |
| 路径B · Agent渠道接入 | 企业后台 → 企业智能体 → 渠道接入 → 绑定Session | IM中与Bot对话 / 分享链接 / API Key | IM → 云端Agent Session → 云端沙箱执行 → 回复IM | 云端沙箱 |
拾
边界和坑 · 落地前必读
把零散在各板块里的注意事项收拢到这里，作为最终落地前的风险排查清单。
10.1 跨渠道通用问题
- 路径A全部依赖电脑开机 + WorkBuddy运行，四种渠道的个人助理集成都是远程控制本地电脑，电脑关机则所有渠道都无法响应
- 路径B仅企业旗舰版/专享版可用，CloudAgent渠道接入是企业版专属功能，个人版无法使用
- 凭据必须妥善保存，所有渠道的核心凭据（Secret/AppSecret/Token/AESKey等）都只有一次性查看机会或需要自行保存，泄露或丢失都会导致重新配置
- 两种路径不要混淆，路径A是个人远程控制本地电脑，路径B是企业级Agent云端服务，两者定位完全不同
- 渠道接入需外部平台同步配置，不是WorkBuddy单边操作就能完成，需在IM平台（企微/飞书/QQ/钉钉）后台同步配置
10.2 各渠道特有问题
- 企微：长连接模式推荐，但企微AIBot渠道接入（路径B）目前仅支持URL回调模式
- 飞书：权限导入必须完整（75个权限），缺少任何一个可能导致功能异常
- QQ：AppSecret仅一次查看机会，二次查看强制重置；不支持群聊@机器人
- 钉钉：必须企业管理员权限；Webhook地址必须用https；群归属组织必须一致
10.3 企业落地建议
- 先明确需求，7×24服务选路径B（Agent），个人远程选路径A（助理），不要上来就配错路径
- 优先企微长连接，大多数企业IM是企微，长连接配置最简单（3步）
- 路径B的飞书/QQ/钉钉渠道接入细节，官方文档目前仅详细覆盖企微AIBot，其他三种渠道的Agent级渠道接入具体步骤待官方补充
- 路径A和路径B可以共存，同一企业可以同时使用两种路径，企微助理用于个人远程控制，企微AIBot用于企业级Agent服务
数据真实性说明
路径B（企业Agent渠道接入）目前官方文档仅详细覆盖企微AIBot的配置步骤，飞书/QQ/钉钉三种渠道的Agent级渠道接入具体操作步骤待官方补充完善。路径A（个人助理集成）四种渠道的配置步骤来自官方指南，数据完整可查证。具体操作界面可能随版本更新变化，请以实际后台为准。