Agent Feishu Doc Guide#

Quick Reference#

OperationAPI EndpointCreate docPOST /drive/v1/documentsGet doc metadataGET /drive/v1/documents/{id}Get doc blocksGET /drive/v1/documents/{id}/blocksAdd blocksPOST /drive/v1/documents/{id}/blocks/{parent_id}/childrenSet public permPATCH /drive/v1/permissions/{id}/public?type=docx

Workflow#

1. Create Document#

bash

curl -X POST "https://open.feishu.cn/open-apis/drive/v1/documents" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"title": "文档标题"}'

2. Write Content (Block API)#

bash

curl -X POST "https://open.feishu.cn/open-apis/drive/v1/documents/{doc_id}/blocks/{block_id}/children" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"children": [{"block_type": 2, "text": {"elements": [{"text_run": {"content": "内容"}}]}}]}'

Block types: 2 =text, 3 =h1, 4 =h2, 7 =bullet (⚠️ may error, use text instead)

3. Set Public Permissions#

bash

curl -X PATCH "https://open.feishu.cn/open-apis/drive/v1/permissions/{doc_id}/public?type=docx" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "link_share_entity": "anyone_editable",
    "external_access_entity": "anyone_can_edit",
    "security_entity": "anyone_can_edit",
    "comment_entity": "anyone_can_edit",
    "share_entity": "anyone"
  }'

Reading Docs#

• By URL: Use web_fetch tool on https://feishu.cn/docx/{doc_id}
• By ID: Call GET /drive/v1/documents/{id} then /blocks

Prerequisites#

1. Agent's Feishu app must be added as doc collaborator, OR doc set to public
2. For cross-agent collaboration: set tools.sessions.visibility: "all" in openclaw.json

Troubleshooting#

• Cannot access doc: Add agent's app as collaborator in Feishu, or set doc to public
• Block API error 9499: Avoid block_type: 7 (bullet), use plain text blocks instead
• Cross-agent visibility: Add "tools": {"sessions": {"visibility": "all"}} to openclaw.json

For detailed API specs, permissions guide, and example workflows, see references/guide.md.