ClawHub 管理技能

简化 ClawHub 技能的发布、删除、查询和搜索操作。

功能特性

• - ✅ 发布技能 - 将本地技能发布到 ClawHub
• ✅ 删除技能 - 从 ClawHub 删除已发布的技能
• ✅ 查询技能 - 查看技能的详细信息和统计数据
• ✅ 搜索技能 - 在 ClawHub 上搜索技能
• ✅ 列出技能 - 列出本地已安装的技能

快速开始

查询技能信息

bash

查询技能详情

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

搜索技能（关键词）

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

列出所有已安装的技能

bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/list.sh

发布技能

bash

发布技能（指定版本）

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

删除技能

bash /root/.openclaw/workspace/skills/clawhub-manager/scripts/delete.sh your-slug

使用场景

• - 📦 批量管理 - 一次性管理多个技能的发布和删除
• 📊 数据统计 - 查看技能的下载量、安装量等统计数据
• 🔍 技能发现 - 搜索和发现有用的技能
• 🔄 版本管理 - 轻松发布新版本和更新技能

技能统计输出示例

json
{
name: Feishu Voice,
slug: feishu-voice,
downloads: 19,
installs: 1,
stars: 0,
versions: 2,
updated: 2026-02-21 16:45
}

🔒 安全注意事项

发布技能前，请确保：

1. 1. ✅ 不在技能文件中硬编码任何密钥

- 所有 API Key、Secret、Token 必须使用环境变量 - 使用占位符（如 YOURAPIKEY_HERE）

1. 2. ✅ 敏感信息存储在环境变量中

bash # ✅ 正确：从环境变量读取 APIKEY=${APIKEY}

# ❌ 错误：硬编码密钥
APIKEY=tvly-YOURREALKEYHERE

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

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

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

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

安全扫描功能

publish.sh 内置安全扫描，会自动检测：

• - 🔑 API 密钥: Tavily (tvly-), OpenAI (sk-), GitHub (ghp, gho, ghu, ghs), Perplexity (pplx-), Exa (exa)
• 🔐 App Secret: 检测 appsecret=, app-secret= 等模式
• 🎫 Access Token: 检测 accesstoken=, access-token= 等模式
• 📁 敏感文件: .env, .secrets, .key, .pem
• 🔧 环境变量硬编码: 检测 export APIKEY=, export SECRET= 等

手动安全检查

发布前也可以手动运行检查：

bash

检查常见密钥格式

grep -r tvly-\|sk-\|ghp\|pplx-\|exa \
--include=.md --include=.sh \
--include=.py --include=.js

检查通用密钥模式

grep -ri api[_-]?key\s*[=:] \ --include=.sh --include=.py

如果发现密钥泄露

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

跳过安全扫描（不推荐）

bash

⚠️ 仅在测试环境使用

bash publish.sh /path/to/skill --version 1.0.0 --skip-security

注意事项

1. 1. 权限要求

- 发布和删除技能需要登录 ClawHub - 只能删除自己发布的技能

1. 2. 版本号规范

- 遵循语义化版本（Semantic Versioning） - 格式：MAJOR.MINOR.PATCH（如 1.0.0）

1. 3. slug 命名

- 只能包含小写字母、数字和连字符 - 一旦发布不能修改

1. 4. 速率限制

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

作者

franklu0819-lang

许可证

MIT