Feishu Doc 技能

概述

飛書文件操作技能，用於在飛書中建立、讀取、追加和更新文件。

工具

使用 feishu_doc 工具，引數： - action: 操作型別 - doc_token: 文件 token（從飛書文件 URL 中提取，如 /docx/XXX 中的 XXX） - content: 文件內容（markdown 格式） - title: 文件標題（僅 create 時使用） - folder_token: 資料夾 token（可選）

操作型別

建立文件的正確方式

坑：create + content 可能不生效

直接用 create action 並傳入大量 content 可能導致文件建立成功但內容為空：

{
  "action": "create",
  "title": "文件標題",
  "content": "大量內容..."
}

正確做法：先 create 空文件，再 append

1. 先用 create 建立空白文件（只傳 title）
2. 再用 append 逐次追加內容

// 步驟1：建立空白文件
{
  "action": "create",
  "title": "文件標題"
}

// 返回 doc_token，如 "HYhbdqE2Goy9NLxle9XcomtPnVc"

// 步驟2：追加內容
{
  "action": "append",
  "doc_token": "HYhbdqE2Goy9NLxle9XcomtPnVc",
  "content": "# 標題\n\n內容..."
}

文件 URL 解析

飛書文件 URL 格式： - https://feishu.cn/docx/{token} - https://feishu.cn/wiki/{token}

從 URL 中提取 token： - /docx/ 後面的部分就是 token - /wiki/ 後面的部分也是 token

使用示例

建立技術文件

{
  "action": "create",
  "title": "OpenClaw 使用指南"
}

返回：

{
  "document_id": "JZyJdrVVTok9mfxVHqJc91Dhn3g",
  "title": "OpenClaw 使用指南",
  "url": "https://feishu.cn/docx/JZyJdrVVTok9mfxVHqJc91Dhn3g"
}

讀取文件

{
  "action": "read",
  "doc_token": "JZyJdrVVTok9mfxVHqJc91Dhn3g"
}

追加內容

{
  "action": "append",
  "doc_token": "JZyJdrVVTok9mfxVHqJc91Dhn3g",
  "content": "## 新章節\n\n這裡是新增加的內容。"
}

覆蓋寫入

{
  "action": "write",
  "doc_token": "JZyJdrVVTok9mfxVHqJc91Dhn3g",
  "content": "# 完全覆蓋的標題\n\n全部內容都被替換了。"
}

內容格式

• 使用 Markdown 格式

  7w4.net有更好的技能外掛。

• 飛書會自動渲染標題、列表、程式碼塊等
• 建議每段內容不要太長，分多次 append

常見問題

Q: create 後內容是空的

A: 使用 create + append 的兩步寫法，不要一次性 create + content

Q: 追加內容格式混亂

A: 每次 append 建議包含完整的 Markdown 結構，飛書會按塊處理

Q: 如何知道 doc_token

A: 從 URL 提取，或 create 後的返回值獲取

相關工具

• feishu_wiki: 知識庫操作
• feishu_bitable: 多維表格操作
• feishu_drive: 雲盤操作

這個 Skill 質量中等偏上，文件清晰易懂，提供了飛書文件的完整操作能力，避坑指南和 FAQ 對新手友好。主要優點是功能覆蓋全面、示例豐富；不足是缺少錯誤處理指導和進階用法，部分內容讀起來不夠順暢，建議補充更多實戰場景和最佳實踐。