home / skills / openclaw / openclaw / feishu-wiki

feishu-wiki skill

safe

This skill helps you navigate and manage Feishu wiki pages and spaces, enabling quick access to nodes, documents, and organization.

npx playbooks add skill openclaw/openclaw --skill feishu-wiki

Review the files below or copy the command above to add this skill to your agents.

Files (1)

SKILL.md

2.1 KB

---
name: feishu-wiki
description: |
  Feishu knowledge base navigation. Activate when user mentions knowledge base, wiki, or wiki links.
---

# Feishu Wiki Tool

Single tool `feishu_wiki` for knowledge base operations.

## Token Extraction

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

## Actions

### List Knowledge Spaces

```json
{ "action": "spaces" }
```

Returns all accessible wiki spaces.

### List Nodes

```json
{ "action": "nodes", "space_id": "7xxx" }
```

With parent:

```json
{ "action": "nodes", "space_id": "7xxx", "parent_node_token": "wikcnXXX" }
```

### 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`

Overview

This skill provides navigation and management for Feishu knowledge bases (wiki). It exposes actions to list spaces and nodes, inspect page metadata, create/move/rename pages, and integrate with the Feishu document tool for reading and editing content. It requires the feishu_doc tool enabled to read or write page bodies.

How this skill works

The tool extracts a page token from Feishu wiki URLs and performs JSON actions such as spaces, nodes, get, create, move, and rename. For full page editing, it returns an obj_token from the get action which you pass to feishu_doc to read or write the document body. Permissions require wiki:wiki or wiki:wiki:readonly.

When to use it

When a user asks to browse or list Feishu wiki spaces and their pages
When you need page metadata (node_token, obj_token, obj_type) without reading content
Before editing a wiki page: use get to obtain obj_token then use feishu_doc for content changes
To create, relocate, or rename wiki pages programmatically
When building automations that integrate wiki navigation with document editing workflows

Best practices

Always extract the token from the Feishu wiki URL (last path segment) before calling get
Use spaces and nodes actions first to discover structure and valid space_id or parent_node_token
Treat wiki pages as documents: use feishu_wiki only for navigation/metadata and feishu_doc for content operations
Check required permissions (wiki:wiki or wiki:wiki:readonly) to avoid authorization errors
When moving pages, provide both target_space_id and target_parent_token to avoid placing nodes at unintended locations

Example use cases

List all accessible wiki spaces for a new team onboarding flow
Enumerate child nodes under a space to build a site map or navigation menu
Retrieve obj_token for a page and call feishu_doc to export or update page content
Create a new sheet or doc page inside a specific space and parent node for structured templates
Move or rename legacy pages during a content reorganization

FAQ

What token do I pass to the get action?

Pass the page token extracted from the wiki URL (the last segment like ABC123def) as token to the get action.

Can I read and write page content with this tool alone?

No. feishu_wiki returns obj_token and metadata. You must enable and use feishu_doc to read or write the document content.