WorkBuddy 接入微信、飞书与钉钉教程

📚 系列导航：上一篇 WorkBuddy 连接器与 MCP 使用教程 已经完成前一阶段；本篇聚焦配置 WorkBuddy 小程序和微信、飞书、钉钉 IM 助理；下一篇 WorkBuddy 外部模型 API 配置教程 继续后续学习。

先给结论：WorkBuddy 可以通过小程序和 IM 助理接收任务。本机模式让手机指令回到已连接电脑执行，云端模式在隔离云环境运行；微信接入以扫码绑定为主，飞书和钉钉则需要创建企业应用、机器人并配置权限。

不在电脑前，也能从微信、飞书或钉钉发起任务

很多任务不是坐到电脑前才想起来的。路上收到消息、开会时冒出需求、临时要查一份资料，如果每次都得等回到工位再启动任务，自动化的价值就打了折扣。

看完这一篇，你会拿到：

• 分清小程序本机模式和云端模式
• 看懂 IM 消息从手机到工作区的完整链路
• 完成微信助理扫码绑定
• 知道飞书和钉钉接入的关键步骤
• 守住凭证、权限、测试组织和敏感结果四条安全边界

⚠️ 微信、飞书、钉钉开放平台和 WorkBuddy 的配置页面会变化。本文保留当前蓝皮书流程，操作时以 WorkBuddy 官方指南和各平台当前控制台为准。

WorkBuddy 小程序本机模式与云端模式

**类比：本机模式像远程叫办公室同事干活，云端模式像临时租一间独立办公室。**前者能碰到你电脑里已授权的资料，但电脑必须在线；后者不依赖你的电脑，却不能想当然地访问本地文件和环境。

首次使用按顺序确认：

1. 从官方入口打开 WorkBuddy 小程序并登录。
2. 看清当前是本机还是云端模式。
3. 使用本机模式时，确认目标电脑在线且连接正确。

💡 一句话总结：需要本地文件就选本机模式并保持电脑在线；不依赖本机环境的调研和写作，才更适合云端模式。

IM 助理背后的工作链路

手机里发出一句话后，任务不是凭空出现在电脑上，而是经过机器人和 WorkBuddy 助理转发：

sequenceDiagram
    participant U as 手机 IM
    participant B as 应用机器人
    participant W as WorkBuddy 助理
    participant P as 本机工作区
    U->>B: 发送任务
    B->>W: 回调或长连接传递消息
    W->>P: 在授权目录执行
    P-->>W: 产物与状态
    W-->>B: 返回结果
    B-->>U: 手机查看与确认

这条链里有三类边界：IM 平台的应用权限、WorkBuddy 的助理配置、本机工作区的文件权限。任何一层配错，都可能表现成“机器人没反应”。

💡 一句话总结：手机只是任务入口，真正执行还要经过机器人、WorkBuddy 助理和授权工作区；排错时按链路逐层查。

接入微信助理：扫码绑定，先做只读测试

进入 WorkBuddy 助理设置

打开 WorkBuddy，在左侧“助理”栏点击齿轮。

选择 WorkBuddy 微信助理集成

找到“微信助理集成”，点击“配置”。

扫码绑定 WorkBuddy 微信助理

等待二维码生成，用手机微信扫码。

确认 WorkBuddy 微信助理绑定状态

卡片显示“已绑定”后，不要直接发删除或修改文件的任务，先发一条只读测试指令。

例如：

只查看当前测试工作区的文件列表，不要修改任何文件。

更换 WorkBuddy 微信助理账号

切换微信账号前，先解绑当前账号，再重新扫码。

二维码有时效限制。若长时间停在“绑定中”、二维码过期或扫码失败，关闭配置窗口后重新进入；仍失败时重启 WorkBuddy，再生成二维码。

预期结果：微信助理显示已绑定，只读测试能返回正确工作区的文件信息，且没有产生文件变更。

💡 一句话总结：微信接入的关键不是扫完码，而是绑定后先用只读任务验证账号、电脑和工作区是否对应正确。

接入飞书：应用、机器人、权限、回调缺一不可

飞书接入比微信扫码多几步，因为你要在开放平台创建企业自建应用。

选择 WorkBuddy 飞书助理

进入“设置 → 助理设置 → 飞书”。

创建飞书企业自建应用

登录飞书开放平台，创建企业自建应用。

添加飞书机器人能力

配置飞书机器人最小权限

只开机器人收发消息和当前任务真正需要的权限，不要因为配置省事把所有权限一把全开。

获取飞书应用凭证

在“凭证与基础信息”中获取 App ID 和 App Secret。

⚠️ App Secret 是凭证，不要出现在公开截图、聊天记录、文章或代码仓库中。发现泄露应立即到平台轮换。

填写 WorkBuddy 飞书配置

将凭证填入 WorkBuddy，生成或复制回调信息。

配置飞书事件订阅

在飞书开放平台配置事件订阅和回调。

按当前指南添加接收消息、卡片交互等事件。

发布并测试飞书应用

创建版本并发布应用。

在飞书中向机器人发送一条只读测试任务，确认消息能进、结果能回、目标工作区正确。

💡 一句话总结：飞书接入要把应用、机器人、权限、凭证、回调、事件和发布串起来；卡住时按这条链逐项检查。

接入钉钉：先在测试组织里跑通

使用企业管理员账号登录钉钉开发者后台，创建应用。

进入“应用开发”，为应用添加机器人能力。

填写机器人名称、描述和头像，并按当前指南开通所需权限。

获取应用凭证并完成 WorkBuddy 侧配置。

优先在测试组织或测试群验证，不要第一次就把机器人发布到正式大群。

💡 一句话总结：钉钉接入先创建应用和机器人，再配置权限与凭证，最后在测试组织完成只读验证。

接入完成后的安全清单

• 当前账号和目标组织正确
• 只开通任务需要的最小权限
• App Secret 等凭证没有进入截图、聊天和仓库
• 本机模式连接的是正确电脑和工作区
• 第一条任务只读、可验证、无破坏性
• 正式发布前在测试群或测试组织跑通
• 通过 IM 返回的结果不含不该外发的敏感内容

远程派活让执行更方便，也把入口从本机扩大到了聊天平台。入口越多，账号、权限和结果外发范围越要看清。

本篇小结

• 小程序本机模式依赖已连接电脑，适合本地文件和工作区任务。
• 云端模式不依赖电脑在线，适合不需要本机环境的任务。
• 微信助理以扫码绑定为主，绑定后先做只读测试。
• 飞书和钉钉需要创建应用、机器人，配置最小权限、凭证和回调。
• 所有 IM 接入都要核对账号、工作区、凭证和结果分享范围。

你现在应该能：根据任务选择本机或云端模式，并理解微信、飞书、钉钉接入的完整链路。更重要的是，你知道远程入口不是“配置成功就结束”，而是必须用只读任务验证权限和工作区。

下一篇 09 · 如何接入外部 API：消息入口接好了，接下来把自己的模型 API、Coding Plan 或本地 Ollama 接进 WorkBuddy。