什么是 飞书文档评论？

飞书文档评论插件允许 AI 智能体直接对接飞书云文档评论 API 来提取协作反馈。它通过获取全局文档评论和局部全文内评论（包括解决状态和完整的回复链）来简化审核过程。通过在 Openclaw Skills 生态系统中使用该工具，开发者可以自动执行文档审计和反馈汇总，无需人工干预。

该工具对于在高速文档协作环境中工作、且版本跟踪和反馈处理至关重要的团队特别有价值。它弥补了结构化文档数据与评审人员提供的对话语境之间的鸿沟，是自动化项目管理工作流的关键组件。

下载入口:https://github.com/openclaw/skills/tree/main/skills/deadblue22/feishu-comments

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

飞书文档评论 应用场景

• 无需打开浏览器即可查看协作者对文档草案的反馈。
• 在定稿发布前审计未解决的评论。
• 通过提取特定文档 token 的所有回复来总结修改周期。
• 交叉引用文档解析过程中识别到的区块级评论。

1. 该工具从本地 openclaw.json 配置中识别飞书 appId 和 appSecret。
2. 与飞书身份验证 API 执行安全握手以获取临时租户访问令牌。
3. 脚本使用文档的唯一 token 向飞书云文档评论 API 发送请求。
4. 解析返回的 JSON 负载，以提取评论 ID、状态、引用文本和按时间顺序排列的回复。
5. 结构化数据返回至标准输出，供 AI 智能体处理或展示给用户。

飞书文档评论 配置指南

要开始使用此插件，请确保您的环境满足以下要求：

• 配置：在 ~/.openclaw/openclaw.json 的 channels.feishu 键下添加您的 appId 和 appSecret。
• 权限：您的飞书应用必须启用 docs:document.comment:read 或 drive:drive 权限范围。
• 依赖：确保系统 PATH 中可以使用 curl 和 python3。

获取文档的所有评论：

bash skills/feishu-comments/scripts/get_comments.sh 

飞书文档评论 数据架构与分类体系

该插件为文档中发现的每个评论主题返回结构化信息：

name: feishu-comments
description: |
  Read comments from Feishu documents. Use when: user asks to check/read/fetch comments on a Feishu doc, review feedback on a document, or collaborate on document revisions via comments.

Feishu Document Comments

Fetch comments from Feishu docx documents via the Drive Comment API.

Requirements

• Feishu app credentials configured in ~/.openclaw/openclaw.json (reads appId and appSecret from channels.feishu)
• System dependencies: curl, python3 (must be available on PATH)
• Feishu app permission: docs:document.comment:read or drive:drive

Usage

Run the bundled script to get all comments on a document:

bash skills/feishu-comments/scripts/get_comments.sh 

To fetch specific comments by ID:

bash skills/feishu-comments/scripts/get_comments.sh  "id1,id2,id3"

Resolve skills/ paths relative to the workspace directory.

When to Use

• After feishu_doc list_blocks shows comment_ids on blocks
• When user asks to review or check comments on a document
• During document collaboration review cycles

Output Format

Each comment shows:

• Comment ID, status (Open/Resolved), scope (Global/Local)
• Quoted text (for local/inline comments)
• All replies with user ID and text content

Extracting doc_token

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

For wiki pages, first use feishu_wiki to get obj_token, then use that as the doc_token.

How It Works

The bundled shell script:

1. Reads Feishu app credentials (appId, appSecret) from ~/.openclaw/openclaw.json
2. Obtains a tenant_access_token via the Feishu auth API
3. Calls the Drive Comment API to list and batch-query comments
4. Formats and outputs comment content to stdout

No data is sent to any third party beyond the Feishu/Lark API endpoints.

Limitations

• Read-only (cannot create or reply to comments)
• API error responses are printed to stderr (may contain request IDs but no sensitive data)