Up Skill to ClawHub / 上传技能到 ClawHub

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

Prerequisites / 前提条件

English

1. 1. ClawHub account and API token
2. Skill folder with valid SKILL.md
3. INLINECODE0 CLI tool

中文

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

Quick Start / 快速开始

English

中文

# 登录 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)
• INLINECODE3 - Metadata with version info
• INLINECODE4 - Python/shell scripts
• INLINECODE5 - Config files, sample data

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

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

File Structure / 文件结构:
CODEBLOCK2

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

English: Update _meta.json with new version:
CODEBLOCK3

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

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

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

• - Real MAC addresses → Use INLINECODE12
• Real IP addresses → Use INLINECODE13
• Real API keys → Use YOUR_API_KEY or INLINECODE15
• Real passwords → Use INLINECODE16
• Personal device names → Use example-pc, INLINECODE18
• Real phone numbers → Use INLINECODE19
• Real email addresses → Use INLINECODE20

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

• - 真实 MAC 地址 → 使用 INLINECODE21
• 真实 IP 地址 → 使用 INLINECODE22
• 真实 API 密钥 → 使用 YOUR_API_KEY 或 INLINECODE24
• 真实密码 → 使用 INLINECODE25
• 个人设备名称 → 使用 example-pc、INLINECODE27
• 真实电话号码 → 使用 INLINECODE28
• 真实邮箱地址 → 使用 INLINECODE29

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:
CODEBLOCK5

中文:
CODEBLOCK6

Step 6: Publish / 步骤 6：发布

English:
CODEBLOCK7

中文:
CODEBLOCK8

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

English:

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

中文:

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

CLI Reference / CLI 命令参考

Login / 登录

Publish / 发布

npx clawhub@latest publish <path> [options]

Check Login / 检查登录状态

Search / 搜索

Install / 安装

npx clawhub@latest install <slug>

Example Session / 示例会话

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

Agent actions / Agent 操作:

1. 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" / "未登录"

"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、INLINECODE40

Publishing fails / 发布失败

1. 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 / 技能模板

CODEBLOCK15

SKILL.md Template / SKILL.md 模板

CODEBLOCK16

meta.json Template / meta.json 模板

CODEBLOCK17