OpenClawを更新して稼働確認まで進めるopenclaw-update

使うとこうなる

既存のGatewayの更新を頼むと、エージェントは対象の特定から稼働確認までを一続きで進めます。

このサーバーのOpenClaw Gatewayを更新して、稼働確認まで進めて

エージェントが最初に調べるのは、対象のホスト、実行ユーザー、プロファイルや状態の保存先です。あわせて、サービス、稼働中のリリース、更新を担う管理主体（オーナー）も確かめます。手元のリポジトリやシェルのCLIが、別のインストールに属していることがあるためです。

そのうえで、導入環境に合った既存の更新手順を選びます。バックアップや再起動、復旧は、その手順に書かれたとおりに進めます。

最後の仕事は、目的のバージョンやコミットが実際に動いているかの確認です。結果は1〜3行の短い報告で返り、必要なときだけ短いSHA（コミットを識別する文字列）が添えられます。ログの繰り返しや完全なハッシュは載りません。

openclaw-updateでできること

このスキルの仕事は、環境ごとの正しい更新手順へ振り分け、完了まで見届けることです。更新を自分で組み立てることはありません。新しいデプロイの仕組みやスケジューラーを作ることもしません。

導入環境に合った手順への振り分け

どの手順で更新するかは、導入環境の種類で決まります。

導入環境	使う更新手順
正規のmainチェックアウトとmacOSアプリ	openclaw-live-updaterスキル
運用者が設定したTeamサーバー	update-team-serverスキル
コンテナや宣言的インストールなど、その他の管理環境	環境固有のスキルや運用手順書と、既存の管理主体
標準パッケージ、または1ユーザーのソース導入	OpenClawの更新ドキュメントとupdate CLI（対象ホスト・プロファイルのCLIを使う）

選んだ手順のコマンド、ロック、バックアップや移行の要件にはそのまま従います。通知方針や後片付けも同様です。別管理のリリースや稼働中のコンテナの中で、標準CLIの更新をかけることはしません。

稼働中のGatewayが使うファイルの書き換えも避けます。未コミットの変更が残るチェックアウトを上書きすることもありません。

再起動とセッション復旧

更新の依頼には、通常の再起動と限られた時間の中断が含まれるものとして扱われます。復旧対象のセッションは自動で再開するので、エージェントやタスクが動いていることだけを理由に、確認を求め直されることはありません。 停止に使うのは、管理主体が用意した穏やかな停止（処理中の作業を終えてから止める方法）です。

タスクの取り消し、セッションの中断、キューの消去は、作業を失う原因になります。そのため、待機状態を無理に作る目的では使いません。復旧した会話を手作業でやり直すこともしません。

失敗しても完了まで追う

更新が延期されたり、失敗やロールバックが起きたりしても、スキルは依頼を手放しません。管理主体による完了確認か、外部の対応が必要な具体的な阻害要因が分かるところまで追います。古いプロセスが復帰しただけでは、完了とは数えません。

利用者が一時停止や取り消しを指示した場合は、それに従います。続きを進める経路がなければ、できない約束はせずに阻害要因を伝えます。

稼働バージョンと正常性の確認

確認に使うのは、管理主体の検証手順です。主に見るのは次の点です。

• 目的のバージョンやコミットが実際に稼働しているか
• RPCやヘルスチェック、設定済みのチャネルが動くか
• 有効な場合、実際の入口（ingress）を通してUIやアセットが読み込めるか
• 起動時や復旧時のエラー（秘密情報は表に出さない）

ビルドの成功や引き継ぎの受領は、完了の証拠になりません。監視用のラッパーが成功を返しても、実際の更新は延期や失敗に終わっていることがあります。そのため、両者の結果は分けて読み取ります。

インストール方法

入れ方は、コマンドを1行実行する方法と、エージェントに頼む方法の2つです。コマンドで入れる場合は、Claude CodeやCodexなど、入れる先のエージェントを選べます。

npx skills add https://github.com/openclaw/openclaw --skill openclaw-update

エージェントに頼む場合は、次の文面をそのまま送ってください。

次の Agent Skill をインストールしてください。
https://github.com/openclaw/openclaw/tree/main/.agents/skills/openclaw-update

まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/openclaw-update/、Codex なら ~/.agents/skills/openclaw-update/ に配置してください。

置き場所は、使う範囲によって次のように分かれます。

エージェント	すべてのプロジェクトで使う	特定のプロジェクトだけで使う
Claude Code	~/.claude/skills/	.claude/skills/
Codex	~/.agents/skills/	.agents/skills/

含まれるファイルはSKILL.mdとagents/openai.yamlの2つです。振り分け先の手順は、同じリポジトリの別スキルやOpenClawの文書にあります。自分の環境に当たるスキル（openclaw-live-updaterやupdate-team-server）があれば、合わせて入れておいてください。

使い方の例

依頼文は日本語で構いません。更新の範囲や確認してほしい点を書き添えると、報告の中身がはっきりします。

ローカルのOpenClaw Gatewayを、今の更新チャネルのまま最新版にして

この場合の「最新版」は、設定済みのチャネルを維持する意味で扱われます。エージェントは管理主体を確かめ、該当する手順で更新します。終わったあとの報告は、稼働しているバージョンを伝える短いものです。

管理しているサーバーのGatewayを更新したい。どの更新手順を使うべきか先に調べて

エージェントはホスト、実行ユーザー、サービス、稼働中のリリースを調べ、上の表のどの手順に当たるかを判断します。手元のCLIが別のインストールのものであれば、その点も切り分けられます。

最新のmainで更新して、稼働中のコミットと正常性を確認して

「最新のmain」と明示して頼むと、開発版のソースから更新する流れが選ばれます。標準CLIなら--channel devにあたるものです。開発版の事前チェックは、ビルド可能な古いコミットを選ぶことがあります。そのため、更新前に対象が示され、更新後は実際に稼働しているSHAが報告されます。

注意点

対象は、既存のGatewayの定常的な更新だけです。新規インストール、リリースの検証や公開、関係のないホストは扱いません。更新する環境の管理手順と、そこへのアクセス権が必要になります。

更新には再起動が伴います。復旧対象のセッションは自動で再開しますが、PTY（疑似端末）は維持されません。 管理主体に制御された中断の仕組みがない場合、エージェントはその不足を報告するか、許された範囲で直します。

強制フラグを作り出したり、互換性のチェックを回避したりはしません。未承認のダウングレードやプラグインの権限変更も、自動では受け入れません。管理環境固有の制約や更新ロックにも従います。

更新手順に確かな不具合が見つかった場合は、許可された範囲で修正します。修正はPRレビューとCIを経て反映する流れです。ライセンスはMIT。入れる前にSKILL.mdと付属ファイルを読み、不審な処理がないかを確かめてください。

関連スキル

openclaw-updateが振り分ける先のスキルは、環境によっては一緒に使います。

openclaw-live-updaterは、macOS上のOpenClawをmainの最新版へ更新し、Gatewayとアプリの動作を確かめるスキルです。正規のmainチェックアウトとmacOSアプリの環境では、こちらが更新を担います。

update-team-serverは、運用者が設定したTeamサーバーの更新を担当者へ引き継ぎ、検証・復旧・完了確認まで進めます。Teamサーバーを運用しているなら、合わせて入れておいてください。

まとめ

openclaw-updateは、すでに動いているOpenClaw Gatewayを、その環境の管理手順に沿って更新するスキルです。再起動後のセッション復旧と、目的のバージョンが稼働しているかの確認までを一続きで進めます。導入環境が複数あり、どの手順で更新すべきか迷う運用者に向いているでしょう。まずは手元のGatewayの更新を頼み、振り分けと報告の流れを確かめてみてください。

cccskills のページ