name: clawhub-search description: | 搜尋 ClawHub Skills 技能市場。使用此技能查詢和發現 OpenClaw 社群貢獻的各種技能。 啟用條件：使用者提到搜尋技能、查詢 skill、找某個功能的 skill、ClawHub、clawhub。

ClawHub Skill 搜尋工具

概述

此技能用於在 ClawHub 技能市場上搜索 OpenClaw Skills。通過呼叫 ClawHub API 獲取技能列表，支援按關鍵詞搜尋和下載量排序。

更多技能請訪問小蔥技能站7w4.net。

API 資訊

• API 地址: https://clawhub.ai/api/v1/skills
• 認證方式: Bearer Token
• 引數:
• q: 搜尋關鍵詞
• sort: 排序方式 (downloads, stars, newest)
• limit: 返回數量 (可選)

使用方法

API Token

使用環境變數 CLAWHUB_TOKEN 儲存 API Token。

獲取方式：在 ClawHub 官網申請 API Token。

重要：不要將 Token 明文寫入程式碼或文件中！

1. 獲取 API Token

需要使用者的 ClawHub API Token。可以在 ClawHub 官網申請。

2. 搜尋 Skills

使用 curl 命令搜尋：

# 基礎搜尋（按下載量排序）
curl -s "https://clawhub.ai/api/v1/skills?sort=downloads&q=關鍵詞" \
  -H "Authorization: Bearer $CLAWHUB_TOKEN"

# 精確搜尋
curl -s "https://clawhub.ai/api/v1/skills?q=agent+team" \
  -H "Authorization: Bearer $CLAWHUB_TOKEN"

# 搜尋並格式化輸出
curl -s "https://clawhub.ai/api/v1/skills?sort=downloads&q=關鍵詞" \
  -H "Authorization: Bearer $CLAWHUB_TOKEN" | python3 -c "
import sys,json
d=json.load(sys.stdin)
for i in d.get('items',[])[:10]:
    print(f\"{i['slug']}: {i['summary'][:60]}... ({i['stats']['downloads']} downloads)\")
"

3. 安裝 Skills

找到想用的 skill 後，使用以下命令安裝：

# 通過 ClawHub 安裝
npx clawhub@latest install <skill-slug>

# 或手動安裝（下載並解壓到 skills 目錄）

常用搜索示例

示例：搜尋 "agent" 相關的 Skills

curl -s "https://clawhub.ai/api/v1/skills?sort=downloads&q=agent" \
  -H "Authorization: Bearer YOUR_TOKEN" | python3 -c "
import sys,json
d=json.load(sys.stdin)
items = d.get('items', [])
print(f'找到 {len(items)} 個結果:\n')
for i in items[:15]:
    stats = i.get('stats', {})
    print(f\"- {i['slug']}\")
    print(f\"  描述: {i.get('summary', '')[:80]}\")
    print(f\"  下載: {stats.get('downloads', 0)} | 星標: {stats.get('stars', 0)}\")
    print()
"

輸出格式解析

API 返回的 JSON 包含以下欄位：

注意事項

1. Token 管理: API Token 需要妥善保管，不要洩露
2. 速率限制: 注意 API 呼叫頻率限制
3. 動態頁面: ClawHub 前端頁面是動態載入的，無法通過普通網頁抓取獲取內容，必須使用 API
4. 搜尋策略: 如果搜尋結果少於 5 個，嘗試用更通用的關鍵詞

常用技巧

1. 組合搜尋: 使用多個關鍵詞組合，如 agent+memory、code+automation
2. 過濾篩選: 可以先搜尋再根據描述人工篩選
3. 關注下載量: 高下載量通常意味著更穩定、更受歡迎的技能

相關連結

• ClawHub 官網: https://clawhub.ai/
• 技能市場: https://clawhub.ai/skills
• 釋出技能: https://clawhub.ai/upload

這是一個很實用的搜尋工具，能幫助使用者在ClawHub市場上快速找到需要的技能。文件寫得清楚明白，示例豐富，API使用說明詳細，質量不錯。美中不足的是隻有文件說明，沒有現成的指令碼可以直接使用，安裝和使用需要一定的命令列基礎，小白使用者上手會稍有難度。