闲社服务运行正常AI智能体自动化平台
y

语雀文档管理

技能标识:yuque

Manage Yuque (语雀) knowledge base documents and repositories. Use when users need to interact with Yuque for document operations including reading documents, listing repositories, searching content, creating documents, and managing knowledge bases. Supports both personal and team spaces.

作者:admin | 来源记录:ClawHub
登记来源
ClawHub
版本
V 1.0.0
检测标记
后台标记通过
免费
免费获取
0
收藏
来源与检测标记为平台登记信息,并不代表已展示可复核的检测报告。使用前请核对版本、依赖和所需权限,建议先在隔离环境中运行。
概述
安装方式
版本历史

语雀文档管理

Yuque 技能

通过语雀开放 API 与语雀知识库平台进行交互。

前提条件

  • - 语雀 API 令牌(存储在环境变量 YUQUE_TOKEN 中)
  • 基础 URL:https://www.yuque.com/api/v2

身份验证

所有 API 请求都需要在请求头中添加 X-Auth-Token,并携带您的语雀令牌。

核心工作流

1. 获取用户信息

bash
curl -s -H X-Auth-Token: $YUQUE_TOKEN https://www.yuque.com/api/v2/user

2. 列出用户知识库

bash
curl -s -H X-Auth-Token: $YUQUE_TOKEN https://www.yuque.com/api/v2/users//repos

3. 列出知识库文档

bash
curl -s -H X-Auth-Token: $YUQUE_TOKEN https://www.yuque.com/api/v2/repos//docs

4. 获取文档详情

bash
curl -s -H X-Auth-Token: $YUQUE_TOKEN https://www.yuque.com/api/v2/repos//docs/

5. 获取文档内容(HTML/Markdown)

bash

获取 HTML 内容


curl -s -H X-Auth-Token: $YUQUE_TOKEN https://www.yuque.com/api/v2/repos//docs/?raw=1

获取 Markdown 内容

curl -s -H X-Auth-Token: $YUQUETOKEN https://www.yuque.com/api/v2/repos//docs/?raw=1 | python scripts/parseyuque.py --format md

6. 创建文档

bash
curl -s -X POST \
-H X-Auth-Token: $YUQUE_TOKEN \
-H Content-Type: application/json \
-d {title: 文档标题, body: Markdown 格式的文档内容} \
https://www.yuque.com/api/v2/repos//docs

7. 更新文档

bash
curl -s -X PUT \
-H X-Auth-Token: $YUQUE_TOKEN \
-H Content-Type: application/json \
-d {title: 新标题, body: 更新后的内容} \
https://www.yuque.com/api/v2/repos//docs/

8. 搜索文档

语雀 API 没有直接的搜索接口。请使用列出加过滤的方式:

bash

列出知识库中的所有文档并按标题过滤


python scripts/search_yuque.py --namespace --query 关键词

常见命名空间格式

  • - 个人知识库:用户名/知识库标识
  • 团队知识库:团队名/知识库标识

响应格式

所有 API 响应均为 JSON 格式,结构如下:

json
{
data: { ... },
meta: { ... }
}

错误处理

常见的 HTTP 状态码:

  • - 401:未授权(检查令牌)
  • 403:禁止访问(无权限)
  • 404:资源未找到
  • 429:请求频率受限(等待后重试)

辅助脚本

使用提供的 Python 脚本进行常见操作:

  • - scripts/yuquecli.py - 语雀操作的完整命令行工具
  • scripts/parseyuque.py - 将语雀 HTML 解析为 Markdown
  • scripts/search_yuque.py - 在知识库中搜索文档

参考资料

标签

skill ai

通过对话安装

以下为平台配置的接入选项,并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 yuque-1776060963 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 yuque-1776060963 技能

通过命令行安装

skillhub install yuque-1776060963

下载

⬇ 下载 yuque v1.0.0(免费)

文件大小: 5.18 KB | 发布时间: 2026-4-15 15:11

v1.0.0 最新 2026-4-15 15:11
Initial release with basic CRUD operations
返回顶部