まだ OpenClaw をインストールしていませんか?
パソコンへの影響が心配?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 フラグはメジャーアップデート前に特に有用です。スキルの互換性をチェックし、必要な設定移行を特定します。
特定のバージョン
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 が含まれる場合があります。これらの場合:
- 完全な移行ガイドを読む
- すべてをバックアップ
- 別のマシンまたは Docker コンテナで先にテスト
- 15-30分のダウンタイムを計画
- ロールバック手順を準備
docker run --rm -it \
-v openclaw-data-copy:/home/openclaw/.openclaw \
openclaw/openclaw:2.0.0 \
openclaw config validate
まとめ
- アップデート前に必ずチェンジログを確認
--dry-run で変更をプレビュー
- すべてのアップデート前にバックアップ
- アップデート後に重要なスキルをテスト
- ロールバック方法を把握
- 個人インスタンスには自動更新、本番にはバージョン固定
参考資料
- Semantic Versioning 2.0.0
- OpenClaw Release Notes
- Cron expression syntax
OpenClaw をデプロイしませんか?
Docker・SSH・DevOps 不要。1分以内でセットアップ。
無料トライアルを始める