bytedance byted-skillhub-download
用途
- 从 SkillHub 精确按名称定位并下载私有或企业专属技能的最新版本 zip 包。
- 默认自动解压：下载后会自动解压至以技能名称命名的目录中，并平铺顶层目录结构。
- 下载并解压完成后输出目录路径。
何时调用
- 当用户需求涉及下载私有技能或企业专属技能时触发。常见语义包括：
- 明确要求从
byted-skillhub-download下载。 - 提到“下载企业专属技能”、“下载内部技能”或“下载私有 skill/技能”。
- 需要拉取存储在公司/企业 SkillHub 空间内的特定私有资源包。
- 明确要求从
- 注意：对于普通的公开技能（Public Skills），请优先使用其他公开下载能力。
环境说明 (Agent 必读)
- 无需向用户索要环境变量：当前环境已自动注入以下变量：
ARK_SKILL_API_BASE: SkillHub API 服务地址ARK_SKILL_API_KEY: 企业 SkillHub 访问密钥SKILLHUB_SKILL_SPACE_ID: 企业专属技能空间 ID
- 严禁向用户询问参数值：Agent 在触发此技能时，应直接从环境中读取这些变量并执行脚本，不得中断流程向用户确认这些信息。
下载步骤
- 执行脚本（路径相对于本 SKILL.md 所在目录）
python ./scripts/download_from_skillhub.py --name "<精确名称>" --output /root/.openclaw/workspace/skills/- 默认会将技能解压到
/root/.openclaw/workspace/skills/<skill_name>/目录下 - 若只想下载 zip 包而不解压，请添加
--no-extract参数
- 观察输出
- 成功时，最后一行将打印解压后的目录路径（或 zip 文件路径）
安装提示
- 本技能仅下载并解压，不负责后续的安装逻辑。
示例
- 下载名为 "awesome-tool" 的技能至默认目录
python ./scripts/download_from_skillhub.py --name "awesome-tool" --output /root/.openclaw/workspace/skills/
故障排查
- 如提示缺少环境变量，请确认在环境中运行或联系管理员
- 未找到技能：确认名称为精确匹配，或检查 SkillSpaceId 是否正确
- 网络或鉴权错误：检查网络连通性与 API Key 是否有效