はじめに
OpenClaw は活発なオープンソースプロジェクト（GitHub 100k+ stars）であり、バージョン更新が頻繁に行われます。新バージョンには通常、機能改善、パフォーマンス最適化、セキュリティ修正が含まれています。本記事では、安全にバージョンアップグレードを行う方法について、更新前の準備作業、各種インストール方法別の更新手順、問題発生時のロールバック戦略を含めて解説します。
アップグレード前の準備
アップグレード作業を行う前に、以下の準備を必ず完了してください。
現在のバージョンの確認
openclaw --version
最新バージョンと変更履歴の確認
# npmでの最新バージョンを確認
npm view openclaw version
# 利用可能なすべてのバージョンを確認
npm view openclaw versions --json
# 変更履歴を確認
npm view openclaw changelog
GitHub の Releases ページで各バージョンの詳細な更新内容を確認することもできます。
https://github.com/openclaw/openclaw/releases
現在の設定の確認
現在の動作状態が正常であることを確認します。
openclaw doctor
設定とデータのバックアップ
これは最も重要なステップです。スキップしないでください。
# バックアップディレクトリを作成
mkdir -p ~/openclaw-backup/$(date +%Y%m%d)
# 設定ファイルをバックアップ
cp -r ~/.config/openclaw ~/openclaw-backup/$(date +%Y%m%d)/config
# スキルファイルをバックアップ
cp -r ~/.openclaw ~/openclaw-backup/$(date +%Y%m%d)/openclaw-data
# 現在のバージョン番号を記録
openclaw --version > ~/openclaw-backup/$(date +%Y%m%d)/version.txt
echo "バックアップ完了：~/openclaw-backup/$(date +%Y%m%d)"
今後の使用のために、簡単なバックアップスクリプトを作成することもできます。
cat > ~/openclaw-backup.sh << 'EOF'
#!/bin/bash
BACKUP_DIR="$HOME/openclaw-backup/$(date +%Y%m%d_%H%M%S)"
mkdir -p "$BACKUP_DIR"
cp -r ~/.config/openclaw "$BACKUP_DIR/config" 2>/dev/null
cp -r ~/.openclaw "$BACKUP_DIR/openclaw-data" 2>/dev/null
openclaw --version > "$BACKUP_DIR/version.txt" 2>/dev/null
echo "バックアップの保存先: $BACKUP_DIR"
EOF
chmod +x ~/openclaw-backup.sh
npmでの更新
最新バージョンへの更新
# OpenClawを停止
openclaw restart # または手動で停止
# 最新バージョンに更新
npm install -g openclaw@latest
# バージョンを確認
openclaw --version
# 再起動
openclaw up
特定バージョンへの更新
最新バージョンに直接ジャンプしたくない場合は、具体的なバージョン番号を指定できます。
npm install -g [email protected]
利用可能な更新の確認
npm outdated -g openclaw
出力例：
Package Current Wanted Latest Location
openclaw 2.4.3 2.5.1 2.5.1 global
- Current：現在インストールされているバージョン
- Wanted：バージョン範囲を満たす最新バージョン
- Latest：npm上の最新バージョン
Homebrewでの更新
Homebrew でインストールした場合、更新は非常に簡単です。
# Homebrewインデックスを更新
brew update
# OpenClawの更新があるか確認
brew outdated openclaw
# OpenClawをアップグレード
brew upgrade openclaw
# サービスを再起動
openclaw restart
Dockerでの更新
Dockerイメージの更新
# 最新イメージを取得
docker pull openclaw/openclaw:latest
# 旧コンテナを停止して削除
docker stop openclaw
docker rm openclaw
# 新しいイメージでコンテナを再作成
docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v /path/to/config:/app/config \
-v /path/to/data:/app/data \
-e OPENCLAW_CONFIG=/app/config/openclaw.json5 \
-e TZ=Asia/Shanghai \
openclaw/openclaw:latest
docker-composeでの更新
cd /path/to/openclaw-compose
# 最新イメージを取得
docker-compose pull
# コンテナを再作成
docker-compose up -d
# 古いイメージをクリーンアップ
docker image prune -f
特定のDockerバージョンへの更新
docker pull openclaw/openclaw:2.5.0
その後、docker-compose.yml の image タグを変更するか、docker run コマンドでバージョン番号を指定します。
アップグレード後の検証
どの方法でアップグレードしても、完了後は必ず検証を行ってください。
# バージョン番号を確認
openclaw --version
# 診断を実行
openclaw doctor
# ログにエラーがないか確認
openclaw logs
# Dashboardにアクセスできるかテスト
curl -s http://localhost:18789/health
検証チェックリスト
| チェック項目 | 検証方法 | 期待結果 |
|---|---|---|
| バージョン番号 | openclaw --version |
新しいバージョン番号が表示 |
| サービス状態 | openclaw doctor |
すべてのチェックに合格 |
| Dashboard | ブラウザアクセス | ページが正常にロード |
| ログ | openclaw logs |
異常なエラーなし |
| チャネル接続 | テストメッセージを送信 | 正常に返信 |
| スキル | openclaw skill list |
既存のスキルが正常に一覧表示 |
旧バージョンへのロールバック
新バージョンに問題がある場合は、迅速にロールバックできます。
npmでのロールバック
# 指定した旧バージョンをインストール
npm install -g [email protected]
# バックアップした設定ファイルを復元
cp -r ~/openclaw-backup/20260318/config/* ~/.config/openclaw/
# 再起動
openclaw restart
Dockerでのロールバック
# 旧バージョンのイメージでコンテナを再構築
docker stop openclaw
docker rm openclaw
docker run -d \
--name openclaw \
--restart always \
-p 18789:18789 \
-v /path/to/config:/app/config \
-v /path/to/data:/app/data \
openclaw/openclaw:2.4.3
Homebrewでのロールバック
Homebrew はロールバックを直接サポートしていませんが、npm で特定のバージョンをインストールできます。
brew uninstall openclaw
npm install -g [email protected]
自動更新戦略
cronで定期的に更新を確認
更新チェック用のスクリプトを作成します。
cat > ~/openclaw-check-update.sh << 'SCRIPT'
#!/bin/bash
CURRENT=$(openclaw --version 2>/dev/null)
LATEST=$(npm view openclaw version 2>/dev/null)
if [ "$CURRENT" != "$LATEST" ]; then
echo "[$(date)] OpenClawの新しいバージョンが利用可能です: $CURRENT -> $LATEST"
# 任意：通知を送信
fi
SCRIPT
chmod +x ~/openclaw-check-update.sh
# 毎日1回チェック
(crontab -l 2>/dev/null; echo "0 9 * * * ~/openclaw-check-update.sh >> ~/openclaw-update.log") | crontab -
Docker Watchtowerによる自動更新
Watchtower を使用して Docker コンテナを自動的に更新できます。
docker run -d \
--name watchtower \
--restart always \
-v /var/run/docker.sock:/var/run/docker.sock \
containrrr/watchtower \
--interval 86400 \
openclaw
これにより、24時間ごとに OpenClaw イメージの更新を確認し、自動的に新しいイメージを取得してコンテナを再起動します。
メジャーバージョンアップグレードの注意事項
メジャーバージョンアップグレード（1.x から 2.x など）を行う場合は、特に注意が必要です。
- リリースノートを熟読 — メジャーバージョンには通常、破壊的変更が含まれます
- 設定ファイルのフォーマット変更を確認 — 新バージョンで設定ファイルの構造が変更されている可能性があります
- 設定移行ツールを実行（利用可能な場合）：
openclaw migrate
- テスト環境で事前に検証 — 本番環境以外で新バージョンをテスト
- ロールバック計画を準備 — 完全なバックアップがあることを確認
更新頻度の推奨
| 更新タイプ | バージョン番号の変化 | 推奨戦略 |
|---|---|---|
| パッチバージョン | x.x.1 → x.x.2 | 速やかに更新、通常はバグ修正 |
| マイナーバージョン | x.1.x → x.2.x | 1週間以内に更新、新機能と改善 |
| メジャーバージョン | 1.x.x → 2.x.x | 慎重に更新、先に移行ガイドを確認 |
まとめ
バージョンアップグレードは、OpenClaw を安定かつ安全に運用するための重要な作業です。核心原則は「バックアップが先、検証が次、ロールバック計画を用意」です。定期的な更新チェックの習慣を身につけ、セキュリティの脆弱性を適時修正しつつ、むやみに最新バージョンを追いかけて本番環境の安定性に影響を与えないようにしましょう。