这里有两种接入方式：clawhub 使用 https://skills.cat/openclaw 兼容入口；原生 skillscat CLI 继续使用主 registry /registry，无需切换到兼容层。

兼容模式安装

保留 OpenClaw 或 ClawHub 工作流时，将 site 和 registry 配置为 SkillsCat。搜索、安装、更新、检查和发布将通过 /openclaw 兼容接口完成。

clawhub search "seo audit" --site https://skills.cat --registry https://skills.cat/openclaw
clawhub inspect <owner>~<skill> --site https://skills.cat --registry https://skills.cat/openclaw
clawhub install <owner>~<skill> --site https://skills.cat --registry https://skills.cat/openclaw
clawhub update <owner>~<skill> --site https://skills.cat --registry https://skills.cat/openclaw
clawhub publish ./my-skill --slug <owner>~<skill> --version 1.0.0 --site https://skills.cat --registry https://skills.cat/openclaw

ClawHub 兼容 slug 使用 ~，例如 owner~skill 或 owner~path~to~skill。发布时也使用这个格式。
客户端可通过 https://skills.cat/.well-known/clawhub.json 自动发现兼容 API。
兼容接口位于 /openclaw，原生 SkillsCat CLI 的 registry 位于 /registry。

原生 CLI 安装

也可以在 OpenClaw 工作区直接使用 SkillsCat CLI。它通过原生 registry 安装完整技能包，--agent openclaw 负责选择对应目录结构。

npx skillscat info <owner>/<repo>
npx skillscat add <slug> --agent openclaw
npx skillscat add <slug> --agent openclaw --global
npx skillscat convert openclaw --from agents

将 <slug> 替换为详情页的精确值，例如 owner/my-skill 或 owner/path/to/skill。只知道仓库时先用 info 检查。convert openclaw --from agents 可用于迁移已有的 .agents 内容。

配置站点与 registry

将 SkillsCat 作为 ClawHub 默认来源时，可以设置环境变量，避免每次重复输入参数。

export CLAWHUB_SITE=https://skills.cat
export CLAWHUB_REGISTRY=https://skills.cat/openclaw

clawhub search "calendar"
clawhub install <owner>~<skill>
clawhub update <owner>~<skill>

临时覆盖可直接在单条命令中使用 --site 和 --registry。站点指向根地址，兼容 registry 指向 /openclaw；原生 SkillsCat CLI 不需要这组配置。

目录与技能包结构

两种接入方式都应保留完整技能包，不能只复制 SKILL.md，或省略模板、脚本、JSON、YAML 等资源。

范围	目录	使用场景
项目安装	`<workspace>/skills/<folder-name>/`	推荐默认方式，让技能随项目管理，方便协作和版本控制。
全局安装	`~/.openclaw/skills/<folder-name>/`	用于个人跨项目复用。

同时存在项目与全局安装时，先检查当前工作区的 skills/。确认 SKILL.md 和附带资源完整，再按当前 OpenClaw 版本刷新技能，或开启新会话。

私有技能与令牌

访问私有技能或执行写入操作前，先确认正在使用哪种 CLI。clawhub 浏览器登录获取 SkillsCat 兼容令牌，skillscat 则使用自己的原生认证流程。

clawhub login --site https://skills.cat
clawhub login --token <skillscat-api-token> --site https://skills.cat --registry https://skills.cat/openclaw
npx skillscat login
npx skillscat add <slug> --agent openclaw

clawhub login --site https://skills.cat 打开兼容认证页面，并将 registry 设为 /openclaw。
手动令牌可在 API 令牌页创建；按操作需要配置 read、write 和 publish 权限。
兼容层支持已认证搜索与已知 slug 安装。更复杂的私有技能浏览、仓库选择与管理请使用原生 CLI。
skillscat login 只影响 SkillsCat CLI，不会重写 ClawHub 的 registry 配置。

问题排查

技能未生效时，检查当前工作区、安装目录、SKILL.md 文件名与包内相对路径，然后开启新的 OpenClaw 会话。
多技能仓库选错目标时，先运行 npx skillscat info owner/repo，再按精确 slug 安装。
只需安装到 OpenClaw 时，优先使用 npx skillscat add <slug> --agent openclaw。
下载或权限异常时，核对技能可见性、令牌权限以及所用 CLI。

技能运行仍依赖源文件说明的命令、凭据或外部工具；安装成功不会自动配置这些依赖。

原生 CLI 的完整命令说明见 CLI 文档。本指南主要说明 ClawHub 兼容层和 OpenClaw 安装目录。