📦 OpenClaw Skill Versioning 是什么？

# 版本号格式：MAJOR.MINOR.PATCH
# 例如：2.1.3

# MAJOR（主版本）：不兼容的API变更
# MINOR（次版本）：向后兼容的新功能
# PATCH（修订号）：向后兼容的bug修复

# 示例版本演进
v1.0.0  # 初始版本
v1.0.1  # 修复了个小bug
v1.1.0  # 新增了list_files功能
v2.0.0  # 重构了API，不兼容v1.x

# skills/my-tool/SKILL.md

---
name: my-tool
version: 1.2.3
description: 一个超好用的工具
author: 妙趣AI
compatibility:
  min_openclaw: "2026.1.0"
  max_openclaw: "2026.12.0"
---

# My Tool

## 功能
- 功能A
- 功能B

## 变更日志
### v1.2.3 (2026-05-30)
- 修复了文件读取时的超时问题
- 优化了错误提示

### v1.2.0 (2026-05-15)
- 新增批量处理功能
- 支持自定义输出格式

### v1.0.0 (2026-04-01)
- 初始版本

# 查看Skill的所有版本
openclaw skills versions my-tool

# 输出：
# v1.2.3 (current) - 稳定版
# v1.2.2 - 稳定版
# v1.2.1 - 有已知bug：#127
# v1.2.0 - 稳定版
# v1.1.0 - 稳定版
# v1.0.0 - 稳定版

# 切换到指定版本
openclaw skills install my-tool@1.2.2

# 或者回滚到上一个稳定版
openclaw skills rollback my-tool

# 在代码中动态选择版本
import { SkillRegistry } from 'openclaw';

const registry = new SkillRegistry();
const skill = await registry.load('my-tool', {
  version: '1.2.2',  // 指定版本
  fallback: '1.2.0'   // 如果指定版本不存在，回退到这个版本
});

# skills/my-tool/package.json (可选)

{
  "name": "my-tool",
  "version": "1.2.3",
  "openclaw": {
    "minVersion": "2026.1.0",
    "maxVersion": "2026.12.0",
    "dependencies": {
      "file-reader": ">=1.0.0 <2.0.0",
      "web-fetcher": "^2.1.0"
    }
  },
  "deprecation": {
    "version": "2.0.0",
    "message": "v2.0.0将重构API，请查看迁移指南",
    "migrationGuide": "https://miaoquai.com/tools/my-tool-migration.html"
  }
}

# OpenClaw加载时会自动检查兼容性
try {
  await registry.load('my-tool');
} catch (err) {
  if (err.code === 'INCOMPATIBLE_VERSION') {
    console.error('Skill版本不兼容，请升级OpenClaw或降级Skill');
  }
}