アップデート

OpenClaw は急速に進化しています（「1.0」以前）。アップデートはインフラのデプロイと同じように扱いましょう：アップデート → チェック実行 → 再起動（または openclaw update を使用、自動的に再起動） → 検証。

推奨：Web サイトのインストーラーを再実行（インプレースアップグレード）

推奨のアップデート方法は、Web サイトのインストーラーを再実行することです。既存のインストールを検出し、インプレースでアップグレードし、必要に応じて openclaw doctor を実行します。

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

注意事項：

• オンボーディングウィザードの再実行を避けたい場合は --no-onboard を追加してください。

• ソースインストールの場合：

  curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard

  インストーラーはリポジトリがクリーンな場合のみ git pull --rebase を実行します。

• グローバルインストールの場合、スクリプトは内部的に npm install -g openclaw@latest を使用します。

• レガシーの注意：clawdbot は互換性シムとして引き続き利用可能です。

アップデート前の確認

• インストール方法を把握：グローバル（npm/pnpm） vs ソースから（git clone）。
• Gateway の実行方法を把握：フォアグラウンドターミナル vs スーパーバイズドサービス（launchd/systemd）。
• カスタマイズのスナップショット：
  • 設定：~/.openclaw/openclaw.json
  • 認証情報：~/.openclaw/credentials/
  • ワークスペース：~/.openclaw/workspace

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

グローバルインストール（いずれかを選択）：

npm i -g openclaw@latest

pnpm add -g openclaw@latest

Gateway ランタイムに Bun は推奨しません（WhatsApp/Telegram でバグが発生します）。

アップデートチャンネルの切り替え（git + npm インストール）：

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

一回限りのインストールタグ/バージョンを指定するには --tag <dist-tag|version> を使用してください。

チャンネルのセマンティクスとリリースノートについては開発チャンネルを参照してください。

npm インストールでは、Gateway が起動時にアップデートヒントをログに出力します（現在のチャンネルタグを確認）。update.checkOnStart: false で無効化できます。

コア自動アップデーター（任意）

自動アップデーターはデフォルトで無効であり、コア Gateway 機能です（プラグインではありません）。

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

動作：

• stable：新しいバージョンが検出されると、stableDelayHours 待機後、stableJitterHours 内のインストールごとの決定論的ジッターを適用（段階的ロールアウト）。
• beta：betaCheckIntervalHours の間隔（デフォルト：1 時間ごと）でチェックし、アップデートが利用可能な場合に適用。
• dev：自動適用なし。手動で openclaw update を使用。

自動化を有効にする前に openclaw update --dry-run でアップデートアクションをプレビューしてください。

その後：

openclaw doctor
openclaw gateway restart
openclaw health

注意事項：

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

アップデート（openclaw update）

ソースインストール（git チェックアウト）の場合：

openclaw update

安全なアップデートフローを実行します：

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

npm/pnpm でインストールした場合（git メタデータなし）、openclaw update はパッケージマネージャー経由でのアップデートを試みます。検出できない場合は、上記の「アップデート（グローバルインストール）」を代わりに使用してください。

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

コントロール UI には Update & Restart（RPC：update.run）があります。以下を実行します：

1. openclaw update と同じソースアップデートフローを実行（git チェックアウトのみ）。
2. 構造化されたレポート（stdout/stderr のテール）付きの再起動センチネルを書き込み。
3. Gateway を再起動し、最後のアクティブセッションにレポートを ping。

リベースが失敗した場合、Gateway はアップデートを適用せずに中断し、再起動します。

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

リポジトリチェックアウトから：

推奨：

openclaw update

手動（ほぼ同等）：

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

注意事項：

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

必ず実行：openclaw doctor

Doctor は「安全なアップデート」コマンドです。意図的に退屈に設計されています：修復 + 移行 + 警告。

ソースインストール（git チェックアウト）の場合、openclaw doctor はまず openclaw update の実行を提案します。

典型的な処理内容：

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

詳細：Doctor

Gateway の起動 / 停止 / 再起動

CLI（OS に関わらず動作）：

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 を実行。

ランブック + 正確なサービスラベル：Gateway ランブック

ロールバック / ピン留め（問題が発生した場合）

ピン留め（グローバルインストール）

動作確認済みのバージョンをインストール（<version> を最後に正常動作したバージョンに置き換え）：

npm i -g openclaw@<version>

pnpm add -g openclaw@<version>

現在の公開バージョンを確認するには npm view openclaw version を実行してください。

その後、再起動 + doctor を再実行：

openclaw doctor
openclaw gateway restart

ピン留め（ソース）日付指定

特定の日付のコミットを選択（例：「2026-01-01 時点の main の状態」）：

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