企业微信远程：把 WorkBuddy 接进企微机器人
💡 一句话总结：用 WorkBuddy 打通企业微信远程派活 —— 建一个企微智能机器人、长连接绑定、在企微聊天里遥控你的电脑。
人在客户现场，同事在企微群里 @你：「上个月那份报价单发我一下」。以前只能回一句「等我回工位」——配好 WorkBuddy 企业微信远程（官方叫「企微助理」）之后，你可以直接在企微里 @机器人 说一句话，让它去你电脑上把文件找出来。
这一课把官方「企微助理接入指南」拆成 5 步：先在企微创建一个 API 模式的智能机器人，用 WebSocket 长连接把它和 WorkBuddy 绑定，然后在企微私聊或群聊里派活——你的电脑自动执行，结果同步回企微聊天窗口。
这是「场景实战」路线三的第 1 课，基于 WorkBuddy v5.9.3（企微助理最低要求 4.6.4），内容依据官方「企微助理接入指南」及助理、定时任务功能文档与 FAQ。
学完你能做什么
- 在企业微信里创建一个 API 模式的智能机器人，用 WebSocket 长连接（Bot ID + Secret，或扫码快捷绑定）把它绑到 WorkBuddy
- 在企微私聊或群聊 @机器人 远程派活：找文件、整理资料、生成文档，你的电脑自动执行，结果同步回企微聊天窗口
- 回到电脑查看远程任务的完整执行记录（思考过程、操作步骤、生成文件、最终结果）并继续追问；远程批准命令执行、文件修改等高风险操作
- 机器人失联时会按官方清单排查：WorkBuddy 运行状态、两侧接入方式、凭据、网络，无响应先切换模型再测
为什么用 WorkBuddy，而不是网页版 AI？
| 能力 | 网页版 AI / 普通企微机器人 | WorkBuddy 企微助理 |
|---|---|---|
| 碰你电脑上的文件 | ❌ 对话框里没有你的文件，全靠复制粘贴 | ✅ 用你本地的项目文件、Shell 环境、凭证权限、插件和工具执行 |
| 在企微群里干活 | ❌ 只会应答和群发，接不进你的电脑 | ✅ 群聊 @机器人 下发团队任务，结果自动回群聊 |
| 高风险操作可控 | ❌ 没有执行能力，谈不上确认 | ✅ 命令执行、文件修改先在企微里向你确认，批准后才动 |
| 人不在电脑前 | ❌ 网页开着也没人替你干活 | ✅ 企微发指令，电脑上的 WorkBuddy 自动执行 |
| 定时任务结果送达 | ❌ 到点没人看 | ✅ 定时任务可推送到企业微信（仅长连接模式） |
你现在的困境
- 人常在外面跑——会议室、通勤路上、客户现场，同事在企微群里要个数据，你只能回「等我回工位」
- 活儿本身不复杂：找份文件、跑个汇总，但手边没电脑就是干不了；远程桌面又卡又小屏，不敢真操作
- 团队的活散在企微群里：派活、跟进、交付全靠人肉 @来 @去，谁也不知道进度
- 想过用企微机器人，但普通机器人只会应答，接不进你电脑里的文件和工具
什么时候用这一招
当你需要：
- 不在电脑前时，让公司电脑替你干活：找文件、整理资料、生成文档
- 在企微群里直接派团队任务，结果回到群里，相关人都能看到
- 随时跟进远程任务进度，远程批准需要确认的操作
而且不想：
- 拿手机开远程桌面，在小屏幕上点来点去
- 让同事干等一份「等我回工位」的文件
- 把公司文件上传到第三方网页版 AI 对话框
🎒 开始前的准备
- 看过 5.1 助理总览：六个远程渠道与安全边界——本课直接用它的统一配置入口，不重复渠道全景与安全边界
- 电脑上的 WorkBuddy 已登录，版本 ≥ 4.6.4（企微助理的最低要求；写本课时最新版为 5.9.3）
- 有一个可创建智能机器人的企业微信账号——管理员走管理后台，普通成员走客户端；还没有企微的话，官方提供免费注册入口
- 电脑和手机都能正常上网；配置期间电脑保持开机并运行 WorkBuddy
- 20 分钟和一杯水 ☕——最好拿工作电脑跟着配，配完当场发条消息验证
跟我做
第 1 步：在企业微信创建智能机器人（API 模式）
为什么：WorkBuddy 不能凭空出现在企微里——得先在企微侧建一个「智能机器人」，拿到凭证才能绑定。入口按账号角色二选一。
方式 A：管理员路径（在企业微信管理后台创建）
- 浏览器打开企业微信管理后台，用管理员账号登录
- 依次点击「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」
方式 B：普通成员路径（在企微客户端创建）
- 打开企业微信客户端，进入「工作台」→「智能机器人应用」→「创建机器人」
两条路在这里汇合：
- 如果先进入 AI 自动生成页面，点左下角的「手动创建」，再选择「API 模式创建」
- 填两项公共配置：
| 配置项 | 说明 |
|---|---|
| 机器人名称 | 建议填容易识别的名字，如「WorkBuddy 助手」 |
| 可见范围（管理员）/ 可使用成员（成员端） | 选择哪些员工、部门或标签可以使用这个机器人 |
- 管理员路径点「可见范围」后的「添加」选成员；成员路径点「可使用成员」后的「修改」选成员
- 完成配置后先点页面底部的「保存」，再在「API 配置」区域选择「使用长连接」
你应该看到：机器人已创建，「API 配置」区域显示「使用长连接」已选中。
第 2 步：复制 Bot ID 和 Secret
为什么：长连接模式靠这两个凭证相认——企微靠 Bot ID 认机器人，WorkBuddy 靠这对凭证连上它。
在「API 配置」区域（已选「使用长连接」）：复制 Bot ID；点「点击获取」拿到 Secret，妥善保存。
💡 为什么推荐长连接
官方说明：长连接模式不需要再填写 URL、Token 或 Encoding-AESKey，配置更简单，也无需回填 Webhook URL。还有一个硬理由——定时任务推送只支持长连接，URL 回调模式开推送开关时会提示需解绑后重新连接（见本课进阶技巧）。
你应该看到：两个凭证都已复制并保存好，Secret 放在安全的地方（不要贴到群里）。
第 3 步：在 WorkBuddy 里注册绑定企微助理
为什么：凭证只在企微侧，还要在 WorkBuddy 里「注册」一次，双向握手才算绑定完成。
- 打开 WorkBuddy，点左下角头像菜单中的「设置 - 助理设置」
- 在「集成（BETA）」区域找到「企微助理集成」，点「配置」
- 在弹窗中选择「WebSocket 长连接」，两种绑定方式任选其一：
- 手动填写：把 Bot ID 和 Secret 填进输入框
- 快捷绑定：点「快捷绑定」接入，用企微扫码完成绑定
- 点「注册」完成绑定
私有化部署的企业微信？要多填一个地址
若你的企业用私有化部署的企微，除 Bot ID 和 Secret 外，还要把专属 WebSocket 地址填进「自定义 WebSocket 地址」输入框：
- 地址在企业微信管理后台获取，格式形如
ws://<网关>:<端口>/im_openws?bizid=1 - 协议必须是
ws://或wss://——填http://等其他协议会被拦截并给出提示 - 留空时自动回落到公有云默认地址，不影响常规（非私有化）部署
- 该输入框只在 WebSocket 长连接模式下出现，URL 回调模式不涉及
配置保存后重启 WorkBuddy 会自动重连；若地址不可达，界面会显示明确的连接错误状态，便于排查网络或地址配置问题。
你应该看到：注册成功，企微助理集成显示已绑定。
第 4 步：给机器人发一条「你好」
为什么：绑定成功不等于通道可用，先用一条零成本消息验证整条链路。
在企微通讯录的「企业创建的」分组下找到刚创建的机器人，点「发消息」，发送一条简单消息（例如「你好」）。
你应该看到：WorkBuddy 接收到消息并在企业微信中返回回复——机器人能正常回复，说明 WorkBuddy 与企业微信对接成功。
第 5 步：在企微里派第一个远程任务
为什么：链路验证通过后，就可以开始跑实际任务了。分工很明确：企微负责发指令，你的电脑负责执行。
在企微聊天里直接给机器人发任务指令，比如：
帮我在电脑上找一下 D:/工作/报价单 目录里最新的报价单，
读出客户名、总金额和有效期，直接回复我。你应该看到：
- WorkBuddy 在你的电脑上执行，过程和结果同步回企微聊天窗口
- 回到电脑，能在这个任务里查看完整执行过程和结果；在助理页面可查看远程任务的完整执行记录：思考过程、操作步骤、生成文件及最终结果
- 你可以在电脑上继续追问、细化任务，也可以在企微里随时查看进度
💡 这就是 WorkBuddy 的独有价值
电脑上的 WorkBuddy 用你本地的项目文件、Shell 环境、凭证权限、插件和工具来执行任务——官方原话：您电脑上能做的事，通过企业微信也能远程完成。网页版 AI 只能「聊」，这里是真执行。
远程任务和你平时在电脑上开的普通任务，官方给了三点对照：
| 对比项 | 普通任务 | 助理（远程任务） |
|---|---|---|
| 工作目录 | 自由指定 | 固定使用助理专属文件夹 |
| 新建对话 | 支持多个并行任务 | 仅一个会话，所有远程指令集中处理 |
| 上下文管理 | 可清空历史重新开始 | 保留完整对话历史，不可清空 |
官方建议：本地操作优先使用主界面的普通任务；需要远程触发或统一查看记录时，再使用助理。
📋 魔法 Prompt
以下指令复制到企微聊天框发给机器人即可，【】里换成你的实际情况。
📝 通勤远程查文件
预期效果：人在外面，让电脑替你翻文件、报关键信息，不用开远程桌面。
## 角色
你是我的办公助理，可以操作我电脑上的文件。
## 任务
在【目录路径】里找【文件关键词】相关的最新文件，读取后把关键信息回复给我。
## 输入信息
### 必填项
- 目录路径：【如 D:/工作/报价单】
- 文件关键词：【如 报价单，或客户、项目名】
### 选填项
- 时间范围：【如 只看本周修改过的?】
- 要提取的字段：【如 客户名、总金额、有效期?】
## 输出规范
- 直接在企微聊天里回复：文件名 + 修改时间 + 关键信息
## 约束条件
- ✅ 只读取，不修改、不移动、不删除任何文件
- ✅ 找不到就如实说明找了哪里、为什么没找到
- ❌ 不虚构文件内容
- ❌ 不执行删除类操作📝 群聊团队任务
预期效果：在企微群里 @机器人 派团队任务，结果直接回到群里，相关人都能看到。
## 角色
你是我们团队的办公助理，处理群里 @你 下发的协作任务。
## 任务
把【材料来源】汇总成【交付物】，完成后把结果回复到群里。
## 输入信息
### 必填项
- 材料来源：【如 我电脑 D:/周报/ 目录下各组本周周报】
- 交付物：【如 一份团队周报，分进展、风险、下周计划三段】
### 选填项
- 输出格式：【如 存成 Word 文档放到 D:/周报/汇总/?】
- 通知对象：【@谁?】
## 输出规范
- 汇总结果回到企微群聊；生成了文件就报出文件路径
## 约束条件
- ✅ 内容全部来自提供的材料，不添油加醋
- ✅ 拿不准的信息单独列「待确认」
- ❌ 不编造材料里没有的事项
- ❌ 不改动原始材料文件📝 进度跟进与结果验收
预期效果：任务派出去之后随时追问，别让远程任务变成「发射后不管」。
## 任务
跟进刚才下发的任务：
1. 汇报当前进行到哪一步
2. 已完成的话，给出结果和产物位置
3. 卡在需要确认的操作时，说清楚需要我批准什么
## 约束条件
- ✅ 如实汇报，进行中就说进行中
- ❌ 不为了交差把未完成说成已完成💡 日常聊天可以更口语
魔法 Prompt 是完整结构，重要任务建议照着写全（做什么 + 有什么 + 怎么样，见 3.1 提需求方法论）。企微助理是单会话、保留完整历史的，日常跟进用一两句话也行——「刚才那个任务好了吗」。
检查点 ✅
- 企微通讯录「企业创建的」分组里能找到机器人，发「你好」能收到回复
- WorkBuddy 版本 ≥ 4.6.4，「助理设置」里企微助理集成显示已绑定
- 绑定用的是 WebSocket 长连接——以后想把定时任务结果推到企微，只有它支持
- 我知道企微只负责发指令和批准操作，真正干活的是我的电脑：它得保持开机并运行 WorkBuddy
- 我知道远程任务固定在助理专属文件夹、单会话集中处理、历史不可清空
- 试过一次远程派活，并在电脑上看到了完整的执行记录
踩坑提醒
❌ 机器人不回复
现象：WorkBuddy 端显示已注册或已配置完成，但企微里发消息机器人不回、偶发断开，或首次可用后再次打开就失联。
原因：官方 FAQ 把「已完成接入但发送消息后没有响应」列为 QQ、企业微信、微信、飞书、钉钉多平台共性问题——连接掉线、模型异常、凭据不符都可能。
正确做法（按官方排查顺序）：确认 WorkBuddy 正在运行且助理服务已开启；核对企业微信与 WorkBuddy 选的是同一种接入方式；长连接核对 Bot ID 和 Secret，URL 回调核对 Token 和 Encoding-AESKey；确认电脑网络正常。官方 FAQ 还有一条经验：优先切换模型后再次测试，部分无响应问题可通过切换模型缓解。
❌ 长连接注册失败
现象：在 WorkBuddy 里点「注册」报错，绑不上。
正确做法（官方清单）：确认企业微信侧已选「使用长连接」；重新复制 Bot ID 和 Secret，避免带入多余空格；Secret 已失效的去企业微信后台重新获取再注册；私有化部署的核对自定义 WebSocket 地址协议（ws:// 或 wss://）、网关与端口，并确认该地址在当前电脑上可访问。
❌ URL 验证失败（URL 回调模式）
现象：把 Webhook URL 回填到企微后，验证不通过。
正确做法（官方清单）：确保 WorkBuddy 处于运行状态；检查助理服务是否已正常启动；重新复制 Webhook URL，确保没有遗漏或多余字符；确认 Token 和 Encoding-AESKey 与 WorkBuddy 中配置的完全一致。
❌ 提示「Webhook 域名主体校验未通过」
现象：在企业微信侧配置 Webhook 地址时，弹出域名主体校验未通过的提示。
原因：企业微信侧会对 Webhook 地址进行域名主体校验。
正确做法：官方建议先核对 Webhook 地址是否完整、是否与当前配置要求一致；若仍无法通过，保留报错截图提交排查。
❌ 电脑一关机，机器人就「失联」
现象：下班关机后，企微里发消息机器人不回；第二天开机又好了。
原因：不是机器人坏了——企微只负责发送指令、批准操作和后续消息，执行任务的全部环境（文件、Shell、凭证、插件、工具）都在你的电脑上，电脑不在线就没人干活。
正确做法：需要远程干活的时段，让电脑保持开机并运行 WorkBuddy（这是官方列的前置条件）。锁屏场景怎么处理，见下一课 C2 手机远程遥控。
进阶技巧（可选）
🔧 URL 回调接入（备选方案）。 长连接是推荐路径；如果你已经在用 Webhook 配置，或因网络、部署限制需要 URL 回调，按官方备选流程走：
- 企微「API 配置」区域选「使用 URL 回调」，点 Token 和 Encoding-AESKey 输入框右侧的「随机获取」，保存好这两个参数——官方强调：丢了就无法完成注册
- WorkBuddy 进「助理设置」→「企微 AIBot 集成」→「配置」，注册弹窗切换到「使用 URL 回调」，填入 Token 和 Encoding-AESKey，点「注册」
- 复制注册成功后生成的 Webhook URL，回到企微机器人创建页粘贴到 URL 输入框，点「保存」
⚠️ URL 回调收不到定时任务推送
定时任务推送只支持 WebSocket 长连接。如果助理当前是 URL 回调连接，开推送开关时会提示「URL 回调连接暂不支持消息推送，需解绑后重新连接」；重新连接后，原来通过 URL 回调接收消息的能力也会改为长连接方式。
🔧 把定时任务结果推送到企微。 绑定好机器人后，本地定时任务（比如每周五 17:00 的周报）可以把结果推送到企业微信。见 3.3 定时任务 与 C4 每日资讯简报。官方说明：推送失败不会影响任务本身的执行。
🔧 建一个专属任务群。 官方能力清单里有「创建专属任务群，长期绑定 WorkBuddy 处理团队日常工作」：把机器人拉进项目群，@机器人 下发任务、跟进进度，任务完成后自动通知群聊相关人员——派活、验收、留痕都在同一个群里。
本课小结
✅ WorkBuddy 企业微信远程五步走：建机器人（API 模式）→ 拿 Bot ID + Secret → WorkBuddy 注册绑定 → 发「你好」验证 → 派第一个远程任务。
✅ 长连接优先：不用回填 Webhook URL，少填三样参数；定时任务推送也只支持它。
✅ 企微是遥控器，电脑是主机：企微只发指令、批准操作；文件、Shell、凭证、插件、工具都在你电脑上——保持开机并运行 WorkBuddy。
✅ 远程任务三特点：固定助理专属文件夹、单会话集中处理、历史不可清空；本地活优先用普通任务。
✅ 高风险操作有确认：命令执行、文件修改等，先在企微里批准才执行。
关键配置回顾：
| 配置项 | 本课取值 | 说明 |
|---|---|---|
| WorkBuddy 版本 | ≥ 4.6.4 | 企微助理最低要求 |
| 机器人创建 | 手动创建 · API 模式 | 管理员走管理后台，成员走客户端 |
| 连接方式 | WebSocket 长连接（推荐） | Bot ID + Secret，或扫码快捷绑定 |
| 私有化企微地址 | ws://<网关>:<端口>/im_openws?bizid=1 | 协议必须 ws:// 或 wss:// |
| 机器人入口 | 企微通讯录 →「企业创建的」 | 点「发消息」即派活 |
下一课预告
企微解决了「在聊天工具里派活」，下一课解决「手机随身遥控」。下一课学 C2 手机远程遥控：通勤路上让公司电脑干活。
你会学到：
- 「连接移动端」开关与「允许锁屏运行」怎么配
- 通勤路上远程找文件、排查报错的官方场景与 Prompt
- 远程续聊、产物自动回传，以及续聊不额外耗积分的规则