必须更新至skills runtime v2.1补丁，否则第三方skill将静默失效；通过设置→关于qclaw确认版本，若为v2.0或无字段则需更新；推荐内建通道检查并安装，或手动覆盖lib/skills_runtime；重启后执行runtime version验证，并逐个注册技能确保状态为“已就绪”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让已安装的第三方Skill在QClaw v2026.3.1及以上版本中正常加载并执行，否则会因运行时接口变更导致技能静默失效、日志无报错但功能不响应。
确认当前Skills运行时版本
打开QClaw主界面→点击左下角齿轮图标进入「设置」→选择「关于 QClaw」选项卡→查看底部“Skills Runtime”字段。若显示为v2.0或未显示该字段，说明尚未应用v2.1补丁，必须更新。
这一步不能跳过。v2.1补丁修改了技能生命周期钩子签名与事件分发机制，旧运行时下即使skill.json校验通过，【entry函数将不会被调用】，所有自定义命令均无法触发。
下载并安装v2.1运行时补丁包
方法一：通过客户端内建通道（推荐）
1、确保QClaw处于运行状态且联网→点击设置→「高级」→「运行时管理」→点击「检查运行时更新」。
2、若检测到v2.1可用，界面将显示“Skills Runtime v2.1（20260528）”，点击「下载并应用」→等待进度条完成→提示“重启后生效”。
方法二：手动覆盖安装（网络受限时）
1、访问官方补丁页：claw.guanjia.qq.com/patch/skills-runtime-v2.1，下载对应系统压缩包（Windows为runtime-win-v2.1.zip，macOS为runtime-mac-v2.1.tar.gz）。
2、解压后，将其中skills_runtime文件夹整体复制到QClaw安装目录下的lib/子目录中，**覆盖同名文件夹**。
注意：macOS用户需先关闭SIP（System Integrity Protection），否则系统会阻止写入/Applications/QClaw.app/Contents/Resources/lib/路径。
验证补丁是否生效
① 重启QClaw应用。
② 打开终端（PowerShell / Terminal），切换至QClaw安装目录，执行：python -mqclaw.cli runtime version。
③ 观察输出是否为：Skills Runtime v2.1 (build 20260528)。
④ 进入「设置→技能管理」，查看列表中所有已注册Skill的状态栏是否由灰色变为绿色“已就绪”。若仍有技能显示“未就绪”，需重新执行qclaw.cli skill register <name></name>命令。
这一步必须逐个确认状态。v2.1补丁启用强签名校验，【任何未通过register命令注册的Skill将被直接屏蔽】，即使文件结构完整也不会出现在加载列表中。
