ClawHub CLI 命令应用详解

ClawdHub 是 OpenClaw 的公共技能注册表。地址为。使用它来发现、安装、更新和备份技能。本文是基于ClawHub CLI v0.7.0版本进行的书写。

xufengzhu

1295人浏览 · 2026-03-05 11:26:44

xufengzhu · 2026-03-05 11:26:44 发布

ClawHub CLI 命令应用详解

概述

ClawdHub 是 OpenClaw 的公共技能注册表。地址为 https://clawdhub.com。使用它来发现、安装、更新和备份技能。

本文是基于ClawHub CLI v0.7.0版本进行的书写

基本用法

npx clawhub@latest [options] [command]

全局选项

选项	描述
`-V, --cli-version`	显示CLI版本
`--workdir <dir>`	工作目录（默认：当前目录）
`--dir <dir>`	技能目录（相对于工作目录，默认：skills）
`--site <url>`	网站基础URL（用于浏览器登录）
`--registry <url>`	注册表API基础URL
`--no-input`	禁用提示
`-h, --help`	显示命令帮助

环境变量

CLAWHUB_SITE - 网站URL
CLAWHUB_REGISTRY - 注册表URL
CLAWHUB_WORKDIR - 工作目录
（也支持 CLAWDHUB_* 格式）

命令列表

命令符	命令解释（中文翻译）
`login [options]`	登录（打开浏览器或存储令牌）
`logout`	移除存储的令牌
`whoami`	验证令牌
`auth`	认证命令
`search [options] <query...>`	向量搜索技能
`install [options] <slug>`	安装到 `<dir>/<slug>`
`update [options] [slug]`	更新已安装的技能
`uninstall [options] <slug>`	卸载技能
`list`	列出已安装的技能（从lockfile）
`explore [options]`	浏览注册表中的最新更新技能
`inspect [options] <slug>`	获取技能元数据和文件而不安装
`publish [options] <path>`	从文件夹发布技能
`delete [options] <slug>`	软删除技能（仅限版主/管理员）
`hide [options] <slug>`	隐藏技能（仅限版主/管理员）
`undelete [options] <slug>`	恢复已隐藏的技能（仅限版主/管理员）
`unhide [options] <slug>`	取消隐藏技能（仅限版主/管理员）
`ban-user [options] <handleOrId>`	封禁用户并删除其拥有的技能（仅限版主/管理员）
`set-role [options] <handleOrId> <role>`	更改用户角色（仅限管理员）
`star [options] <slug>`	将技能添加到您的亮点
`unstar [options] <slug>`	从您的亮点中移除技能
`sync [options]`	扫描本地技能并发布新的/更新的技能

命令详细说明

认证相关命令

login: 用户登录，支持浏览器登录或令牌存储
logout: 登出并移除本地存储的认证令牌
whoami: 验证当前令牌的有效性
auth: 认证相关子命令

技能管理命令

search: 使用向量搜索技术查找技能
install: 安装指定技能到本地目录
update: 更新已安装的技能（可指定特定技能或全部）
uninstall: 从本地卸载技能
list: 列出当前已安装的所有技能
explore: 浏览注册表中最新更新的技能
inspect: 查看技能详细信息而不实际安装

发布与管理命令

publish: 将本地技能文件夹发布到注册表
sync: 扫描本地技能目录，自动发布新的或已更新的技能

管理员命令（需要权限）

delete: 软删除技能（不永久删除，可恢复）
hide: 隐藏技能使其不可见
undelete: 恢复已删除的技能
unhide: 取消隐藏技能
ban-user: 封禁用户并删除其所有技能
set-role: 更改用户角色权限

个人收藏命令

star: 将技能标记为个人收藏（添加到亮点）
unstar: 从个人收藏中移除技能

使用示例

# 登录到ClawHub
npx clawhub@latest login

# 搜索技能
npx clawhub@latest search "数据分析"

# 安装技能
npx clawhub@latest install data-analyst

# 列出已安装技能
npx clawhub@latest list

# 更新所有技能| <单个技能名>
npx clawhub@latest update -all | <技能名>