SuperAPI AI 工具集

skill-compatibility-checker

通用与其它

查看项目

更新于 10-15 19:57

技能介绍

用途:检查已安装技能与当前 OpenClaw 版本的兼容性。技能可声明最低 OpenClaw 版本和所需运行时功能(cron 引擎、会话隔离、状态存储、上下文压缩等),升级、降级或迁移环境时兼容性可能静默失效,该工具在造成困惑的静默失败前报告不兼容。

主要能力:读取技能 frontmatter 中的 requires_openclaw(可选 semver 约束)与 requires_features(可选功能列表,如 cron、session_isolation、state_storage、context_compaction、sessions_send);字段缺失时视为与版本无关。内置功能注册表记录各功能引入版本:cron 1.0.0、state_storage 1.0.0、session_isolation 1.2.0、context_compaction 1.3.0、sessions_send 1.4.0。输出区分 FAIL(无法运行,需升级 OpenClaw 或禁用技能)与 WARN(功能可能降级)。

使用方式:python3 check.py --check 全量扫描;--check --skill my-skill 检查单个技能;--openclaw-version 1.5.0 覆盖检测版本;--features 列出已知功能及版本;--status 查看上次检查摘要;--format json 输出 JSON。检查结果存于 ~/.openclaw/skill-state/skill-compatibility-checker/state.yaml,字段含 last_check_at、openclaw_version、incompatibilities、check_history。

适用场景:升级 OpenClaw 后、将技能部署到新环境前、原本可用的技能在更新后失效时,以及作为自动化部署流水线的升级后门禁。

限制:仅依据技能 frontmatter 声明与内置功能注册表比对;未声明约束的技能按版本无关处理,可能无法发现隐式依赖。其他限制暂未提供。