腾讯WorkBuddy接入飞书指南

WorkBuddy接入飞书教程:

WorkBuddy怎么接入飞书

接入前请确认已满足以下条件:

  • 已在电脑端安装WorkBuddy,并启用Claw远程控制功能
  • 拥有具备应用创建权限的飞书企业账号

一、在飞书开放平台创建应用

1. 登录飞书开放平台,点击「创建企业自建应用」。

2. 填写应用信息:

  • 应用名称(如“WorkBuddy助手”)
  • 应用描述(简要说明功能)
  • 上传应用图标

3. 点击「创建」,进入应用详情页。

二、配置机器人能力与权限

1. 在「添加应用能力」区域,点击「机器人」卡片的「添加」按钮。

2. 左侧菜单进入「权限管理」→「批量导入/导出权限」。

3. 在弹窗中清空输入框,完整粘贴以下权限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"
]
}
}

三、获取凭证并配置Claw

1. 左侧菜单进入「凭证与基础信息」,记录以下两项:

  • AppID:应用唯一标识
  • AppSecret:密钥(点击「查看」后妥善保管,切勿泄露)

2. 打开WorkBuddy → 右上角头像 → 「Claw设置」→ 选择「飞书集成」。

3. 填入AppID和AppSecret,点击「注册」获取并复制Webhook地址。

四、配置飞书事件与回调

1. 返回飞书应用详情页 → 左侧「事件与回调」→ 选择「将事件发送至开发者服务器」。

2. 粘贴Webhook地址,点击「保存」。

3. 在「事件配置」中点击「添加事件」,搜索并启用「接收消息」。

4. 切换至「回调配置」页签,搜索「卡片回传交互」,点击「确认添加」。

五、发布应用

1. 点击页面上方「创建版本」→ 填写:

  • 版本号:1.0.0
  • 版本描述:首次发布,集成WorkBuddy

2. 创建成功后,点击版本右侧「发布」按钮。

注:企业管理员身份下通常自动审批;如需人工审批,请联系管理员。

六、使用机器人

1. 在飞书搜索框中输入机器人名称,点击进入对话窗口或「打开应用」。

2. 发送指令(如“帮我写一个待办事项应用”),WorkBuddy将在本地执行任务并返回结果。