78 lines
2.2 KiB
Markdown
78 lines
2.2 KiB
Markdown
---
|
||
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 - 飞书文档读取工具
|
||
|
||
## 使用场景
|
||
- 数据分析师需要访问飞书知识库获取业务数据
|
||
- 团队需要将知识库内容与其他系统集成
|
||
- 需要定期同步知识库内容进行分析
|
||
|
||
## 注意事项
|
||
- 建议使用只读权限，确保数据安全
|
||
- 可以同时接入多个知识库空间
|
||
- 权限变更需要重新审批 |