QwenPaw 升级助手

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install qwenpaw-upgrade-assistant
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 qwenpaw-upgrade-assistant。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

QwenPaw 升级助手是 Openclaw Skills 中的一款实用工具，可在你进行更改前评估 QwenPaw 升级。它会将已安装版本与 PyPI 上的最新发行版进行比较，在可用时获取发行说明，并帮助识别自定义技能、插件和 MCP 设置可能存在的兼容性问题。
该技能会生成结构化报告，包含版本状态、破坏性变更信息、兼容性检查结果和建议的后续步骤。它会提供备份、升级、验证和回滚指导，但不会执行升级，也不会处理需要登录、API 密钥或付款的流程。

应用场景

在规划升级前检查已安装的 QwenPaw 版本和最新版本。
查看发行说明并识别潜在的破坏性变更。
评估目标版本是否可能影响自定义技能、插件或 MCP 设置。
在升级前获取备份和验证建议。
升级失败后查阅回滚指导。
检查 PATH 和安装状态，以排查 QwenPaw 命令缺失或无法运行的问题。

工作原理

运行 qwenpaw --version 确定已安装的版本；如果命令失败，则报告应检查 PATH 或安装状态。
使用 curl 和 python3 查询 PyPI 软件包元数据，以获取最新的 QwenPaw 版本。
尝试从 QwenPaw 发行说明端点获取发行说明；如果不可用，则跳过此步骤并报告连接问题。
比较当前版本和目标版本，然后评估自定义技能、插件和 MCP 设置的兼容性，以及可能已移除或过时的功能。
建议备份重要数据，并提供升级、验证和回滚步骤，供用户审阅和执行。
以结构化 Markdown 报告呈现调查结果，涵盖版本、是否可升级、破坏性变更、兼容性和建议步骤。

配置指南

确保所需命令已安装且可通过 PATH 使用：qwenpaw、python3 和 curl。该技能未声明必需的环境变量。使用 QwenPaw 升级检查命令来请求评估：
qwenpaw upgrade-check
检查会通过 PyPI 获取最新软件包版本，并通过 QwenPaw 发行说明端点获取发行信息，因此这些查询需要网络访问。该技能只提供建议：它不会执行升级、修改系统软件包管理器设置，也不会处理需要登录、API 密钥或付款的升级流程。

数据架构

该技能在其技能元数据和说明中描述了依赖项及报告结构。它未指定持久化数据文件或生成的构件；其输出为结构化 Markdown 报告。
报告字段 用途
当前版本 qwenpaw --version 返回的已安装版本
最新版本 从 PyPI 获取的最新版本
可升级 指示是否有更新版本可用
破坏性变更 概述发行信息是否指出存在破坏性变更
兼容性：技能 对自定义技能兼容性的评估
兼容性：插件 对插件兼容性的评估
兼容性：MCP 对 MCP 配置兼容性的评估
步骤 建议的备份、升级和验证操作
声明的命令依赖项为 qwenpaw、python3 和 curl；必需的环境变量：无。Openclaw Skills 用户可以使用此报告格式审查升级准备情况，而不应将建议视为自动执行的更改。

高级特性

将本地 QwenPaw 版本与 PyPI 上的最新发行版进行比较。
尝试获取发行说明；如果端点不可用，可以跳过此检查。
按自定义技能、插件和 MCP 设置分类整理兼容性审查。
标记过时或已移除功能等潜在问题，以供考虑。
提供优先备份、升级、验证和回滚建议。
让升级由用户掌控：不会自动安装或回滚版本。
使用结构化报告，让 Openclaw Skills 升级评估更易于审阅和执行。

name: qwenpaw-upgrade-assistant description: QwenPaw 升級檢查與相容性驗證。用於檢查目前版本、查找最新版本、驗證升級相容性，並提供升級步驟與回滾建議。