Clawdhub Submit

Automates ClawdHub skill submission by diagnosing common issues, checking file structure, and guiding users through proper publishing steps.

Security Scan

The skill is an instruction-only helper that matches its stated purpose (diagnosing ClawdHub submission issues and guiding publish steps); it asks for no unusual permissions or environment access and contains no code to run automatically.

Purpose & Capability

The name/description (ClawdHub Submit) align with the SKILL.md instructions: diagnosing publish errors, checking file layout, and suggesting publish workflows. There are no unrelated credential requests or surprising capabilities in the manifest.

Instruction Scope

Instructions stay on-topic: checking SKILL.md and _meta.json, visiting the ClawdHub website to accept license terms, optional CLI usage, and GitHub import flows. They do not instruct reading unrelated system files, exfiltrating data, or contacting unknown external endpoints beyond clawdhub.ai, docs, and GitHub links referenced in the guidance.

Install Mechanism

This is instruction-only (no install spec). The document suggests installing an npm CLI ('npm install -g clawdhub') as an optional troubleshooting step; that is proportional to the task but is not enforced by the manifest. Users should verify the npm package and its source before installing third-party CLIs.

Credentials

The skill declares no required environment variables, credentials, or config paths. The instructions mention using a token for the optional CLI login, which is expected and proportional for publishing workflows.

Persistence & Privilege

always is false and the skill is user-invocable. There is no request to modify other skills or system-wide settings, and no persistent background behavior is claimed.

Assessment

This skill is instruction-only and appears coherent with its purpose. Before following the CLI installation steps, verify the 'clawdhub' npm package and the linked GitHub repository to ensure they are authentic. Do not paste tokens or secrets into public places; use the website to accept license terms as instructed and only provide tokens to the official CLI if you trust the package source. If you prefer not to install additional software, follow the web-based publish flow described in the guide.

ClawdHub Skill 提交工具

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

触发条件

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

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

功能

1. 诊断问题

检测以下常见问题：

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

2. 解决指南

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

症状：

Publish payload: acceptLicenseTerms: invalid value

解决方法：

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

问题2：Skill 文件结构错误

必需文件：

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

_meta.json 示例：

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

3. 一键检查清单

检查本地 skill 目录：

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

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

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

4. 备用方案

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

方案A：本地 CLI 发布

# 安装 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。

正确发布流程

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

ClawdHub vs GitHub

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

常见错误

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

技术细节

ClawdHub CLI

# 搜索 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