---
name: openclaw-skill-manager
description: "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（凭据走环境变量，含隐私提示），使用统计、缺失依赖图、快照增量更新、批量启停（自动备份）、更新检查（只报告）。输出与分类标签为中文。"
license: MIT
allowed-tools:
  - Bash
metadata:
  version: "1.2.6"
  author: kuntao2011
  language: zh-CN
---

# 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`，执行前有隐私提示）

## 🏗️ 架构设计

```
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）；`--check-updates` 会用 `git ls-remote` 访问技能安装记录中登记的 git 远端地址。
- **无持久化**：不注册任何 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": ["开发工具", "编码与开发"]
}
```

## 📊 输出示例

> 节选自真实运行输出（2026-09-25，本机 64 个技能：31 ✅ / 5 ⚠️ / 28 ❌）。长描述自动压平换行并在 120 字处截断，完整内容见 JSON/HTML。

```
| 序号 | 状态 | 技能名称 | 版本 | 来源 | 调用量 | 描述 |
|------|------|----------|------|------|------|------|
| 1 | ✅ | [☔ weather](https://wttr.in/:help) |  | bundled | - | Current weather and forecasts with web_fetch, falling back to wttr.in curl for locations, rain, temperature, travel plan… |
| 2 | ✅ | kkk-ocr-local |  | agents-skills-personal | - | 本地图片预处理（纯 CPU）+ OCR 后备。主用途：①图片朝向检测与自动旋转 （auto_orient_ocr.py — 横放/倒置的文档照片先转正再送 MCP/云端识别，防旋转幻觉） ②空白裁剪（crop_whitespace.py —… |
| 3 | ❌ | [🔐 1password](https://developer.1password.com/docs/cli/get-started/) |  | bundled | - | 设置和使用 1Password CLI for sign-in, desktop integration, and reading or injecting secrets. |
```

### 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. 输出与分类标签为中文，面向中文用户

## 🔮 后续规划

- [x] 支持导出到飞书文档（v1.2.0 `--push feishu`）
- [x] 支持导出到 Notion（v1.2.0 `--push notion`）
- [x] 技能使用频率统计（v1.2.0 `--usage`）
- [x] 技能依赖关系图（v1.2.0 `--deps`）
- [x] 批量启用/禁用技能（v1.2.0 `--enable` / `--disable`）
- [x] 自动更新检查（v1.2.0 `--check-updates`）

- [ ] 技能使用趋势图（按周聚合）
- [ ] 更多远端文档目标（Obsidian / 语雀）

## 👤 作者

**kuntao2011**（[GitHub @kuntao2011](https://github.com/kuntao2011)）

## 📄 许可证

MIT License