← 返回 Skills 市场
a3152557994-ship-it

飞书读取云文档

作者 a3152557994-ship-it · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
83
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install feishu-doc-read
功能描述
获取飞书云文档内容。返回文档的 Markdown 内容,支持处理文档中的图片、文件和画板(需配合 feishu_doc_media 工具)。
使用说明 (SKILL.md)

feishu_mcp_fetch_doc

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

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

文档中的图片、文件、画板需要通过 feishu_doc_media(action: download)工具单独获取!

识别格式

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

  • 图片

    \x3Cimage token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" width="1833" height="2491" align="center"/>
    
  • 文件

    \x3Cview type="1">
      \x3Cfile token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" name="skills.zip"/>
    \x3C/view>
    
  • 画板

    \x3Cwhiteboard 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/Z1FjxxxxxxxxxxxxxxxxxxxtnAcZ1FjxxxxxxxxxxxxxxxxxxxtnAc

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_* 系列
安全使用建议
This skill is an instruction-only helper for reading Feishu docs and looks internally consistent. Before installing: 1) Confirm your agent environment already provides and trusts the referenced helper tools (feishu_doc_media, feishu_wiki_space_node, feishu_sheet, feishu_bitable_*). Those tools — not this SKILL.md — are the components that will need Feishu credentials. 2) Verify where Feishu API credentials are stored and which tool will use them (ensure least privilege). 3) When downloading media, choose safe output paths and be mindful of sensitive content in documents. 4) If you cannot find or audit the referenced helper tools, treat this skill as incomplete and avoid enabling it until you know which component will perform network calls and hold credentials.
功能分析
Type: OpenClaw Skill Name: feishu-doc-read Version: 1.0.0 The skill bundle contains documentation and instructions for an AI agent to interact with Feishu (Lark) documents. It outlines legitimate procedures for fetching document content, handling media attachments (images/files), and resolving Wiki URLs using specific tool actions like `feishu_mcp_fetch_doc` and `feishu_wiki_space_node`. No malicious intent, data exfiltration, or harmful prompt injection patterns were identified.
能力评估
Purpose & Capability
The name/description match the SKILL.md: it explains how to extract doc tokens and produce Markdown, and explicitly delegates media downloads and wiki-type resolution to other Feishu tools. Nothing requested is unrelated to reading Feishu docs.
Instruction Scope
SKILL.md stays on task: it details parsing HTML-like tags for media tokens, resolving wiki tokens to object types, and calling the specified helper actions. It does not instruct reading arbitrary local files, environment variables, or contacting unexpected external endpoints.
Install Mechanism
Instruction-only skill with no install steps or code files — minimal disk/system impact. This is the lowest-risk install profile.
Credentials
The skill declares no required env vars or credentials, but it depends on other Feishu helper tools (feishu_doc_media, feishu_wiki_space_node, etc.) that will likely require Feishu API credentials when invoked. The lack of declared credentials here is not necessarily malicious, but you should verify where and how Feishu credentials are provided and which component uses them.
Persistence & Privilege
No special persistence requested (always:false). The skill does not request modifying other skills or global agent configuration. Normal user-invocable/autonomous invocation settings are used.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-doc-read
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-doc-read 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: Fetch and parse Feishu (Lark) cloud document contents as Markdown. - Supports both document URLs and tokens as input (including docs and knowledge base links). - Returns Markdown with placeholders for images, files, and whiteboards in HTML tag format. - Provides clear guidance for extracting and downloading embedded media using feishu_doc_media. - Includes detailed handling for knowledge base (wiki) links, ensuring correct type resolution via feishu_wiki_space_node. - Outlines tool usage and combination strategies for varied Feishu document types.
元数据
Slug feishu-doc-read
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

飞书读取云文档 是什么?

获取飞书云文档内容。返回文档的 Markdown 内容,支持处理文档中的图片、文件和画板(需配合 feishu_doc_media 工具)。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 83 次。

如何安装 飞书读取云文档?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-doc-read」即可一键安装,无需额外配置。

飞书读取云文档 是免费的吗?

是的,飞书读取云文档 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

飞书读取云文档 支持哪些平台?

飞书读取云文档 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 飞书读取云文档?

由 a3152557994-ship-it(@a3152557994-ship-it)开发并维护,当前版本 v1.0.0。

💬 留言讨论