ClawHub 管理技能
简化 ClawHub 技能的发布、删除、查询和搜索操作。
功能特性
- ✅ 发布技能 - 将本地技能发布到 ClawHub
- ✅ 删除技能 - 从 ClawHub 删除已发布的技能
- ✅ 查询技能 - 查看技能的详细信息和统计数据
- ✅ 搜索技能 - 在 ClawHub 上搜索技能
- ✅ 列出技能 - 列出本地已安装的技能
快速开始
查询技能信息
# 查询技能详情
bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/inspect.sh feishu-voice
# 查询技能统计（JSON 格式）
bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/inspect.sh feishu-voice --json搜索技能
# 搜索技能（关键词）
bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/search.sh "feishu"
# 搜索技能（限制结果数量）
bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/search.sh "pdf" --limit 10列出本地技能
# 列出所有已安装的技能
bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/list.sh发布技能
# 发布技能（指定版本）
bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/publish.sh \
/root/.openclaw/workspace/skills/your-skill \
--version 1.0.0 \
--changelog "首次发布"
# 发布技能（指定 slug 和名称）
bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/publish.sh \
/root/.openclaw/workspace/skills/your-skill \
--slug your-slug \
--name "Your Skill Name" \
--version 1.0.0删除技能
# 删除技能
bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/delete.sh your-slug使用场景
- 📦 批量管理 - 一次性管理多个技能的发布和删除
- 📊 数据统计 - 查看技能的下载量、安装量等统计数据
- 🔍 技能发现 - 搜索和发现有用的技能
- 🔄 版本管理 - 轻松发布新版本和更新技能
技能统计输出示例
{
"name": "Feishu Voice",
"slug": "feishu-voice",
"downloads": 19,
"installs": 1,
"stars": 0,
"versions": 2,
"updated": "2026-02-21 16:45"
}🔒 安全注意事项
发布技能前，请确保：
- ✅ 不在技能文件中硬编码任何密钥
- 所有 API Key、Secret、Token 必须使用环境变量 - 使用占位符（如 YOUR_API_KEY_HERE）
- ✅ 敏感信息存储在环境变量中
# ✅ 正确：从环境变量读取 API_KEY="${API_KEY}" # ❌ 错误：硬编码密钥 API_KEY="tvly-YOUR_REAL_KEY_HERE" - ✅ .env 文件已添加到.gitignore
- 防止敏感配置被提交到版本控制
- ✅ 发布前会自动进行安全扫描
- 脚本会自动检测常见密钥泄露 - 发现问题会阻止发布并提示修复
安全扫描功能
publish.sh 内置安全扫描，会自动检测：
- 🔑 API 密钥: Tavily (tvly-), OpenAI (sk-), GitHub (ghp_, gho_, ghu_, ghs_), Perplexity (pplx-), Exa (exa_)
- 🔐 App Secret: 检测
app_secret=,app-secret=等模式 - 🎫 Access Token: 检测
access_token=,access-token=等模式 - 📁 敏感文件:.env,.secrets, *.key, *.pem
- 🔧 环境变量硬编码: 检测
export API_KEY=,export SECRET=等
手动安全检查
发布前也可以手动运行检查：
# 检查常见密钥格式
grep -r "tvly-\|sk-\|ghp_\|pplx-\|exa_" \
--include="*.md" --include="*.sh" \
--include="*.py" --include="*.js"
# 检查通用密钥模式
grep -ri "api[_-]?key\s*[=:]" \
--include="*.sh" --include="*.py"如果发现密钥泄露
- ⚠️ 立即撤销已泄露的密钥
- 🔁 重新生成新的密钥
- 📝 替换为占位符（如
YOUR_API_KEY_HERE） - 🧹 从 Git 历史中清除（如果已提交）
跳过安全扫描（不推荐）
# ⚠️ 仅在测试环境使用
bash publish.sh /path/to/skill --version 1.0.0 --skip-security注意事项
- 权限要求
- 发布和删除技能需要登录 ClawHub - 只能删除自己发布的技能
- 版本号规范
- 遵循语义化版本（Semantic Versioning） - 格式：MAJOR.MINOR.PATCH（如 1.0.0）
- slug 命名
- 只能包含小写字母、数字和连字符 - 一旦发布不能修改
- 速率限制
- ClawHub 可能有 API 速率限制 - 大量操作时建议添加延迟
作者
franklu0819-lang
许可证
MIT