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"
}

🔒 安全注意事项

发布技能前，请确保：

1. ✅ 不在技能文件中硬编码任何密钥
2. 所有 API Key、Secret、Token 必须使用环境变量

3. 使用占位符（如 YOUR_API_KEY_HERE）

4. ✅ 敏感信息存储在环境变量中 ```bash # ✅ 正确：从环境变量读取 API_KEY="${API_KEY}"

# ❌ 错误：硬编码密钥 API_KEY="tvly-YOUR_REAL_KEY_HERE" ```

1. ✅ .env 文件已添加到 .gitignore

2. 防止敏感配置被提交到版本控制

3. ✅ 发布前会自动进行安全扫描

4. 脚本会自动检测常见密钥泄露
5. 发现问题会阻止发布并提示修复

安全扫描功能

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[_-]?keys*[=:]" 
  --include="*.sh" --include="*.py"

如果发现密钥泄露

1. ⚠️ 立即撤销已泄露的密钥
2. 🔁 重新生成新的密钥
3. 📝 替换为占位符（如 YOUR_API_KEY_HERE）
4. 🧹 从 Git 历史中清除（如果已提交）

跳过安全扫描（不推荐）

# ⚠️ 仅在测试环境使用
bash publish.sh /path/to/skill --version 1.0.0 --skip-security

注意事项

1. 权限要求
2. 发布和删除技能需要登录 ClawHub

3. 只能删除自己发布的技能

4. 版本号规范

5. 遵循语义化版本（Semantic Versioning）

6. 格式：MAJOR.MINOR.PATCH（如 1.0.0）

7. slug 命名

8. 只能包含小写字母、数字和连字符

9. 一旦发布不能修改

10. 速率限制

11. ClawHub 可能有 API 速率限制
12. 大量操作时建议添加延迟

作者

franklu0819-lang

许可证

MIT