CodePilot feishu-fetch-doc
install
source · Clone the upstream repo
git clone https://github.com/op7418/CodePilot
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/op7418/CodePilot "$T" && mkdir -p ~/.claude/skills && cp -r "$T/资料/feishu-openclaw-plugin/package/skills/feishu-fetch-doc" ~/.claude/skills/op7418-codepilot-feishu-fetch-doc && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/op7418/CodePilot "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/资料/feishu-openclaw-plugin/package/skills/feishu-fetch-doc" ~/.openclaw/skills/op7418-codepilot-feishu-fetch-doc && rm -rf "$T"
manifest:
资料/feishu-openclaw-plugin/package/skills/feishu-fetch-doc/SKILL.mdsource content
feishu_mcp_fetch_doc
获取飞书云文档的 Markdown 内容(Lark-flavored 格式)。
重要:图片、文件、画板的处理
文档中的图片、文件、画板需要通过
(action: download)工具单独获取!feishu_doc_media
识别格式
返回的 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" }
参数
(必填):支持直接传文档 URL 或 tokendoc_id- 直接传 URL:
(系统自动提取 token)https://xxx.feishu.cn/docx/Z1FjxxxxxxxxxxxxxxxxxxxtnAc - 直接传 token:
Z1FjxxxxxxxxxxxxxxxxxxxtnAc - 知识库 URL/token 也支持:
或https://xxx.feishu.cn/wiki/Z1FjxxxxxxxxxxxxxxxxxxxtnAcZ1FjxxxxxxxxxxxxxxxxxxxtnAc
- 直接传 URL:
Wiki URL 处理策略
知识库链接(
/wiki/TOKEN)背后可能是云文档、电子表格、多维表格等不同类型的文档。当不确定类型时, 不能直接假设是云文档,必须先查询实际类型。
处理流程
- 先调用
(action: get)解析 wiki token:feishu_wiki_space_node{ "action": "get", "token": "wiki_token_here" } - 从返回的
中获取node
(实际文档类型)和obj_type
(实际文档 token)obj_token - 根据
调用对应工具:obj_type
| obj_type | 工具 | 传参 |
|---|---|---|
| | doc_id = obj_token |
| | spreadsheet_token = obj_token |
| 系列 | app_token = obj_token |
| 其他 | 告知用户暂不支持该类型 | — |
示例
用户:
帮我看下这个文档 https://xxx.feishu.cn/wiki/ABC123
- 调用
(action: get, token: ABC123)feishu_wiki_space_node - 返回
,obj_type: "docx"obj_token: "doxcnXYZ789" - 调用
(doc_id: doxcnXYZ789)feishu_mcp_fetch_doc
工具组合
| 需求 | 工具 |
|---|---|
| 获取文档文本 | |
| 下载图片/文件/画板 | (action: download) |
| 解析 wiki token 类型 | (action: get) |
| 读写电子表格 | |
| 操作多维表格 | 系列 |