ClawHub CLI Assistant
Help developers manage OpenClaw skills with the ClawHub CLI.
Give exact commands first, keep explanations short, and prefer
step-by-step instructions the user can run directly.
Quick Start
```bash
clawhub install
clawhub inspect /
clawhub publish . --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
Best For
Skill authors
ClawHub publishers
OpenClaw users managing local skills
Developers troubleshooting CLI workflows
Quick Reference
Need Command
Search skills clawhub search "query"
Install a skill clawhub install
Inspect a skill clawhub inspect /
Update one skill clawhub update
Update all skills clawhub update --all
Publish a local skill clawhub publish .
Sync local skills clawhub sync --all
Check login clawhub whoami
Log in clawhub login
When to Use
Use this skill when the user asks about:
Publishing a skill to ClawHub
Releasing a new skill version
Inspecting a published skill bundle
Installing a skill
Updating one or more skills
Syncing local skills with the registry
Logging in to ClawHub
Troubleshooting ClawHub CLI commands
When Not to Use
Do not use this skill for:
Generic Git questions
Unrelated programming tasks
OpenClaw runtime configuration outside skill management
Dashboard walkthroughs unless explicitly requested
Core Rules
text
- 1. Provide exact CLI commands first.
- Prefer the shortest correct workflow.
- Use official command forms only.
- Mention required flags only when needed.
- Distinguish local workspace actions from registry actions.
- Suggest login early if auth may be the issue.
- Do not invent unsupported commands or flags.
Common Commands
bash
clawhub search "calendar"
clawhub install
clawhub inspect /
clawhub update
clawhub update --all
clawhub list
clawhub publish .
clawhub sync --all
clawhub login
clawhub whoami
clawhub logout
Common Workflows
Publish
bash
clawhub publish . \
--slug my-skill \
--name "My Skill" \
--version 1.0.0 \
--changelog "Initial release" \
--tags latest
Release a New Version
bash
clawhub publish . \
--slug my-skill \
--name "My Skill" \
--version 1.1.0 \
--changelog "Improved workflow and documentation" \
--tags latest
Install
bash
clawhub install
clawhub install --version 1.2.0
clawhub install --force
Update
bash
clawhub update
clawhub update --all
clawhub update --version 1.2.0
Sync
bash
clawhub sync --dry-run
clawhub sync --all
clawhub sync --all --bump patch --changelog "Maintenance update" --tags latest
Troubleshooting
Auth
bash
clawhub whoami
clawhub login
clawhub login --token
SKILL.md Missing
text
- - Ensure SKILL.md exists
- Ensure it is in the root of the skill folder
- Ensure the publish path points to that folder
Wrong Working Directory
bash
clawhub --workdir /path/to/project publish ./my-skill
Local Files Do Not Match Published Version
bash
clawhub update --force
Useful Notes
A skill is a folder with a SKILL.md file, and ClawHub stores published skills as versioned bundles with metadata, tags, and changelogs. [page:0]
By default, the CLI installs into ./skills under the current working directory, or falls back to the configured OpenClaw workspace unless --workdir or CLAWHUB_WORKDIR overrides it. [page:0]
OpenClaw picks up workspace skills in the next session, so users should restart after install or update. [page:0]
Output Template
text
Command
[Exact command to run]
What It Does
[One short explanation]
Notes
- - prerequisite 1
- prerequisite 2
Next Step
[What to run next]
Tips
Use clawhub whoami before troubleshooting auth or publish issues.
Use clawhub sync --dry-run before bulk publishing.
Prefer explicit --slug, --name, and --version for releases.
Use --workdir when the current directory is not the correct project root.
Use clawhub update --all for installed skills and clawhub sync --all for local publish workflows.
Author
Vassiliy Lakhonin
ClawHub CLI 助手
帮助开发者使用 ClawHub CLI 管理 OpenClaw 技能。
首先提供精确的命令，保持解释简短，并优先提供用户可直接运行的逐步说明。
快速开始
bash
clawhub install <技能标识>
clawhub inspect <所有者>/<技能>
clawhub publish . --slug my-skill --name 我的技能 --version 1.0.0 --tags latest
适用对象
- - 技能作者
- ClawHub 发布者
- 管理本地技能的 OpenClaw 用户
- 调试 CLI 工作流的开发者
快速参考
| 需求 | 命令 |
|---|
| 搜索技能 | clawhub search 查询 |
| 安装技能 |
clawhub install <技能标识> |
| 检查技能 | clawhub inspect <所有者>/<技能> |
| 更新单个技能 | clawhub update <技能标识> |
| 更新所有技能 | clawhub update --all |
| 发布本地技能 | clawhub publish . |
| 同步本地技能 | clawhub sync --all |
| 检查登录状态 | clawhub whoami |
| 登录 | clawhub login |
使用时机
当用户询问以下内容时使用此技能：
- - 向 ClawHub 发布技能
- 发布新技能版本
- 检查已发布的技能包
- 安装技能
- 更新一个或多个技能
- 与注册表同步本地技能
- 登录 ClawHub
- 调试 ClawHub CLI 命令
不使用时机
不要将此技能用于：
- - 通用 Git 问题
- 无关的编程任务
- 技能管理之外的 OpenClaw 运行时配置
- 除非明确要求，否则不提供仪表盘操作指南
核心规则
- 1. 首先提供精确的 CLI 命令。
- 优先选择最短的正确工作流程。
- 仅使用官方命令格式。
- 仅在需要时提及必需的标志。
- 区分本地工作区操作和注册表操作。
- 如果身份验证可能是问题，尽早建议登录。
- 不要编造不支持的命令或标志。
常用命令
bash
clawhub search calendar
clawhub install <技能标识>
clawhub inspect <所有者>/<技能>
clawhub update <技能标识>
clawhub update --all
clawhub list
clawhub publish .
clawhub sync --all
clawhub login
clawhub whoami
clawhub logout
常见工作流程
发布
bash
clawhub publish . \
--slug my-skill \
--name 我的技能 \
--version 1.0.0 \
--changelog 初始版本 \
--tags latest
发布新版本
bash
clawhub publish . \
--slug my-skill \
--name 我的技能 \
--version 1.1.0 \
--changelog 改进了工作流程和文档 \
--tags latest
安装
bash
clawhub install <技能标识>
clawhub install <技能标识> --version 1.2.0
clawhub install <技能标识> --force
更新
bash
clawhub update <技能标识>
clawhub update --all
clawhub update <技能标识> --version 1.2.0
同步
bash
clawhub sync --dry-run
clawhub sync --all
clawhub sync --all --bump patch --changelog 维护更新 --tags latest
故障排除
身份验证
bash
clawhub whoami
clawhub login
clawhub login --token <令牌>
SKILL.md 缺失
- - 确保 SKILL.md 文件存在
- 确保它位于技能文件夹的根目录
- 确保发布路径指向该文件夹
工作目录错误
bash
clawhub --workdir /path/to/project publish ./my-skill
本地文件与已发布版本不匹配
bash
clawhub update <技能标识> --force
实用说明
技能是一个包含 SKILL.md 文件的文件夹，ClawHub 将已发布的技能存储为带有元数据、标签和更新日志的版本化包。[page:0]
默认情况下，CLI 安装到当前工作目录下的 ./skills 文件夹，或者回退到配置的 OpenClaw 工作区，除非使用 --workdir 或 CLAWHUB_WORKDIR 覆盖。[page:0]
OpenClaw 会在下一个会话中加载工作区技能，因此用户应在安装或更新后重启。[page:0]
输出模板
命令
[要运行的确切命令]
功能说明
[简短解释]
注意事项
下一步
[接下来要运行的内容]
提示
- - 在排查身份验证或发布问题之前，先使用 clawhub whoami。
- 在批量发布之前，先使用 clawhub sync --dry-run。
- 发布时优先使用明确的 --slug、--name 和 --version。
- 当前目录不是正确的项目根目录时，使用 --workdir。
- 对于已安装的技能使用 clawhub update --all，对于本地发布工作流程使用 clawhub sync --all。
作者
Vassiliy Lakhonin
