飞书文档接入

更新时间:
复制为 MD 格式

通过自然语言对话即可操作飞书云文档,无需手动配置 API 和应用权限。本文介绍如何将飞书云文档接入 JVS Claw,完成接入后可通过 ClawBot 创建和管理飞书文档、多维表格等资源。接入流程包括:安装飞书 CLI、创建 CLI 应用、开通权限、效果测试。

方案概述

通过飞书 CLI 和飞书开放平台应用,实现 JVS Claw 对飞书云文档(文档、多维表格等)的读写能力。与 ClawBot(JVS Claw 中的机器人实例)对话即可完成全流程接入,无需手动配置。

适用场景:适用于个人飞书账号或企业飞书组织的文档自动化管理场景,包括创建文档、编辑内容、查询数据等。

本接入方式使用的飞书 CLI 为免费工具,不会产生额外费用。

接入流程如下:

  1. 安装飞书 CLI。

  2. 创建 CLI 应用。

  3. 权限开通。

  4. 效果测试。

前提条件

  • 已安装 JVS Claw 并创建了 ClawBot。

  • 已注册飞书账号并具备飞书组织的管理员或开发者权限,以便创建和管理飞书应用。

接入步骤

安装飞书 CLI

与 ClawBot 对话,发送以下指令:帮我安装飞书 CLI:https://open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md

创建 CLI 应用

  1. 与 ClawBot 对话,发送以下指令以通过扫码完成飞书 CLI 应用的创建与配置:使用 bot-only 的模式,给我一个二维码链接,让我可以通过扫码直接完成配置

    说明

    bot-only 模式指仅创建机器人应用,无需配置网页、小程序等其他能力。

  2. ClawBot 将返回二维码链接。使用飞书 App 扫描二维码,按照页面提示完成应用创建。

  3. ClawBot 在应用创建完成后会回复确认信息,表示应用已就绪。

权限开通

  1. 应用创建完成后,与 ClawBot 对话,发送以下指令以通过扫码完成权限配置:已完成配置,给我一个二维码链接,让我可以通过扫码直接完成权限的配置

  2. ClawBot 将返回二维码链接。使用飞书 App 扫描二维码,按照页面提示完成权限授权。

    说明

    授权前请仔细确认权限范围,遵循最小权限原则,仅授予必要的文档读写权限。

  3. 权限配置完成后,告知 JVS Claw 验证配置状态。例如:请帮我验证飞书应用的权限配置是否正确

JVS Claw 会自动检测已配置的权限并返回验证结果。验证通过时ClawBot 会确认权限配置正确,验证失败时ClawBot 会提示缺失的权限项及排查建议。

效果测试

完成接入后,可通过以下场景验证操作能力。

飞书多维表格

与 ClawBot 对话,创建飞书多维表格:帮我创建一个飞书多维表格

对话示例

用户:帮我创建一个飞书多维表格,名字叫"项目管理"。

ClawBot:好的,正在创建飞书多维表格……创建完成,多维表格"项目管理"已就绪。

ClawBot 回复「多维表格已就绪」表示创建成功。创建完成后,可继续向 ClawBot 下达操作指令,例如向多维表格中插入数据、查询多维表格中的数据等。

飞书文档

与 ClawBot 对话,创建飞书文档:帮我创建一个飞书文档

对话示例

用户:帮我创建一个飞书文档,名字叫"会议纪要"。

ClawBot:好的,正在创建飞书文档……创建完成,文档"会议纪要"已就绪。

ClawBot 回复「文档已就绪」表示创建成功。创建完成后,可继续向 ClawBot 下达操作指令,例如编辑文档内容、读取文档内容等。

常见问题

CLI 安装失败怎么办?

  • 检查网络连接是否正常。

  • 确认飞书 CLI 安装指南中的系统要求是否满足。

  • 如仍有问题,可重新向 ClawBot 发送安装指令,ClawBot 会重新尝试安装。

扫码授权超时怎么办?

二维码链接具有时效性,超时后请重新向 ClawBot 请求生成二维码链接。

权限验证失败怎么办?

根据 ClawBot 提示的缺失权限项,在飞书开放平台手动补充对应权限后重新验证。