aiskillstore/openclaw-feishu-ops-assistant

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 |