feishu-fetch-doc
获取飞书云文档内容。返回文档的 Markdown 内容,支持处理文档中的图片、文件和画板(需配合 feishu_doc_media 工具)。
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/a3152557994-ship-it/feishu-doc-readfeishu_mcp_fetch_doc
获取飞书云文档的 Markdown 内容(Lark-flavored 格式)。
重要:图片、文件、画板的处理
文档中的图片、文件、画板需要通过 feishu_doc_media(action: download)工具单独获取!
识别格式
返回的 Markdown 中,媒体文件以 HTML 标签形式出现:
-
图片:
<image token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" width="1833" height="2491" align="center"/> -
文件:
<view type="1"> <file token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" name="skills.zip"/> </view> -
画板:
<whiteboard token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc"/>
获取步骤
- 从 HTML 标签中提取
token属性值 - 调用
feishu_doc_media下载:{ "action": "download", "resource_token": "提取的token", "resource_type": "media", "output_path": "/path/to/save/file" }
参数
doc_id(必填):支持直接传文档 URL 或 token- 直接传 URL:
https://xxx.feishu.cn/docx/Z1FjxxxxxxxxxxxxxxxxxxxtnAc(系统自动提取 token) - 直接传 token:
Z1FjxxxxxxxxxxxxxxxxxxxtnAc - 知识库 URL/token 也支持:
https://xxx.feishu.cn/wiki/Z1FjxxxxxxxxxxxxxxxxxxxtnAc或Z1FjxxxxxxxxxxxxxxxxxxxtnAc
- 直接传 URL:
Wiki URL 处理策略
知识库链接(/wiki/TOKEN)背后可能是云文档、电子表格、多维表格等不同类型的文档。当不确定类型时, 不能直接假设是云文档,必须先查询实际类型。
处理流程
- 先调用
feishu_wiki_space_node(action: get)解析 wiki token:{ "action": "get", "token": "wiki_token_here" } - 从返回的
node中获取obj_type(实际文档类型)和obj_token(实际文档 token) - 根据
obj_type调用对应工具:
| obj_type | 工具 | 传参 |
|---|---|---|
docx | feishu_mcp_fetch_doc | doc_id = obj_token |
sheet | feishu_sheet | spreadsheet_token = obj_token |
bitable | feishu_bitable_* 系列 | app_token = obj_token |
| 其他 | 告知用户暂不支持该类型 | — |
示例
用户:帮我看下这个文档 https://xxx.feishu.cn/wiki/ABC123
- 调用
feishu_wiki_space_node(action: get, token: ABC123) - 返回
obj_type: "docx",obj_token: "doxcnXYZ789" - 调用
feishu_mcp_fetch_doc(doc_id: doxcnXYZ789)
工具组合
| 需求 | 工具 |
|---|---|
| 获取文档文本 | feishu_mcp_fetch_doc |
| 下载图片/文件/画板 | feishu_doc_media(action: download) |
| 解析 wiki token 类型 | feishu_wiki_space_node(action: get) |
| 读写电子表格 | feishu_sheet |
| 操作多维表格 | feishu_bitable_* 系列 |
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-a3152557994-ship-it-feishu-doc-read": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
feishu-bitable
飞书多维表格(Bitable)的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**: (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录(行数据) (3) 需要管理字段(列)、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格
feishu-calendar
飞书日历与日程管理工具集。包含日历管理、日程管理、参会人管理、忙闲查询。
Lobster Config
Skill by a3152557994-ship-it
feishu-create-doc
创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档,支持指定创建位置(文件夹/知识库/知识空间)。
feishu-update-doc
更新飞书云文档。支持 7 种更新模式:追加、覆盖、定位替换、全文替换、前/后插入、删除。