ClawdHub Skill 提交工具#

自动引导用户完成 ClawdHub skill 发布流程。

触发条件#

当用户提到以下关键词时激活：

• "提交 skill"
• "发布 skill"
• "上传 skill"
• "clawdhub submit"
• "skill 被关闭"
• "PR 自动关闭"

功能#

1. 诊断问题#

检测以下常见问题：

• Token 是否已接受许可条款
• Skill 文件结构是否正确
• _meta.json 格式是否有效

2. 解决指南#

问题1：Token 未接受许可条款

症状：

text

Publish payload: acceptLicenseTerms: invalid value

解决方法：

1. 打开 https://clawdhub.ai/upload
2. 使用 GitHub 账号登录
3. 在网页上接受开发者条款
4. 完成后回来重新发布

问题2：Skill 文件结构错误

必需文件：

text

skill-name/
├── SKILL.md        # 必需：使用文档
├── _meta.json      # 可选：元信息
└── scripts/        # 可选：支持脚本

_meta.json 示例：

json

{
  "slug": "my-skill",
  "name": "我的技能",
  "version": "1.0.0",
  "description": "技能描述",
  "tags": ["工具", "实用"]
}

3. 一键检查清单#

检查本地 skill 目录：

bash

# 1. 检查 SKILL.md 存在
ls -la */SKILL.md

# 2. 检查 _meta.json 格式
cat */_meta.json | python3 -m json.tool

# 3. 检查文件大小（太大会被拒绝）
du -sh */

4. 备用方案#

如果网页端遇到问题，可尝试：

方案A：本地 CLI 发布

bash

# 安装 clawdhub
npm install -g clawdhub

# 登录（需要网页端先接受条款）
clawdhub login --token YOUR_TOKEN

# 发布
clawdhub publish ./your-skill --name "你的技能" --slug "your-skill"

方案B：GitHub Fork + 网站导入

1. Fork https://github.com/openclaw/skills
2. 在自己仓库添加 skill
3. 在 clawdhub.ai 使用 "Import from GitHub" 功能

重要说明#

为什么 PR 被自动关闭？#

openclaw/skills 仓库是 只读镜像，所有内容自动从 clawdhub.com 同步。 不接受直接 PR。

正确发布流程#

text

本地开发 → clawdhub.ai 上传 → 自动同步到 GitHub

ClawdHub vs GitHub#

平台用途clawdhub.ai主站：发布、管理 skillgithub.com/openclaw/skills镜像：只读备份

常见错误#

错误原因解决acceptLicenseTerms invalid未在网页接受条款去网页登录接受Rate limit exceededAPI 请求过多等待 1 分钟重试SERVICE_NOT_AVAILABLE部分 API 需要企业认证使用基础 API401 UnauthorizedToken 无效或过期重新登录

技术细节#

ClawdHub CLI#

bash

# 搜索 skill
clawdhub search 高德

# 安装 skill
clawdhub install amap-search

# 查看已安装
clawdhub list

# 更新所有
clawdhub update

API 端点#

• 网站： https://clawdhub.ai
• 文档： https://docs.openclaw.ai/zh-CN/tools/clawhub
• GitHub： https://github.com/clawd-hub/clawdhub