mcpField
A
auto-updater-skill

auto-updater-skill

github.com/alphaonedevエージェントワークフロー58 回インストール
リポジトリ

auto-updater-skill について

レジストリやコミュニティクラスター内のスキルを管理する OpenClaw スキルです。コマンドラインから更新確認、差分作成、適用、ロールバック、履歴記録を行います。

主な機能

  1. 01レジストリの更新確認
  2. 02バージョン差分の生成
  3. 03競合オプション付きの更新適用
  4. 04以前のバージョンへのロールバック
  5. 05バージョン履歴の追跡

活用シーン

  1. 01デプロイ前のスキル更新確認
  2. 02定期的なバージョン確認の自動化
  3. 03更新失敗後のスキル復旧
  4. 04コミュニティクラスター内のバージョン追跡

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/alphaonedev/openclaw-graph --skill auto-updater-skill

インストール後、Claude Code で/auto-updater-skillを入力して読み込まれたか確認します。

詳細

auto-updater-skill

目的

このスキルは、新しいバージョンの確認、差分の生成、更新の適用、変更のロールバック、バージョンの追跡など、OpenClaw スキルの更新管理を自動化し、メンテナンスを円滑に行えるようにします。

使用するタイミング

コミュニティクラスターでスキルのバージョンを管理する必要があるときに、このスキルを使用します。変更をデプロイする前、潜在的な問題を検出した後、定期的なメンテナンスサイクルの際などに適しています。本番環境や共同開発のように、複数のスキル間でバージョンの一貫性が重要となる状況に最適です。

主な機能

  • 更新の確認：OpenClaw レジストリに問い合わせて、新しいスキルのバージョンを確認します。
  • 差分の生成：現在のバージョンと最新バージョンを比較し、変更点を明らかにします。
  • 更新の適用：競合を解決しながら、安全に更新をインストールします。
  • 更新のロールバック：問題が発生した場合に、以前のバージョンに戻します。
  • バージョン追跡：バージョン履歴とメタデータのログを維持します。 詳細：バージョンの上書き指定に使用する JSON 設定ファイルに対応しています。例：{"skill_id": "my-skill", "target_version": "1.2.3"}。認証には環境変数 $OPENCLAW_API_KEY が必要です。

使用パターン

このスキルを使用するには、まず OpenClaw CLI がインストールされ、認証済みであることを確認します。openclaw skill import auto-updater-skill でスキルをインポートします。その後、プログラムから、または CLI 経由で呼び出します。自動化するには、毎日更新を確認するコマンドをスクリプトで実行します。常にスキル ID を指定し、ドライランや強制適用などのオプションにはフラグを使用します。

主なコマンド／API

OpenClaw CLI を使用して操作します。すべてのコマンドで、環境変数 $OPENCLAW_API_KEY を設定する必要があります。

  • 更新の確認：openclaw auto-update check --skill-id <id> --cluster community を実行します。API エンドポイント /api/skills/{id}/updates に問い合わせて、利用可能なバージョンを返します。 コード例： 
    export OPENCLAW_API_KEY=your_key
openclaw auto-update check --skill-id auto-updater-skill
  • 差分の生成：openclaw auto-update diff --skill-id <id> --from-version 1.0.0 --to-version 1.1.0 を実行します。差分を JSON 形式で出力します。 コード例： 
    openclaw auto-update diff --skill-id my-skill --from-version 1.2.3
  • 更新の適用：openclaw auto-update apply --skill-id <id> --version 1.1.0 --dry-run を使用します。チェックを省略するには --force を追加します。 コード例： 
    openclaw auto-update apply --skill-id my-skill --version latest
  • 更新のロールバック：コマンド：openclaw auto-update rollback --skill-id <id> --to-version 1.0.0。API エンドポイント /api/skills/{id}/rollback にアクセスします。 コード例： 
    openclaw auto-update rollback --skill-id my-skill --to-version 1.0.0
  • バージョンの追跡：openclaw auto-update track --skill-id <id> で問い合わせます。設定形式：versions.yaml などの YAML ファイルを使用し、内容を skill_id: my-skill, history: ["1.0.0", "1.1.0"] とします。

統合に関する注意事項

メインスキルの設定ファイルに依存関係として追加し、このスキルを OpenClaw のワークフローに統合します。例：skill.json に "dependencies": ["auto-updater-skill"] を追加します。API と統合する場合は、ベース URL https://api.openclaw.com を使用し、ヘッダー Authorization: Bearer $OPENCLAW_API_KEY を含めます。他のスキルと連携させる場合は、コールバックを通じたエラー伝播を適切に処理してください。まずステージング環境で統合をテストします。

エラー処理

CLI コマンドの終了コード（失敗時のコード 1 など）を確認して、エラーを処理します。よくあるエラーには、$OPENCLAW_API_KEY が無効な場合の認証失敗（HTTP 401）や、バージョンの競合（エラーコード 409）があります。処理するには、スクリプト内でコマンドを try-catch ブロックで囲みます。例：

try {
  openclaw auto-update check --skill-id my-skill
} catch (error) {
  if (error.code === 401) { echo "Auth failed; check $OPENCLAW_API_KEY"; }
}

--log-file output.log フラグを使用して、エラーをファイルに記録します。API 呼び出しでは、{"error": "Version not found"} のようなエラー詳細を JSON レスポンスから解析します。

具体的な使用例

  1. 例：スキルの更新を確認して適用する
    まず、更新を確認します：openclaw auto-update check --skill-id my-skill。新しいバージョンが利用可能な場合は、適用します：openclaw auto-update apply --skill-id my-skill --version latest。これにより、手動で操作しなくてもスキルを最新の状態に保てます。CI/CD パイプラインで自動デプロイに使用してください。

  2. 例：更新に失敗した後にロールバックする
    更新によって問題が発生した場合は、すぐにロールバックします：openclaw auto-update rollback --skill-id my-skill --to-version 1.0.0。その前に、差分を生成して変更を確認します：openclaw auto-update diff --skill-id my-skill --from-version 1.1.0。このパターンは、本番環境の安定性を維持するのに役立ちます。

グラフの関係

  • 依存先：skill-registry（バージョンの照会用）
  • 提供する機能：update-management（他のコミュニティスキル向け）
  • 関連先：openclaw-core（API エンドポイント経由）
  • 競合：なし
  • 使用元：maintenance-skills クラスター

コメント

Markdown 対応