OpenClaw 接入飞书文档：AI 助手自动化文档管理

什么是飞书文档集成？

OpenClaw 内置飞书文档操作能力，可以让 AI 助手直接读取、创建、编辑飞书云文档，实现文档自动化管理。

主要功能包括：

• 读取文档内容
• 创建新文档
• 写入/追加内容
• 插入表格
• 上传图片和附件
• 块级别操作（获取、更新、删除）

前置条件

确保 OpenClaw 已正确配置飞书渠道，且飞书应用具有以下权限：

• docx:document - 文档读写
• docx:document:readonly - 文档只读
• docx:document.block:convert - 块转换
• drive:drive - 云空间访问

基本操作

1. 读取文档

从飞书文档 URL 提取 doc_token：

https://xxx.feishu.cn/docx/ABC123def → doc_token = ABC123def

读取文档内容：

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

返回文档标题、纯文本内容和块统计信息。

2. 创建文档

{
  "action": "create",
  "title": "新文档标题",
  "folder_token": "fldcnXXX",
  "owner_open_id": "ou_xxx"
}

重要：必须传入 owner_open_id（用户的 open_id），否则只有机器人应用有权限访问文档。

3. 写入内容

写入会替换整个文档：

{
  "action": "write",
  "doc_token": "ABC123def",
  "content": "# 标题\n\n正文内容...\n\n- 列表项1\n- 列表项2"
}

追加内容到文档末尾：

{
  "action": "append",
  "doc_token": "ABC123def",
  "content": "新增的段落"
}

4. 表格操作

创建表格：

{
  "action": "create_table",
  "doc_token": "ABC123def",
  "row_size": 3,
  "column_size": 2,
  "column_width": [200, 200]
}

写入表格数据：

{
  "action": "write_table_cells",
  "doc_token": "ABC123def",
  "table_block_id": "doxcnTABLE",
  "values": [
    ["姓名", "年龄"],
    ["张三", "25"],
    ["李四", "30"]
  ]
}

5. 上传图片

从 URL 上传：

{
  "action": "upload_image",
  "doc_token": "ABC123def",
  "url": "https://example.com/image.png"
}

从本地上传：

{
  "action": "upload_image",
  "doc_token": "ABC123def",
  "file_path": "/tmp/image.png"
}

6. 上传附件

{
  "action": "upload_file",
  "doc_token": "ABC123def",
  "url": "https://example.com/report.pdf",
  "filename": "季度报告.pdf"
}

块级别操作

列出所有块

获取文档的完整结构，包括表格、图片等：

{
  "action": "list_blocks",
  "doc_token": "ABC123def"
}

获取单个块

{
  "action": "get_block",
  "doc_token": "ABC123def",
  "block_id": "doxcnXXX"
}

更新块内容

{
  "action": "update_block",
  "doc_token": "ABC123def",
  "block_id": "doxcnXXX",
  "content": "新的文本内容"
}

删除块

{
  "action": "delete_block",
  "doc_token": "ABC123def",
  "block_id": "doxcnXXX"
}

读取工作流

推荐的两步读取流程：

1. 先用 read 获取纯文本和统计信息
2. 检查返回的 block_types，如果有 Table、Image 等
3. 用 list_blocks 获取完整的结构化数据

注意事项

• Markdown 表格不支持：写入时表格需要用 create_table 单独创建
• 图片尺寸：小图片建议先放大到 800px+ 宽度再上传
• 权限继承：创建文档时务必传入 owner_open_id

总结

OpenClaw 的飞书文档集成让 AI 助手可以自动化处理文档工作，从简单的读取写入到复杂的表格图片操作，覆盖了大部分文档管理场景。配合飞书知识库（wiki）能力，可以实现更强大的文档自动化。