@openclaw/feishu 2026.7.2-beta.7 → 2026.8.1-beta.2

package/skills/feishu-doc/references/block-types.md

@@ -1,6 +1,6 @@
 # Feishu Block Types Reference
 
-Complete reference for Feishu document block types. Use with `feishu_doc_list_blocks`, `feishu_doc_update_block`, and `feishu_doc_delete_block`.
+Complete reference for Feishu document block types. Use the single `feishu_doc` tool with its `list_blocks`, `update_block`, and `delete_block` actions.
 
 ## Block Type Table
 
@@ -59,10 +59,11 @@ Complete reference for Feishu document block types. Use with `feishu_doc_list_bl
 
 ### Text-based blocks (2-17, 19)
 
-Update text content using `feishu_doc_update_block`:
+Update text content with `feishu_doc`:
 
 ```json
 {
+  "action": "update_block",
   "doc_token": "ABC123",
   "block_id": "block_xxx",
   "content": "New text content"
@@ -71,13 +72,11 @@ Update text content using `feishu_doc_update_block`:
 
 ### Image blocks (27)
 
-Images cannot be updated directly via `update_block`. Use `feishu_doc_write` or `feishu_doc_append` with markdown to add new images.
+Images cannot be updated directly via `update_block`. Use `upload_image` to add a replacement image, then delete the old block only after the new upload succeeds.
 
 ### Table blocks (31)
 
-**Important:** Table blocks CANNOT be created via the `documentBlockChildren.create` API (error 1770029). This affects `feishu_doc_write` and `feishu_doc_append` - markdown tables will be skipped with a warning.
-
-Tables can only be read (via `list_blocks`) and individual cells (type 32) can be updated, but new tables cannot be inserted programmatically via markdown.
+Markdown tables are not converted by `write`, `append`, or `insert`. Create tables with `create_table` or `create_table_with_values`; use the table row, column, cell, and merge actions exposed by the current schema for later edits.
 
 ### Container blocks (24, 25, 35)
 
@@ -87,17 +86,13 @@ Grid and QuoteContainer are layout containers. Edit their child blocks instead.
 
 ### Replace specific paragraph
 
-1. `feishu_doc_list_blocks` - find the block_id
-2. `feishu_doc_update_block` - update its content
+1. Call `feishu_doc` with `action: "list_blocks"` to find the block ID.
+2. Call `feishu_doc` with `action: "update_block"` to replace its text.
 
 ### Insert content at specific location
 
-Currently, the API only supports appending to document end. For insertion at specific positions, consider:
-
-1. Read existing content
-2. Delete affected blocks
-3. Rewrite with new content in desired order
+Call `feishu_doc` with `action: "insert"`, the target `doc_token`, Markdown `content`, and the preceding block's ID as `after_block_id`.
 
 ### Delete multiple blocks
 
-Blocks must be deleted one at a time. Delete child blocks before parent containers.
+Call `delete_block` for exact block IDs. Delete child blocks before parent containers and confirm broad deletions first.

package/skills/feishu-drive/SKILL.md

@@ -1,114 +1,28 @@
 ---
 name: feishu-drive
 description: |
-  Feishu cloud storage file management. Activate when user mentions cloud space, folders, drive.
+  Feishu cloud-storage and comment workflows. Activate when the user mentions cloud space, folders, Drive files, or document comments.
 ---
 
-# Feishu Drive Tool
+# Feishu Drive
 
-Single tool `feishu_drive` for cloud storage operations.
+Use the single `feishu_drive` tool and its current action schema.
 
-## Token Extraction
+From `https://example.feishu.cn/drive/folder/ABC123`, use `ABC123` as `folder_token`.
 
-From URL `https://xxx.feishu.cn/drive/folder/ABC123` → `folder_token` = `ABC123`
+## Files and folders
 
-## Actions
+- Start from a folder shared with the bot. Bot credentials normally have no usable personal root folder.
+- For paginated folder listings, keep the same `folder_token` and pass the returned `page_token` until no continuation token remains.
+- Use `info` with the exact file token and type returned by Drive or wiki discovery.
+- Resolve the exact source and destination before moving or deleting. Confirm destructive deletes when the user's intent or target is unclear.
+- Create subfolders inside a shared folder; creating at the account root normally fails for bots.
 
-### List Folder Contents
+## Comments
 
-```json
-{ "action": "list" }
-```
+- Use `list_comments`, then `list_comment_replies` with the exact `comment_id` to inspect a discussion.
+- Use `add_comment` for a document-level comment. Include `block_id` only when the user wants a comment on one known Docx block.
+- Use `reply_comment` for an existing comment thread.
+- Preserve the file type and pagination fields returned by the tool. The schema is authoritative for which file types each comment action accepts.
 
-Requests the account root (no `folder_token`). Bot credentials normally have no root folder, so
-use a folder that has been shared with the bot instead.
-
-```json
-{ "action": "list", "folder_token": "fldcnXXX", "page_size": 100 }
-```
-
-Returns one page of files with token, name, type, url, timestamps, and `next_page_token` when
-another page is available. To continue, pass the returned token with the same folder token:
-
-```json
-{
-  "action": "list",
-  "folder_token": "fldcnXXX",
-  "page_size": 100,
-  "page_token": "next-page-token"
-}
-```
-
-`page_size` must be between 1 and 200. Pagination requires a concrete shared `folder_token`;
-root-list cursors are not forwarded.
-
-### Get File Info
-
-```json
-{ "action": "info", "file_token": "ABC123", "type": "docx" }
-```
-
-Looks up file metadata directly by token and type, regardless of which shared folder contains it.
-Shortcuts are the exception: Feishu's metadata API does not support the `shortcut` type, so shortcut
-info retains the root-directory lookup behavior.
-
-`type`: `doc`, `docx`, `sheet`, `bitable`, `folder`, `file`, `mindnote`, `shortcut`
-
-### Create Folder
-
-```json
-{ "action": "create_folder", "name": "New Folder" }
-```
-
-In parent folder:
-
-```json
-{ "action": "create_folder", "name": "New Folder", "folder_token": "fldcnXXX" }
-```
-
-### Move File
-
-```json
-{ "action": "move", "file_token": "ABC123", "type": "docx", "folder_token": "fldcnXXX" }
-```
-
-### Delete File
-
-```json
-{ "action": "delete", "file_token": "ABC123", "type": "docx" }
-```
-
-## File Types
-
-| Type       | Description             |
-| ---------- | ----------------------- |
-| `doc`      | Old format document     |
-| `docx`     | New format document     |
-| `sheet`    | Spreadsheet             |
-| `bitable`  | Multi-dimensional table |
-| `folder`   | Folder                  |
-| `file`     | Uploaded file           |
-| `mindnote` | Mind map                |
-| `shortcut` | Shortcut                |
-
-## Configuration
-
-```yaml
-channels:
-  feishu:
-    tools:
-      drive: true # default: true
-```
-
-## Permissions
-
-- `drive:drive` - Full access (create, move, delete)
-- `drive:drive:readonly` - Read only (list and root-level info fallback)
-- `drive:drive.metadata:readonly` - Direct `info` lookup outside the root (not needed with `drive:drive`)
-
-## Known Limitations
-
-- **Bots have no root folder**: Feishu bots use `tenant_access_token` and don't have their own "My Space". The root folder concept only exists for user accounts. This means:
-  - `create_folder` without `folder_token` will fail (400 error)
-  - Bot can only access files/folders that have been **shared with it**
-  - **Workaround**: User must first create a folder manually and share it with the bot, then bot can create subfolders inside it
+Only expose or forward file and comment contents needed for the user's request; shared Drive data may be private.

package/skills/feishu-perm/SKILL.md

@@ -1,119 +1,19 @@
 ---
 name: feishu-perm
 description: |
-  Feishu permission management for documents and files. Activate when user mentions sharing, permissions, collaborators.
+  Feishu collaborator and permission workflows. Activate when the user explicitly asks to inspect or change sharing, permissions, or collaborators.
 ---
 
-# Feishu Permission Tool
+# Feishu permissions
 
-Single tool `feishu_perm` for managing file/document permissions.
+Use the single `feishu_perm` tool and its current action schema. This tool is disabled by default because it changes access to user data; if it is unavailable, explain that `channels.feishu.tools.perm` must be enabled.
 
-## Actions
+## Workflow
 
-### List Collaborators
+1. Resolve the exact file token and type.
+2. Use `list` to inspect current collaborators before changing access.
+3. For `add`, resolve the collaborator's exact identifier and choose the least permission that satisfies the request.
+4. For `remove`, confirm the exact collaborator and file when the request is ambiguous or broad.
+5. Report the resulting permission change without exposing unrelated collaborator data.
 
-```json
-{ "action": "list", "token": "ABC123", "type": "docx" }
-```
-
-Returns: members with member_type, member_id, perm, name.
-
-### Add Collaborator
-
-```json
-{
-  "action": "add",
-  "token": "ABC123",
-  "type": "docx",
-  "member_type": "email",
-  "member_id": "user@example.com",
-  "perm": "edit"
-}
-```
-
-### Remove Collaborator
-
-```json
-{
-  "action": "remove",
-  "token": "ABC123",
-  "type": "docx",
-  "member_type": "email",
-  "member_id": "user@example.com"
-}
-```
-
-## Token Types
-
-| Type       | Description             |
-| ---------- | ----------------------- |
-| `doc`      | Old format document     |
-| `docx`     | New format document     |
-| `sheet`    | Spreadsheet             |
-| `bitable`  | Multi-dimensional table |
-| `folder`   | Folder                  |
-| `file`     | Uploaded file           |
-| `wiki`     | Wiki node               |
-| `mindnote` | Mind map                |
-
-## Member Types
-
-| Type               | Description        |
-| ------------------ | ------------------ |
-| `email`            | Email address      |
-| `openid`           | User open_id       |
-| `userid`           | User user_id       |
-| `unionid`          | User union_id      |
-| `openchat`         | Group chat open_id |
-| `opendepartmentid` | Department open_id |
-
-## Permission Levels
-
-| Perm          | Description                          |
-| ------------- | ------------------------------------ |
-| `view`        | View only                            |
-| `edit`        | Can edit                             |
-| `full_access` | Full access (can manage permissions) |
-
-## Examples
-
-Share document with email:
-
-```json
-{
-  "action": "add",
-  "token": "doxcnXXX",
-  "type": "docx",
-  "member_type": "email",
-  "member_id": "alice@company.com",
-  "perm": "edit"
-}
-```
-
-Share folder with group:
-
-```json
-{
-  "action": "add",
-  "token": "fldcnXXX",
-  "type": "folder",
-  "member_type": "openchat",
-  "member_id": "oc_xxx",
-  "perm": "view"
-}
-```
-
-## Configuration
-
-```yaml
-channels:
-  feishu:
-    tools:
-      perm: true # default: false (disabled)
-```
-
-**Note:** This tool is disabled by default because permission management is a sensitive operation. Enable explicitly if needed.
-
-## Permissions
-
-Required: `drive:permission`
+Never infer an email, user ID, department, or chat from a display name alone. Follow the current schema for supported member types, token types, and permission levels.

package/skills/feishu-wiki/SKILL.md

@@ -1,122 +1,26 @@
 ---
 name: feishu-wiki
 description: |
-  Feishu knowledge base navigation. Activate when user mentions knowledge base, wiki, or wiki links.
+  Feishu knowledge-base navigation workflows. Activate when the user mentions a knowledge base, wiki, or wiki link.
 ---
 
-# Feishu Wiki Tool
+# Feishu wiki
 
-Single tool `feishu_wiki` for knowledge base operations.
+Use the single `feishu_wiki` tool and its current action schema.
 
-Wiki `space_id` values are opaque strings. Always keep them quoted in tool calls, even when they contain only digits; passing a long numeric-looking ID as a number can corrupt the suffix due to JavaScript number precision limits.
+From `https://example.feishu.cn/wiki/ABC123def`, use `ABC123def` as `token`. Treat every `space_id` as an opaque quoted string, even when it contains only digits.
 
-## Token Extraction
+## Navigate
 
-From URL `https://xxx.feishu.cn/wiki/ABC123def` → `token` = `ABC123def`
+- Use `spaces` to enumerate accessible knowledge spaces and `nodes` for a space or parent node.
+- Continue pagination with the returned `page_token` while `has_more` is true, keeping the same space and parent.
+- Use `search` when the user provides a query but not an exact node.
+- Use `get` to resolve a wiki token to its `node_token`, `obj_token`, and `obj_type`.
 
-## Actions
+## Create and organize
 
-### List Knowledge Spaces
+Wiki creation supports only `docx`, `sheet`, and `bitable`; `docx` is the default. Resolve an exact space and parent before create, move, or rename operations, and confirm ambiguous or destructive reorganizations.
 
-```json
-{ "action": "spaces" }
-```
+## Wiki content workflow
 
-Returns one page of accessible wiki spaces plus `has_more` and `page_token`.
-Continue with the returned `page_token` while `has_more` is true:
-
-```json
-{ "action": "spaces", "page_token": "next-page-token" }
-```
-
-### List Nodes
-
-```json
-{ "action": "nodes", "space_id": "7xxx" }
-```
-
-With parent:
-
-```json
-{ "action": "nodes", "space_id": "7xxx", "parent_node_token": "wikcnXXX" }
-```
-
-Returns one page of nodes plus `has_more` and `page_token`. Continue with the
-same `space_id` and `parent_node_token`, adding the returned `page_token`, while
-`has_more` is true. Both list actions accept optional `page_size` from 1 to 50.
-
-### Get Node Details
-
-```json
-{ "action": "get", "token": "ABC123def" }
-```
-
-Returns: `node_token`, `obj_token`, `obj_type`, etc. Use `obj_token` with `feishu_doc` to read/write the document.
-
-### Create Node
-
-```json
-{ "action": "create", "space_id": "7xxx", "title": "New Page" }
-```
-
-With type and parent:
-
-```json
-{
-  "action": "create",
-  "space_id": "7xxx",
-  "title": "Sheet",
-  "obj_type": "sheet",
-  "parent_node_token": "wikcnXXX"
-}
-```
-
-`obj_type`: `docx` (default), `sheet`, `bitable`, `mindnote`, `file`, `doc`, `slides`
-
-### Move Node
-
-```json
-{ "action": "move", "space_id": "7xxx", "node_token": "wikcnXXX" }
-```
-
-To different location:
-
-```json
-{
-  "action": "move",
-  "space_id": "7xxx",
-  "node_token": "wikcnXXX",
-  "target_space_id": "7yyy",
-  "target_parent_token": "wikcnYYY"
-}
-```
-
-### Rename Node
-
-```json
-{ "action": "rename", "space_id": "7xxx", "node_token": "wikcnXXX", "title": "New Title" }
-```
-
-## Wiki-Doc Workflow
-
-To edit a wiki page:
-
-1. Get node: `{ "action": "get", "token": "wiki_token" }` → returns `obj_token`
-2. Read doc: `feishu_doc { "action": "read", "doc_token": "obj_token" }`
-3. Write doc: `feishu_doc { "action": "write", "doc_token": "obj_token", "content": "..." }`
-
-## Configuration
-
-```yaml
-channels:
-  feishu:
-    tools:
-      wiki: true # default: true
-      doc: true # required - wiki content uses feishu_doc
-```
-
-**Dependency:** This tool requires `feishu_doc` to be enabled. Wiki pages are documents - use `feishu_wiki` to navigate, then `feishu_doc` to read/edit content.
-
-## Permissions
-
-Required: `wiki:wiki` or `wiki:wiki:readonly`
+Wiki navigation is independent of the document tool. When `get` returns a `docx` object, use its `obj_token` as `doc_token` with `feishu_doc` to read or edit the page. Other object types require a currently available tool that supports that type; do not treat them as documents.