ClawHub

Up Skill To Clawhub

Other

Package and publish OpenClaw skills to ClawHub registry. Use when user wants to upload, publish, or update a skill to ClawHub. Triggers on phrases like "upload skill", "publish skill", "push to clawhub", "update skill on clawhub".

Install

openclaw skills install up-skill-to-clawhub

Up Skill to ClawHub / 上传技能到 ClawHub

English: A workflow guide for packaging and publishing OpenClaw skills to ClawHub registry. 中文: 打包并发布 OpenClaw 技能到 ClawHub 注册表的工作流程指南。

Prerequisites / 前提条件

English

  1. ClawHub account and API token
  2. Skill folder with valid SKILL.md
  3. npx clawhub@latest CLI tool

中文

  1. ClawHub 账户和 API Token
  2. 包含有效 SKILL.md 的技能文件夹
  3. npx clawhub@latest CLI 工具

Quick Start / 快速开始

English

# Login to ClawHub
npx clawhub@latest login --token YOUR_API_TOKEN --no-browser

# Publish skill
npx clawhub@latest publish /path/to/skill-folder --version 1.0.0

中文

# 登录 ClawHub
npx clawhub@latest login --token YOUR_API_TOKEN --no-browser

# 发布技能
npx clawhub@latest publish /path/to/skill-folder --version 1.0.0

Workflow Steps / 工作流程

Step 1: Prepare Skill / 步骤 1：准备技能

English: Ensure the skill folder contains required files:

  • SKILL.md - Main skill documentation (required)
  • _meta.json - Metadata with version info
  • scripts/ - Python/shell scripts
  • references/ - Config files, sample data

中文: 确保技能文件夹包含必要文件：

  • SKILL.md - 主技能文档（必需）
  • _meta.json - 包含版本信息的元数据
  • scripts/ - Python/shell 脚本
  • references/ - 配置文件、示例数据

File Structure / 文件结构:

skill-name/
├── SKILL.md          # Required / 必需
├── _meta.json        # Metadata / 元数据
├── scripts/
│   └── main.py       # Scripts / 脚本
└── references/
    └── config.json   # Configs / 配置

Step 2: Update Version / 步骤 2：更新版本

English: Update _meta.json with new version:

{
  "ownerId": "YOUR_OWNER_ID",
  "slug": "skill-name",
  "version": "1.0.1",
  "publishedAt": 1700000000000
}

中文: 更新 _meta.json 版本号：

{
  "ownerId": "YOUR_OWNER_ID",
  "slug": "skill-name",
  "version": "1.0.1",
  "publishedAt": 1700000000000
}

Step 3: Sanitize Sensitive Data / 步骤 3：清理敏感数据

English: ⚠️ IMPORTANT: Before publishing, remove or replace:

  • Real MAC addresses → Use AA:BB:CC:DD:EE:FF
  • Real IP addresses → Use 192.168.1.100
  • Real API keys → Use YOUR_API_KEY or sk-xxx...
  • Real passwords → Use YOUR_PASSWORD
  • Personal device names → Use example-pc, my-device
  • Real phone numbers → Use +1-555-123-4567
  • Real email addresses → Use user@example.com

中文: ⚠️ 重要：发布前必须移除或替换：

  • 真实 MAC 地址 → 使用 AA:BB:CC:DD:EE:FF
  • 真实 IP 地址 → 使用 192.168.1.100
  • 真实 API 密钥 → 使用 YOUR_API_KEY 或 sk-xxx...
  • 真实密码 → 使用 YOUR_PASSWORD
  • 个人设备名称 → 使用 example-pc、my-device
  • 真实电话号码 → 使用 +1-555-123-4567
  • 真实邮箱地址 → 使用 user@example.com

Step 4: Update Documentation / 步骤 4：更新文档

English: Update SKILL.md with:

  • Version number in changelog
  • New features/changes
  • Bilingual (EN/CN) documentation

中文: 更新 SKILL.md：

  • 更新日志中的版本号
  • 新功能/变更说明
  • 中英文双语文档

Step 5: Login to ClawHub / 步骤 5：登录 ClawHub

English:

npx clawhub@latest login --token YOUR_API_TOKEN --no-browser

中文:

npx clawhub@latest login --token YOUR_API_TOKEN --no-browser

Step 6: Publish / 步骤 6：发布

English:

npx clawhub@latest publish /path/to/skill-folder \
  --version 1.0.1 \
  --changelog "Added new feature. Fixed bug."

中文:

npx clawhub@latest publish /path/to/skill-folder \
  --version 1.0.1 \
  --changelog "添加新功能。修复问题。"

Step 7: Verify & Restore / 步骤 7：验证并恢复

English:

  1. Verify publication on clawhub.ai
  2. Restore real configuration if needed for local use

中文:

  1. 在 clawhub.ai 验证发布成功
  2. 如需本地使用，恢复真实配置

CLI Reference / CLI 命令参考

Login / 登录

npx clawhub@latest login --token YOUR_API_TOKEN --no-browser

Publish / 发布

npx clawhub@latest publish <path> [options]
OptionDescription说明
--version <ver>Version (semver)版本号（语义化版本）
--slug <slug>Skill slug技能标识符
--changelog <text>Changelog text更新日志
--tags <tags>Comma-separated tags逗号分隔的标签

Check Login / 检查登录状态

npx clawhub@latest whoami

Search / 搜索

npx clawhub@latest search <query>

Install / 安装

npx clawhub@latest install <slug>

Example Session / 示例会话

User / 用户: "Upload my skill to clawhub, version 1.0.1"

Agent actions / Agent 操作:

  1. Check skill folder structure / 检查技能文件夹结构
  2. Update _meta.json version / 更新版本号
  3. Scan for sensitive data / 扫描敏感数据
  4. Replace with generic values / 替换为通用值
  5. Login to ClawHub / 登录 ClawHub
  6. Publish with changelog / 发布并附带更新日志
  7. Report success / 报告成功
  8. Restore original config / 恢复原始配置

Troubleshooting / 故障排除

"Not logged in" / "未登录"

npx clawhub@latest login --token YOUR_API_TOKEN --no-browser

"Path must be a folder" / "路径必须是文件夹"

  • Ensure path points to a directory / 确保路径指向目录
  • Check SKILL.md exists / 检查 SKILL.md 是否存在

"Version must be valid semver" / "版本号必须是有效的语义化版本"

  • Use format: 1.0.0, 1.0.1, 2.0.0 / 使用格式：1.0.0、1.0.1、2.0.0

Publishing fails / 发布失败

  1. Check internet connection / 检查网络连接
  2. Verify API token is valid / 验证 API Token 有效
  3. Ensure version is higher than existing / 确保版本号高于现有版本

Security Checklist / 安全检查清单

Before publishing, verify / 发布前验证：

  • No real MAC addresses / 无真实 MAC 地址
  • No real IP addresses / 无真实 IP 地址
  • No API keys or tokens / 无 API 密钥或令牌
  • No passwords / 无密码
  • No personal names or devices / 无个人姓名或设备名
  • No phone numbers / 无电话号码
  • No email addresses / 无邮箱地址
  • No private URLs / 无私有 URL

Skill Template / 技能模板

skill-name/
├── SKILL.md              # Main documentation / 主文档
├── _meta.json            # Metadata / 元数据
├── scripts/
│   └── main.py           # Main script / 主脚本
└── references/
    ├── config.json       # Config template / 配置模板
    └── README.md         # Reference docs / 参考文档

SKILL.md Template / SKILL.md 模板

---
name: skill-name
description: Brief description of what this skill does.
---

# Skill Name / 技能名称

**English**: Description in English.
**中文**: 中文描述。

## Quick Start / 快速开始

## Usage / 使用方法

## Configuration / 配置

## Troubleshooting / 故障排除

_meta.json Template / _meta.json 模板

{
  "ownerId": "YOUR_OWNER_ID",
  "slug": "skill-name",
  "version": "1.0.0",
  "publishedAt": 1700000000000
}