Clh Stage

OpenClaw skill inventory tool: scans installed skills via the OpenClaw CLI, auto-classifies (10 categories/48 subcategories, user overlay), detects duplicates, exports Markdown/JSON/HTML interactive reports (static sortable HTML, no server), opt-in push of Markdown to Feishu/Notion (env-var credentials, privacy notice), usage stats, missing-dependency graphs, snapshot-diff incremental updates, batch enable/disable with auto-backup, and report-only update checks. CLI output and category labels are Chinese by design. OpenClaw 技能清单工具：经 CLI 扫描已装技能，自动分类（10 大类 48 子类，支持覆盖层）与重复检测，导出 Markdown/JSON/HTML 交互式报告（静态可排序网页，无需服务器），可选推送 Markdown 到飞书/Notion（凭据走环境变量，含隐私提示），使用统计、缺失依赖图、快照增量更新、批量启停（自动备份）、更新检查（只报告）。输出与分类标签为中文。

OpenClaw 技能统计与分类管理

增强版 OpenClaw 技能列表生成工具，采用模块化架构，支持多种输出格式和高级功能。

✨ 功能特性

核心功能

• ✅ 多格式输出：Markdown / JSON / HTML
• ✅ 分类统计：10 大类 48 子类自动归类，支持用户自定义覆盖层
• ✅ 状态图标：✅ Ready / ⚠️ NeedSetup / ❌ Disabled
• ✅ 元数据：版本号、作者、emoji、来源、主页链接
• ✅ 交互式 HTML 报告：可搜索/筛选/表头排序的静态网页（无需服务器）

高级功能

• 🔄 增量更新：对比上次运行快照，只输出变化的技能
• 🤖 自动分类：基于规则的技能自动归类
• 🔍 重复检测：名称模式 + 描述相似度（SequenceMatcher）
• 🎯 灵活过滤：按状态、关键词、分类过滤
• 📦 状态检测：基于 OpenClaw CLI 输出识别缺失依赖（含 anyBins 组）
• 🌍 描述汉化：内置词表替换常见英文描述短语，附未汉化词报告
• 📊 使用统计：state 库 skill_usage 表 / curator 双数据源，--usage
• 🔗 依赖关系图：缺失依赖边可视化，md 为 mermaid、html 为 SVG，--deps
• 🔁 批量启停：写 skills.entries.<名>.enabled，自动备份 + 写后验证
• ⬆️ 更新检查：git 轨对比远端 HEAD，ClawHub 轨提示官方命令，只报告不升级
• 📤 远端推送：显式传参方触发的 Markdown 推送为飞书云文档 / Notion 页面（--push，执行前有隐私提示）

🏗️ 架构设计

text

openclaw-skill-manager/
├── data/                      # 数据层
│   ├── openclaw.py            # OpenClaw CLI 封装与状态判定
│   ├── filesystem.py          # 文件系统扫描
│   ├── meta_reader.py         # 元数据读取
│   ├── usage.py               # 使用统计（skill_usage 表 / curator）
│   ├── deps.py                # 缺失依赖边收集与 mermaid 渲染
│   ├── updates.py             # 更新检查（git 轨 / ClawHub 轨）
│   └── toggle.py              # 批量启停（备份 + 校验 + 验证）
├── classifier/                # 分类层
│   ├── category_map.py        # 分类映射表 + 用户覆盖层
│   └── auto_classify.py       # 重复技能检测
├── exporter/                  # 导出层
│   ├── markdown.py            # Markdown 导出（含 mermaid 依赖图）
│   ├── json_exporter.py       # JSON 导出
│   ├── html_exporter.py       # HTML 交互式导出（含 SVG 依赖图）
│   ├── feishu.py              # 飞书云文档推送
│   └── notion.py              # Notion 页面推送
├── utils/                     # 工具层
│   ├── config.py              # 配置管理（可自定义输出目录）
│   ├── translator.py          # 描述汉化词表
│   ├── diff.py                # 差异对比
│   └── webclient.py           # 标准库 HTTP 客户端（白名单主机）
├── tests/                     # pytest 单测
├── generate_skill_list.py     # 主入口
└── __init__.py                # 包定义

🚀 使用方式

基本用法

bash

python3 generate_skill_list.py

指定输出格式

bash

# Markdown（默认）
python3 generate_skill_list.py -f markdown

# JSON
python3 generate_skill_list.py -f json

# HTML（交互式界面）
python3 generate_skill_list.py -f html

# 全部格式
python3 generate_skill_list.py -f all

过滤选项

bash

# 只导出已激活技能
python3 generate_skill_list.py -F activated

# 只导出未激活技能
python3 generate_skill_list.py -F not_activated

# 按关键词搜索
python3 generate_skill_list.py -s "同花顺"

# 按分类过滤
python3 generate_skill_list.py -c "金融分析工具"

高级选项

bash

# 增量更新（只输出变化）
python3 generate_skill_list.py -i

# 检测重复技能
python3 generate_skill_list.py --check-duplicates

# 自定义输出目录（不存在时自动创建）
python3 generate_skill_list.py -o /path/to/output

# 简洁模式
python3 generate_skill_list.py -q

# 使用次数列（数据源：state 库 skill_usage 表 / curator）
python3 generate_skill_list.py --usage

# 缺失依赖关系图（md=mermaid，html=SVG）
python3 generate_skill_list.py --deps

# 未汉化英文词报告（辅助扩充词表）
python3 generate_skill_list.py --i18n-report

# 更新检查（git 轨对比远端 HEAD；只报告，不自动升级）
python3 generate_skill_list.py --check-updates

# 批量启停（自动备份 openclaw.json，写后跑 CLI 验证）
python3 generate_skill_list.py --disable skill-a,skill-b
python3 generate_skill_list.py --enable skill-a

# 推送本次导出的 Markdown 到飞书 / Notion
python3 generate_skill_list.py -f all --push feishu,notion

🔐 远端推送凭据（只走环境变量）

目标	必填	可选
飞书	FEISHU_APP_ID、FEISHU_APP_SECRET	FEISHU_FOLDER_TOKEN（缺省写入云空间根目录）
Notion	NOTION_TOKEN、NOTION_PAGE_ID	—

凭据一律从环境变量读取，任何凭据字面量不得写入本仓库。

🔒 隐私与安全

• 外发提示：--push 会把技能清单（名称、描述、来源、调用量）发送到你指定的第三方服务（飞书/Notion）。仅在显式传入该参数时触发，运行前有提示；敏感/企业环境请勿使用。
• 权限范围：经 Bash 运行 python3；调用 openclaw/git CLI；写入 ~/.openclaw（快照缓存；--enable/--disable 改 openclaw.json 前自动备份）与输出目录；网络访问仅限飞书/Notion API 白名单主机（强制 HTTPS）。
• 无持久化：不注册任何 cron、开机自启或会话钩子；快照与分类覆盖层只是普通数据文件，删掉即失效。
• 语言说明：输出与分类标签为中文，面向中文用户（metadata.language: zh-CN）。

⚙️ 配置说明

输出目录配置

编辑 utils/config.py 自定义输出目录：

python

# 默认输出目录
OUTPUT_DIR = os.path.join(USER_PROFILE, 'openclaw_out')

# 修改为其他目录
# OUTPUT_DIR = '/your/custom/path'

或通过命令行参数临时指定：

bash

python3 generate_skill_list.py -o ~/my_skills

自定义分类覆盖层

新建 ~/.openclaw/skill_categories.json（优先级高于内置映射表）：

json

{
  "my-skill": ["开发工具", "编码与开发"]
}

📊 输出示例

Markdown 表格

text

| 序号 | 状态 | 技能名称 | 版本 | 来源 | 调用量 | 描述 |
|------|------|----------|------|------|------|------|
| 1 | ✅ | [🔮 问财选A股](https://...) | 1.0.0 | workspace | 12 | A股智能选股 |
| 2 | ⚠️ | futuapi | 2.1.0 | bundled | - | 富途行情API |

HTML 界面特性

• 🔍 实时搜索技能名称和描述
• 📂 按分类过滤、按状态筛选
• 🔃 表头点击排序（名称/版本/来源/调用量/分类）
• 🔗 缺失依赖关系 SVG 二部图
• 📈 实时统计面板
• 🎨 响应式布局，手机和电脑都可正常使用

📝 注意事项

1. 首次运行会自动创建输出目录与缓存目录 ~/.openclaw/cache/skill_list/
2. 增量更新（-i）依赖上次运行保存的快照；--no-snapshot 可跳过快照保存
3. 分类规则基于作者个人技能库定制，第三方技能大概率落入「其他」——用 ~/.openclaw/skill_categories.json 覆盖层或修改 classifier/category_map.py 增补
4. 批量启停会修改 ~/.openclaw/openclaw.json，每次改动前自动生成带时间戳的备份
5. 使用统计依赖 OpenClaw 的 skill_usage 记录，暂无数据时输出占位符 -
6. 本技能不注册 cron/自启动；快照与覆盖层（skill_categories.json）为普通数据文件
7. 输出与分类标签为中文，面向中文用户

🔮 后续规划

• 支持导出到飞书文档（v1.2.0 --push feishu）

• 支持导出到 Notion（v1.2.0 --push notion）

• 技能使用频率统计（v1.2.0 --usage）

• 技能依赖关系图（v1.2.0 --deps）

• 批量启用/禁用技能（v1.2.0 --enable / --disable）

• 自动更新检查（v1.2.0 --check-updates）

• 技能使用趋势图（按周聚合）

• 更多远端文档目标（Obsidian / 语雀）

👤 作者

kuntao2011（GitHub @kuntao2011）

📄 许可证

MIT License