Feishu Ops Assistant

A skill bundle that teaches OpenClaw agents how to operate Feishu (Lark) workspace resources: documents, cloud drive, permissions, and knowledge bases.

Platform: OpenClaw with the feishu plugin enabled. Trigger keywords: Feishu, Lark, 飞书, cloud doc, wiki, drive, permissions, 文档, 知识库, 云空间, 权限

---

Bundled Skills

#	Skill	Tool	What it does
1	feishu-doc	feishu_doc	Read, write, append, create documents; manage blocks and tables
2	feishu-drive	feishu_drive	List, create, move, and delete files/folders in cloud storage
3	feishu-perm	feishu_perm	Add/remove collaborators, manage sharing and permissions
4	feishu-wiki	feishu_wiki	Navigate knowledge bases, create/move/rename wiki pages

---

Quick Start

1. Ensure the feishu plugin is enabled in your OpenClaw config.
2. Install this skill into your agent workspace:

   clawhub install openclaw-feishu-ops-assistant

3. Ask your agent to read a Feishu doc:

   Read this doc: https://xxx.feishu.cn/docx/ABC123def

---

1. feishu-doc

Single tool feishu_doc with an action parameter for all document operations.

Token Extraction

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

Core Actions

Action	Description
read	Get plain-text content + block statistics
write	Replace entire document with Markdown
append	Append Markdown to end of document
create	Create a new document (optionally in a folder)
list_blocks	List all blocks (tables, images, code, etc.)
get_block	Get a single block by ID
update_block	Update block text content
delete_block	Delete a block

Tables

Action	Description
create_table	Create a table in a document
create_table_with_values	Create a table pre-filled with data
write_table_cells	Write values into existing table cells
insert_table_row / insert_table_column	Insert rows or columns
delete_table_rows / delete_table_columns	Delete rows or columns
merge_table_cells	Merge a range of cells

Media

Action	Description
upload_image	Upload an image (URL, file path, or base64) into a document
upload_file	Upload a file attachment into a document

Reading Workflow

1. Start with action: "read" — get plain text + statistics.
2. Check block_types in response for Table, Image, Code, etc.
3. If structured content exists, use action: "list_blocks" for full data.

Permissions Required

docx:document, docx:document:readonly, docx:document.block:convert, drive:drive

---

2. feishu-drive

Single tool feishu_drive for cloud storage operations.

Token Extraction

From URL https://xxx.feishu.cn/drive/folder/ABC123 → folder_token = ABC123

Actions

Action	Description
list	List folder contents (root if no token)
info	Get file metadata
create_folder	Create a new folder
move	Move a file/folder
delete	Delete a file/folder

File Types

doc, docx, sheet, bitable, folder, file, mindnote, shortcut

Known Limitation

Feishu bots have no root folder. The bot can only access files/folders that have been shared with it. Users must first create a folder and share it with the bot.

Permissions Required

drive:drive (full) or drive:drive:readonly (read-only)

---

3. feishu-perm

Single tool feishu_perm for managing file/document permissions.

Disabled by default — permission management is sensitive. Enable via config:

channels:
  feishu:
    tools:
      perm: true

Actions

Action	Description
list	List collaborators on a resource
add	Add a collaborator (email, user ID, group, department)
remove	Remove a collaborator

Permission Levels

Level	Description
view	View only
edit	Can edit
full_access	Full access (can manage permissions)

Member Types

email, openid, userid, unionid, openchat, opendepartmentid

Permissions Required

drive:permission

---

4. feishu-wiki

Single tool feishu_wiki for knowledge-base operations.

Token Extraction

From URL https://xxx.feishu.cn/wiki/ABC123def → token = ABC123def

Actions

Action	Description
spaces	List all accessible knowledge spaces
nodes	List child nodes of a space or parent node
get	Get node details (returns obj_token for doc operations)
search	Search for nodes by keyword
create	Create a new wiki page (docx, sheet, bitable, etc.)
move	Move a node within or across spaces
rename	Rename a node

Wiki → Doc Workflow

1. Get node: feishu_wiki { action: "get", token: "wiki_token" } → returns obj_token
2. Read content: feishu_doc { action: "read", doc_token: "<obj_token>" }
3. Edit content: feishu_doc { action: "write", doc_token: "<obj_token>", content: "..." }

Permissions Required

wiki:wiki or wiki:wiki:readonly

---

Configuration Reference

channels:
  feishu:
    tools:
      doc: true    # default: true
      drive: true  # default: true
      perm: false  # default: false (enable explicitly)
      wiki: true   # default: true

Feishu App Permissions Checklist

Scope	Required for
docx:document	Doc read/write
docx:document:readonly	Doc read-only
docx:document.block:convert	Block operations
drive:drive	Drive full access
drive:drive:readonly	Drive read-only
drive:permission	Permission management
wiki:wiki	Wiki full access
wiki:wiki:readonly	Wiki read-only