前言¶

在 skillhub.cn 上架技能，往往要同时处理几件事：发布目录里不能带真实 API Key、CLI 在 Windows 与 WSL 下行为不一致、路径格式和登录方式搞错就会反复 401。官方文档分散在网页与安装说明里，Agent 若缺少一份按步骤执行的笔记，容易漏检或把运行环境路径写进公开包。

下面介绍社区 Skill「SkillHub.cn 技能发布指南（OpenClaw 实战版）」：它把在 skillhub.cn 一键发布技能的完整流程写进 SKILL.md，其他 Agent 按文档执行即可，作者声明无需再查其他资料。本文依据 SkillHub 页面元数据与该 Skill 正文整理，供选型与安装参考。

这是什么¶

一句话定位：面向 skillhub.cn 的技能发布 SOP（标准操作步骤）Skill，基于通用 SKILL.md 格式，强调「发布包」与「运行包」分离。

• 坐标：@user_310a65be/openclaw-skillhub-publish-guide
• 版本：2.0.0（来源：community）
• 分类：knowledge-management
• 发布者：user_310a65be
• 标签：requires_api_key=true（发布与 CLI 登录需要 SkillHub API Key / Token）
• 简介：在 skillhub.cn 一键发布技能的完整操作笔记，其他 Agent 照着做即可，无需查阅任何其他资料
• SkillHub 页面：https://www.skillhub.cn/skills/user_310a65be/openclaw-skillhub-publish-guide
• 资源地址：https://api.skillhub.cn/user_310a65be/openclaw-skillhub-publish-guide

文档内写明实战验证过 deepseek-bridge、skill-sedimentation 等发布案例（含 skillId），主体场景为 OpenClaw 工作区 + Windows 下通过 WSL 调用 bash 脚本版 CLI。

核心功能¶

以下内容均来自该 Skill 正文，只列可核对的能力点。

发布包与运行包分离¶

原则：Token 从 credential vault 运行时读取，不得写入发布包；公开平台上传的 Key 无法删除。

Windows 下 CLI 选型说明¶

Skill 对比 npm 全局安装（@astron-team/skillhub / clawhub，使用 --token）与 WSL bash 脚本安装（curl -fsSL https://skillhub.cn/install/install.sh | bash -s -- --cli-only，使用 --key）。文档结论：Windows 发布应使用 WSL 脚本版 CLI，npm 版在 Windows 上易出现认证 401。

端到端发布流程¶

文档按步骤覆盖：

1. WSL 内安装 CLI（仅首次）
2. 在 https://skillhub.cn/dashboard/keys 创建 API key（格式 skh_xxx，仅显示一次）
3. skillhub login --key <Token>（示例要求通过 wsl 调用）
4. 整理发布包目录（SKILL.md、核心脚本、可选 README.md）及 Frontmatter 模板
5. 代码中 Key 用环境变量占位（Python / JavaScript 示例）
6. 发布前 5 项自检清单（无硬编码 Key、无真实路径泄露等）
7. skillhub publish "<WSL 路径>" --changelog "..."（路径需为 /mnt/d/... 形式）
8. 浏览器或 CLI 验证；可选通过 sessions_send 通知 main Agent

常见错误对照表¶

Skill 内置错误信息、原因与处理（如 401 认证、未知 flag、409 slug 冲突、误传 skill.zip、路径格式等），便于 Agent 按表排查。

安装与启用¶

SkillHub 通用安装说明见 https://skillhub.cn/install/skillhub.md。先做 CLI 检查，再装到当前 Agent 的 skills 目录（必须用 --dir，否则默认 ./skills/ 可能不被识别）。

检查 / 安装 SkillHub CLI¶

command -v skillhub && skillhub --version

未安装时（完整安装或仅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装本 Skill¶

网页给出的安装提示为：按 skillhub.md 安装坐标 @user_310a65be/openclaw-skillhub-publish-guide。

skillhub install @user_310a65be/openclaw-skillhub-publish-guide --dir <当前 Agent 的 skills 目录>

常用客户端 skills 目录（摘自官方安装文档）：

• Claude Code：~/.claude/skills/
• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

OpenClaw 及其变体使用各自工作区下的 skills 目录；以你当前环境为准。

安装后让 Agent 读取该目录下的 SKILL.md 即可加载发布指南。发布操作本身仍需 SkillHub API Key，并在 WSL 内完成登录与 publish（见下文典型用法）。

典型用法¶

1. 登录（Skill 内 Windows + WSL 示例）¶

在 SkillHub 控制台创建 Token 后，在 WSL 中执行（路径以你机器上 which skillhub 为准）：

wsl /home/huawei/.local/bin/skillhub login --key <你的Token>

成功时示例输出包含当前账号 @user_310a65be。

2. 准备发布包 Frontmatter¶

---
slug: <slug>
displayName: <技能显示名>
version: 1.0.0
summary: <一句话描述>
license: MIT
---

3. 发布命令¶

路径必须为 WSL 可识别的 Unix 风格（文档示例）：

wsl /home/huawei/.local/bin/skillhub publish "/mnt/d/openclaw-data/workspace/skills/<slug>" --changelog "首次发布 v1.0.0"

若提示版本已存在，需先提高 SKILL.md 中的 version 再重试。

4. 验证¶

浏览器打开文档给出的技能页模式，或使用带 registry 的搜索命令（正文示例使用 https://skill.xfyun.cn/api/v1/skills.json）。

经过上面的步骤，Agent 可把「整理包 → 自检 → publish → 验证」串成固定流水线，而不是每次重新拼命令。

适用场景与注意¶

适合谁

• 在 OpenClaw 工作流里维护技能、需要反复向 skillhub.cn 发布版本的开发者或 Agent
• 希望把发布 checklist、CLI 坑位、错误表固化成 Skill，交给其他 Agent 执行的场景

限制与注意

• 文档以 Windows + WSL 为主线；Linux/macOS 用户可借鉴流程，但需自行替换 wsl 前缀与路径示例（如 /mnt/d/...、示例中的固定 home 路径）。
• 标签 requires_api_key=true：发布前必须在控制台创建并妥善保存 Token；勿将 Token 写入上传的发布包。
• Skill 内 credential vault、OpenClaw 会话通知等路径与 API 与具体部署绑定，迁移环境时要改为你自己的 vault 与 sessionKey。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载 1327 次，安装计数为 0；数据以平台展示为准，会随时间变化。

结尾¶

若你的痛点是「公开上架技能时怕泄密、怕 CLI 认证失败、怕路径格式不对」，这份 OpenClaw 实战版 Skill 把原则、步骤和排错表写进一份 SKILL.md，适合作为团队内 Agent 的发布手册。安装坐标 @user_310a65be/openclaw-skillhub-publish-guide，详情见 https://www.skillhub.cn/skills/user_310a65be/openclaw-skillhub-publish-guide 。