アップデート

​

推奨：ウェブサイトのインストーラーを再実行する（インプレースアップグレード）

curl -fsSL https://openclaw.ai/install.sh | bash

• オンボーディングウィザードを再度実行したくない場合は、--no-onboard を追加してください。
• ソースインストール の場合は、以下を使用します：
  Copy

  Ask AI

  curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
  
  インストーラーは、リポジトリがクリーンな場合にのみ git pull --rebase を実行します。
• グローバルインストール の場合、スクリプトは内部で npm install -g openclaw@latest を使用します。
• レガシーに関する注意：clawdbot は互換性のためのシム（shim）として引き続き利用可能です。

​

アップデートの前に

• インストール方法を確認してください：グローバル (npm/pnpm) か ソースから (git clone) か。
• ゲートウェイの実行方法を確認してください：フォアグラウンドのターミナル か 管理されたサービス (launchd/systemd) か。
• 現在の設定のスナップショット（バックアップ）を取ってください：
  • 構成：~/.openclaw/openclaw.json
  • 認証情報：~/.openclaw/credentials/
  • ワークスペース：~/.openclaw/workspace

​

アップデート（グローバルインストール）

npm i -g openclaw@latest

pnpm add -g openclaw@latest

openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable

​

コア自動アップデーター（オプション）

{
  "update": {
    "channel": "stable",
    "auto": {
      "enabled": true,
      "stableDelayHours": 6,
      "stableJitterHours": 12,
      "betaCheckIntervalHours": 1
    }
  }
}

• stable：新しいバージョンがリリースされると、OpenClaw は stableDelayHours だけ待機し、その後 stableJitterHours 内でインストールごとの決定論的なジッター（ばらつき）を設けて適用します（段階的ロールアウト）。
• beta：betaCheckIntervalHours（デフォルト：1時間）おきにチェックし、アップデートがあれば適用します。
• dev：自動適用は行われません。手動で openclaw update を使用してください。

openclaw doctor
openclaw gateway restart
openclaw health

• ゲートウェイをサービスとして実行している場合は、PID を kill するよりも openclaw gateway restart を推奨します。
• 特定のバージョンに固定している場合は、下記の「ロールバック / バージョン固定」を参照してください。

​

アップデート (openclaw update)

openclaw update

• クリーンなワークツリーが必要です。
• 選択されたチャンネル（タグまたはブランチ）に切り替えます。
• 設定されたアップストリーム（dev チャンネル）に対して fetch + rebase を行います。
• 依存関係のインストール、ビルド、コントロール UI のビルドを実行し、openclaw doctor を実行します。
• デフォルトでゲートウェイを再起動します（スキップするには --no-restart を使用）。

​

アップデート（コントロール UI / RPC）

1. openclaw update と同じソースアップデートフローを実行します（git チェックアウトのみ）。
2. 再起動の目印（センチネル）を構造化されたレポート（stdout/stderr の末尾）と共に書き込みます。
3. ゲートウェイを再起動し、最後にアクティブだったセッションにレポートと共に通知を送ります。

​

アップデート（ソースから）

openclaw update

git pull
pnpm install
pnpm build
pnpm ui:build # 初回実行時に UI の依存関係を自動インストール
openclaw doctor
openclaw health

• パッケージ化された openclaw バイナリ（openclaw.mjs）を実行する場合や、Node で dist/ を実行する場合は pnpm build が重要です。
• グローバルインストールなしでリポジトリのチェックアウトから実行する場合は、CLI コマンドに pnpm openclaw ... を使用してください。
• TypeScript から直接実行する場合（pnpm openclaw ...）、再ビルドは通常不要ですが、設定の移行は依然として適用されるため、doctor を実行してください。
• グローバルインストールと git インストールの切り替えは簡単です：もう一方の形式をインストールし、openclaw doctor を実行すれば、Gateway サービスののエントリポイントが現在のインストールに書き換えられます。

​

常に実行：openclaw doctor

• 非推奨の設定キー / レガシーな設定ファイルの場所を移行します。
• DM ポリシーを監査し、リスクのある「open」設定に警告を出します。
• Gateway のヘルスチェックを行い、再起動を提案できます。
• 古い Gateway サービス（launchd/systemd、レガシーな schtasks）を検出し、現在の OpenClaw サービスに移行します。
• Linux で、systemd ユーザーのリンガリング（ログアウト後も Gateway が存続すること）を確保します。

​

Gateway の起動 / 停止 / 再起動

openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow

• macOS launchd（アプリに同梱された LaunchAgent）：launchctl kickstart -k gui/$UID/ai.openclaw.gateway（ai.openclaw.<profile> を使用。レガシーな com.openclaw.* も引き続き動作します）
• Linux systemd ユーザーサービス：systemctl --user restart openclaw-gateway[-<profile>].service
• Windows (WSL2)：systemctl --user restart openclaw-gateway[-<profile>].service
  • launchctl/systemctl はサービスがインストールされている場合にのみ動作します。そうでない場合は openclaw gateway install を実行してください。

​

ロールバック / バージョン固定（何かが壊れた場合）

​

バージョン固定（グローバルインストール）

npm i -g openclaw@<version>

pnpm add -g openclaw@<version>

openclaw doctor
openclaw gateway restart

​

日付による固定（ソースインストール）

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 を実行し、出力を注意深く読んでください（解決策が示されていることが多いです）。
• チェック：トラブルシューティング
• Discord で質問する：https://discord.gg/clawd