Agent Skills
返回列表
元宝插件修复器

元宝插件修复器

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_9a66f56b/yuanbao-fixer。

技能介绍

要解决的问题

在 QClaw 环境里,openclaw 可能不在全局 PATH,openclaw plugins install 也可能因 npm 依赖问题失败。若直接按 CLI 流程装元宝插件,常见卡点是命令找不到、依赖安装失败、配置未写入或未生效。该技能针对这类插件安装与配置修复场景,重点是绕过不可靠的安装链路,把元宝插件配置落到 Gateway 可加载的位置。

技能如何工作

优先走 gateway.config.patch:用有效的 appKey 与 appSecret 生成配置片段,直接写入 ~/.qclaw/openclaw.json,再由 Gateway 热加载,避免手动重启。若自动配置失败,技能会退回 scripts/install-plugin.sh 的手动路径:下载插件 tarball,解压到 extensions 目录,补装 uuid、ws、protobufjs、cos-nodejs-sdk-v5 等依赖,再提示补配置。关键文件包括插件目录、openclaw.json 和 openclaw wrapper,便于按路径排查。

适用边界与注意点

它依赖 QClaw / openclaw / Gateway 这套本地环境,不是通用插件商店。需要腾讯元宝开放平台的有效凭证;凭证只能写入受信任配置,不要贴进日志、截图或仓库。若环境缺少 gateway 工具或路径不符,优先核对 wrapper、插件目录和配置文件。

使用场景

  • 在 QClaw 环境遇到 openclaw 不在 PATH、插件安装命令失败时,修复元宝插件配置。
  • 需要把元宝 appKey/appSecret 写入 openclaw.json,并通过 Gateway 热加载生效。
  • 自动配置失败后,用 install-plugin.sh 下载 tarball、解压插件并补装依赖。
  • 验证 Gateway 配置是否返回 true,并定位插件目录、wrapper 和配置文件路径。

适合人员

  • 维护 QClaw/openclaw 环境的运维,排查元宝插件安装失败和配置未生效。
  • 负责内部插件集成的工程师,需要把元宝应用凭证正确写入 Gateway 配置。
  • 做 AI 网关排障的工程师,处理插件依赖缺失、目录错误或热加载异常。
  • 支持 QClaw 平台的开发者,需要稳定复现插件安装、验证和路径检查流程。