前言
在企业数字化转型的深水区,工具链的割裂往往是效率流失的隐形杀手。许多团队面临着"腾讯系应用存数据,飞书平台做协同"的双轨现状,导致信息流转不畅。如何将腾讯生态内的核心业务能力无缝"嵌入"飞书,构建统一的办公门户,已成为众多IT管理者的迫切需求。
本教程将以腾讯WorkBuddy的接入为实战案例,深入讲解如何通过飞书开放平台打破生态壁垒。我们将从技术选型对比切入,手把手指导您完成从应用创建、权限配置到接口联调的全流程,帮助企业打造"消息通、数据通、业务通"的一站式飞书工作台,彻底终结频繁切换应用的低效时代。
第一章:介绍WorkBuddy
在部署前,我们需要明确技术路线。本章将对比腾讯WorkBuddy与OpenClaw两种主流方案的差异,助您快速决策。
- 核心定位差异
-
WorkBuddy:定位为智能业务助手,提供开箱即用的标准化连接器。优势在于与腾讯会议、文档等生态原生融合,配置即用,维护成本低。
-
OpenClaw:定位为通用开源集成框架。优势在于极高的灵活性,适合有定制化开发能力的团队进行深度二次开发,但部署与维护成本较高。
- 推荐选择

第二章:WorkBuddy 环境搭建与安装
本章将指导您完成 WorkBuddy 的基础配置,获取后续对接飞书所需的关键凭证。
注册与登录控制台
- 访问 WorkBuddy 官网。安装自己对应的版本的 WorkBuddy应用软件。

- 安装成功后,打开软件完成登录操作,系统将自动进入就绪状态,您可以立即体验各项功能。

- 顺利进入应用主界面后,即可开始使用各项功能。

第三章:接入飞书
访问飞书开放平台。
- 创建企业自建应用 → 选择机器人类型 → 填写基本信息 → 创建。

添加描述
- 选择机器人,继续下一步

添加描述
- 输入内容(自定义)

-
在权限管理/批量导入/导出权限中清空原有权限,粘贴复制下方内容。
{
"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"
]
}
}

- 在「凭证与基础信息」中复制 App ID 和 App Secret。复制到WorkBuddy软件接入到Claw设置中。

-
进入「事件与回调」:选择事件配置
-
订阅方式选择 将事件发送至 开发者服务器。
-
添加事件:至少包含 im.message.receive_v1(接收消息)。

-
进入「事件与回调」:选择回调配置
-
订阅方式选择 将事件发送至 开发者服务器。
-
添加事件:至少包含------卡片回传交互。

- 保存设置。发布机器人

- 打开飞书客户端,进入与机器人的对话窗口,发送测试指令,验证是否收到预期回复。

第五章:Skills和插件安装
完成基础对接后,通过安装Skills(技能)与插件,可赋予WorkBuddy更强大的业务处理能力,使其不仅能对话,还能执行具体任务。
5.1 认识Skills与插件体系
-
也可以直接在对话框中描述您的业务需求,系统将智能识别并自动安装所需的 Skills。
-
Skills(技能):指AI助手内置的通用能力,如"文档摘要"、"代码解释"、"多语种翻译"等,通常开箱即用。

- Plugins(插件):指连接外部业务系统的扩展工具,如"查询飞书日程"、"检索内部知识库"、"发起腾讯会议"等,需配置授权。

结语
至此,整个部署流程已圆满结束。但这仅仅是一个开始,您手中构建的不仅是一个消息推送通道,更是一个可无限扩展的智能业务中枢。
随着 WorkBuddy 持续迭代,未来您还可以尝试接入更多内部业务系统,或利用 API 定制开发专属的自动化工作流。我们鼓励您保持探索,不断挖掘"飞书 + WorkBuddy"的组合潜力,让技术真正成为驱动业务增长的隐形引擎。愿您在未来的工作中,尽享高效协同的便捷与乐趣!