本页内容
本页内容
使用ClawHub
故障排除
故障排除
clawhub login 等待授权
打开CLI打印的验证码URL,如果需要,使用GitHub登录,并为显示的代码选择Authorize。您可以在其他设备上使用浏览器;不需要本地主机回调。
如果代码过期,请再次运行 clawhub login。对于无人值守登录,请在 ClawHub 设置 → API 令牌中创建 API 令牌并运行:
whoami 或 publish 返回 Unauthorized (401)
- 使用
clawhub login重新登录。 - 如果您使用自定义配置路径,请确认
CLAWHUB_CONFIG_PATH指向包含当前令牌的文件。 - 如果您使用API令牌,请确认它没有在网络UI中被撤销。
搜索或安装返回 Rate limit exceeded (429)
读取响应中的重试信息:
Retry-After:重试之前等待的秒数。RateLimit-Limit:应用于此请求的限制。RateLimit-Remaining:当标题存在时您的确切剩余预算。在429上,它是0。RateLimit-Reset或X-RateLimit-Reset:复位时序。
如果许多用户共享一个出口 IP,则即使每个人仅发送少量请求,也可能会达到匿名 IP 限制。尽可能登录并在报告的延迟后重试。
在代理后面搜索或安装失败
CLI 遵循标准代理变量:
支持的名称包括 HTTPS_PROXY、HTTP_PROXY、https_proxy 和 http_proxy。
A技能未出现在搜索中
- 如果您知道,请检查确切的 slug 或所有者页面。
- 确认该发布是公开的且未通过扫描或审核进行保存。
- 如果您拥有该技能,请登录并检查:
所有者可见的诊断可以解释扫描、上传门或审核状态。
Publish 失败,因为缺少所需的元数据
有关技能,请查看 SKILL.md frontmatter。应声明所需的环境变量和工具,以便用户和扫描程序可以理解该包。
对于插件,请检查 package.json 兼容性元数据。代码插件发布需要OpenClaw兼容字段,例如openclaw.compat.pluginApi和openclaw.build.openclawVersion。
首先预览发布负载:
Publish 失败,并出现 GitHub 所有者或源错误
ClawHub 使用 GitHub 身份和来源归属将包连接到其发布者。
- 确保您使用拥有或可以发布包的 GitHub 帐户登录。
- 检查源 URL 是否是公共的或可供 ClawHub 访问。
- 对于 GitHub 源,请使用
owner/repo、owner/repo@ref或完整的 GitHub URL。
Publish 失败,因为命名空间已声明或保留
如果由于所有者句柄、组织命名空间、包范围、技能 slug 或包名称已被声明或保留而导致发布失败,请首先确认您正在使用与命名空间匹配的所有者进行发布。对于插件包,必须将 @example-org/example-plugin 等范围名称发布为匹配的 example-org 所有者。
如果您认为您的组织、项目或品牌是合法的命名空间所有者,但您无法管理当前的 ClawHub 所有者,请使用公开的非敏感证据打开 Org / 命名空间声明问题 。请参阅 Org 和命名空间 Claims 以获取证据指导以及应避免出现公共问题的内容。
sync 说没有找到技能
sync 查找包含 SKILL.md 或 skill.md 的文件夹。
将其指向要扫描的根:
如果您不确定将发布什么内容,请先预览:
update 由于本地更改而拒绝
本地文件与 ClawHub 所知的任何版本都不匹配。选择一项:
- 保留本地编辑并跳过更新。
- 用发布的版本覆盖:
- 将编辑后的副本发布为新的 slug 或 fork。
A 插件安装在 OpenClaw 中失败
- 使用显式 ClawHub 源:
- 检查包详细信息页面以获取扫描状态和兼容性元数据。
- 确认您的 OpenClaw 版本满足软件包公布的兼容性范围。
- 如果软件包被隐藏、保留或阻止,则在所有者解决问题之前可能无法安装。
公共 API 请求失败
- 尊重
429重试标头并缓存公共 list/search 响应。 - Link 用户返回到规范的 ClawHub 列表。
- 请勿在公共 API 表面之外镜像隐藏、私人、保留或审核阻止的内容。
有关端点详细信息,请参阅 HTTP API。