WorkBuddy 飞书与企业微信集成

一句话结论

在飞书和企业微信中使用 WorkBuddy 的完整指南

本章概述

在飞书和企业微信中使用 WorkBuddy 的完整指南

---

WorkBuddy 接入飞书指南

WorkBuddy 接入飞书指南 本指南将帮助您在飞书中配置 WorkBuddy 机器人，让您可以通过飞书随时随地远程操控电脑上的 WorkBuddy 完成编程任务。

一、前提条件

在开始之前，请确保您已满足以下条件：

• 已在电脑上安装 WorkBuddy，并开启了 助理 远程控制功能
• 拥有一个飞书企业账号（需要有创建应用的权限）

二、创建飞书应用

1）登录开发者后台

打开浏览器，访问 「飞书开放平台」，使用企业账号登录后，点击「创建企业自建应用」。

2）填写应用信息

在弹出的创建窗口中，填写以下信息： 配置项说明应用名称 给应用起一个名字，如「WorkBuddy 助手」应用描述 简单描述应用的功能应用图标 上传一个应用图标 填写完成后，点击「创建」按钮。

3）进入应用详情

应用创建成功后，会自动跳转到应用详情页面。

三、添加机器人能力

在应用详情页的「添加应用能力」区域，找到「机器人」卡片，点击「添加」按钮。

四、配置应用权限

为了让机器人能够正常收发消息，需要为应用添加必要的权限。

1）进入权限管理

在应用详情页左侧菜单中，点击「权限管理」，然后选择「批量导入 / 导出权限」。

2）批量导入权限

在弹出的窗口中：

• 清空输入框中的所有内容
• 将下方的权限列表完整复制并粘贴进去
• 点击「确定新增权限」

需要导入的权限列表： json { "scopes": { "tenant": [ "contact:contact.base:readonly", "docx:document:readonly", "im:chat:read", "im:chat:update", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message.pins:read", "im:message.pins:write_only", "im:message.reactions:read", "im:message.reactions:write_only", "im:message:readonly", "im:message:recall", "im:message:send_as_bot", "im:message:send_multi_users", "im:message:send_sys_msg", "im:message:update", "im:resource", "application:application:self_manage", "cardkit:card:write", "cardkit:card:read" ], "user": [ "contact:user.employee_id:readonly", "offline_access", "base:app:copy", "base:field:create", "base:field:delete", "base:field:read", "base:field:update", "base:record:create", "base:record:delete", "base:record:retrieve", "base:record:update", "base:table:create", "base:table:delete", "base:table:read", "base:table:update", "base:view:read", "base:view:write_only", "base:app:create", "base:app:update", "base:app:read", "board:whiteboard:node:create", "board:whiteboard:node:read", "calendar:calendar:read", "calendar:calendar.event:create", "calendar:calendar.event:delete", "calendar:calendar.event:read", "calendar:calendar.event:reply", "calendar:calendar.event:update", "calendar:calendar.free_busy:read", "contact:contact.base:readonly", "contact:user.base:readonly", "contact:user:search", "docs:document.comment:create", "docs:document.comment:read", "docs:document.comment:update", "docs:document.media:download", "docs:document:copy", "docx:document:create", "docx:document:readonly", "docx:document:write_only", "drive:drive.metadata:readonly", "drive:file:download", "drive:file:upload", "im:chat.members:read", "im:chat:read", "im:message", "im:message.group_msg:get_as_user", "im:message.p2p_msg:get_as_user", "im:message:readonly", "search:docs:read", "search:message", "space:document:delete", "space:document:move", "space:document:retrieve", "task:comment:read", "task:comment:write", "task:task:read", "task:task:write", "task:task:writeonly", "task:tasklist:read", "task:tasklist:write", "wiki:node:copy", "wiki:node:create", "wiki:node:move", "wiki:node:read", "wiki:node:retrieve", "wiki:space:read", "wiki:space:retrieve", "wiki:space:write_only" ] } }等待几秒钟，页面会显示权限已成功添加。

五、获取应用凭证

1）查看凭证信息

在应用详情页左侧菜单中，点击「凭证与基础信息」。

在页面中，您会看到两个重要的凭证信息：

• App ID：应用的唯一标识
• App Secret ：应用的密钥（点击查看）

重要

请务必妥善保管 App Secret，不要泄露给他人！

2）获取 Encrypt Key 和 Verification Token

在应用详情页左侧菜单中，点击「事件与回调」，在右侧页面中选择加密策略。

您可以点击刷新按钮自动生成，或点击编辑按钮自定义您的 Encrypt Key 和 Verification Token。 重要

请务必妥善保管 Encrypt Key 和 Verification Token，不要泄露给他人！

六、在 WorkBuddy 中配置飞书

现在，我们需要将凭证配置到 WorkBuddy 中，让它能够与飞书通信。

1）填写凭证

在 WorkBuddy 中，点击左上角的个人头像，选择「设置 - 助理设置」，找到「飞书集成」开始配置。 将刚才获取的 App ID、App Secret 以及 Encrypt Key 填入对应的输入框:

• WebSocket 长连接 模式 适用于个人/家庭/办公室用户（没有公网 IP）。配置更简单，不需要公网地址，开箱即用。 - 使用 URL 回调 模式 适用于有服务器、有公网 IP 的用户，需要额外在飞书开放平台填写生成的 Webhook 地址。

3）注册

• WebSocket 长连接：点击「注册」按钮完成配置，配置成功显示已连接 ： - 使用 URL 回调：点击「注册」按钮系统会生成一个 Webhook 地址，点击复制保存：

七、配置飞书事件回调

接下来，我们需要告诉飞书将消息发送到哪里。

1）配置事件订阅

返回飞书开放平台，进入应用详情页；在左侧菜单中，点击「事件与回调」。

• WebSocket 长连接：在「订阅方式」中选择「使用长连接接收事件」，点击「验证」： 配置成功显示「连接成功」： - 使用 URL 回调：在「订阅方式」中选择「将事件发送至开发者服务器」，将刚才复制的 Webhook 地址粘贴到输入框中并点击「保存」：

2）添加消息接收事件

在「事件配置」区域，点击「添加事件」，搜索并添加「接收消息」事件。

3）配置卡片回调

• 切换到「回调配置」页签
• 搜索「卡片回传交互」
• 点击「确认添加」

八、发布应用

应用必须发布后才能在飞书中使用。

1）创建版本

点击页面上方的「创建版本」按钮。 在弹出的窗口中填写： 配置项示例版本号 1.0.0版本描述 首次发布，集成 WorkBuddy 点击「确定」创建版本。

2）发布版本

创建成功后，点击版本右侧的「发布」按钮。

提示
如果您是企业管理员，应用通常会自动审批通过。如果需要审批，请联系您的企业管理员。

九、开始使用

1）找到机器人

在飞书的搜索框中，输入刚才创建的机器人名称进行搜索。

2）开始对话

点击机器人进入对话窗口，或者点击「打开应用」开始使用。

3）发送任务

直接发送您的需求，比如「帮我写一个待办事项应用」。WorkBuddy 会在电脑上自动执行任务，并将结果返回给您。 恭喜

您已成功将 WorkBuddy 接入飞书！现在可以通过飞书随时随地远程控制 WorkBuddy 完成各种编程任务了。

十、常见问题

1）机器人没有响应怎么办？

请按以下步骤排查：

• 检查应用状态 ：确认应用已成功发布
• 检查 WorkBuddy ：确保电脑上的 WorkBuddy 正在运行，且 助理 服务已开启
• 核对 Webhook ：确认 Webhook 地址配置正确
• 检查权限 ：确保所有权限都已正确导入

2）收不到消息怎么办？

• 确认已添加「接收消息」事件
• 确认已配置「卡片回传交互」回调
• 检查事件订阅中的 Webhook 地址是否正确

WorkBuddy 接入企业微信指南

WorkBuddy 接入企业微信指南 企微助理集成让您可以通过企业微信远程控制电脑上的 WorkBuddy。在企业微信中向智能机器人发送任务指令，WorkBuddy 在电脑上自动执行，并将结果同步回企业微信聊天窗口。

企微助理能做什么

绑定企微助理后，您可以在企业微信中完成以下操作：

• 在群聊中 @机器人 下发团队协作任务，WorkBuddy 自动执行并返回结果
• 跟进任务进度 ：直接向机器人发送任务指令，随时跟进执行进度
• 创建专属任务群 ，长期绑定 WorkBuddy 处理团队日常工作
• 发布通知 ：任务完成后自动通知群聊相关人员
• 任务提醒 ：将待办、验收、协作事项同步到企微群
• 流程打通 ：连接 WorkBuddy 任务处理与团队现有工作流
• 确认操作 ：批准命令执行、文件修改等需要确认的操作

设置前的准备

在开始配置之前，请确认满足以下条件： 要求说明WorkBuddy已在电脑上安装 WorkBuddy >= 4.6.4企业微信账号拥有一个可创建智能机器人的企业微信账号网络连接电脑和手机均能正常访问互联网WorkBuddy 运行中电脑保持开机并运行 WorkBuddy 提示

如果您还没有企业微信账号，可以前往 「企业微信官网」 免费注册一个企业。

连接企微助理

企业微信集成需要先在平台完成机器人创建和配置。请根据您的账号角色选择对应的操作指南。

管理员操作

第一步：进入管理后台创建机器人

打开浏览器，访问 「企业微信管理后台」，使用管理员账号登录后，依次点击「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」。

如果先进入 AI 自动生成页面，请点击左下角的「手动创建」： 在创建页面直接选择「API 模式创建」：

第二步：填写基本信息

进入 API 模式页面后，请先完成以下公共配置： 配置项说明机器人名称建议填写容易识别的名字，如「WorkBuddy 助手」可见范围 选择哪些员工、部门或标签可以使用这个机器人 点击「可见范围」后的「添加」，选择需要使用机器人的成员、部门或标签。 完成以上配置后，请先点击页面底部的「保存」，再在右侧「API 配置」区域选择「使用长连接」。

第三步：获取凭证并完成绑定

进入使用长连接方式接入完成后续步骤。

普通成员操作

第一步：在企业微信客户端创建机器人

打开企业微信客户端，进入「工作台」→「智能机器人应用」→「创建机器人」。 如果先进入 AI 自动生成页面，请点击左下角的「手动创建」，再选择「API 模式创建」：

第二步：填写基本信息

进入 API 模式页面后，请先完成以下公共配置： 配置项说明机器人名称建议填写容易识别的名字，如「WorkBuddy 助手」可使用成员围 选择哪些员工、部门或标签可以使用这个机器人 点击「可使用成员」后的「修改」，选择需要使用机器人的成员、部门或标签。 完成以上配置后，再在下方「API 配置」区域选择「使用长连接」。

第三步：获取凭证并完成绑定

进入使用长连接方式接入完成后续步骤。

使用长连接方式接入

两种角色在此步骤的操作一致。推荐优先使用长连接模式，配置步骤更少，也不需要回填 Webhook URL。

在企业微信中获取 Bot ID 和 Secret ：

• 在「API 配置」区域选择「使用长连接」
• 复制 Bot ID
• 点击 点击获取 获取 Secret，并妥善保存 提示

长连接模式不需要再填写 URL、Token 或 Encoding-AESKey。

在 WorkBuddy 中完成绑定

• 打开 WorkBuddy，点击左下角头像菜单中的「设置-助理设置」
• 在「集成（BETA）」区域找到「企微助理集成」，点击「配置」
• 在弹窗中选择「WebSocket 长连接」后，有两种绑定方式可选： 手动填写 Bot ID 和 Secret
• 点击快捷绑定接入，使用企微扫码完成绑定
• 填入刚才复制的 Bot ID 和 Secret后点击「注册」完成绑定

关于 API 模式

企业微信 API 模式支持两种接入方式：

• 长连接模式（推荐）：在 WorkBuddy 中填写 Bot ID 和 Secret 即可完成绑定，配置更简单，无需回填 Webhook URL。
• URL 回调模式 ：适用于需要 Webhook 回调的场景。需在 WorkBuddy 中填写 Token 和 Encoding-AESKey，生成 Webhook URL 后再回填到企业微信。

URL 回调模式配置指引见文末「使用 URL 回调接入（备选方案）」。

开始使用

配置完成后，您就可以在企业微信中直接与机器人对话了。

找到机器人

在企业微信通讯录的「企业创建的」分组下找到刚刚创建的机器人，点击「发消息」即可开始下发任务。

联通后对话效果

发送一条简单消息（例如”你好”）进行联通测试。如果配置正确，WorkBuddy 会接收到消息并在企业微信中返回回复。

恭喜

如果机器人能够正常回复，说明您已成功完成 WorkBuddy 与企业微信的对接！

跨设备接续工作

企微助理支持与 WorkBuddy 桌面端无缝衔接：

• 在企业微信中发起一个任务后，可以回到电脑上的 WorkBuddy 查看完整的执行过程和结果
• 在助理 页面可查看远程任务的完整执行记录，包括思考过程、操作步骤、生成文件及最终结果
• 您可以在电脑上继续追问、细化任务，或在企业微信中随时查看进度

什么来自本地电脑

当您通过企业微信向 WorkBuddy 发送任务时，处理过程发生在您的电脑上： 来源说明企业微信仅发送指令、批准操作和后续消息您的电脑提供 WorkBuddy 执行任务所需的全部环境 电脑上的 WorkBuddy 使用您本地的项目文件、Shell 环境、凭证权限、插件和工具来执行任务。也就是说，您电脑上能做的事，通过企业微信也能远程完成。

远程任务与普通任务的区别

对比项普通任务助理（远程任务）工作目录自由指定固定使用助理 专属文件夹新建对话支持多个并行任务仅一个会话，所有远程指令集中处理上下文管理可清空历史重新开始保留完整对话历史，不可清空 建议

本地操作优先使用主界面的普通任务；需要远程触发或统一查看记录时，再使用助理。

使用 URL 回调接入（备选方案）

如果您已经在使用 Webhook 配置，或因网络、部署限制需要通过 URL 回调接入，可按以下步骤操作。

在企业微信中生成回调凭据

• 在「API 配置」区域选择「使用 URL 回调」
• 点击 Token 和 Encoding-AESKey 输入框右侧的「随机获取」
• 保存这两个参数，后续需要在 WorkBuddy 中使用 重要

请务必保存好 Token 和 Encoding-AESKey，否则后续无法完成注册。

在 WorkBuddy 中生成 Webhook URL

• 打开 WorkBuddy，进入「助理设置」→「企微 AIBot 集成」→「配置」
• 在注册弹窗中切换到「使用 URL 回调」
• 填入刚才获取的 Token 和 Encoding-AESKey，点击「注册」
• 注册成功后，复制生成的 Webhook URL

回填 URL 并保存

回到企业微信的机器人创建页面：

• 将刚才复制的 Webhook 地址粘贴到 URL 输入框
• 点击「保存」完成配置

常见问题

机器人没有响应怎么办？

请按以下步骤排查：

• 检查 WorkBuddy 状态：确保电脑上的 WorkBuddy 正在运行，且助理 服务已开启
• 核对接入方式 ：确认企业微信与 WorkBuddy 中选择的是同一种接入方式
• 检查凭据 ：长连接模式请核对 Bot ID 和 Secret；URL 回调模式请核对 Token 和 Encoding-AESKey
• 检查网络连接 ：确保电脑能够正常访问网络

URL 验证失败怎么办？

• 确保 WorkBuddy 处于运行状态
• 检查助理 服务是否已正常启动
• 重新复制 Webhook URL，确保没有遗漏或多余字符
• 确认 Token 和 Encoding-AESKey 与 WorkBuddy 中配置的完全一致

长连接注册失败怎么办？

• 确认企业微信侧已选择「使用长连接」
• 重新复制 Bot ID 和 Secret，避免带入多余空格
• 如 Secret 已失效，可在企业微信后台重新获取后再次注册

相关文档

• 助理功能说明

平台接入改变的是入口，不是执行边界

飞书和企业微信适合把 WorkBuddy 接入日常协作，让团队成员在原有聊天场景中发起任务、接收结果或继续跟进。但真正执行任务的仍然是本地 WorkBuddy 环境，电脑状态、工作空间、文件权限和连接器授权都不会因为入口换成聊天平台而消失。

接入后的第一条任务

不要一接入就开放复杂操作。先用“查询今天的日程”“汇总一份已知文档”这类只读任务验证消息、权限、回传和结果链路，再逐步增加文件写入或团队协作动作。

群聊机器人尤其要控制可见范围和可执行权限。涉及团队文件、客户资料、外部发送或正式发布时，建议把准备和放行拆成两步，避免一句聊天消息直接触发高后果动作。

---

原文信息

• 整理自：WorkBuddy 官方文档