Feishu Doc Workflow_内容创作 skill-PHP中文网

Feishu Doc Workflow

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

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

Feishu Doc Workflow

功能概述

Feishu Doc Workflow是一项面向实际任务的技能，主要用于用这个 skill 处理飞书 docx 文档本体的写作、排版、插图、公开分享和排障；这个 skill 能不能给别人用？

核心要点

这个 skill 本质上是一套飞书文档工作流说明书，不是绑定某个私人账号的硬编码脚本；
但它不是“裸技能包到处都能跑”的那种万能包；
别人要正常使用，至少要满足：；

使用与执行

OpenClaw 环境里能用 feishu_doc。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

结果检查与注意事项

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

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。

安装前检查清单

发布时建议附这个 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 一次确认最终值。

快速判断

改正文内容 → 用 feishu_doc 的 read / write / append / insert / update_block
调整图片位置或补图 → 用 feishu_doc 的 list_blocks + upload_image + 必要时 delete_block
把文档开成互联网可读 → 走 Feishu Drive public permission 接口（见下文）
发送普通文件给用户（HTML / ZIP / PDF / 代码文件）→ 不用本 skill，改看 skills/feishu-send-file/SKILL.md

公开分享权限：开成“互联网获得链接的人可查看”

当用户明确要求：

“允许互联网访问的人查看”
“外网拿链接的人可读”
“Anyone with link can read”

目标状态应设为：

external_access_entity = open
security_entity = anyone_can_view
link_share_entity = anyone_readable
comment_entity = anyone_can_view
share_entity = anyone
manage_collaborator_entity = collaborator_can_view
copy_entity = anyone_can_view

API 方式

用 Feishu Drive public permission 接口：

GET /open-apis/drive/v2/permissions/{token}/public?type=docx 先看当前值
PATCH /open-apis/drive/v2/permissions/{token}/public?type=docx 再更新

PATCH body 参考：

{
  "external_access_entity": "open",
  "security_entity": "anyone_can_view",
  "comment_entity": "anyone_can_view",
  "share_entity": "anyone",
  "manage_collaborator_entity": "collaborator_can_view",
  "link_share_entity": "anyone_readable",
  "copy_entity": "anyone_can_view"
}

改完后一定再 GET 一次确认，不要只看 PATCH 成功。