ClawHub 报错很多时候不是 Skill 本身坏了，而是登录状态、工作目录、锁文件或网络访问问题。先查分发链路，再查 Skill 内容。
本章完成标准
你读完后应该能独立处理 ClawHub 的登录、搜索、安装、同步和更新问题。
步骤一：先检查 CLI 登录与网络
clawhub whoami
clawhub search "calendar"如果这里失败，先处理登录 token、网络代理或 DNS，再继续后续步骤。
步骤二：确认当前 workdir 与锁文件
.clawhub/lock.json记录了当前目录安装状态。clawhub sync默认按当前目录同步，不是全局目录。- 多项目并行时，最容易因为目录切换导致误判。
步骤三：执行安装与同步验证
clawhub sync
clawhub install <skill-slug>
openclaw skills list
openclaw skills list --eligible如果安装成功但不 eligible，转去检查依赖与配置门槛。
步骤四：更新失败时的排查顺序
- 确认仓库/registry 可访问。
- 确认锁文件与本地目录未损坏。
- 确认本地没有同名覆盖冲突。
- 重试后看日志定位具体错误。
高频误区
- 在错误目录执行
clawhub sync。 - 忽略锁文件状态，直接手改目录结构。
- 安装后不执行
openclaw skills list验证。 - 把“不可用”误判成“没安装成功”，实际是依赖不满足。