元宝插件修复器:在 QClaw 下恢复 openclaw-plugin-yuanbao

前言

在 QClaw 里接元宝 Bot,常见卡点不是「会不会写脚本」,而是官方侧尚未提供对应插件,以及重启 QClaw 后元宝 Bot 再次不可用——这类问题往往反复出现,手工改官方脚本又容易在每次重启后重来一遍。下面介绍社区 Skill「元宝插件修复器」,它把安装、配置与重启后的恢复流程收进一套可重复执行的技能里。

这是什么

「元宝插件修复器」是 SkillHub 上的社区 Skill,坐标为 @user_9a66f56b/yuanbao-fixer,当前版本 1.0.0,分类为 it-ops-security,由发布者 user_9a66f56b 维护。

根据 SkillHub 页面说明,该 Skill 基于元宝官方 Bot 脚本做了 QClaw 适配,用于在 QClaw 环境中安装、配置 openclaw-plugin-yuanbao 元宝插件;每次重启 QClaw 后执行本技能,可快速恢复元宝插件的正常使用。页面标签标明 requires_api_key=true,即相关配置通常涉及 API Key,具体字段以技能包内 SKILL.md 为准。

SkillHub 展示页:https://www.skillhub.cn/skills/user_9a66f56b/yuanbao-fixer
API 坐标页:https://api.skillhub.cn/user_9a66f56b/yuanbao-fixer

核心功能

已核实的能力范围如下,不超出官方简介:

  1. 安装与配置:在 QClaw 环境下协助完成 openclaw-plugin-yuanbao 的安装与配置(相对「仅使用元宝官方 Bot 脚本、自行改适配」的零散做法,流程被固化在 Skill 指令中)。
  2. 重启后恢复:针对「重启 QClaw 后元宝 Bot 仍会失效」的场景,通过再次执行本 Skill,缩短恢复时间。
  3. 适配来源:说明中明确基于元宝官方 Bot 脚本修改以适配 QClaw,而非 QClaw 官方内置插件。

安装与启用

SkillHub 页面 meta 提示:请按 SkillHub 安装与优先源配置 安装 yuanbao-fixer。下面步骤摘自该安装文档的通用流程,安装时须把技能装进当前 Agent 实际使用的 skills 目录。

1、安装 SkillHub CLI(若尚未安装)

先检查是否已有 CLI:

command -v skillhub && skillhub --version

未安装时,可用官方脚本安装(完整安装含 CLI 与默认 Skill):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需 CLI 时:

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

2、安装元宝插件修复器

安装技能时必须使用 --dir 指向当前环境的 skills 目录;文档说明若装到默认 ./skills/ 而 Agent 未从该路径加载,技能不会被识别,且仍可能需要重启 Agent。

skillhub install @user_9a66f56b/yuanbao-fixer --dir <你的 skills 目录>

也可按页面关键词使用包名 yuanbao-fixer 搜索后再安装,例如:

skillhub search yuanbao-fixer
skillhub install yuanbao-fixer --dir <你的 skills 目录>

3、各客户端 skills 目录(摘自官方安装文档)

安装文档列出的常见路径如下,QClaw 属于 OpenClaw 变体,文档说明其会有类似的 skills 目录,具体以你所用 QClaw 发行说明为准:

环境 skills 目录
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或项目下的 .agents/skills/

Cursor、Codex CLI、Claude Code 的差异仅在于 skills 目录不同,安装命令形式相同,均需 --dir 指向对应目录。未在官方资料中单独写明的客户端,不臆造路径。

4、启用

将 Skill 安装到正确目录后,在支持 Skills 的 Agent 中加载该技能(部分环境需重启 Agent 后生效,与 SkillHub 安装文档说明一致)。因标签 requires_api_key=true,首次使用前应在技能指引中完成 API Key 等必要配置。

典型用法

官方简介给出的可复现节奏如下:

  1. 在 QClaw 环境中,通过本 Skill 完成 openclaw-plugin-yuanbao 的安装与配置(首次或环境变更时)。
  2. 日常使用元宝 Bot;当 重启 QClaw 后出现元宝插件失效时,再次执行本 Skill,按技能内步骤恢复插件可用状态。

具体交互话术、脚本路径与配置项以安装后的 SKILL.md 为准;本文未获取到技能包正文时,不补充未核实的命令或配置字段。

适用场景与注意

适合谁

  • 使用 QClaw,需要接入元宝 Bot,并愿意通过 Agent Skill 驱动安装与修复流程的运维或开发者。
  • 已遇到或预期会遇到「重启 QClaw 后元宝 Bot 失效」,希望用固定技能代替每次手工改脚本。

限制与注意

  • QClaw 官方暂未提供元宝 Bot 插件(Skill 说明中的背景),本 Skill 为社区适配方案,升级 QClaw 或元宝侧脚本时需自行关注兼容性。
  • 涉及 API Key(requires_api_key=true),请勿把密钥写入公开仓库或日志。
  • SkillHub 抓取数据(截至编写时):评分 100000,下载 1003,安装 39;页面展示版本 v1.0.0。统计会随时间变化,以 SkillHub 页面为准。

结尾

「元宝插件修复器」把 QClaw 下元宝插件的安装、配置与重启后恢复收敛为可重复执行的 Skill,适合作为 openclaw-plugin-yuanbao 的运维辅助手段。需要安装步骤与坐标时,以 SkillHub 为准:

  • https://www.skillhub.cn/skills/user_9a66f56b/yuanbao-fixer
  • https://api.skillhub.cn/user_9a66f56b/yuanbao-fixer
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye