ClawHub Publishing Workflow 🚀

Description: Complete workflow for publishing OpenClaw skills to ClawHub - includes authentication troubleshooting, bot detection workarounds, and the mother skill philosophy.

Status: ✅ PRODUCTION READY (Version 1.0.0)

🎯 When to Use

- Publishing a new skill to ClawHub for the first time
Updating an existing published skill
Troubleshooting ClawHub authentication issues
Understanding bot detection challenges with ClawHub
Implementing the "mother skill" philosophy

📋 Prerequisites

1. ClawHub CLI installed:

CODEBLOCK0

2. GitHub account (for ClawHub registration)
ClawHub API token from: https://clawhub.ai/settings/tokens

🚀 Complete Workflow

Phase 1: Authentication (DISCOVERED METHOD)

CODEBLOCK1

Phase 2: Skill Preparation & Location

CODEBLOCK2

Phase 3: Publishing

CODEBLOCK3

Phase 4: Verification

CODEBLOCK4

⚠️ Pitfalls & Solutions (LEARNED FROM EXPERIENCE)

Pitfall 1: Bot Detection (Vercel Security Checkpoint)

Symptoms: "We're verifying your browser" page blocks authentication Solution:

- Use token authentication (clawhub login --token --no-browser)
For browser auth: Enable Camo Fox + residential proxies in BrowserBase

Pitfall 2: "SKILL.md required" Error (Misleading Message)

Symptoms: Getting "Error: SKILL.md required" even when SKILL.md exists Root Cause: ClawHub CLI looks for skills in /root/.openclaw/workspace/skills/ by default, NOT /root/.hermes/skills/ Solution: CODEBLOCK5

Pitfall 3: Rate Limits

Symptoms: "Rate limit: max 5 new skills per hour. Please wait before publishing more." Solution:

- Batch publish with clawhub sync --all and let it handle queuing
Wait 1 hour between large batch publishes
Prioritize most important skills first

Pitfall 4: Individual Publish vs Sync

Symptoms: clawhub publish gives cryptic errors, clawhub sync works better Solution: Always use clawhub sync for batch operations: CODEBLOCK6

Pitfall 2: Incorrect Authentication Methods

Symptoms: "Not logged in" despite having token Solution: Use exact command: INLINECODE7

Pitfall 3: Invalid Semver Version

Symptoms: "--version must be valid semver" error Solution: Use proper semver: "1.0.0", "2.2.0" (not "2.2")

Pitfall 4: Slug Conflicts

Symptoms: "Only the owner can publish updates" Solution: Check slug availability, use unique slug

✅ Verification Steps

Authentication Test

CODEBLOCK7

Skill Structure Test

CODEBLOCK8

Publish Test

CODEBLOCK9

🦊 Bot Detection & Camo Fox

When Browser Auth is Required

If you need browser authentication (for token generation):

1. Enable Camo Fox in BrowserBase dashboard
Configure residential proxies
Use browser with stealth features enabled

Environment Variables for BrowserBase

CODEBLOCK10

🐕 Mother Skill Philosophy

A mother skill is:

- Comprehensive: End-to-end solution for a specific problem
Battle-tested: Proven in real-world use
Community-evolved: Improves with community feedback
Branded: British dry humour + canine wisdom (optional but fun)

Brand Elements (Optional)

- British phrases: "Right then", "Bob's your uncle", "Sorted"
Canine personas: Romeo, Luna, Buster, Thomas
Signature: "Put that in your pipe and smoke it!"

🔧 Troubleshooting Commands

CODEBLOCK11

📁 Example Skill Structure

CODEBLOCK12

🔄 Version History

- v1.0.0: Initial skill creation with discovered authentication method
v1.0.1: Added bot detection guidance and mother skill philosophy

🤝 Community Contributions

This skill documents approaches discovered through trial and error. If you find better methods, update and share!

HELL YEAH, ClawHub publishing mastered! 🎯

Based on real discovery: clawhub login --token TOKEN --no-browser
British dry humour + canine personas optional but recommended

技能名称: ClawHub 发布工作流

详细描述:

ClawHub 发布工作流 🚀

描述： 将 OpenClaw 技能发布到 ClawHub 的完整工作流——包括身份验证故障排除、机器人检测规避方法以及母技能理念。

状态： ✅ 生产就绪（版本 1.0.0）

🎯 使用场景

- 首次向 ClawHub 发布新技能
更新已发布的现有技能
排查 ClawHub 身份验证问题
了解 ClawHub 的机器人检测挑战
实施“母技能”理念

📋 前提条件

1. 已安装 ClawHub CLI：

bash npm install -g clawhub

2. GitHub 账户（用于 ClawHub 注册）
ClawHub API 令牌，获取地址：https://clawhub.ai/settings/tokens

🚀 完整工作流

阶段 1：身份验证（已发现的方法）

bash

从 ClawHub 设置获取令牌（格式：clh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx）

然后使用正确的身份验证方法（通过反复试验发现）：

clawhub login --token 你的令牌 --no-browser

验证身份验证：

clawhub whoami

应显示：✔ 你的用户名

我们尝试过的错误方法：

❌ export CLAWHUB_TOKEN=令牌（无效）

❌ echo 令牌 > ~/.clawhub/token（无效）

✅ clawhub login --token 令牌 --no-browser（正确）

阶段 2：技能准备与位置

bash

1. 创建技能目录结构（位于 Hermes 位置）

your-skill/ ├── SKILL.md ├── references/（可选） ├── templates/（可选） ├── scripts/（可选） └── assets/（可选）

2. 验证技能结构

./scripts/validate.sh

3. 复制到 CLAWHUB 工作区（关键步骤！）

ClawHub CLI 默认在 /root/.openclaw/workspace/skills/ 中查找

cp -r your-skill /root/.openclaw/workspace/skills/

4. 修复权限（ClawHub 需要可读的 SKILL.md）

chmod 644 /root/.openclaw/workspace/skills/your-skill/SKILL.md

3. 检查个人信息（对于社区共享至关重要）

grep -i C:\\\\\|/home/\|password\|token\|secret SKILL.md || echo 干净

阶段 3：发布

bash

重要提示：版本必须是有效的 semver（2.2.0 而非 2.2）

clawhub publish /path/to/your-skill \ --slug 你的唯一标识 \ --name 技能显示名称 \ --version 1.0.0 \ --changelog 初始发布

标识规则：

- 小写字母，仅使用连字符

- 在 ClawHub 上必须全局唯一

- 如果已被占用，请附加 -v2 或 -backup

阶段 4：验证

bash

技能将进行安全扫描（需要几分钟）

clawhub inspect your-slug

扫描完成后，技能可在以下地址获取：

https://clawhub.ai/s/你的用户名/你的标识

⚠️ 陷阱与解决方案（经验之谈）

陷阱 1：机器人检测（Vercel 安全检查点）

症状： “我们正在验证您的浏览器”页面阻止身份验证 解决方案：

- 使用令牌身份验证（clawhub login --token --no-browser）
对于浏览器身份验证：在 BrowserBase 中启用 Camo Fox + 住宅代理

陷阱 2：“需要 SKILL.md”错误（误导性消息）

症状： 即使 SKILL.md 存在，也出现“错误：需要 SKILL.md” 根本原因： ClawHub CLI 默认在 /root/.openclaw/workspace/skills/ 中查找技能，而非 /root/.hermes/skills/ 解决方案： bash

将技能复制到 ClawHub 的预期位置

cp -r /root/.hermes/skills/devops/your-skill /root/.openclaw/workspace/skills/

或者从正确目录使用同步命令

cd /root/.openclaw/workspace && clawhub sync --dry-run

陷阱 3：速率限制

症状： “速率限制：每小时最多 5 个新技能。请稍后再发布。” 解决方案：

- 使用 clawhub sync --all 批量发布，让其处理排队
在大量批量发布之间等待 1 小时
优先发布最重要的技能

陷阱 4：单个发布与同步

症状： clawhub publish 出现难以理解的错误，clawhub sync 效果更好 解决方案： 对于批量操作，始终使用 clawhub sync： bash

先进行试运行

clawhub sync --dry-run

然后发布所有

clawhub sync --all

或者通过将其他技能移出目录来发布特定技能

陷阱 2：错误的身份验证方法

症状： 尽管有令牌，仍显示“未登录” 解决方案： 使用精确命令：clawhub login --token 令牌 --no-browser

陷阱 3：无效的 Semver 版本

症状： “--version 必须是有效的 semver”错误 解决方案： 使用正确的 semver：“1.0.0”、“2.2.0”（而非“2.2”）

陷阱 4：标识冲突

症状： “只有所有者才能发布更新” 解决方案： 检查标识可用性，使用唯一标识

✅ 验证步骤

身份验证测试

bash clawhub whoami

预期：✔ 用户名

技能结构测试

bash

在技能中创建验证脚本：

cat > scripts/validate.sh << EOF #!/bin/bash echo === 技能验证 === [ -f SKILL.md ] && echo ✅ SKILL.md 存在 || echo ❌ SKILL.md 缺失 EOF chmod +x scripts/validate.sh

发布测试

bash

没有可用的试运行选项，因此先发布小型测试技能

🦊 机器人检测与 Camo Fox

何时需要浏览器身份验证

如果您需要浏览器身份验证（用于生成令牌）：

1. 在 BrowserBase 仪表板中启用 Camo Fox
配置住宅代理
使用启用了隐身功能的浏览器

BrowserBase 的环境变量

bash export BROWSERBASECAMOFOX=true export BROWSERBASEPROXYTYPE=residential

🐕 母技能理念

母技能是：

- 全面性：针对特定问题的端到端解决方案
经过实战检验：在真实世界中得到验证
社区进化：通过社区反馈不断改进
品牌化：英式冷幽默 + 犬类智慧（可选但有趣）

品牌元素（可选）

- 英式短语：“Right then”、“Bobs your uncle”、“Sorted”
犬类角色：Romeo、Luna、Buster、Thomas
签名：“Put that in your pipe and smoke it!”

🔧 故障排除命令

bash

检查 CLI 版本

clawhub -V

检查身份验证方法

clawhub auth --help

获取令牌帮助

clawhub login --help

列出您已发布的技能

访问：https://clawhub.ai/u/你的用户名

📁 示例技能结构

clawhub-publish-mother-skill/
├── SKILL.md # 主文档
├── scripts/
│ ├── validate.sh # 验证脚本
│ └── test-publish.sh # 测试发布
└── references/
├── checklist.md # 发布清单
└── camo-fox.md # 机器人检测指南

🔄 版本历史

- v1.0.0： 使用发现的身份验证方法创建初始技能
v1.0.1： 添加了机器人检测指导和母技能理念

🤝 社区贡献

此技能记录了通过反复试验发现的方法。如果您找到更好的方法，请更新并分享！

太棒了，ClawHub 发布已掌握！ 🎯

*基于真实发现：clawhub login --token 令牌

ClawHub Publishing WorkflowClawHub发布流程