ClawHub Rate Limited Publisher
Use this skill when the user wants to publish one or more local skills to ClawHub without exceeding the platform's publish cap.
What this skill does
This skill does not magically grant shell permissions. It provides a safe local queue + scheduler workflow around the user's own clawhub CLI.
Follow this procedure:
- 1. Verify the skill folder exists and contains
SKILL.md. - Build or update a queue JSON file.
- Ask the host to run the helper script from
{baseDir}/scripts/clawhub_rate_limited_uploader.py. - Prefer a host scheduler such as cron or systemd timer so uploads happen automatically every 12 minutes.
- Never exceed 5 publish attempts in any rolling 3600-second window.
- Log stdout/stderr for each attempt and mark queue items as
published or failed.
Required runtime conditions
- -
clawhub must already be installed and authenticated on the host. - The host must allow command execution. In OpenClaw this usually means enabling runtime tools such as
bash/exec, or running the Python script directly outside chat. - New sessions may be required after changing skill/config state because eligible skills are snapshotted per session.
Recommended invocation patterns
One-off manual run
Run:
INLINECODE8
Dry run
Run:
INLINECODE9
Cron schedule
Run every 12 minutes using the example in {baseDir}/resources/cron.example.
Queue file shape
See {baseDir}/examples/queue.sample.json.
Each item may contain:
- -
path: absolute path to one skill directory - INLINECODE13 : optional command template, default INLINECODE14
Safety rules
- - Use absolute paths.
- Do not use
curl|bash, base64 piping, or hidden remote installers. - Keep
command limited to the local clawhub publish "{path}" pattern unless the user explicitly audits and accepts a custom command. - Count failures toward the hourly cap to avoid hammering ClawHub when auth or validation is broken.
技能名称: clawhub-rate-limited-publisher
详细描述:
ClawHub 速率限制发布器
当用户希望将一个或多个本地技能发布到 ClawHub 且不超过平台发布上限时，使用此技能。
此技能的功能
此技能不会神奇地授予 shell 权限。它围绕用户自己的 clawhub CLI 提供了一个安全的本地队列 + 调度器工作流。
请遵循以下步骤：
- 1. 验证技能文件夹存在且包含 SKILL.md。
- 构建或更新队列 JSON 文件。
- 请求主机运行来自 {baseDir}/scripts/clawhubratelimited_uploader.py 的辅助脚本。
- 优先使用主机调度器（如 cron 或 systemd 定时器），以便每 12 分钟自动执行上传。
- 在任何滚动 3600 秒窗口内，发布尝试次数不得超过 5 次。
- 记录每次尝试的 stdout/stderr，并将队列项标记为 published 或 failed。
必需的运行时条件
- - clawhub 必须已在主机上安装并完成身份验证。
- 主机必须允许命令执行。在 OpenClaw 中，这通常意味着启用 bash/exec 等运行时工具，或直接在聊天外部运行 Python 脚本。
- 在更改技能/配置状态后，可能需要新会话，因为符合条件的技能是按会话快照的。
推荐的调用模式
一次性手动运行
运行：
python3 {baseDir}/scripts/clawhubratelimited_uploader.py --queue /absolute/path/to/queue.json --execute
试运行
运行：
python3 {baseDir}/scripts/clawhubratelimited_uploader.py --queue /absolute/path/to/queue.json --dry-run
Cron 调度
使用 {baseDir}/resources/cron.example 中的示例，每 12 分钟运行一次。
队列文件格式
请参见 {baseDir}/examples/queue.sample.json。
每个项可能包含：
- - path：一个技能目录的绝对路径
- command：可选命令模板，默认为 clawhub publish {path}
安全规则
- - 使用绝对路径。
- 不要使用 curl|bash、base64 管道或隐藏的远程安装程序。
- 将 command 限制为本地 clawhub publish {path} 模式，除非用户明确审核并接受自定义命令。
- 将失败次数计入每小时上限，以避免在身份验证或验证失败时频繁请求 ClawHub。
