---
name: feishu-wiki-access
description: |
  飞书知识库接入技能 | Feishu Wiki Access Skill
  帮助用户快速配置和接入飞书知识库，获取只读访问权限，实现文档内容的读取和分析。
metadata:
  {
    "openclaw":
      {
        "requires": { "tools": ["feishu_wiki", "feishu_doc"] },
        "categories": ["feishu", "knowledge-base", "setup"]
      },
  }
---

# 飞书知识库接入技能

## 功能描述
帮助用户快速配置和接入飞书知识库，获取只读访问权限，实现文档内容的读取和分析。

## 接入流程

### 1. 前置准备
- 飞书机器人应用已创建
- OpenClaw已配置飞书通道

### 2. 权限配置
1. **飞书应用权限配置**:
   - 登录飞书开放平台（https://open.feishu.cn）
   - 进入目标应用 → 权限管理
   - 添加以下权限:
     - `wiki:wiki:readonly` - 知识库只读权限
     - `docx:document:readonly` - 文档只读权限
     - `docs:document.content:read` - 文档内容读取权限
   - 提交权限申请并等待管理员审批

2. **知识库空间授权**:
   - 打开目标飞书知识库空间
   - 进入「设置」→「成员管理」
   - 点击「添加成员」
   - 搜索并添加机器人应用
   - 设置权限为「可查看」
   - 保存配置

### 3. 功能测试
1. **测试知识库访问**:
   ```json
   {"action": "spaces"}
   ```

2. **测试文档列表**:
   ```json
   {"action": "nodes", "space_id": "SPACE_ID"}
   ```

3. **测试文档读取**:
   ```json
   {"action": "read", "doc_token": "DOC_TOKEN"}
   ```

### 4. 常见问题排查
- **权限不足**: 检查飞书应用权限是否已审批，知识库成员是否已添加机器人
- **文档读取失败**: 确保已配置`docx:document:readonly`权限
- **找不到机器人**: 通过机器人主页的「添加到知识库」功能添加

## 依赖工具
- feishu-wiki - 飞书知识库导航工具
- feishu-doc - 飞书文档读取工具

## 使用场景
- 数据分析师需要访问飞书知识库获取业务数据
- 团队需要将知识库内容与其他系统集成
- 需要定期同步知识库内容进行分析

## 注意事项
- 建议使用只读权限，确保数据安全
- 可以同时接入多个知识库空间
- 权限变更需要重新审批