適用於 Openclaw 的 語雀 AI Agent 技能

一個強大的整合工具,使 AI Agent 能夠與語雀知識庫互動,進行文件管理和內容操作。

a6590072
v1.0.0
Mar 16, 2026
0
1.1k
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install yuque

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 yuque。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 語雀 AI Agent 技能?

語雀技能在您的 AI Agent 與語雀 (語雀) 知識庫平台之間提供了一個全面的橋樑。通過利用 語雀 Open API v2,此技能允許對個人和團隊倉庫進行程式化存取,從而實現閱讀、編寫和組織技術文件或內部維基等任務。

這種整合對於使用 Openclaw Skills 自動化其文件工作流或構建需要存取專有知識庫的研究 Agent 的開發人員和團隊至關重要。它支援對文件進行完整的 CRUD 操作,並提供對倉庫階層結構的結構化存取。

語雀 AI Agent 技能 應用場景

  • 將在地文件或專案筆記直接同步到語雀倉庫。
  • 在團隊空間中自動建立會議記錄或狀態報告。
  • 跨多個語雀倉庫進行搜尋,為研究任務提取資訊。
  • 作為 AI 驅動的開發工作流的一部分,管理和更新技術文件。

語雀 AI Agent 技能 運作原理

  1. 技能使用通過環境變數提供的安全 API 令牌與平台進行身份驗證。
  2. 它識別目標命名空間(用戶或團隊)以準確界定文件操作範圍。
  3. 對於檢索,技能獲取倉庫列表或特定的文件元資料和原始內容。
  4. 對於內容處理,技能可以將來自 API 的原始 HTML 解析為乾淨的 Markdown 格式,以提高可讀性。
  5. 對於修改,它傳送結構化的 JSON 有效負載,以程式化方式建立或更新文件主體和標題。

語雀 AI Agent 技能 設定指南

要在 Openclaw Skills 生態系統中使用此技能,請按照以下步驟操作:

  1. 從您的帳戶設定中獲取您的 語雀 API Token。
  2. 在您的 shell 中將令牌匯出為環境變數:
export YUQUE_TOKEN="your_api_token_here"
  1. 通過獲取您的用戶資訊來驗證連接:
curl -s -H "X-Auth-Token: $YUQUE_TOKEN" https://www.yuque.com/api/v2/user
  1. 使用 scripts/ 目錄中提供的 Python 輔助腳本進行進階解析和搜尋任務。

語雀 AI Agent 技能 資料結構與分類體系

該技能與 語雀 API v2 交互,後者以結構化的 JSON 格式返回數據。以下是數據的主要組織方式:

組件 描述 格式
data 核心資源物件(用戶、倉庫或文件) JSON 物件
meta 包含分頁和速率限制資訊的元資料 JSON 物件
namespace 倉庫的唯一識別碼 (owner/slug) 字串
raw 獲取未格式化文件內容的可選參數 整數 (0 或 1)

語雀 AI Agent 技能 進階特性

  • 通過輔助腳本提供全面的 CLI 支援,用於批次操作和手動覆蓋。
  • 內建 HTML-to-Markdown 轉換引擎,確保與 AI 編碼 Agent 的相容性。
  • 智慧搜尋過濾,通過遍歷倉庫文件列表模擬全域搜尋。
  • 在 Openclaw Skills 整合中支援個人和企業團隊空間。
  • 針對速率限制 (429) 和權限問題 (403) 的標準化錯誤處理。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*