⏩ OpenClaw Skills CI/CD 流水线搭建指南

🎯 为什么要给Skills上CI/CD？

想象一下这个场景：凌晨两点，你刚写了一个超酷的 summarize-slack-thread Skill，得意地往 ~/.openclaw/skills/ 一丢，倒头就睡。第二天老板说「你那个Skill把公司所有Slack消息都转成了猪叫emoji」—— 你才发现忘了跑 openclaw validate。

CI/CD 不是大厂的专利。个人开发者更需要它，因为你的睡眠质量取决于你的流水线质量。一个正经的 CI/CD 流水线能帮你：

🏗️ 流水线架构全景

这条流水线的每个环节都对应一个 openclaw CLI 命令。你不需要自己写脚本——把这些命令串起来就行。

核心工具链

🔧 GitHub Actions 配置实战

下面是一个完整的 .github/workflows/skill-ci.yml 配置。别怕长——复制粘贴改一下就能用。

# .github/workflows/skill-ci.yml
name: OpenClaw Skill CI/CD

on:
  push:
    branches: [ main, develop ]
  pull_request:
    branches: [ main ]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup OpenClaw CLI
        uses: openclaw/setup-cli@v1
        with:
          version: 'latest'
      
      - name: Lint Skill
        run: openclaw skill lint ./skills/
      
      - name: Run Tests
        run: openclaw skill test ./skills/ --coverage
      
      - name: Security Scan
        run: openclaw security scan ./skills/

  build-and-publish:
    needs: validate
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Build Skill Package
        run: openclaw skill build ./skills/ --output ./dist/
      
      - name: Publish to ClawHub
        run: openclaw skill publish ./dist/*.skill
        env:
          CLAWHUB_TOKEN: ${{ secrets.CLAWHUB_TOKEN }}

🧪 测试策略：从娱乐到专业

Skill 测试不是玄学，是科学。科学的尽头是玄学，但中间那段归你管。

三级测试金字塔

测试文件怎么写？

在Skill目录下创建 tests/ 文件夹，放一个 test_*.yaml：

# tests/test_summarize.yaml
name: "Slack Summarizer 测试套件"
description: "验证总结功能在不同场景下的表现"

cases:
  - name: "短消息总结"
    input:
      messages: ["今天上线了吗？", "还没有", "那就继续写吧"]
    expected:
      topic: "上线状态确认"
      sentiment: "neutral"
      action_items: ["继续开发"]

  - name: "空消息处理"
    input:
      messages: []
    expected:
      error: "EMPTY_INPUT"
      fallback: "没有消息可总结"

🔄 自动部署 & 版本管理

部署策略决定了你的Skill上线时是「烟花」还是「哑炮」。

三种部署策略

版本号语义

遵循 SemVer 规范：MAJOR.MINOR.PATCH

• MAJOR — 破坏性变更（改tool签名、删API）
• MINOR — 新增功能（加tool、加参数）
• PATCH — 修复bug、优化性能

# 自动版本号注入（GitHub Actions）
- name: Auto Version
  run: |
    VERSION=$(git describe --tags --abbrev=0)
    echo "SKILL_VERSION=$VERSION" >> $GITHUB_ENV
    
- name: Build with Version
  run: |
    openclaw skill build \
      --version ${{ env.SKILL_VERSION }} \
      --output ./dist/

⚠️ 常见翻车现场 & 救火指南

🔗 更多相关指南