核心用法
ClawHub CLI Assistant 是一款面向 OpenClaw 生态开发者的纯文档型技能，专注于 ClawHub CLI 的全生命周期管理。该技能不提供可执行代码，而是以结构化的命令模板和工作流指南为核心，帮助用户完成技能的搜索、安装、更新、发布、同步及故障排查等操作。
核心用法涵盖六大场景：
1. 技能发现与获取：通过 clawhub search 搜索技能，使用 clawhub install 安装指定版本或强制重装；
2. 技能发布：使用 clawhub publish 配合 --slug、--name、--version、--changelog、--tags 等参数完成版本化发布；
3. 版本迭代：发布新版本时仅需更新版本号与变更日志，支持 --tags latest 标记最新版本；
4. 批量维护：clawhub update --all 批量更新已安装技能，clawhub sync --all 同步本地技能与注册表状态；
5. 身份认证：clawhub login、clawhub whoami、clawhub logout 管理会话状态；
6. 故障诊断：针对 SKILL.md 缺失、工作目录错误、本地文件与发布版本不一致等常见问题提供排查步骤。
技能输出遵循固定模板：命令本身、功能说明、前置条件、下一步操作，确保用户能够直接复制执行。
显著优点
1. 命令精准零偏差：所有命令均来自官方文档，拒绝臆造参数，降低用户因命令错误导致的环境损坏风险；
2. 场景覆盖完整：从首次发布到持续集成，从单技能维护到批量运维，覆盖开发者 90% 以上的日常 CLI 使用场景；
3. 输出结构化：采用标准四段式模板（Command/What It Does/Notes/Next Step），适合快速查阅和团队协作；
4. 零代码攻击面：纯 Markdown 文档型技能，无脚本执行、无依赖引入、无网络调用，从根本上杜绝代码注入和供应链攻击；
5. 平台原生适配：明确标注支持 Linux、macOS、Windows 三大平台，兼容 OpenClaw 工作区机制，自动识别 ./skills 目录或 CLAWHUB_WORKDIR 环境变量覆盖。
潜在缺点与局限性
1. 无智能推理能力：仅提供静态命令模板，无法根据用户实际项目结构自动生成最优参数组合，复杂场景仍需人工判断；
2. 版本锁定模糊：文档未明确说明 Skill 支持的 ClawHub CLI 最低/最高版本，跨版本兼容性存在不确定性；
3. 故障排查深度有限：针对网络超时、权限拒绝、注册表异常等运行时错误，仅提供基础检查步骤，缺乏深度诊断建议；
4. 外部链接依赖：文档引用 docs.openclaw.ai 和 clawhub.ai 作为参考，若官方域名变更或证书过期，可能导致用户访问受阻；
5. 无交互式向导：对于 CLI 新手，纯文本模板的学习曲线仍较陡峭，缺乏渐进式引导或可视化配置界面。
适合的目标群体
- Skill 作者：需要频繁发布、迭代、版本管理技能的个人开发者或团队；
- ClawHub 发布者：负责维护组织内私有注册表或公开技能仓库的运维人员；
- OpenClaw 终端用户：管理本地技能安装、更新、同步的普通开发者；
- CI/CD 集成工程师：需要将 ClawHub CLI 嵌入自动化流水线的 DevOps 从业者；
- CLI 工作流故障排查者：遇到身份认证、工作目录、版本冲突等问题的技术支持人员。
使用风险
1. 外部链接失效风险：文档中引用的官方文档链接可能因平台迁移或域名调整而失效，建议用户访问前二次确认 URL；
2. 版本兼容风险：ClawHub CLI 快速迭代可能导致命令参数变更，建议结合官方最新文档交叉验证；
3. 工作目录误操作风险：clawhub publish . 默认以当前目录为技能根目录，若执行位置错误可能发布非目标项目，建议始终使用 --workdir 显式指定；
4. 批量更新中断风险：clawhub update --all 和 clawhub sync --all 在技能数量庞大时可能因网络波动中断，建议分批次或配合 --dry-run 预演；
5. 认证状态过期风险：长期未使用可能导致登录凭据失效，关键操作前建议优先执行 clawhub whoami 验证会话有效性。