360 Secure SkillHub
360 安全技能中心

OpenClaw飞书获取文档

按 doc_id(URL 或 token)调用飞书 MCP 工具获取云文档的 Markdown 内容;文档中的图片、文件、画板以 HTML 标签形式返回,需另用 feishu_doc_media 下载。对 /wiki/ 链接先解析 obj_type,再按类型分发到云文档、电子表格或多维表格工具。

chenfa188
chenfa188
热度 52.32
最近更新 2026-05-11 17:37:34
分类:知识依赖:MCP 服务 / 第三方 API / 读写文件应用场景:笔记整理 / 研究

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add openclaw-feishu-fetch-doc
Metadata
name
feishu-fetch-doc
description
获取飞书云文档内容。返回文档的 Markdown 内容,支持处理文档中的图片、文件和画板(需配合 feishu_doc_media 工具)。

feishu_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"/>
    

获取步骤

  1. 从 HTML 标签中提取 token 属性值
  2. 调用 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

Wiki URL 处理策略

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

处理流程

  1. 先调用 feishu_wiki_space_node(action: get)解析 wiki token:
    { "action": "get", "token": "wiki_token_here" }
    
  2. 从返回的 node 中获取 obj_type(实际文档类型)和 obj_token(实际文档 token)
  3. 根据 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

  1. 调用 feishu_wiki_space_node(action: get, token: ABC123)
  2. 返回 obj_type: "docx", obj_token: "doxcnXYZ789"
  3. 调用 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_* 系列