larksuite/openclaw-lark/feishu-fetch-doc

feishu_mcp_fetch_doc

获取飞书云文档的 Markdown 内容（Lark-flavored 格式）。

重要：图片、文件、画板的处理

文档中的图片、文件、画板需要通过 `feishu_doc_media`（action: download）工具单独获取！

识别格式

返回的 Markdown 中，媒体文件以 HTML 标签形式出现：

• 图片：

``html <image token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" width="1833" height="2491" align="center"/> ``

• 文件：

``html <view type="1"> <file token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" name="skills.zip"/> </view> ``

• 画板：

``html <whiteboard token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc"/> ``

获取步骤

1. 从 HTML 标签中提取 token 属性值
2. 调用 feishu_doc_media 下载：

``json { "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

Wiki URL 处理策略

知识库链接（/wiki/TOKEN）背后可能是云文档、电子表格、多维表格等不同类型的文档。当不确定类型时, 不能直接假设是云文档，必须先查询实际类型。

处理流程

1. 先调用 `feishu_wiki_space_node`（action: get）解析 wiki token：

``json { "action": "get", "token": "wiki_token_here" } ``

1. 从返回的 `node` 中获取 `obj_type`（实际文档类型）和 `obj_token`（实际文档 token）
2. 根据 `obj_type` 调用对应工具：

示例

用户：帮我看下这个文档 https://xxx.feishu.cn/wiki/ABC123

1. 调用 feishu_wiki_space_node（action: get, token: ABC123）
2. 返回 obj_type: "docx", obj_token: "doxcnXYZ789"
3. 调用 feishu_mcp_fetch_doc（doc_id: doxcnXYZ789）

工具组合