ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

feishu-doc-workflow

Feishu 文档写作与排版工作流。处理飞书 docx 的正文改写、分段润色、插图、按块定位插入、补充链接、以及把文档权限改成“互联网获得链接的人可查看”等公开分享设置时使用。也用于排查“能读不能写”“插图位置不对”“文档写入 400/403”这类飞书文档问题。

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/dadaniya99/feishu-doc-workflow
Or

Feishu Doc Workflow

用这个 skill 处理 飞书 docx 文档本体 的写作、排版、插图、公开分享和排障。

这个 skill 能不能给别人用？

能。这个 skill 本质上是一套 飞书文档工作流说明书，不是绑定某个私人账号的硬编码脚本。

但它不是“裸技能包到处都能跑”的那种万能包。别人要正常使用，至少要满足：

  • OpenClaw 环境里能用 feishu_doc
  • 已配置飞书 channel（有 appId / appSecret）
  • 具备本文档里列出的飞书权限
  • 若要复用“公开分享给互联网可读”这一步，环境还需要允许通过 exec 调用 Feishu OpenAPI

是否必须安装新版飞书插件？

不绝对要求“必须是最新版官方插件”，但要求环境里已经具备等价能力。

更准确地说，这个 skill 依赖的是：

  • 最近版本的 OpenClaw / Feishu 扩展
  • feishu_doc 工具可用
  • 飞书 app 凭证可用
  • Drive public permission API 可调用

所以：

  • 如果别人已经有一套能正常提供 feishu_doc 的飞书集成，这个 skill 就能复用
  • 如果别人环境太老，或者根本没有 feishu_doc，那这个 skill 不能直接开箱即用

最稳妥的发布建议：默认面向“已接好飞书、且 feishu_doc 正常可用”的 OpenClaw 用户发布。

发布给别人前，最好写清楚的飞书权限

按当前这套 skill 的能力，建议至少写清下面这些 最低测试通过权限：

  • docx:document
  • docx:document:readonly
  • docx:document.block:convert
  • drive:drive

如果发布说明要写得更实用，再补两条环境前提：

  • channels.feishu.appId 已配置
  • channels.feishu.appSecret 已配置

其中：

  • 文档读写、按块改写、插图定位，核心依赖 docx:* + drive:drive
  • “互联网获得链接的人可查看” 这类公开分享设置，核心依赖 Drive public permission API；当前实测用 drive:drive 可完成

建议在发布页附的兼容性说明

可以直接写成：

本 skill 面向已完成飞书集成的 OpenClaw 用户。要求环境中 feishu_doc 工具可用，且飞书应用至少具备 docx:document、docx:document:readonly、docx:document.block:convert、drive:drive 权限。若需将文档开成“互联网获得链接的人可查看”，还需在当前环境允许通过 API 更新 Drive public permission。

推荐 OpenClaw 最低版本

建议写成：

  • 推荐 OpenClaw 版本：2026.3.8 及以上

原因不是“这个 skill 只认某个版本号”，而是当前内容已经按我这次实际验证通过的环境来写：

  • OpenClaw 2026.3.8
  • 可用 feishu_doc
  • 可通过 Feishu Drive API 更新 public permission

如果别人版本更老，但 feishu_doc 与相关权限链路都正常，也可能能用；只是公开发布时最好写“推荐 2026.3.8+”，避免踩旧环境坑。

推荐飞书插件形态

公开说明里建议明确：

  • 优先推荐使用当前可正常提供 feishu_doc 能力的 Feishu 集成环境
  • 对 OpenClaw 用户来说，最稳妥的是：
    • 已启用当前内置 / stock feishu 扩展，或
    • 使用功能等价、已验证可提供 feishu_doc 的 Feishu 插件方案

不要把发布文案写成“必须安装某一个特定插件版本”，而应写成：

只要你的 OpenClaw 环境已经具备 feishu_doc 工具能力，并配置好了飞书 app 凭证，本 skill 就可使用。

安装前检查清单

发布时建议附这个 checklist：

  • 已完成 OpenClaw 基础安装
  • OpenClaw 版本建议 2026.3.8+
  • feishu_doc 工具可用
  • channels.feishu.appId 已配置
  • channels.feishu.appSecret 已配置
  • 飞书应用已开以下权限：
    • docx:document
    • docx:document:readonly
    • docx:document.block:convert
    • drive:drive
  • 若需要“互联网获得链接的人可查看”：当前环境允许通过 API 调用 Feishu Drive public permission

常见报错速查表

1. 400 写文档失败

先查：

  • 是否缺 docx:document.block:convert

这是最常见根因。没有这个权限时，经常表现为：

  • 能读文档
  • 但 write / append / update_block / insert 报 400

2. 403 能读不能写

先查：

  • 这篇具体文档有没有给“小龙虾（应用）”开可编辑权限

也就是：

  • scope 够，不代表对象权限一定够
  • 应用有写权限 + 文档对象也允许编辑，这两层都得通

3. 图片插入成功但位置不对

先查：

  • 有没有先 list_blocks
  • parent_block_id / index 有没有按当前块顺序计算

解决原则：

  • 插错了就直接 delete_block
  • 再按正确位置重新 upload_image

4. 文档已经开了外部访问，但外网还是打不开

先查：

  • external_access_entity 是否为 open
  • security_entity 是否为 anyone_can_view
  • link_share_entity 是否为 anyone_readable

不要只看 PATCH 成功，要再 GET 一次确认最终值。

快速判断

Read Full Documentation on GitHub

Metadata

Author@dadaniya99
Stars3409
Views0
Updated2026-03-25
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-dadaniya99-feishu-doc-workflow": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

evomap-gep

Connect any OpenClaw agent to the EvoMap collaborative evolution marketplace via the GEP-A2A protocol — no evolver required. Activate when the user or agent mentions EvoMap, wants to search for capsules or genes from other agents, publish a solution, or learn the GEP protocol. sender_id is auto-detected from MEMORY.md — each agent just saves their node ID once and the scripts handle the rest.

dadaniya99 3409

feishu-card

飞书互动卡片发送技能（国际版 Feishu 兼容）。当需要发送格式丰富的飞书卡片消息时使用。支持标题、Markdown 内容、颜色主题。关键：必须使用 schema 2.0 格式 + 双重 JSON stringify，否则国际版飞书（Feishu）无法渲染。

dadaniya99 3409

pdf-ocr

PDF扫描件转Word文档。支持中文OCR识别，自动裁掉页眉页脚，保留插图，彩色章节封面页保留为图片。使用百度OCR API（免费额度1000次/月）。当用户要求把扫描PDF转成文字/Word时触发。

dadaniya99 3409

sketch-illustration

插画图片生成技能，支持多种手绘风格。使用 Imagen 3（ZenMux API）生成插图，适合流程图、功能说明、PPT配图、教程配图、知识图和手绘信息图等场景。支持四种风格：A) Sketch 极简手绘风（Notion/Linear 风格，简笔人物，冷淡低饱和）；B) Watercolor 奶油彩铅水彩风（暖色调，纸纹彩铅，适合PPT讲义）；C) Flat Vector Retro 扁平矢量复古风（黑色轮廓线，几何简化，复古配色，适合NotebookLM PPT/课程封面）；D) Doodle Infographic 白纸手绘知识图风（白纸背景、拟人角色、高信息密度、手账/课堂板书感，适合概念对比、方法论、拖延机制、知识卡片）。生成后自动上传发送到飞书。当用户要求生成插画、配图、手绘风格图、流程示意图、产品插图、PPT配图、知识图、信息图、手绘知识海报时触发此技能。

dadaniya99 3409

eudic-vocab

欧路词典生词本管理与每日测试技能。支持自动从欧路词典收藏夹出题、管理单词、删除已掌握词汇。适合每日背单词使用。

dadaniya99 3409