用途
Skill 配置检索器用于扫描本地所有 skills,检测需要配置的 API keys、tokens、secrets 等,生成配置需求清单和操作指南。当用户需要检查 skills 配置、了解哪些 skill 需要配置、获取 skill 配置清单、检查 API key 需求或进行配置需求扫描时,可以使用此技能。
主要能力
- 扫描所有本地 skills:检查 ~/.openclaw/skills 和 ~/clawd/skills 目录。
- 检测配置需求:识别需要 API keys、tokens、secrets、OAuth 等的 skills。
- 分类整理:按配置类型分类(API key、OAuth、环境变量等)。
- 生成报告:输出清晰的配置清单和操作步骤。
报告包含以下部分:
- ✅ 已配置的 Skills:列出已经有 API key 或 token 的 skills。
- ⚠️ 需要配置的 Skills:列出缺少配置的 skills,包括 Skill 名称、需要的配置项、如何获取配置、配置步骤。
- 🔐 需要 OAuth 授权的 Skills:列出需要 OAuth 授权的 skills,包括 Skill 名称、授权方式、授权链接。
- 🆓 无需配置的 Skills:列出不需要任何配置即可使用的 skills。
使用方式
快速扫描:
python3 ~/clawd/skills/skill-config-checker/scripts/check_configs.py
详细报告:
python3 ~/clawd/skills/skill-config-checker/scripts/check_configs.py --verbose
只检查特定 agent:
python3 ~/clawd/skills/skill-config-checker/scripts/check_configs.py --agent code
脚本位置:
~/clawd/skills/skill-config-checker/
├── SKILL.md # 本文件
└── scripts/
└── check_configs.py # 扫描脚本
配置类型
| 类型 | 示例 | 存储位置 |
|---|---|---|
| API Key | OPENAI_API_KEY | 环境变量 / pass |
| OAuth Token | Google OAuth | Rube MCP / credentials.json |
| App Credentials | app_id + app_secret | pass show api/<service> |
| Environment Variables | GEMINI_API_KEY | ~/.bashrc / .env |
常见配置模式
- Rube MCP(推荐):适用于 Twitter、Gmail、Google Calendar 等。无需 API key,只需一次性 OAuth 授权,授权链接由工具提供。
- Pass Store(推荐):适用于所有 API keys。通过
pass show api/<service>获取,安全存储,自动轮换。 - 环境变量:适用于模型 API keys。例如
export GEMINI_API_KEY="xxx",添加到 ~/.bashrc 持久化。
触发词
- "检查 skill 配置"
- "哪些 skill 需要配置"
- "skill 配置清单"
- "API key 需求"
- "配置需求扫描"
- "检查 skills 配置需求"
示例输出
📋 Skills 配置需求总览
✅ 已配置的 Skills (12)
- tavily (data, research)
- firecrawl (data)
- feishu-automation (多个)
⚠️ 需要配置的 Skills (5)
1. deep-research (research)
- 需要: GEMINI_API_KEY
- 获取: https://aistudio.google.com/
- 配置: export GEMINI_API_KEY="your-key"
🔐 需要 OAuth 授权的 Skills (2)
- twitter-automation (market)
- 授权: Rube MCP → Twitter OAuth
- 链接: [待生成]
🆓 无需配置的 Skills (8)
- multi-search-engine (research)
- github-automation (code)
适用场景
- 需要快速了解本地所有 skills 的配置状态。
- 需要找出缺少 API key 或 token 的 skills 并获取配置指引。
- 需要识别需要 OAuth 授权的 skills。
- 需要生成配置需求清单以便批量处理。
限制
- 仅扫描 ~/.openclaw/skills 和 ~/clawd/skills 目录。
- 需要 Python 3 环境运行脚本。
- 具体支持的 skill 范围、检测准确率、是否支持自定义扫描路径等暂未提供。
- 更新日志:2026-03-06 v1.0.0 初始版本。