360 Secure SkillHub
360 安全技能中心

Feishu Docx

通过飞书开放平台 docx API 操作云文档:以应用级 tenant_access_token 认证,支持创建文档、向指定块追加子块内容以及批量更新块。凭据通过 FEISHU_APP_ID / FEISHU_APP_SECRET 传入,附 Python 客户端脚本与 API 参考文档。

cpjhy
cpjhy
热度 57.73
最近更新 2026-05-18 12:12:37
分类:知识依赖:第三方 API / 代码执行应用场景:API 集成 / 自动化脚本 / 笔记整理 / 工作流

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add feishu-docx
Metadata
name
feishu-docx
description
飞书云文档(docx)的创建与编辑技能。支持通过 API 创建文档、追加内容、批量更新块等操作。使用此技能需要提供 App ID 和 App Secret。

Feishu Docx Skill

本技能封装了飞书云文档(docx)API 的核心操作,允许老大快速对飞书文档进行读写操作。

认证信息

使用该技能前,需确保已设置以下环境变量或在代码中显式传入:

  • FEISHU_APP_ID: cli_a92c5076b7789cd2
  • FEISHU_APP_SECRET: 9jPdCn49G54RFoEoDPUCVcptnWZnTZqp

核心工作流

  1. 获取访问令牌: 使用 tenant_access_token 进行应用级别的认证。
  2. 创建文档: 调用 POST /open-apis/docx/v1/documents 创建一个空的或指定标题的文档。
  3. 写入/编辑内容:
    • 追加块:POST /open-apis/docx/v1/documents/{document_id}/blocks/{block_id}/children
    • 批量更新:POST /open-apis/docx/v1/documents/{document_id}/blocks/batch_update

使用示例 (Python)

from scripts.feishu_docx_client import FeishuDocx

client = FeishuDocx(app_id="cli_a92c5076b7789cd2", app_secret="9jPdCn49G54RFoEoDPUCVcptnWZnTZqp")

# 1. 创建文档
doc_id = client.create_document("测试文档")

# 2. 追加文本
client.append_text(doc_id, "这是由 OpenClaw 写入的内容。")

资源

  • 客户端脚本: scripts/feishu_docx_client.py 封装了常用的 API 调用。
  • 参考文档: 请参考 REFERENCES.md 了解更多 Block 类型和 API 细节。