飞书文档接入
通过自然语言对话即可操作飞书云文档,无需手动配置 API 和应用权限。本文介绍如何将飞书云文档接入 JVS Claw,完成接入后可通过 ClawBot 创建和管理飞书文档、多维表格等资源。接入流程包括:安装飞书 CLI、创建 CLI 应用、开通权限、效果测试。
方案概述
通过飞书 CLI 和飞书开放平台应用,实现 JVS Claw 对飞书云文档(文档、多维表格等)的读写能力。与 ClawBot(JVS Claw 中的机器人实例)对话即可完成全流程接入,无需手动配置。
适用场景:适用于个人飞书账号或企业飞书组织的文档自动化管理场景,包括创建文档、编辑内容、查询数据等。
本接入方式使用的飞书 CLI 为免费工具,不会产生额外费用。
接入流程如下:
安装飞书 CLI。
创建 CLI 应用。
权限开通。
效果测试。
前提条件
已安装 JVS Claw 并创建了 ClawBot。
已注册飞书账号并具备飞书组织的管理员或开发者权限,以便创建和管理飞书应用。
接入步骤
安装飞书 CLI
与 ClawBot 对话,发送以下指令:帮我安装飞书 CLI:https://open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md
创建 CLI 应用
与 ClawBot 对话,发送以下指令以通过扫码完成飞书 CLI 应用的创建与配置:
使用 bot-only 的模式,给我一个二维码链接,让我可以通过扫码直接完成配置说明bot-only 模式指仅创建机器人应用,无需配置网页、小程序等其他能力。
ClawBot 将返回二维码链接。使用飞书 App 扫描二维码,按照页面提示完成应用创建。
ClawBot 在应用创建完成后会回复确认信息,表示应用已就绪。
权限开通
应用创建完成后,与 ClawBot 对话,发送以下指令以通过扫码完成权限配置:
已完成配置,给我一个二维码链接,让我可以通过扫码直接完成权限的配置ClawBot 将返回二维码链接。使用飞书 App 扫描二维码,按照页面提示完成权限授权。
说明授权前请仔细确认权限范围,遵循最小权限原则,仅授予必要的文档读写权限。
权限配置完成后,告知 JVS Claw 验证配置状态。例如:
请帮我验证飞书应用的权限配置是否正确
JVS Claw 会自动检测已配置的权限并返回验证结果。验证通过时ClawBot 会确认权限配置正确,验证失败时ClawBot 会提示缺失的权限项及排查建议。
效果测试
完成接入后,可通过以下场景验证操作能力。
飞书多维表格
与 ClawBot 对话,创建飞书多维表格:帮我创建一个飞书多维表格
对话示例
用户:帮我创建一个飞书多维表格,名字叫"项目管理"。
ClawBot:好的,正在创建飞书多维表格……创建完成,多维表格"项目管理"已就绪。
ClawBot 回复「多维表格已就绪」表示创建成功。创建完成后,可继续向 ClawBot 下达操作指令,例如向多维表格中插入数据、查询多维表格中的数据等。
飞书文档
与 ClawBot 对话,创建飞书文档:帮我创建一个飞书文档
对话示例
用户:帮我创建一个飞书文档,名字叫"会议纪要"。
ClawBot:好的,正在创建飞书文档……创建完成,文档"会议纪要"已就绪。
ClawBot 回复「文档已就绪」表示创建成功。创建完成后,可继续向 ClawBot 下达操作指令,例如编辑文档内容、读取文档内容等。
常见问题
CLI 安装失败怎么办?
检查网络连接是否正常。
确认飞书 CLI 安装指南中的系统要求是否满足。
如仍有问题,可重新向 ClawBot 发送安装指令,ClawBot 会重新尝试安装。
扫码授权超时怎么办?
二维码链接具有时效性,超时后请重新向 ClawBot 请求生成二维码链接。
权限验证失败怎么办?
根据 ClawBot 提示的缺失权限项,在飞书开放平台手动补充对应权限后重新验证。