ClawHub 发布以 owner 为作用域：发布时必须选择发布者（owner），且 package scope 必须与所选 owner 一致。若发布失败提示 "Package scope must match selected owner"，可改用匹配的 owner 包名或重命名包。使用 clawhub package transfer 转移包所有权（需双方管理员权限）。发布完成后自动进入安全审核，审核通过前不可被安装或下载。

ClawHub 技能与插件发布配置与权限校验

Owner（发布者）

Owner 是 ClawHub 上的发布者标识，例如 @alice 或 @openclaw。

• 个人用户注册后自动获得个人 owner。
• 组织（Org）owner 可以添加多个成员共同管理。

发布时，你可以选择自己的个人 owner，或选择一个你有发布权限的组织 owner。

Skill（技能发布）

技能从技能文件夹发布，发布后的公开页面格式为：

https://clawhub.ai/<owner>/<slug>

例如：

https://clawhub.ai/alice/review-helper

发布请求中需包含：选择的 owner、slug、版本号、变更日志和文件。
服务器会先验证当前用户是否有以该 owner 身份发布的权限，通过后才创建 release。

Plugin（插件发布）

插件使用 npm 风格包名。作用域包名在第一个部分包含 owner：

@owner/package-name

scope 必须与所选发布 owner 一致。
例如，包名为 @openclaw/dronzer，则只能以 @openclaw 发布。如果以 @vintageayu 发布，则需要将包重命名为 @vintageayu/dronzer。

这一规则防止某个包冒用其发布者无法控制的组织命名空间。

发布流程

1. UI、CLI 或 GitHub workflow 收集包元数据与文件。
2. 发布请求发送至 ClawHub，附带所选 owner。
3. 服务端校验：owner 权限、package scope、包名、版本号、文件大小限制、源码元数据。
4. ClawHub 存储 release 并启动自动化安全检查。
5. 新 release 在审核与验证完成前对普通安装/下载页面不可见。

若任何校验失败，release 不会被创建。

常见问题

Package scope 必须匹配所选 owner，报错怎么解决？

当 package scope 与所选 owner 不匹配时，ClawHub 拒绝发布并提示：

Package scope "@openclaw" must match selected owner "@vintageayu".
Publish as "@openclaw" or rename this package to "@vintageayu/dronzer".

两种修复方式：

• 选择与 scope 匹配的 owner 发布（例如改用 @openclaw）。
• 重命名包，使 scope 与你可发布的 owner 一致（例如改为 @vintageayu/dronzer）。

如果包名 scope 已经正确，但包属于另一个发布者，可以转移所有权：

clawhub package transfer @opik/opik-openclaw --to opik

注意：package transfer 仅当你同时拥有当前包 owner 和目标发布者的管理员权限时才能使用。它不能让你进入一个无权管理的 scope。

发布后为什么我的技能/插件不可见？

新发布的 release 会被自动隐藏，直到 ClawHub 完成安全审核与验证。审核通过后才会出现在安装/下载列表中。如果怀疑被拒，可检查发布请求的返回信息或联系 ClawHub 支持。

如何查看当前有哪些 owner 可供发布？

在发布 UI 或 CLI 中选择 owner 时，通常只列出你有权限的 owner。若你属于某个组织，但未在发布选项中看到，请联系该组织的 owner 添加你的发布权限。