ClawTank
ドキュメント活用法ブログ今すぐデプロイ
すべての記事
OpenClaw を安全にアップデートする方法:バージョン管理、チャンネル、ロールバック

OpenClaw を安全にアップデートする方法:バージョン管理、チャンネル、ロールバック

2026年2月22日|4 分で読める
目次
  • 現在のバージョンの確認
  • アップデートチャンネル
  • update コマンド
  • ドライラン
  • 特定のバージョン
  • チェンジログの確認
  • アップデート前のバックアップ
  • バックアップスクリプト
  • 保持されるもの
  • 壊れる可能性があるもの
  • Docker イメージのアップデート
  • ロールバック手順
  • npm ロールバック
  • バックアップからのロールバック
  • Docker ロールバック
  • ロールバック後の確認
  • アップデート頻度の推奨
  • 自動アップデート設定
  • アップデート前チェックリスト
  • メジャーバージョンアップデート
  • まとめ
  • 参考資料

まだ OpenClaw をインストールしていませんか?

curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

パソコンへの影響が心配?ClawTank なら60秒でクラウドデプロイ、ファイルへのリスクゼロ。

OpenClaw を安全にアップデートする方法:バージョン管理、チャンネル、ロールバック

OpenClaw を最新に保つことで、最新のエージェント機能、バグ修正、セキュリティパッチを入手できます。ただし、AI エージェント、会話、設定されたスキルを管理するシステムのアップデートには注意が必要です。このガイドでは、現在のバージョンの確認からロールバックまで、アップデートプロセスのすべてをカバーします。

現在のバージョンの確認

openclaw --version
openclaw v0.14.2 (build 2026-02-10)
  gateway: v0.14.2
  runtime: v0.14.2
  node: v22.14.0

3つのバージョン番号(openclaw、gateway、runtime)はすべて一致するはずです。一致しない場合、部分的または混合されたインストールの可能性があります。

openclaw update --check

これはインストールせずに、すべてのチャンネルで利用可能なバージョンを表示します。

アップデートチャンネル

OpenClaw は異なる安定性保証を持つ3つのチャンネルで公開されています。

Stable(デフォルト):ベータテストに合格したリリース。セマンティックバージョニング[1]に従います — メジャーは破壊的変更、マイナーは新機能、パッチはバグ修正。

openclaw update

Beta:まだ検証中の完全な機能。形式:v0.15.1-beta.3。

openclaw update --channel beta

Dev:main ブランチからのビルドで、不安定な可能性があります。形式:v0.16.0-dev.12。コントリビューターとプラグイン開発者向けのみ。

openclaw update --channel dev

update コマンド

openclaw update

これはチャンネルで最新バージョンを確認し、ダウンロードし、チェックサムを検証し、インストールし、ゲートウェイを再起動し、結果を報告します。

ドライラン

openclaw update --dry-run
Dry run - no changes will be made

Current:  v0.14.2
Target:   v0.15.0
Channel:  stable

Changes:
  - 47 files modified
  - 3 new dependencies
  - Configuration migration: none required

Breaking changes: none detected
Skill compatibility: all installed skills compatible

--dry-run フラグはメジャーアップデート前に特に有用です。スキルの互換性をチェックし、必要な設定移行を特定します。

あなた専用の AI アシスタントをデプロイ

ClawTank なら OpenClaw を簡単にデプロイ — サーバー・Docker・SSH 不要。14日間無料トライアル付き。

無料トライアルを始める

特定のバージョン

openclaw update --version v0.14.5

既知の良好なバージョンに固定したり、チームメンバーとバージョンを一致させるのに便利です。

チェンジログの確認

アップデート前に必ずチェンジログを確認してください:

openclaw changelog                            # 最新バージョン
openclaw changelog v0.15.0                    # 特定のバージョン
openclaw changelog --from v0.14.0 --to v0.15.0  # 範囲

変更は Features、Fixes、Breaking、Deprecated、Security に分類されています[2]。「Breaking」セクションには特に注意してください。

アップデート前のバックアップ

重要なディレクトリ:

~/.openclaw/
  openclaw.json       # 設定
  memory/             # エージェントメモリとナレッジ
  sessions/           # 会話履歴
  skills/             # インストール済みスキル

バックアップスクリプト

#!/bin/bash
BACKUP_DIR="$HOME/openclaw-backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_PATH="$BACKUP_DIR/openclaw-backup-$TIMESTAMP"

mkdir -p "$BACKUP_PATH"
openclaw stop
cp -r "$HOME/.openclaw" "$BACKUP_PATH/"
openclaw --version > "$BACKUP_PATH/version.txt"
tar -czf "$BACKUP_PATH.tar.gz" -C "$BACKUP_DIR" "openclaw-backup-$TIMESTAMP"
rm -rf "$BACKUP_PATH"
echo "Backup saved to $BACKUP_PATH.tar.gz"

保持されるもの

  • 設定:設定はそのまま残り、新しいオプションには適切なデフォルトが設定されます
  • メモリ:エージェントメモリとナレッジベースは保持されます
  • セッション:会話履歴は保持されます
  • API キー:保存された認証情報は触れられません

壊れる可能性があるもの

スキルの互換性:最も一般的な問題です。あるバージョン用に構築されたスキルは、スキル API が変更された場合、別のバージョンでは動作しない可能性があります。

openclaw update --dry-run | grep -i skill   # アップデート前にチェック
openclaw skills test <skill-name>           # アップデート後にテスト

設定スキーマの変更:メジャーアップデートでは必須フィールドが変更される場合があります。以下で確認:

openclaw config validate

ゲートウェイポートの変更:まれですが、メジャーアップデート後にファイアウォールとリバースプロキシの設定を確認してください。

Docker イメージのアップデート

Docker で OpenClaw を実行している場合(直接または ClawTank を通じて):

docker pull openclaw/openclaw:latest
# または特定のバージョン:
docker pull openclaw/openclaw:0.15.0

コンテナを再作成(ボリュームがデータを保持):

docker stop openclaw && docker rm openclaw
docker run -d --name openclaw --restart unless-stopped \
  -p 19090:19090 \
  -v openclaw-data:/home/openclaw/.openclaw \
  openclaw/openclaw:latest

Docker Compose の場合、イメージタグを変更して実行:

docker compose pull && docker compose up -d

ロールバック手順

npm ロールバック

npm install -g openclaw@0.14.2
openclaw --version

バックアップからのロールバック

openclaw stop
tar -xzf ~/openclaw-backups/openclaw-backup-20260224_103000.tar.gz -C /tmp/
cp -r /tmp/openclaw-backup-20260224_103000/.openclaw ~/
npm install -g openclaw@0.14.2
openclaw start

Docker ロールバック

docker stop openclaw && docker rm openclaw
docker run -d --name openclaw --restart unless-stopped \
  -p 19090:19090 \
  -v openclaw-data:/home/openclaw/.openclaw \
  openclaw/openclaw:0.14.2

ロールバック後の確認

openclaw --version
openclaw config validate
openclaw skills test <critical-skill>
curl -s http://localhost:19090/health

アップデート頻度の推奨

個人使用:各安定リリースでアップデート。通知を有効に:

openclaw config set notifications.updates true

チーム/共有インスタンス:メンテナンスウィンドウ中にアップデート。バージョンを固定:

openclaw config set update.pin v0.15.0

本番環境:安定リリース後1-2週間待機。セキュリティパッチは即座に適用。

openclaw config set update.autoUpdate false
openclaw config set update.pin v0.14.2

自動アップデート設定

openclaw config set update.autoUpdate true
openclaw config set update.channel stable
openclaw config set update.schedule "0 3 * * 1"  # 毎週月曜の午前3時
openclaw config set update.backupBeforeUpdate true

スケジュールは cron 構文を使用します[3]。代替として systemd タイマーを使用:

sudo tee /etc/systemd/system/openclaw-update.service > /dev/null << 'EOF'
[Unit]
Description=OpenClaw Auto Update
After=network-online.target

[Service]
Type=oneshot
User=openclaw
ExecStart=/usr/bin/openclaw update --auto --backup
StandardOutput=journal
EOF

sudo tee /etc/systemd/system/openclaw-update.timer > /dev/null << 'EOF'
[Unit]
Description=Weekly OpenClaw Update

[Timer]
OnCalendar=Mon 03:00
Persistent=true
RandomizedDelaySec=3600

[Install]
WantedBy=timers.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now openclaw-update.timer

自動アップデート履歴を確認:

openclaw update --history

アップデート前チェックリスト

openclaw --version                # 1. 現在のバージョン
openclaw update --check           # 2. 利用可能なアップデート
openclaw changelog                # 3. 変更内容
openclaw update --dry-run         # 4. 変更のプレビュー
~/backup-openclaw.sh              # 5. データのバックアップ
openclaw update                   # 6. アップデートの適用
openclaw config validate          # 7. 設定の検証
openclaw skills test <skill>      # 8. 重要なスキルのテスト
curl -s localhost:19090/health    # 9. ゲートウェイの確認

メジャーバージョンアップデート

メジャーアップデート(v0.x から v1.0、v1.x から v2.0)では、設定スキーマの変更、削除された機能、新しい依存関係、変更されたデフォルト、互換性のないスキル API が含まれる場合があります。これらの場合:

  1. 完全な移行ガイドを読む
  2. すべてをバックアップ
  3. 別のマシンまたは Docker コンテナで先にテスト
  4. 15-30分のダウンタイムを計画
  5. ロールバック手順を準備
docker run --rm -it \
  -v openclaw-data-copy:/home/openclaw/.openclaw \
  openclaw/openclaw:2.0.0 \
  openclaw config validate

まとめ

  1. アップデート前に必ずチェンジログを確認
  2. --dry-run で変更をプレビュー
  3. すべてのアップデート前にバックアップ
  4. アップデート後に重要なスキルをテスト
  5. ロールバック方法を把握
  6. 個人インスタンスには自動更新、本番にはバージョン固定

参考資料

  1. Semantic Versioning 2.0.0
  2. OpenClaw Release Notes
  3. Cron expression syntax

この記事はいかがでしたか?

新しいガイドやチュートリアルの公開時にお知らせします。

OpenClaw をデプロイしませんか?

Docker・SSH・DevOps 不要。1分以内でセットアップ。

無料トライアルを始める
ClawTank
利用規約プライバシー