OpenClaw飞书获取文档

获取飞书云文档内容。返回文档的 Markdown 内容，支持处理文档中的图片、文件和画板（需配合 feishu_doc_media 工具）。

Security Scan

Instructions and requirements match the stated purpose: it parses Feishu doc tokens, returns Markdown, and delegates media downloads and wiki resolution to other Feishu-specific tools; nothing requested here is disproportionate or unrelated.

Purpose & Capability

Name/description say: fetch Feishu cloud document and return Markdown, including media handled via an external feishu_doc_media tool. SKILL.md only contains parsing and orchestration instructions and refers to complementary tools — this is coherent with the declared purpose.

Instruction Scope

Instructions are focused: extract token from URL/HTML tags, call feishu_doc_media to download media, and call feishu_wiki_space_node to resolve wiki tokens. Note: it assumes the presence of other tools (feishu_doc_media, feishu_wiki_space_node, feishu_sheet, feishu_bitable_*). The skill itself does not request credentials or access unrelated system files, but it instructs writing media to an output_path (requires agent filesystem write permissions).

Install Mechanism

No install spec and no code files (instruction-only). This minimizes disk writes and installation risk.

Credentials

No required environment variables, primary credential, or config paths are declared. The SKILL.md does not access env vars or credentials itself. Note that actual API access would be performed by the referenced tools, which may require credentials — those should be reviewed separately.

Persistence & Privilege

always is false and the skill is user-invocable. It does not request persistent presence or attempt to modify other skills/configs.

Assessment

This skill is an orchestration document: it parses Feishu doc tokens and directs other Feishu tools to download media or resolve wiki tokens. Before installing: (1) confirm the complementary tools it calls (feishu_doc_media, feishu_wiki_space_node, feishu_sheet, bitable tools) are trusted and review their requested credentials, since those tools will perform API calls; (2) be aware the skill may instruct writing downloaded media to a filesystem path — ensure the agent runtime has appropriate and limited filesystem permissions; (3) treat extracted tokens and downloaded files as sensitive data. The skill itself does not request extra credentials and appears internally consistent.

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_* 系列