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 <doc_token>
To fetch specific comments by ID:
bash skills/feishu-comments/scripts/get_comments.sh <doc_token> "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:
- Reads Feishu app credentials (
appId, appSecret) from ~/.openclaw/openclaw.json
- Obtains a
tenant_access_token via the Feishu auth API
- Calls the Drive Comment API to list and batch-query comments
- 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)