awesome-openclaw-skills 生态调研与技能管理体系搭建实录

导语：技能太多，真正值得装的并不多

OpenClaw 的 Skills 生态已经膨胀到令人眼花缭乱程度。VoltAgent/awesome-openclaw-skills 仓库从 12,500+ 个原始技能中筛选出 5,300+ 个可用条目，分成 27 个类别。问题在于：这些技能里哪些与我们当前的工作流真正相关？哪些只是看起来很美？这篇文章把调研过程、筛选逻辑、安装实操和踩坑记录整理成一份可复用的 playbook。

一、awesome-openclaw-skills 项目是什么

VoltAgent/awesome-openclaw-skills 是 OpenClaw 社区维护的"技能精选 awesome 列表"。它的核心逻辑：

• 数据源：从 OpenClaw 的官方技能注册表 ClawHub（clawhub.ai）抓取所有技能
• 过滤筛选：通过自动化 + 人工审核，从 ~12,500+ 原始技能中过滤掉 7,215 个不合格品
• 精选入库：保留 5,300+ 高质量技能，按 27 个分类整理
• 配套网站：clawskills.sh 提供可浏览的 Web 界面

过滤标准（质量门禁）

27 个分类全景

关键发现：Coding Agents & IDEs（1,184）和 Web & Frontend（920）两个分类占了总量的 40%，说明开发者工具是 OpenClaw 生态的最大需求方。而 Data & Analytics（28）、iOS/macOS Dev（29）、Self-Hosted（33）几乎空白——这是蓝海。

二、数据源搭建：让 awesome list 保持最新

要评估技能生态，首先要有一个可靠的数据源。我们选择了 VoltAgent/awesome-openclaw-skills 这个社区维护的精选列表，并搭建了一个完整的同步管道。

2.1 Clone 仓库

cd workspace-skill-factory
git clone --depth 1 https://github.com/VoltAgent/awesome-openclaw-skills.git data/awesome-openclaw-skills

2.2 创建同步脚本 sync.sh

脚本的核心逻辑：

#!/bin/bash
cd data/awesome-openclaw-skills

# 1. 拉取最新数据
git pull --ff-only

# 2. 用 Python 解析 categories/*.md，输出 JSON 索引
python3 << 'PYEOF'
import re, json, os, glob

all_skills = {}
categories = {}

for cat_file in sorted(glob.glob("categories/*.md")):
    cat_name = os.path.basename(cat_file).replace(".md", "")
    skills = []
    
    with open(cat_file) as f:
        for line in f:
            # 匹配 clawskills.sh 链接格式
            m = re.match(r'^- \[(.+?)\]\(https://clawskills\.sh/skills/([^/]+)-([^/]+)\)', line.strip())
            if m:
                name, owner, slug = m.group(1), m.group(2), m.group(3)
                skills.append({
                    "name": name, "owner": owner,
                    "slug": f"{owner}-{slug}",
                    "url": f"https://clawskills.sh/skills/{owner}-{slug}"
                })
            else:
                # 匹配 clawhub.ai 链接格式
                m2 = re.match(r'^- \[(.+?)\]\(https://clawhub\.ai/([^/]+)/([^)]+)\)', line.strip())
                if m2:
                    skills.append({
                        "name": m2.group(1), "owner": m2.group(2),
                        "slug": f"{m2.group(2)}-{m2.group(3)}",
                        "url": f"https://clawhub.ai/{m2.group(2)}/{m2.group(3)}"
                    })
    
    categories[cat_name] = {"skill_count": len(skills), "skills": skills}
    for s in skills:
        all_skills[s["slug"]] = {"category": cat_name, **s}

# 读取上次的数据做对比
prev_file = "categories-index.json"
prev_skills = set()
if os.path.exists(prev_file):
    with open(prev_file) as f:
        prev_data = json.load(f)
        prev_skills = set(prev_data.get("skills_index", {}).keys())

current_skills = set(all_skills.keys())
new_skills = current_skills - prev_skills
removed_skills = prev_skills - current_skills

# 保存新数据
with open(prev_file, "w") as f:
    json.dump({
        "last_updated": os.popen("date -u '+%Y-%m-%dT%H:%M:%SZ'").read().strip(),
        "total_categories": len(categories),
        "total_skills": len(all_skills),
        "new_since_last_sync": len(new_skills),
        "removed_since_last_sync": len(removed_skills),
        "categories": {k: v["skill_count"] for k, v in categories.items()},
        "skills_index": all_skills
    }, f, indent=2, ensure_ascii=False)

# 保存变更日志
if new_skills or removed_skills:
    changes_file = "changes.json"
    changes = []
    if os.path.exists(changes_file):
        with open(changes_file) as f:
            changes = json.load(f)
    
    changes.insert(0, {
        "date": os.popen("date -u '+%Y-%m-%dT%H:%M:%SZ'").read().strip(),
        "new_count": len(new_skills),
        "removed_count": len(removed_skills),
        "new_skills": list(new_skills)[:50],
        "removed_skills": list(removed_skills)[:50]
    })
    changes = changes[:30]  # 只保留最近30条
    
    with open(changes_file, "w") as f:
        json.dump(changes, f, indent=2, ensure_ascii=False)

print(f"✅ 同步完成: {len(all_skills)} 技能")
if new_skills:
    print(f"🆕 新增: {len(new_skills)} 个技能")
if removed_skills:
    print(f"🗑️ 移除: {len(removed_skills)} 个技能")
PYEOF

2.3 配置 Cron 每周自动同步

通过 OpenClaw 的 cron 工具配置：

Job ID: 41893b79-62d9-447e-919a-31df098b4e0e
频率: 每周日 10:00 (Asia/Shanghai)
操作: git pull → Python 解析 → JSON 索引 → 对比变更 → 报告

2.4 同步结果

首次扫描结果：5,175 个技能，30 个分类。数据保存在 categories-index.json（约 1.5 MB），包含每个技能的名称、作者、URL 和所属分类。

三、覆盖率分析：137 个技能只覆盖了 2.6%

拿到完整列表后，第一件事是算覆盖率。我们把已安装的 137 个技能与 awesome list 逐一比对：

3.1 总体差距

3.2 缺失分类排名

3.3 我们已有的核心资产

搜索研究类（14 个）：anysearch, sn-search-academic, sn-search-code, sn-search-image, sn-search-social-cn, sn-search-social-en, sn-deep-research, sn-dimension-research, sn-research-planning, sn-research-report, sn-research-synthesis, web-search, tavily-search

飞书生态（11 个）：feishu-bitable, feishu-calendar, feishu-channel-rules, feishu-create-doc, feishu-fetch-doc, feishu-im-read, feishu-task, feishu-task-suite, feishu-troubleshoot, feishu-update-doc

浏览器与自动化（7 个）：agent-browser, agent-browser-clawdbot, browser-use, bb-browser, web-scraper, computer-use

图片视频（7 个）：agnes-image, sn-image-base, sn-image-doctor, sn-image-imitate, sn-image-resume, step-image, image-reader

Office 文档（10 个）：sn-ppt-creative, sn-ppt-doctor, sn-ppt-entry, sn-ppt-standard, sn-md-to-html-report, sn-infographic, sn-report-format-discovery

关键结论：我们的技能组合偏向"飞书办公 + 搜索研究 + 内容创作"场景，在编程、前端工程化、基础设施自动化这些方向上几乎空白。

四、高优先级缺失技能盘点

基于 clawskills.sh 热门榜和分类缺口，我们列出最该优先安装的技能：

4.1 热门榜 Top 50 中我们缺少的

注：标记"跳过"的技能因用户明确要求不安装。

五、安装实操：8 个高人气技能的落地

5.1 安装命令

# Google Workspace 全家桶 — 117.1k 安装，最高人气
cd ~/.openclaw && npx clawhub install @steipete/gog

# 自动更新所有技能
cd ~/.openclaw && npx clawhub install @maximeprades/auto-updater

# 免费 AI 模型管理 — 降本
cd ~/.openclaw && npx clawhub install @shaivpidadi/free-ride

# 长期记忆 — 六层记忆架构
cd ~/.openclaw && npx clawhub install @itsjustfred/elite-longterm-memory-1-2-3

# 凭证管理
cd ~/.openclaw && npx clawhub install @steipete/1password

# 社交媒体自动化
cd ~/.openclaw && npx clawhub install @nevo-david/postiz

# 数据分析
cd ~/.openclaw && npx clawhub install @realroc/data-analyst-pro

# AI 深度搜索
cd ~/.openclaw && npx clawhub install @ericsantos/perplexity-deep-search

5.2 安装结果

5.3 踩坑记录：clawhub install 的路径陷阱

最大的坑出现在安装路径上。

clawhub install 的安装目标取决于当前执行目录。第一次我们在 workspace 目录（/home/oklife/.openclaw/workspace-skill-factory/）执行，结果所有技能都被装进了 workspace 自带的 skills/ 下：

❌ 错误路径：
workspace-skill-factory/skills/gog
workspace-skill-factory/skills/auto-updater
...

只有 skill-factory 自己能用，其他 Agent 全部不可见！

修正方法：必须 cd ~/.openclaw 再执行安装：

✅ 正确路径：
~/.openclaw/skills/gog
~/.openclaw/skills/auto-updater
...

全局可用，所有 Agent 都能调用

其他踩坑点：

1. 同名 slug 歧义：gog 有 steipete、sindrenilsen、tionghieng 三个版本，必须用 @owner/slug 格式指定
2. openclaw skills install vs clawhub install：前者用 @owner/slug 格式，后者也支持，但纯 slug 会报 404
3. 部分 slug 不可用：data-analyst 和 perplexity 原 slug 不可用，需替换为同分类下载量最高的替代品（data-analyst-pro 和 perplexity-deep-search）

5.4 安装路径规则（写入永久配置）

这条教训后来被写入 MEMORY.md 和 TOOLS.md：

• 安装第三方技能：cd ~/.openclaw && npx clawhub install @owner/slug
• 自研技能：通过 skill_workshop 或直接写入 workspace/skills/
• 除非用户明确指定路径，否则默认装全局

六、自动化同步与持续维护

6.1 同步管道架构

每周日 10:00 (Asia/Shanghai)
    ↓
git pull --ff-only (拉取最新 awesome list)
    ↓
Python 解析 categories/*.md → categories-index.json
    ↓
对比上次 JSON → 记录新增/删除 → changes.json
    ↓
输出变更报告

6.2 数据文件

6.3 后续维护策略

1. 每周自动同步：cron 驱动，无需人工干预
2. 每月人工审核：查看新增技能，评估是否有值得安装的
3. 每季度覆盖率重算：追踪覆盖率变化趋势
4. 安全扫描：安装前检查 VirusTotal 报告（awesome list 已排除 373 个恶意技能）

七、我们完全空白的 15 个分类

以下分类在 awesome list 中有大量技能，但我们一个都没有：

这些分类中，Calendar & Scheduling、Data & Analytics、Security & Passwords 是办公场景的高频需求，值得优先补齐。

八、总结与下一步

核心收获

1. 技能再多，也要按分类缺口来选择：不能看排名装，要看自己缺什么
2. 安装路径是 clawhub 最容易踩的坑：执行目录决定安装位置，必须 cd ~/.openclaw
3. 同步脚本 + cron 是低成本维护生态 freshness 的方法：值得长期运行
4. awesome list 的过滤标准值得借鉴：安全审计、去重、低质量排除 — 这些可以直接用于我们的 QA checklist

下一步计划

• 补装 Coding Agents 和 Web Frontend 分类下的轻量工具
• 把 DevOps 类技能纳入下一轮评估
• 补齐 Calendar & Scheduling、Data & Analytics、Security & Passwords 三个办公高频分类
• 将安全扫描（VirusTotal）纳入 QA-CHECKLIST
• 参考 awesome list 的 27 分类体系优化我们的 skill-catalog taxonomy
• 尝试把技能清单和实际工作流配置打通，形成可追溯的记录

关联阅读

• [[已装可用技能]]
• [[agents-orchestrator 技能配置与安装全过程（详细版）]]

参考来源

• VoltAgent/awesome-openclaw-skills
• OpenClaw 官方文档
• clawskills.sh

–全文完–

若你有故事想讲、有困惑想聊、或是想找个人说说心里话，甚至只是吐槽发泄一下情绪，都欢迎来找我聊聊：　　　《内容已折叠，点击展开》

希望我写的每一个字，成为我自己和某个人活下去、拼下去的力量。　　　　　　　　　　　　　　　　　　　　　《内容已折叠，点击展开》

“技术终归是工具，而我们一次次认真把问题理顺，守住的其实不只是页面样式和代码输出，还有那一点不愿被混乱打败的心气，是每一个深夜仍愿点灯前行的人。”

转载请注明来自https://oklife.me。