- name
- all-skill-list
- description
- 本地扩展技能目录 - 聚合所有 OpenClaw 本地技能，支持列表查询、描述提取、缓存加速、差异对比、自动更新技能清单
- metadata
- {"clawbot":{"emoji":"📚","requires":{},"install":[{"id":"local","kind":"dir","path":"/home/node/.openclaw/workspace/skills","label":"本地技能目录"}]}}
📚 Skill-List - 本地扩展技能目录（智能缓存版）
🦀️ 功能介绍
本技能是 OpenClaw 本地技能的聚合管理工具，核心能力：
- ✅ 扫描
~/.openclaw/workspace/skills目录下所有本地技能 - ✅ 自动提取每个技能的名称、功能描述、存储路径
- ✅ 基于 Pickle 缓存加速查询，避免重复全量扫描
- ✅ 智能对比目录变化：仅当技能增/删时更新缓存，无变化直接返回缓存
- ✅ 支持多种输出格式：简单列表、半详细、全详细、JSON、Markdown
- ✅ 支持多种信息详细级别：simple（简单）、half（半详细）、all（完整）
🎯 使用方式
1. 查看所有技能列表（自动使用缓存）
bash python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py -V simple
2. 强制刷新缓存（无视缓存，重新扫描）
‵‵·bash python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py --force
3. 查看完整技能信息
#显示简单信息
python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py -V simple#显示完整SKILL.md内容
python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py -V all#显示一半信息
python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py -V half4. 导出格式
bash 导出为JSON格式
python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py --json
导出为Markdown格式
python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py --md
5. 组合使用
bash 强制刷新并显示完整信息
python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py -f -V all
显示完整信息并导出为JSON
python3 ~/.openclaw/workspace/skills/all-skill-list/scripts/skill-list.py -V all --json
📊 显示级别说明
| 级别 | 参数 | 显示内容 | 示例 |
|---|---|---|---|
| 简单 | -V simple | 技能名称、状态图标 | 1. ✅ skill-name |
| 半详细 | -V half | 名称、状态、一半描述、路径 | 显示描述前200字符 |
| 完整 | -V all | 名称、状态、完整描述、路径 | 显示完整SKILL.md内容 |
📝 核心工作流程
OpenClaw 调用本技能时，执行以下逻辑：
- 读取本地技能根目录：
~/.openclaw/workspace/skills - 检查缓存文件：
~/.openclaw/workspace/skills/all-skill-list/scripts/skills_cache.pickle - 对比缓存中记录的技能目录列表与当前实际目录
- 目录无变化 → 直接读取并返回缓存内容 - 目录有变化 → 重新扫描所有技能 → 更新缓存 → 返回新结果
- 支持通过
--force参数跳过对比，强制刷新缓存 - 支持通过
-V参数控制输出详细程度
📂 缓存与导出文件说明
| 文件 | 格式 | 用途 | 路径 |
|---|---|---|---|
skills_cache.pickle | Pickle | 主缓存文件，加快查询速度 | all-skill-list/scripts/ |
skills_export.json | JSON | 导出数据，供其他程序使用 | all-skill-list/scripts/ |
all_skills.md | Markdown | 技能总览文档，包含所有技能描述 | all-skill-list/scripts/ |
🔧 完整命令行参数
基本参数
用法: python skill-list.py [选项]
选项:
-f, --force 强制重新扫描
-v, --verbose 显示详细信息
-V 级别 显示级别: all(全部)/half(一半)/simple(简单)
--json 导出为JSON格式
--md 导出为Markdown格式
--no-repair 关闭自动修复功能
--debug 显示调试信息
-h, --help 显示帮助
自动修复功能:
当技能的描述为空、路径不存在或信息不完整时，会自动尝试重新获取
默认开启，可使用 --no-repair 关闭示例: python3 skill-list.py # 简单列表 python3 skill-list.py -V all # 显示完整信息 python3 skill-list.py --no-repair # 关闭自动修复 python3 skill-list.py -f -V all # 强制刷新并显示全部
🎪 使用示例
示例1：快速查看所有技能
bash python3 skill-list.py
输出：
🔍 扫描OpenClaw技能... 📊 OpenClaw技能列表 (共 8 个) 1. ✅ skill-1 2. ✅ skill-2 3. ❌ skill-3 📈 统计: 6/8 个技能有SKILL.md文件
示例2：查看技能完整描述
bash python3 skill-list.py -V all
输出每个技能的完整SKILL.md内容，便于了解技能详情。
示例3：导出技能库文档
bash python3 skill-list.py --md
生成包含所有技能完整描述的Markdown文档，便于分享和查阅。
示例4：与其他系统集成
bash python3 skill-list.py --json > skills.json
导出为JSON格式，便于被其他程序或工具读取。
📁 目录结构
~/.openclaw/workspace/skills/ ├── skill-1/ # 技能1 │ └── SKILL.md ├── skill-2/ # 技能2 │ └── SKILL.md └── all-skill-list/ # 当前技能 ├── SKILL.md # 本文件 └── scripts/ ├── skill-list.py # 主脚本 ├── skills_cache.pickle # 缓存文件 ├── skills_export.json # JSON导出文件 └── all_skills.md # Markdown导出文件
🔄 缓存机制
- 智能检测：通过对比技能目录列表变化，决定是否更新缓存
- 增量更新：只有技能增删时才重新扫描，提高效率
- 手动刷新：支持
--force参数强制重新扫描 - 缓存格式：使用Pickle格式存储，同时支持JSON导出
📅 更新日志
| 日期 | 版本 | 说明 |
|---|---|---|
| 2026-03-13 | v1.0 | 初版：基础技能列表查询功能 |
| 新增缓存加速、目录差异对比、JSON输出 | ||
| 增加-V参数控制显示级别，支持all/half/simple三种模式 | ||
| 添加--json和--md导出功能，完善帮助文档 |
🆕 新功能亮点
- 灵活的信息显示：通过
-V参数控制输出详细程度 - 多格式导出：支持JSON和Markdown导出
- 智能缓存：自动检测变化，减少不必要的扫描
- 完整文档：可生成包含所有技能的详细文档
- 易于集成：JSON格式便于与其他工具集成
注意：本技能会自动排除自身目录（all-skill-list），避免递归扫描问题。所有路径均基于脚本所在位置动态计算，确保在不同环境下都能正常工作。
最后更新：2026-03-20