メインコンテンツへスキップ

​
更新

OpenClawを最新の状態に保ってください。

​
推奨: openclaw update

最も速い更新方法です。インストール方式（npmまたはgit）を検出し、最新バージョンを取得し、openclaw doctor を実行して、ゲートウェイを再起動します。 
openclaw update
チャンネルを切り替える、または特定バージョンを対象にするには: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # 適用せずにプレビュー
--channel beta はbetaを優先しますが、betaタグが存在しないか、最新のstableリリースより古い場合、ランタイムはstable/latestにフォールバックします。一度限りのパッケージ更新で生のnpm beta dist-tagを使いたい場合は --tag beta を使ってください。 チャンネルの意味については Development channels を参照してください。

​
別の方法: インストーラーを再実行する

curl -fsSL https://openclaw.ai/install.sh | bash
オンボーディングをスキップするには --no-onboard を追加します。ソースインストールの場合は、--install-method git --no-onboard を渡してください。

​
別の方法: 手動でnpm、pnpm、またはbunを使う

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
root所有のグローバルnpmインストール

一部のLinux npm環境では、グローバルパッケージが /usr/lib/node_modules/openclaw のようなroot所有ディレクトリにインストールされます。OpenClawはこのレイアウトをサポートしています。インストール済みパッケージはランタイム時に読み取り専用として扱われ、バンドル済みPluginのランタイム依存関係は、パッケージツリーを変更する代わりに、書き込み可能なランタイムディレクトリへステージングされます。 強化されたsystemdユニットでは、ReadWritePaths に含まれる書き込み可能なステージディレクトリを設定してください: 
Environment=OPENCLAW_PLUGIN_STAGE_DIR=/var/lib/openclaw/plugin-runtime-deps
ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp
OPENCLAW_PLUGIN_STAGE_DIR が設定されていない場合、OpenClawはsystemdが提供していれば $STATE_DIRECTORY を使い、その後 ~/.openclaw/plugin-runtime-deps にフォールバックします。

​
自動更新機能

自動更新機能はデフォルトでオフです。~/.openclaw/openclaw.json で有効にします: 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
Channel動作
stablestableDelayHours 待機した後、stableJitterHours 全体にわたる決定的ジッター付きで適用します（段階的ロールアウト）。
betabetaCheckIntervalHours ごとに（デフォルト: 毎時）確認し、即時適用します。
dev自動適用はありません。手動で openclaw update を使ってください。
ゲートウェイは起動時にも更新ヒントをログに出します（update.checkOnStart: false で無効化）。

​
更新後

1
doctorを実行
2
openclaw doctor
3
設定を移行し、DMポリシーを監査し、ゲートウェイの健全性を確認します。詳細: Doctor
4
ゲートウェイを再起動
5
openclaw gateway restart
6
確認
7
openclaw health

​
ロールバック

​
バージョンを固定する（npm）

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
ヒント: npm view openclaw version で現在公開されているバージョンを確認できます。

​
コミットを固定する（ソース）

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
最新に戻すには: git checkout main && git pull。

​
行き詰まった場合

  • もう一度 openclaw doctor を実行し、出力を注意深く読んでください。
  • ソースチェックアウトで openclaw update --channel dev を使う場合、必要に応じてアップデーターが pnpm を自動ブートストラップします。pnpm/corepackのブートストラップエラーが表示された場合は、pnpm を手動でインストールするか（または corepack を再度有効にして）、更新をやり直してください。
  • 確認先: Troubleshooting
  • Discordで質問: https://discord.gg/clawd

​
関連

  • Install Overview — すべてのインストール方法
  • Doctor — 更新後のヘルスチェック
  • Migrating — メジャーバージョン移行ガイド