@heretek-ai/openclaw 2026.3.31 → 2026.3.32

package/dist/chunks/update-cli-DK2TX2U4.mjs

@@ -0,0 +1,1632 @@
+import "./chunk-CQFkT1cY.mjs";
+import "./redact-CtGOTRBK.mjs";
+import "./errors-CbvpN2RP.mjs";
+import "./logger-vRSRu9wD.mjs";
+import { n as DEFAULT_GATEWAY_PORT, u as resolveGatewayPort } from "./paths-CNST7z3O.mjs";
+import "./node-startup-env-Vn3Qa5f_.mjs";
+import "./tmp-openclaw-dir-BeWwpCKM.mjs";
+import { r as theme } from "./theme-w86ra_7m.mjs";
+import "./globals-DZFR3wyP.mjs";
+import { m as defaultRuntime } from "./subsystem-yLe4Gjha.mjs";
+import "./ansi-BJ9IOlIp.mjs";
+import "./boolean-Bwxxidw8.mjs";
+import "./env-9fhyzTaG.mjs";
+import { h as pathExists } from "./utils-Dc9DiBqf.mjs";
+import { t as formatDocsLink } from "./links-BNNF54ea.mjs";
+import { n as inheritOptionFromParent } from "./command-options-CMEANk0N.mjs";
+import "./paths-B5L5nZjW.mjs";
+import "./auth-profiles-ByaVWjmJ.mjs";
+import "./agent-scope-CnAwGoC2.mjs";
+import "./boundary-path-DnlNnNbU.mjs";
+import "./boundary-file-read-BB4JbZzx.mjs";
+import "./logger-DWOgrQoS.mjs";
+import { n as runCommandWithTimeout } from "./exec-DX0zVVG7.mjs";
+import { t as resolveOpenClawPackageRoot } from "./openclaw-root-CSfnLaqO.mjs";
+import "./workspace-CoFl73GV.mjs";
+import "./model-selection-BJk_hQeE.mjs";
+import { d as readConfigFileSnapshot, g as writeConfigFile } from "./io-CDQGJKjg.mjs";
+import "./shell-env-CP5vTYhw.mjs";
+import "./safe-text-Bsdm3bQS.mjs";
+import "./version-Ckv-IbvB.mjs";
+import "./env-substitution-DGlYO8jV.mjs";
+import "./scan-paths-ahOy4FCQ.mjs";
+import "./includes-DcO1JxKG.mjs";
+import "./zod-schema.providers-core-CjdAU1TY.mjs";
+import "./legacy-web-search-B1O8hiGy.mjs";
+import "./schema-validator-BOH34EXk.mjs";
+import "./registry-DBJv0dvl.mjs";
+import "./config-state-kmbzTT63.mjs";
+import "./min-host-version-EA11e8I5.mjs";
+import "./manifest-registry-dO1qi1iI.mjs";
+import { i as parseSemver } from "./runtime-guard-CWHkkioa.mjs";
+import "./avatar-policy-uRVtZ7lJ.mjs";
+import "./ip-BtMd9ssR.mjs";
+import "./zod-schema.agent-runtime-BtGT59eP.mjs";
+import "./zod-schema.core-CMT7g7UX.mjs";
+import "./zod-schema.channels-BAG3dUtC.mjs";
+import "./zod-schema.providers-whatsapp-qnpQepaf.mjs";
+import "./config-Bhjk4Vel.mjs";
+import "./process-scoped-map-BmLEe6nP.mjs";
+import "./file-lock-hqfE8fCo.mjs";
+import "./file-lock-CjVc7LJY.mjs";
+import "./audit-fs-kb-rv_ZT.mjs";
+import "./shared-VxKfp8Uy.mjs";
+import "./resolve-DI6cKS4v.mjs";
+import "./chutes-oauth-BLrDl-qw.mjs";
+import "./json-file-ZNWqd95a.mjs";
+import "./profiles-CqdEUxnl.mjs";
+import "./redact-identifier-DTBisVz0.mjs";
+import { n as resolveCliName, t as replaceCliName } from "./cli-name-lEyorNIN.mjs";
+import { t as formatCliCommand } from "./command-format-D1DrcTDP.mjs";
+import { f as resolveGatewaySystemdServiceName, l as resolveGatewayLaunchAgentLabel, p as resolveGatewayWindowsTaskName } from "./constants-Bu6_2DSg.mjs";
+import "./daemon-install-plan.shared-MtLyPLVq.mjs";
+import "./runtime-paths-qezFSLu3.mjs";
+import "./gateway-install-token-3hijf3Zd.mjs";
+import "./prompt-hGCcgj-D.mjs";
+import "./tailscale-DZJRdd6v.mjs";
+import "./secret-equal-DcNDdUBf.mjs";
+import "./tailnet-Bc7IPWjH.mjs";
+import "./net-OJiOmwY1.mjs";
+import "./auth-C5eSR-m1.mjs";
+import "./credentials-DTsHVnAc.mjs";
+import "./message-channel-DCt8BIP7.mjs";
+import "./store-B0V1qm_-.mjs";
+import "./runtime-a4e8n7tq.mjs";
+import "./registry-9YpVWxKb.mjs";
+import "./plugins-D8oapapr.mjs";
+import "./sessions-CYgBPqrc.mjs";
+import "./paths-CGxgQvpf.mjs";
+import "./types-DoAKcnWC.mjs";
+import "./session-write-lock-DE8KASyZ.mjs";
+import "./json-files-BcpXnc9i.mjs";
+import "./delivery-info-CGNfeMd6.mjs";
+import "./method-scopes-hu-4urbi.mjs";
+import "./call-CcXWxOVG.mjs";
+import "./ws-Dv5Afaxu.mjs";
+import "./control-ui-shared-Dhzx9It_.mjs";
+import "./onboard-helpers-C5GCWoDO.mjs";
+import "./wsl-BW8_A9_i.mjs";
+import { n as stylePromptMessage } from "./prompt-style-Dua6SIJh.mjs";
+import "./ports-lsof-D1pMGdtZ.mjs";
+import "./restart-stale-pids-DpJ5KhNO.mjs";
+import "./runtime-parse-Dv1L_ID-.mjs";
+import "./launchd-CFtZl6rs.mjs";
+import { n as resolveGatewayService } from "./service-eLNsotU2.mjs";
+import { r as quoteCmdScriptArg } from "./kill-tree-C7sbsfc4.mjs";
+import "./ports-0KspCIU9.mjs";
+import "./ports-probe-CW8QePv6.mjs";
+import "./systemd-B1Tl3zeB.mjs";
+import "./shared-CKm0v_dB.mjs";
+import "./systemd-hints-CLxWQM3C.mjs";
+import "./logging-CO6W9Zis.mjs";
+import { r as runDaemonRestart, s as runDaemonInstall } from "./daemon-cli-BKniTIR4.mjs";
+import "./commands-CibL1v-k.mjs";
+import "./probe-4uB3UbEE.mjs";
+import { n as formatConfigIssueLines } from "./issue-format-C5C4zFWv.mjs";
+import "./lifecycle-core-CYrnYd8J.mjs";
+import { a as renderRestartDiagnostics, c as waitForGatewayHealthyRestart, o as terminateStaleGatewayPids } from "./status-B6GRulE7.mjs";
+import "./diagnostics-CXwZ82ru.mjs";
+import "./inspect-CBu749pN.mjs";
+import "./probe-auth-kG5V7ULz.mjs";
+import "./progress-BxDdsPK3.mjs";
+import { t as formatHelpExamples } from "./help-format-VI-o9lzW.mjs";
+import "./tokens-CIQuw4-h.mjs";
+import "./heartbeat-B3sryw3e.mjs";
+import "./registry-CFSnIRx_.mjs";
+import "./internal-hooks-VOrTrqjW.mjs";
+import "./secure-random-Cta_A2w5.mjs";
+import "./multimodal-B5--YVtx.mjs";
+import "./memory-search-CI34ggcG.mjs";
+import "./embeddings-BgbopHnm.mjs";
+import "./api-key-rotation-CuLnDVwp.mjs";
+import "./provider-runtime-CRmI76OF.mjs";
+import "./providers.runtime-CtdkYDy2.mjs";
+import "./accounts-DCMTPA3m.mjs";
+import "./loader-CYgWRKc6.mjs";
+import "./config-presence-DzY-U322.mjs";
+import "./types-BaXbwBIP.mjs";
+import "./hook-runner-global-z_Icpwvo.mjs";
+import "./session-binding-service-Bmkk4TGJ.mjs";
+import "./conversation-binding-elBCYjlA.mjs";
+import "./sdk-alias-C5qDxQv2.mjs";
+import "./anthropic-vertex-provider-Davkw2Ua.mjs";
+import "./provider-env-vars-BvHq384O.mjs";
+import "./model-auth-markers-D9P0hXHx.mjs";
+import "./model-auth-env-D5wfS1i-.mjs";
+import "./model-auth-DtPujlPX.mjs";
+import "./ssrf-DfOlyZAO.mjs";
+import "./fetch-guard-BNr7RxWd.mjs";
+import "./provider-model-allowlist-Bz7SYU4G.mjs";
+import "./provider-model-defaults-CPQyoqIg.mjs";
+import "./mime-CbiZRMeN.mjs";
+import "./backend-config-DaJEmaVa.mjs";
+import "./config-schema-BBMwxQY-.mjs";
+import "./helpers-DxddeIS7.mjs";
+import "./channel-plugin-common-DFFE5uzd.mjs";
+import "./path-safety-CTs-ZpWF.mjs";
+import "./archive-CwsJ_E7G.mjs";
+import "./fs-safe-DvWloqcG.mjs";
+import "./path-alias-guards-Dq2I3ITG.mjs";
+import "./status-helpers-BmYd-e9Q.mjs";
+import "./accounts-Bxxxwdxj.mjs";
+import "./format-DIM1-tQX.mjs";
+import "./api-C4xoLY_P.mjs";
+import "./telegram-DZaimX0b.mjs";
+import "./poll-params-DWHBuRx9.mjs";
+import "./token-BNIxZjju.mjs";
+import "./sticker-cache-CFR6cQio.mjs";
+import "./status-issues-Bu3cVorN.mjs";
+import "./fetch-BI0FMqrI.mjs";
+import "./update-offset-store-3hPuz7sI.mjs";
+import "./api-CE6hZv7r.mjs";
+import "./audit-BkbWkLoN.mjs";
+import "./runtime-api-BR_m5NcJ.mjs";
+import "./bootstrap-budget-B-IQwkE2.mjs";
+import "./pi-embedded-helpers-DTWSmIk7.mjs";
+import "./tool-catalog-DblrqUGw.mjs";
+import "./config-BT5BZCwj.mjs";
+import "./runtime-status-BCn1Ito_.mjs";
+import "./tool-images-DMUfrdai.mjs";
+import "./image-ops-CabelrfU.mjs";
+import "./thinking-DvqE1iCX.mjs";
+import "./models-config-CXzGvNtq.mjs";
+import "./provider-catalog-BDbid2d6.mjs";
+import "./models-config.providers-4zEBpqdF.mjs";
+import "./models-config.providers.discovery-BjIw3Rrd.mjs";
+import "./bundle-lsp-DyU7-zol.mjs";
+import "./exec-approvals-allowlist-DinDB1Z8.mjs";
+import "./exec-safe-bin-runtime-policy-CyPJcb_7.mjs";
+import "./local-file-access-Cloywpfb.mjs";
+import "./sandbox-paths-BltFttSo.mjs";
+import "./path-prepend-B3TwK2p2.mjs";
+import "./sandbox-B1Fh0xU6.mjs";
+import { r as formatDurationPrecise } from "./format-duration-DXuRoMzK.mjs";
+import "./target-registry-B8jHfrX7.mjs";
+import "./runtime-web-tools-SZ1bF8Ui.mjs";
+import "./web-search-providers.runtime-C9cFlSM-.mjs";
+import "./image-generation-provider-6Bn9TpiN.mjs";
+import "./web-search-providers-D1Ywb8m5.mjs";
+import "./client-fetch-BLpjnLN8.mjs";
+import "./resolve-configured-secret-input-string-BG1RVESA.mjs";
+import "./config-BBc-AI9Q.mjs";
+import "./store-CgM2S6uo.mjs";
+import "./stagger-DL_NciFx.mjs";
+import { o as trimLogTail } from "./restart-sentinel-BkRzS474.mjs";
+import "./model-catalog-CWUezRcI.mjs";
+import "./command-secret-gateway-CG3hVPib.mjs";
+import "./command-secret-targets-DskfH4zj.mjs";
+import "./bindings-B0u6nL3P.mjs";
+import "./plugin-auto-enable-C2JsxNX4.mjs";
+import "./accounts-C8JW5aRU.mjs";
+import "./account-inspect-D6JVmmbI.mjs";
+import "./runtime-api-BtH8ogGO.mjs";
+import "./send-MNad2Oi4.mjs";
+import "./mentions-zhy7pfW_.mjs";
+import "./api-DXEplirz.mjs";
+import "./allow-list-BmsN9jdO.mjs";
+import "./handle-action-Liqu1FVR.mjs";
+import "./status-issues-DEI316v-.mjs";
+import "./normalize-P7c7I_FZ.mjs";
+import "./pluralkit-BrMYZvsn.mjs";
+import "./api-BcbhfW_y.mjs";
+import "./send-DnRAtQfI.mjs";
+import "./threading-tool-context-CHndxZE0.mjs";
+import "./sent-thread-cache-HjNNrYhB.mjs";
+import "./targets-XG-6x8Dr.mjs";
+import "./api-s9vnTb6r.mjs";
+import "./pairing-store-CZ8m5dqj.mjs";
+import "./json-store-79zyIPBO.mjs";
+import "./config-eval-BRFipjhU.mjs";
+import "./frontmatter-DtyHHNb1.mjs";
+import "./env-overrides-CiAKRDlo.mjs";
+import "./skills-B94iGCMk.mjs";
+import "./windows-spawn-BIgkarI-.mjs";
+import "./docker-RHNUruWe.mjs";
+import "./ssh-tunnel-rTW1iTuR.mjs";
+import "./server-middleware-CgGy22IV.mjs";
+import "./parse-json-compat-C8iu7A7C.mjs";
+import "./logging-CcQ-gmqC.mjs";
+import "./store-BoqljpMQ.mjs";
+import "./read-only-account-inspect-CoN81Eok.mjs";
+import "./dm-policy-shared-CnmKIKQO.mjs";
+import "./backup-create-CRi_Wc9K.mjs";
+import "./thread-bindings-runtime-DZHuPlAx.mjs";
+import "./matrix-migration-snapshot-ChWL_Ldz.mjs";
+import "./account-resolution-B5v6WlRC.mjs";
+import "./skills-status-DjVDxLj2.mjs";
+import "./install-source-utils-irFQt_KV.mjs";
+import "./clawhub-CW7VHtLD.mjs";
+import "./install-safe-path-CEnkDyia.mjs";
+import "./installs-D9sH8j10.mjs";
+import "./clawhub-HvwNujFy.mjs";
+import "./status-BWLPyL8Y.mjs";
+import "./auth-health-whXtiaC8.mjs";
+import "./note-CaQ2HD-A.mjs";
+import "./bundled-sources-BG6YeEu2.mjs";
+import { r as installCompletion } from "./completion-cli-DuMZk0lN.mjs";
+import "./register.subclis-Dj9qGYdr.mjs";
+import "./command-registry-BnmWhMEa.mjs";
+import "./program-context-9v4H9od4.mjs";
+import { n as renderTable, t as getTerminalTableWidth } from "./table-DBZ08bTi.mjs";
+import "./heartbeat-summary-CUbo9b9F.mjs";
+import "./health-C4WG9Yfr.mjs";
+import "./control-ui-assets-CW49D85b.mjs";
+import { a as createGlobalInstallEnv, c as globalInstallArgs, d as normalizePackageTagInput, f as readPackageName, i as cleanupGlobalRenameDirs, l as resolveGlobalInstallSpec, n as runGatewayUpdate, o as detectGlobalInstallManagerByPresence, p as readPackageVersion, r as canResolveRegistryVersionForPackageTarget, s as detectGlobalInstallManagerForRoot, u as resolveGlobalPackageRoot } from "./server-startup-matrix-migration-BYVP8K4t.mjs";
+import { a as resolveNpmChannelTag, c as DEFAULT_PACKAGE_CHANNEL, d as formatUpdateChannelLabel, g as resolveUpdateChannelDisplay, h as resolveEffectiveUpdateChannel, m as normalizeUpdateChannel, n as compareSemverStrings, r as fetchNpmTagVersion, s as DEFAULT_GIT_CHANNEL, t as checkUpdateStatus, u as channelToNpmTag } from "./update-check-CinGDRx-.mjs";
+import "./channels-status-issues-DxKcDmEl.mjs";
+import { i as resolveUpdateAvailability, n as formatUpdateOneLiner, t as formatUpdateAvailableHint } from "./status.update-4WSHdpiH.mjs";
+import { n as updateNpmInstalledPlugins, t as syncPluginsForUpdateChannel } from "./update-B838aQTS.mjs";
+import "./provider-auth-guidance-DyLaRtDO.mjs";
+import "./systemd-linger-CMHj3APL.mjs";
+import "./health-format-DnRUP-NJ.mjs";
+import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-DWTJpQCH.mjs";
+import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-1UqU9aiy.mjs";
+import "./doctor-config-preflight-C6d55ZHc.mjs";
+import "./channel-account-context-Bcf1_AeX.mjs";
+import "./doctor-state-migrations-CfyTM0UY.mjs";
+import "./provider-openai-codex-oauth-tls-CVsiK51M.mjs";
+import path from "node:path";
+import { spawn, spawnSync } from "node:child_process";
+import os from "node:os";
+import fs from "node:fs/promises";
+import { confirm, isCancel, spinner } from "@clack/prompts";
+
+//#region src/cli/update-cli/shared.ts
+const INVALID_TIMEOUT_ERROR = "--timeout must be a positive integer (seconds)";
+function parseTimeoutMsOrExit(timeout) {
+	const timeoutMs = timeout ? Number.parseInt(timeout, 10) * 1e3 : void 0;
+	if (timeoutMs !== void 0 && (Number.isNaN(timeoutMs) || timeoutMs <= 0)) {
+		defaultRuntime.error(INVALID_TIMEOUT_ERROR);
+		defaultRuntime.exit(1);
+		return null;
+	}
+	return timeoutMs;
+}
+const OPENCLAW_REPO_URL = "https://github.com/Heretek-AI/openclaw.git";
+const MAX_LOG_CHARS = 8e3;
+const DEFAULT_PACKAGE_NAME = "openclaw";
+const CORE_PACKAGE_NAMES = new Set([DEFAULT_PACKAGE_NAME]);
+function normalizeTag(value) {
+	return normalizePackageTagInput(value, ["openclaw", DEFAULT_PACKAGE_NAME]);
+}
+function normalizeVersionTag(tag) {
+	const trimmed = tag.trim();
+	if (!trimmed) return null;
+	const cleaned = trimmed.startsWith("v") ? trimmed.slice(1) : trimmed;
+	return parseSemver(cleaned) ? cleaned : null;
+}
+async function resolveTargetVersion(tag, timeoutMs) {
+	if (!canResolveRegistryVersionForPackageTarget(tag)) return null;
+	const direct = normalizeVersionTag(tag);
+	if (direct) return direct;
+	return (await fetchNpmTagVersion({
+		tag,
+		timeoutMs
+	})).version ?? null;
+}
+async function isGitCheckout(root) {
+	try {
+		await fs.stat(path.join(root, ".git"));
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function isCorePackage(root) {
+	const name = await readPackageName(root);
+	return Boolean(name && CORE_PACKAGE_NAMES.has(name));
+}
+async function isEmptyDir(targetPath) {
+	try {
+		return (await fs.readdir(targetPath)).length === 0;
+	} catch {
+		return false;
+	}
+}
+function resolveGitInstallDir() {
+	const override = process.env.OPENCLAW_GIT_DIR?.trim();
+	if (override) return path.resolve(override);
+	return resolveDefaultGitDir();
+}
+function resolveDefaultGitDir() {
+	return path.join(os.homedir(), "openclaw");
+}
+function resolveNodeRunner() {
+	const base = path.basename(process.execPath).toLowerCase();
+	if (base === "node" || base === "node.exe") return process.execPath;
+	return "node";
+}
+async function resolveUpdateRoot() {
+	return await resolveOpenClawPackageRoot({
+		moduleUrl: import.meta.url,
+		argv1: process.argv[1],
+		cwd: process.cwd()
+	}) ?? process.cwd();
+}
+async function runUpdateStep(params) {
+	const command = params.argv.join(" ");
+	params.progress?.onStepStart?.({
+		name: params.name,
+		command,
+		index: 0,
+		total: 0
+	});
+	const started = Date.now();
+	const res = await runCommandWithTimeout(params.argv, {
+		cwd: params.cwd,
+		env: params.env,
+		timeoutMs: params.timeoutMs
+	});
+	const durationMs = Date.now() - started;
+	const stderrTail = trimLogTail(res.stderr, MAX_LOG_CHARS);
+	params.progress?.onStepComplete?.({
+		name: params.name,
+		command,
+		index: 0,
+		total: 0,
+		durationMs,
+		exitCode: res.code,
+		stderrTail
+	});
+	return {
+		name: params.name,
+		command,
+		cwd: params.cwd ?? process.cwd(),
+		durationMs,
+		exitCode: res.code,
+		stdoutTail: trimLogTail(res.stdout, MAX_LOG_CHARS),
+		stderrTail
+	};
+}
+async function ensureGitCheckout(params) {
+	const gitEnv = params.env ?? await createGlobalInstallEnv();
+	if (!await pathExists(params.dir)) return await runUpdateStep({
+		name: "git clone",
+		argv: [
+			"git",
+			"clone",
+			OPENCLAW_REPO_URL,
+			params.dir
+		],
+		env: gitEnv,
+		timeoutMs: params.timeoutMs,
+		progress: params.progress
+	});
+	if (!await isGitCheckout(params.dir)) {
+		if (!await isEmptyDir(params.dir)) throw new Error(`OPENCLAW_GIT_DIR points at a non-git directory: ${params.dir}. Set OPENCLAW_GIT_DIR to an empty folder or an openclaw checkout.`);
+		return await runUpdateStep({
+			name: "git clone",
+			argv: [
+				"git",
+				"clone",
+				OPENCLAW_REPO_URL,
+				params.dir
+			],
+			cwd: params.dir,
+			env: gitEnv,
+			timeoutMs: params.timeoutMs,
+			progress: params.progress
+		});
+	}
+	if (!await isCorePackage(params.dir)) throw new Error(`OPENCLAW_GIT_DIR does not look like a core checkout: ${params.dir}.`);
+	return null;
+}
+async function resolveGlobalManager(params) {
+	const runCommand = createGlobalCommandRunner();
+	if (params.installKind === "package") {
+		const detected = await detectGlobalInstallManagerForRoot(runCommand, params.root, params.timeoutMs);
+		if (detected) return detected;
+	}
+	return await detectGlobalInstallManagerByPresence(runCommand, params.timeoutMs) ?? "npm";
+}
+async function tryWriteCompletionCache(root, jsonMode) {
+	const binPath = path.join(root, "openclaw.mjs");
+	if (!await pathExists(binPath)) return;
+	const result = spawnSync(resolveNodeRunner(), [
+		binPath,
+		"completion",
+		"--write-state"
+	], {
+		cwd: root,
+		env: process.env,
+		encoding: "utf-8"
+	});
+	if (result.error) {
+		if (!jsonMode) defaultRuntime.log(theme.warn(`Completion cache update failed: ${String(result.error)}`));
+		return;
+	}
+	if (result.status !== 0 && !jsonMode) {
+		const stderr = (result.stderr ?? "").toString().trim();
+		const detail = stderr ? ` (${stderr})` : "";
+		defaultRuntime.log(theme.warn(`Completion cache update failed${detail}.`));
+	}
+}
+function createGlobalCommandRunner() {
+	return async (argv, options) => {
+		const res = await runCommandWithTimeout(argv, options);
+		return {
+			stdout: res.stdout,
+			stderr: res.stderr,
+			code: res.code
+		};
+	};
+}
+
+//#endregion
+//#region src/cli/update-cli/status.ts
+function formatGitStatusLine(params) {
+	const shortSha = params.sha ? params.sha.slice(0, 8) : null;
+	const branch = params.branch && params.branch !== "HEAD" ? params.branch : null;
+	const tag = params.tag;
+	return [
+		branch ?? (tag ? "detached" : "git"),
+		tag ? `tag ${tag}` : null,
+		shortSha ? `@ ${shortSha}` : null
+	].filter(Boolean).join(" · ");
+}
+async function updateStatusCommand(opts) {
+	const timeoutMs = parseTimeoutMsOrExit(opts.timeout);
+	if (timeoutMs === null) return;
+	const root = await resolveUpdateRoot();
+	const configSnapshot = await readConfigFileSnapshot();
+	const configChannel = configSnapshot.valid ? normalizeUpdateChannel(configSnapshot.config.update?.channel) : null;
+	const update = await checkUpdateStatus({
+		root,
+		timeoutMs: timeoutMs ?? 3500,
+		fetchGit: true,
+		includeRegistry: true
+	});
+	const channelInfo = resolveUpdateChannelDisplay({
+		configChannel,
+		installKind: update.installKind,
+		gitTag: update.git?.tag ?? null,
+		gitBranch: update.git?.branch ?? null
+	});
+	const channelLabel = channelInfo.label;
+	const gitLabel = update.installKind === "git" ? formatGitStatusLine({
+		branch: update.git?.branch ?? null,
+		tag: update.git?.tag ?? null,
+		sha: update.git?.sha ?? null
+	}) : null;
+	const updateAvailability = resolveUpdateAvailability(update);
+	const updateLine = formatUpdateOneLiner(update).replace(/^Update:\s*/i, "");
+	if (opts.json) {
+		defaultRuntime.writeJson({
+			update,
+			channel: {
+				value: channelInfo.channel,
+				source: channelInfo.source,
+				label: channelLabel,
+				config: configChannel
+			},
+			availability: updateAvailability
+		});
+		return;
+	}
+	const tableWidth = getTerminalTableWidth();
+	const rows = [
+		{
+			Item: "Install",
+			Value: update.installKind === "git" ? `git (${update.root ?? "unknown"})` : update.installKind === "package" ? update.packageManager : "unknown"
+		},
+		{
+			Item: "Channel",
+			Value: channelLabel
+		},
+		...gitLabel ? [{
+			Item: "Git",
+			Value: gitLabel
+		}] : [],
+		{
+			Item: "Update",
+			Value: updateAvailability.available ? theme.warn(`available · ${updateLine}`) : updateLine
+		}
+	];
+	defaultRuntime.log(theme.heading("OpenClaw update status"));
+	defaultRuntime.log("");
+	defaultRuntime.log(renderTable({
+		width: tableWidth,
+		columns: [{
+			key: "Item",
+			header: "Item",
+			minWidth: 10
+		}, {
+			key: "Value",
+			header: "Value",
+			flex: true,
+			minWidth: 24
+		}],
+		rows
+	}).trimEnd());
+	defaultRuntime.log("");
+	const updateHint = formatUpdateAvailableHint(update);
+	if (updateHint) defaultRuntime.log(theme.warn(updateHint));
+}
+
+//#endregion
+//#region src/cli/update-cli/progress.ts
+const STEP_LABELS = {
+	"clean check": "Working directory is clean",
+	"upstream check": "Upstream branch exists",
+	"git fetch": "Fetching latest changes",
+	"git rebase": "Rebasing onto target commit",
+	"git rev-parse @{upstream}": "Resolving upstream commit",
+	"git rev-list": "Enumerating candidate commits",
+	"git clone": "Cloning git checkout",
+	"preflight worktree": "Preparing preflight worktree",
+	"preflight cleanup": "Cleaning preflight worktree",
+	"deps install": "Installing dependencies",
+	build: "Building",
+	"ui:build": "Building UI assets",
+	"ui:build (post-doctor repair)": "Restoring missing UI assets",
+	"ui assets verify": "Validating UI assets",
+	"openclaw doctor entry": "Checking doctor entrypoint",
+	"openclaw doctor": "Running doctor checks",
+	"git rev-parse HEAD (after)": "Verifying update",
+	"global update": "Updating via package manager",
+	"global update (omit optional)": "Retrying update without optional deps",
+	"global install": "Installing global package"
+};
+function getStepLabel(step) {
+	return STEP_LABELS[step.name] ?? step.name;
+}
+function inferUpdateFailureHints(result) {
+	if (result.status !== "error" || result.mode !== "npm") return [];
+	const failedStep = [...result.steps].toReversed().find((step) => step.exitCode !== 0);
+	if (!failedStep) return [];
+	const stderr = (failedStep.stderrTail ?? "").toLowerCase();
+	const hints = [];
+	if (failedStep.name.startsWith("global update") && stderr.includes("eacces")) {
+		hints.push("Detected permission failure (EACCES). Re-run with a writable global prefix or sudo (for system-managed Node installs).");
+		hints.push("Example: npm config set prefix ~/.local && npm i -g openclaw@latest");
+	}
+	if (failedStep.name.startsWith("global update") && (stderr.includes("node-gyp") || stderr.includes("prebuild"))) {
+		hints.push("Detected native optional dependency build failure. The updater retries with --omit=optional automatically.");
+		hints.push("If it still fails: npm i -g openclaw@latest --omit=optional");
+	}
+	return hints;
+}
+function createUpdateProgress(enabled) {
+	if (!enabled) return {
+		progress: {},
+		stop: () => {}
+	};
+	let currentSpinner = null;
+	return {
+		progress: {
+			onStepStart: (step) => {
+				currentSpinner = spinner();
+				currentSpinner.start(theme.accent(getStepLabel(step)));
+			},
+			onStepComplete: (step) => {
+				if (!currentSpinner) return;
+				const label = getStepLabel(step);
+				const duration = theme.muted(`(${formatDurationPrecise(step.durationMs)})`);
+				const icon = step.exitCode === 0 ? theme.success("✓") : theme.error("✗");
+				currentSpinner.stop(`${icon} ${label} ${duration}`);
+				currentSpinner = null;
+				if (step.exitCode !== 0 && step.stderrTail) {
+					const lines = step.stderrTail.split("\n").slice(-10);
+					for (const line of lines) if (line.trim()) defaultRuntime.log(`    ${theme.error(line)}`);
+				}
+			}
+		},
+		stop: () => {
+			if (currentSpinner) {
+				currentSpinner.stop();
+				currentSpinner = null;
+			}
+		}
+	};
+}
+function formatStepStatus(exitCode) {
+	if (exitCode === 0) return theme.success("✓");
+	if (exitCode === null) return theme.warn("?");
+	return theme.error("✗");
+}
+function printResult(result, opts) {
+	if (opts.json) {
+		defaultRuntime.writeJson(result);
+		return;
+	}
+	const statusColor = result.status === "ok" ? theme.success : result.status === "skipped" ? theme.warn : theme.error;
+	defaultRuntime.log("");
+	defaultRuntime.log(`${theme.heading("Update Result:")} ${statusColor(result.status.toUpperCase())}`);
+	if (result.root) defaultRuntime.log(`  Root: ${theme.muted(result.root)}`);
+	if (result.reason) defaultRuntime.log(`  Reason: ${theme.muted(result.reason)}`);
+	if (result.before?.version || result.before?.sha) {
+		const before = result.before.version ?? result.before.sha?.slice(0, 8) ?? "";
+		defaultRuntime.log(`  Before: ${theme.muted(before)}`);
+	}
+	if (result.after?.version || result.after?.sha) {
+		const after = result.after.version ?? result.after.sha?.slice(0, 8) ?? "";
+		defaultRuntime.log(`  After: ${theme.muted(after)}`);
+	}
+	if (!opts.hideSteps && result.steps.length > 0) {
+		defaultRuntime.log("");
+		defaultRuntime.log(theme.heading("Steps:"));
+		for (const step of result.steps) {
+			const status = formatStepStatus(step.exitCode);
+			const duration = theme.muted(`(${formatDurationPrecise(step.durationMs)})`);
+			defaultRuntime.log(`  ${status} ${step.name} ${duration}`);
+			if (step.exitCode !== 0 && step.stderrTail) {
+				const lines = step.stderrTail.split("\n").slice(0, 5);
+				for (const line of lines) if (line.trim()) defaultRuntime.log(`      ${theme.error(line)}`);
+			}
+		}
+	}
+	const hints = inferUpdateFailureHints(result);
+	if (hints.length > 0) {
+		defaultRuntime.log("");
+		defaultRuntime.log(theme.heading("Recovery hints:"));
+		for (const hint of hints) defaultRuntime.log(`  - ${theme.warn(hint)}`);
+	}
+	defaultRuntime.log("");
+	defaultRuntime.log(`Total time: ${theme.muted(formatDurationPrecise(result.durationMs))}`);
+}
+
+//#endregion
+//#region src/cli/update-cli/restart-helper.ts
+/**
+* Shell-escape a string for embedding in single-quoted shell arguments.
+* Replaces every `'` with `'\''` (end quote, escaped quote, resume quote).
+* For batch scripts, validates against special characters instead.
+*/
+function shellEscape(value) {
+	return value.replace(/'/g, "'\\''");
+}
+/** Validates a string is safe for embedding in a batch (cmd.exe) script. */
+function isBatchSafe(value) {
+	return /^[A-Za-z0-9 _\-().]+$/.test(value);
+}
+function resolveSystemdUnit(env) {
+	const override = env.OPENCLAW_SYSTEMD_UNIT?.trim();
+	if (override) return override.endsWith(".service") ? override : `${override}.service`;
+	return `${resolveGatewaySystemdServiceName(env.OPENCLAW_PROFILE)}.service`;
+}
+function resolveLaunchdLabel(env) {
+	const override = env.OPENCLAW_LAUNCHD_LABEL?.trim();
+	if (override) return override;
+	return resolveGatewayLaunchAgentLabel(env.OPENCLAW_PROFILE);
+}
+function resolveWindowsTaskName(env) {
+	const override = env.OPENCLAW_WINDOWS_TASK_NAME?.trim();
+	if (override) return override;
+	return resolveGatewayWindowsTaskName(env.OPENCLAW_PROFILE);
+}
+/**
+* Prepares a standalone script to restart the gateway service.
+* This script is written to a temporary directory and does not depend on
+* the installed package files, ensuring restart capability even if the
+* update process temporarily removes or corrupts installation files.
+*/
+async function prepareRestartScript(env = process.env, gatewayPort = DEFAULT_GATEWAY_PORT) {
+	const tmpDir = os.tmpdir();
+	const timestamp = Date.now();
+	const platform$1 = process.platform;
+	let scriptContent = "";
+	let filename = "";
+	try {
+		if (platform$1 === "linux") {
+			const escaped = shellEscape(resolveSystemdUnit(env));
+			filename = `openclaw-restart-${timestamp}.sh`;
+			scriptContent = `#!/bin/sh
+# Standalone restart script — survives parent process termination.
+# Wait briefly to ensure file locks are released after update.
+sleep 1
+systemctl --user restart '${escaped}'
+# Self-cleanup
+rm -f "$0"
+`;
+		} else if (platform$1 === "darwin") {
+			const label = resolveLaunchdLabel(env);
+			const escaped = shellEscape(label);
+			const uid = process.getuid ? process.getuid() : 501;
+			const home = env.HOME?.trim() || process.env.HOME || os.homedir();
+			const escapedPlistPath = shellEscape(path.join(home, "Library", "LaunchAgents", `${label}.plist`));
+			filename = `openclaw-restart-${timestamp}.sh`;
+			scriptContent = `#!/bin/sh
+# Standalone restart script — survives parent process termination.
+# Wait briefly to ensure file locks are released after update.
+sleep 1
+# Try kickstart first (works when the service is still registered).
+# If it fails (e.g. after bootout), clear any persisted disabled state,
+# then re-register via bootstrap and kickstart.
+if ! launchctl kickstart -k 'gui/${uid}/${escaped}' 2>/dev/null; then
+  launchctl enable 'gui/${uid}/${escaped}' 2>/dev/null
+  launchctl bootstrap 'gui/${uid}' '${escapedPlistPath}' 2>/dev/null
+  launchctl kickstart -k 'gui/${uid}/${escaped}' 2>/dev/null || true
+fi
+# Self-cleanup
+rm -f "$0"
+`;
+		} else if (platform$1 === "win32") {
+			const taskName = resolveWindowsTaskName(env);
+			if (!isBatchSafe(taskName)) return null;
+			const port = Number.isFinite(gatewayPort) && gatewayPort > 0 ? gatewayPort : DEFAULT_GATEWAY_PORT;
+			filename = `openclaw-restart-${timestamp}.bat`;
+			scriptContent = `@echo off
+REM Standalone restart script — survives parent process termination.
+REM Wait briefly to ensure file locks are released after update.
+timeout /t 2 /nobreak >nul
+schtasks /End /TN "${taskName}"
+REM Poll for gateway port release before rerun; force-kill listener if stuck.
+set /a attempts=0
+:wait_for_port_release
+set /a attempts+=1
+netstat -ano | findstr /R /C:":${port} .*LISTENING" >nul
+if errorlevel 1 goto port_released
+if %attempts% GEQ 10 goto force_kill_listener
+timeout /t 1 /nobreak >nul
+goto wait_for_port_release
+:force_kill_listener
+for /f "tokens=5" %%P in ('netstat -ano ^| findstr /R /C:":${port} .*LISTENING"') do (
+  taskkill /F /PID %%P >nul 2>&1
+  goto port_released
+)
+:port_released
+schtasks /Run /TN "${taskName}"
+REM Self-cleanup
+del "%~f0"
+`;
+		} else return null;
+		const scriptPath = path.join(tmpDir, filename);
+		await fs.writeFile(scriptPath, scriptContent, { mode: 493 });
+		return scriptPath;
+	} catch {
+		return null;
+	}
+}
+/**
+* Executes the prepared restart script as a **detached** process.
+*
+* The script must outlive the CLI process because the CLI itself is part
+* of the service being restarted — `systemctl restart` / `launchctl
+* kickstart -k` will terminate the current process tree.  Using
+* `spawn({ detached: true })` + `unref()` ensures the script survives
+* the parent's exit.
+*
+* Resolves immediately after spawning; the script runs independently.
+*/
+async function runRestartScript(scriptPath) {
+	const isWindows = process.platform === "win32";
+	spawn(isWindows ? "cmd.exe" : "/bin/sh", isWindows ? [
+		"/d",
+		"/s",
+		"/c",
+		quoteCmdScriptArg(scriptPath)
+	] : [scriptPath], {
+		detached: true,
+		stdio: "ignore",
+		windowsHide: true
+	}).unref();
+}
+
+//#endregion
+//#region src/cli/update-cli/suppress-deprecations.ts
+/**
+* Suppress Node.js deprecation warnings.
+*
+* On Node.js v23+ `process.noDeprecation` may be a read-only property
+* (defined via a getter on the prototype with no setter), so the
+* assignment can throw. We fall back to the environment variable which
+* achieves the same effect.
+*/
+function suppressDeprecations() {
+	try {
+		process.noDeprecation = true;
+	} catch {}
+	process.env.NODE_NO_WARNINGS = "1";
+}
+
+//#endregion
+//#region src/cli/update-cli/update-command.ts
+const CLI_NAME = resolveCliName();
+const SERVICE_REFRESH_TIMEOUT_MS = 6e4;
+const SERVICE_REFRESH_PATH_ENV_KEYS = [
+	"OPENCLAW_HOME",
+	"OPENCLAW_STATE_DIR",
+	"OPENCLAW_CONFIG_PATH"
+];
+const UPDATE_QUIPS = [
+	"Leveled up! New skills unlocked. You're welcome.",
+	"Fresh code, same lobster. Miss me?",
+	"Back and better. Did you even notice I was gone?",
+	"Update complete. I learned some new tricks while I was out.",
+	"Upgraded! Now with 23% more sass.",
+	"I've evolved. Try to keep up.",
+	"New version, who dis? Oh right, still me but shinier.",
+	"Patched, polished, and ready to pinch. Let's go.",
+	"The lobster has molted. Harder shell, sharper claws.",
+	"Update done! Check the changelog or just trust me, it's good.",
+	"Reborn from the boiling waters of npm. Stronger now.",
+	"I went away and came back smarter. You should try it sometime.",
+	"Update complete. The bugs feared me, so they left.",
+	"New version installed. Old version sends its regards.",
+	"Firmware fresh. Brain wrinkles: increased.",
+	"I've seen things you wouldn't believe. Anyway, I'm updated.",
+	"Back online. The changelog is long but our friendship is longer.",
+	"Upgraded! Peter fixed stuff. Blame him if it breaks.",
+	"Molting complete. Please don't look at my soft shell phase.",
+	"Version bump! Same chaos energy, fewer crashes (probably)."
+];
+function pickUpdateQuip() {
+	return UPDATE_QUIPS[Math.floor(Math.random() * UPDATE_QUIPS.length)] ?? "Update complete.";
+}
+function resolveGatewayInstallEntrypointCandidates(root) {
+	if (!root) return [];
+	return [
+		path.join(root, "dist", "entry.js"),
+		path.join(root, "dist", "entry.mjs"),
+		path.join(root, "dist", "index.js"),
+		path.join(root, "dist", "index.mjs")
+	];
+}
+function formatCommandFailure(stdout, stderr) {
+	const detail = (stderr || stdout).trim();
+	if (!detail) return "command returned a non-zero exit code";
+	return detail.split("\n").slice(-3).join("\n");
+}
+function tryResolveInvocationCwd() {
+	try {
+		return process.cwd();
+	} catch {
+		return;
+	}
+}
+function resolveServiceRefreshEnv(env, invocationCwd) {
+	const resolvedEnv = { ...env };
+	for (const key of SERVICE_REFRESH_PATH_ENV_KEYS) {
+		const rawValue = resolvedEnv[key]?.trim();
+		if (!rawValue) continue;
+		if (rawValue.startsWith("~") || path.isAbsolute(rawValue) || path.win32.isAbsolute(rawValue)) {
+			resolvedEnv[key] = rawValue;
+			continue;
+		}
+		if (!invocationCwd) {
+			resolvedEnv[key] = rawValue;
+			continue;
+		}
+		resolvedEnv[key] = path.resolve(invocationCwd, rawValue);
+	}
+	return resolvedEnv;
+}
+function printDryRunPreview(preview, jsonMode) {
+	if (jsonMode) {
+		defaultRuntime.writeJson(preview);
+		return;
+	}
+	defaultRuntime.log(theme.heading("Update dry-run"));
+	defaultRuntime.log(theme.muted("No changes were applied."));
+	defaultRuntime.log("");
+	defaultRuntime.log(`  Root: ${theme.muted(preview.root)}`);
+	defaultRuntime.log(`  Install kind: ${theme.muted(preview.installKind)}`);
+	defaultRuntime.log(`  Mode: ${theme.muted(preview.mode)}`);
+	defaultRuntime.log(`  Channel: ${theme.muted(preview.effectiveChannel)}`);
+	defaultRuntime.log(`  Tag/spec: ${theme.muted(preview.tag)}`);
+	if (preview.currentVersion) defaultRuntime.log(`  Current version: ${theme.muted(preview.currentVersion)}`);
+	if (preview.targetVersion) defaultRuntime.log(`  Target version: ${theme.muted(preview.targetVersion)}`);
+	if (preview.downgradeRisk) defaultRuntime.log(theme.warn("  Downgrade confirmation would be required in a real run."));
+	defaultRuntime.log("");
+	defaultRuntime.log(theme.heading("Planned actions:"));
+	for (const action of preview.actions) defaultRuntime.log(`  - ${action}`);
+	if (preview.notes.length > 0) {
+		defaultRuntime.log("");
+		defaultRuntime.log(theme.heading("Notes:"));
+		for (const note$1 of preview.notes) defaultRuntime.log(`  - ${theme.muted(note$1)}`);
+	}
+}
+async function refreshGatewayServiceEnv(params) {
+	const args = [
+		"gateway",
+		"install",
+		"--force"
+	];
+	if (params.jsonMode) args.push("--json");
+	for (const candidate of resolveGatewayInstallEntrypointCandidates(params.result.root)) {
+		if (!await pathExists(candidate)) continue;
+		const res = await runCommandWithTimeout([
+			resolveNodeRunner(),
+			candidate,
+			...args
+		], {
+			cwd: params.result.root,
+			env: resolveServiceRefreshEnv(process.env, params.invocationCwd),
+			timeoutMs: SERVICE_REFRESH_TIMEOUT_MS
+		});
+		if (res.code === 0) return;
+		throw new Error(`updated install refresh failed (${candidate}): ${formatCommandFailure(res.stdout, res.stderr)}`);
+	}
+	await runDaemonInstall({
+		force: true,
+		json: params.jsonMode || void 0
+	});
+}
+async function tryInstallShellCompletion(opts) {
+	if (opts.jsonMode || !process.stdin.isTTY) return;
+	const status = await checkShellCompletionStatus(CLI_NAME);
+	if (status.usesSlowPattern) {
+		defaultRuntime.log(theme.muted("Upgrading shell completion to cached version..."));
+		if (await ensureCompletionCacheExists(CLI_NAME)) await installCompletion(status.shell, true, CLI_NAME);
+		return;
+	}
+	if (status.profileInstalled && !status.cacheExists) {
+		defaultRuntime.log(theme.muted("Regenerating shell completion cache..."));
+		await ensureCompletionCacheExists(CLI_NAME);
+		return;
+	}
+	if (!status.profileInstalled) {
+		defaultRuntime.log("");
+		defaultRuntime.log(theme.heading("Shell completion"));
+		const shouldInstall = await confirm({
+			message: stylePromptMessage(`Enable ${status.shell} shell completion for ${CLI_NAME}?`),
+			initialValue: true
+		});
+		if (isCancel(shouldInstall) || !shouldInstall) {
+			if (!opts.skipPrompt) defaultRuntime.log(theme.muted(`Skipped. Run \`${replaceCliName(formatCliCommand("openclaw completion --install"), CLI_NAME)}\` later to enable.`));
+			return;
+		}
+		if (!await ensureCompletionCacheExists(CLI_NAME)) {
+			defaultRuntime.log(theme.warn("Failed to generate completion cache."));
+			return;
+		}
+		await installCompletion(status.shell, opts.skipPrompt, CLI_NAME);
+	}
+}
+async function runPackageInstallUpdate(params) {
+	const manager = await resolveGlobalManager({
+		root: params.root,
+		installKind: params.installKind,
+		timeoutMs: params.timeoutMs
+	});
+	const installEnv = await createGlobalInstallEnv();
+	const pkgRoot = await resolveGlobalPackageRoot(manager, createGlobalCommandRunner(), params.timeoutMs);
+	const packageName = (pkgRoot ? await readPackageName(pkgRoot) : await readPackageName(params.root)) ?? DEFAULT_PACKAGE_NAME;
+	const installSpec = resolveGlobalInstallSpec({
+		packageName,
+		tag: params.tag,
+		env: installEnv
+	});
+	const beforeVersion = pkgRoot ? await readPackageVersion(pkgRoot) : null;
+	if (pkgRoot) await cleanupGlobalRenameDirs({
+		globalRoot: path.dirname(pkgRoot),
+		packageName
+	});
+	const steps = [await runUpdateStep({
+		name: "global update",
+		argv: globalInstallArgs(manager, installSpec),
+		env: installEnv,
+		timeoutMs: params.timeoutMs,
+		progress: params.progress
+	})];
+	let afterVersion = beforeVersion;
+	if (pkgRoot) {
+		afterVersion = await readPackageVersion(pkgRoot);
+		const entryPath = path.join(pkgRoot, "dist", "entry.js");
+		if (await pathExists(entryPath)) {
+			const doctorStep = await runUpdateStep({
+				name: `${CLI_NAME} doctor`,
+				argv: [
+					resolveNodeRunner(),
+					entryPath,
+					"doctor",
+					"--non-interactive"
+				],
+				timeoutMs: params.timeoutMs,
+				progress: params.progress
+			});
+			steps.push(doctorStep);
+		}
+	}
+	const failedStep = steps.find((step) => step.exitCode !== 0);
+	return {
+		status: failedStep ? "error" : "ok",
+		mode: manager,
+		root: pkgRoot ?? params.root,
+		reason: failedStep ? failedStep.name : void 0,
+		before: { version: beforeVersion },
+		after: { version: afterVersion },
+		steps,
+		durationMs: Date.now() - params.startedAt
+	};
+}
+async function runGitUpdate(params) {
+	const updateRoot = params.switchToGit ? resolveGitInstallDir() : params.root;
+	const effectiveTimeout = params.timeoutMs ?? 20 * 6e4;
+	const installEnv = await createGlobalInstallEnv();
+	const cloneStep = params.switchToGit ? await ensureGitCheckout({
+		dir: updateRoot,
+		env: installEnv,
+		timeoutMs: effectiveTimeout,
+		progress: params.progress
+	}) : null;
+	if (cloneStep && cloneStep.exitCode !== 0) {
+		const result = {
+			status: "error",
+			mode: "git",
+			root: updateRoot,
+			reason: cloneStep.name,
+			steps: [cloneStep],
+			durationMs: Date.now() - params.startedAt
+		};
+		params.stop();
+		printResult(result, {
+			...params.opts,
+			hideSteps: params.showProgress
+		});
+		defaultRuntime.exit(1);
+		return result;
+	}
+	const updateResult = await runGatewayUpdate({
+		cwd: updateRoot,
+		argv1: params.switchToGit ? void 0 : process.argv[1],
+		timeoutMs: params.timeoutMs,
+		progress: params.progress,
+		channel: params.channel,
+		tag: params.tag
+	});
+	const steps = [...cloneStep ? [cloneStep] : [], ...updateResult.steps];
+	if (params.switchToGit && updateResult.status === "ok") {
+		const installStep = await runUpdateStep({
+			name: "global install",
+			argv: globalInstallArgs(await resolveGlobalManager({
+				root: params.root,
+				installKind: params.installKind,
+				timeoutMs: effectiveTimeout
+			}), updateRoot),
+			cwd: updateRoot,
+			env: installEnv,
+			timeoutMs: effectiveTimeout,
+			progress: params.progress
+		});
+		steps.push(installStep);
+		const failedStep = installStep.exitCode !== 0 ? installStep : null;
+		return {
+			...updateResult,
+			status: updateResult.status === "ok" && !failedStep ? "ok" : "error",
+			steps,
+			durationMs: Date.now() - params.startedAt
+		};
+	}
+	return {
+		...updateResult,
+		steps,
+		durationMs: Date.now() - params.startedAt
+	};
+}
+async function updatePluginsAfterCoreUpdate(params) {
+	if (!params.configSnapshot.valid) {
+		if (!params.opts.json) defaultRuntime.log(theme.warn("Skipping plugin updates: config is invalid."));
+		return;
+	}
+	const pluginLogger = params.opts.json ? {} : {
+		info: (msg) => defaultRuntime.log(msg),
+		warn: (msg) => defaultRuntime.log(theme.warn(msg)),
+		error: (msg) => defaultRuntime.log(theme.error(msg))
+	};
+	if (!params.opts.json) {
+		defaultRuntime.log("");
+		defaultRuntime.log(theme.heading("Updating plugins..."));
+	}
+	const syncResult = await syncPluginsForUpdateChannel({
+		config: params.configSnapshot.config,
+		channel: params.channel,
+		workspaceDir: params.root,
+		logger: pluginLogger
+	});
+	let pluginConfig = syncResult.config;
+	const npmResult = await updateNpmInstalledPlugins({
+		config: pluginConfig,
+		skipIds: new Set(syncResult.summary.switchedToNpm),
+		logger: pluginLogger
+	});
+	pluginConfig = npmResult.config;
+	if (syncResult.changed || npmResult.changed) await writeConfigFile(pluginConfig);
+	if (params.opts.json) return;
+	const summarizeList = (list) => {
+		if (list.length <= 6) return list.join(", ");
+		return `${list.slice(0, 6).join(", ")} +${list.length - 6} more`;
+	};
+	if (syncResult.summary.switchedToBundled.length > 0) defaultRuntime.log(theme.muted(`Switched to bundled plugins: ${summarizeList(syncResult.summary.switchedToBundled)}.`));
+	if (syncResult.summary.switchedToNpm.length > 0) defaultRuntime.log(theme.muted(`Restored npm plugins: ${summarizeList(syncResult.summary.switchedToNpm)}.`));
+	for (const warning of syncResult.summary.warnings) defaultRuntime.log(theme.warn(warning));
+	for (const error of syncResult.summary.errors) defaultRuntime.log(theme.error(error));
+	const updated = npmResult.outcomes.filter((entry) => entry.status === "updated").length;
+	const unchanged = npmResult.outcomes.filter((entry) => entry.status === "unchanged").length;
+	const failed = npmResult.outcomes.filter((entry) => entry.status === "error").length;
+	const skipped = npmResult.outcomes.filter((entry) => entry.status === "skipped").length;
+	if (npmResult.outcomes.length === 0) defaultRuntime.log(theme.muted("No plugin updates needed."));
+	else {
+		const parts = [`${updated} updated`, `${unchanged} unchanged`];
+		if (failed > 0) parts.push(`${failed} failed`);
+		if (skipped > 0) parts.push(`${skipped} skipped`);
+		defaultRuntime.log(theme.muted(`npm plugins: ${parts.join(", ")}.`));
+	}
+	for (const outcome of npmResult.outcomes) {
+		if (outcome.status !== "error") continue;
+		defaultRuntime.log(theme.error(outcome.message));
+	}
+}
+async function maybeRestartService(params) {
+	if (params.shouldRestart) {
+		if (!params.opts.json) {
+			defaultRuntime.log("");
+			defaultRuntime.log(theme.heading("Restarting service..."));
+		}
+		try {
+			let restarted = false;
+			let restartInitiated = false;
+			if (params.refreshServiceEnv) try {
+				await refreshGatewayServiceEnv({
+					result: params.result,
+					jsonMode: Boolean(params.opts.json),
+					invocationCwd: params.invocationCwd
+				});
+			} catch (err) {
+				if (!params.opts.json) defaultRuntime.log(theme.warn(`Failed to refresh gateway service environment from updated install: ${String(err)}`));
+			}
+			if (params.restartScriptPath) {
+				await runRestartScript(params.restartScriptPath);
+				restartInitiated = true;
+			} else restarted = await runDaemonRestart();
+			if (!params.opts.json && restarted) {
+				defaultRuntime.log(theme.success("Daemon restarted successfully."));
+				defaultRuntime.log("");
+				process.env.OPENCLAW_UPDATE_IN_PROGRESS = "1";
+				try {
+					await doctorCommand(defaultRuntime, { nonInteractive: !(Boolean(process.stdin.isTTY) && !params.opts.json && params.opts.yes !== true) });
+				} catch (err) {
+					defaultRuntime.log(theme.warn(`Doctor failed: ${String(err)}`));
+				} finally {
+					delete process.env.OPENCLAW_UPDATE_IN_PROGRESS;
+				}
+			}
+			if (!params.opts.json && restartInitiated) {
+				const service = resolveGatewayService();
+				let health = await waitForGatewayHealthyRestart({
+					service,
+					port: params.gatewayPort
+				});
+				if (!health.healthy && health.staleGatewayPids.length > 0) {
+					if (!params.opts.json) defaultRuntime.log(theme.warn(`Found stale gateway process(es) after restart: ${health.staleGatewayPids.join(", ")}. Cleaning up...`));
+					await terminateStaleGatewayPids(health.staleGatewayPids);
+					await runDaemonRestart();
+					health = await waitForGatewayHealthyRestart({
+						service,
+						port: params.gatewayPort
+					});
+				}
+				if (health.healthy) defaultRuntime.log(theme.success("Daemon restart completed."));
+				else {
+					defaultRuntime.log(theme.warn("Gateway did not become healthy after restart."));
+					for (const line of renderRestartDiagnostics(health)) defaultRuntime.log(theme.muted(line));
+					defaultRuntime.log(theme.muted(`Run \`${replaceCliName(formatCliCommand("openclaw gateway status --deep"), CLI_NAME)}\` for details.`));
+				}
+				defaultRuntime.log("");
+			}
+		} catch (err) {
+			if (!params.opts.json) {
+				defaultRuntime.log(theme.warn(`Daemon restart failed: ${String(err)}`));
+				defaultRuntime.log(theme.muted(`You may need to restart the service manually: ${replaceCliName(formatCliCommand("openclaw gateway restart"), CLI_NAME)}`));
+			}
+		}
+		return;
+	}
+	if (!params.opts.json) {
+		defaultRuntime.log("");
+		if (params.result.mode === "npm" || params.result.mode === "pnpm") defaultRuntime.log(theme.muted(`Tip: Run \`${replaceCliName(formatCliCommand("openclaw doctor"), CLI_NAME)}\`, then \`${replaceCliName(formatCliCommand("openclaw gateway restart"), CLI_NAME)}\` to apply updates to a running gateway.`));
+		else defaultRuntime.log(theme.muted(`Tip: Run \`${replaceCliName(formatCliCommand("openclaw gateway restart"), CLI_NAME)}\` to apply updates to a running gateway.`));
+	}
+}
+async function updateCommand(opts) {
+	suppressDeprecations();
+	const invocationCwd = tryResolveInvocationCwd();
+	const timeoutMs = parseTimeoutMsOrExit(opts.timeout);
+	const shouldRestart = opts.restart !== false;
+	if (timeoutMs === null) return;
+	const root = await resolveUpdateRoot();
+	const updateStatus = await checkUpdateStatus({
+		root,
+		timeoutMs: timeoutMs ?? 3500,
+		fetchGit: false,
+		includeRegistry: false
+	});
+	const configSnapshot = await readConfigFileSnapshot();
+	const storedChannel = configSnapshot.valid ? normalizeUpdateChannel(configSnapshot.config.update?.channel) : null;
+	const requestedChannel = normalizeUpdateChannel(opts.channel);
+	if (opts.channel && !requestedChannel) {
+		defaultRuntime.error(`--channel must be "stable", "beta", or "dev" (got "${opts.channel}")`);
+		defaultRuntime.exit(1);
+		return;
+	}
+	if (opts.channel && !configSnapshot.valid) {
+		const issues = formatConfigIssueLines(configSnapshot.issues, "-");
+		defaultRuntime.error(["Config is invalid; cannot set update channel.", ...issues].join("\n"));
+		defaultRuntime.exit(1);
+		return;
+	}
+	const installKind = updateStatus.installKind;
+	const switchToGit = requestedChannel === "dev" && installKind !== "git";
+	const switchToPackage = requestedChannel !== null && requestedChannel !== "dev" && installKind === "git";
+	const updateInstallKind = switchToGit ? "git" : switchToPackage ? "package" : installKind;
+	const channel = requestedChannel ?? storedChannel ?? (updateInstallKind === "git" ? DEFAULT_GIT_CHANNEL : DEFAULT_PACKAGE_CHANNEL);
+	const explicitTag = normalizeTag(opts.tag);
+	let tag = explicitTag ?? channelToNpmTag(channel);
+	let currentVersion = null;
+	let targetVersion = null;
+	let downgradeRisk = false;
+	let fallbackToLatest = false;
+	let packageInstallSpec = null;
+	if (updateInstallKind !== "git") {
+		currentVersion = switchToPackage ? null : await readPackageVersion(root);
+		if (explicitTag) targetVersion = await resolveTargetVersion(tag, timeoutMs);
+		else targetVersion = await resolveNpmChannelTag({
+			channel,
+			timeoutMs
+		}).then((resolved) => {
+			tag = resolved.tag;
+			fallbackToLatest = channel === "beta" && resolved.tag === "latest";
+			return resolved.version;
+		});
+		const cmp = currentVersion && targetVersion ? compareSemverStrings(currentVersion, targetVersion) : null;
+		downgradeRisk = canResolveRegistryVersionForPackageTarget(tag) && !fallbackToLatest && currentVersion != null && (targetVersion == null || cmp != null && cmp > 0);
+		packageInstallSpec = resolveGlobalInstallSpec({
+			packageName: DEFAULT_PACKAGE_NAME,
+			tag,
+			env: process.env
+		});
+	}
+	if (opts.dryRun) {
+		let mode = "unknown";
+		if (updateInstallKind === "git") mode = "git";
+		else if (updateInstallKind === "package") mode = await resolveGlobalManager({
+			root,
+			installKind,
+			timeoutMs: timeoutMs ?? 20 * 6e4
+		});
+		const actions = [];
+		if (requestedChannel && requestedChannel !== storedChannel) actions.push(`Persist update.channel=${requestedChannel} in config`);
+		if (switchToGit) actions.push("Switch install mode from package to git checkout (dev channel)");
+		else if (switchToPackage) actions.push(`Switch install mode from git to package manager (${mode})`);
+		else if (updateInstallKind === "git") actions.push(`Run git update flow on channel ${channel} (fetch/rebase/build/doctor)`);
+		else actions.push(`Run global package manager update with spec ${packageInstallSpec ?? tag}`);
+		actions.push("Run plugin update sync after core update");
+		actions.push("Refresh shell completion cache (if needed)");
+		actions.push(shouldRestart ? "Restart gateway service and run doctor checks" : "Skip restart (because --no-restart is set)");
+		const notes = [];
+		if (opts.tag && updateInstallKind === "git") notes.push("--tag applies to npm installs only; git updates ignore it.");
+		if (fallbackToLatest) notes.push("Beta channel resolves to latest for this run (fallback).");
+		if (explicitTag && !canResolveRegistryVersionForPackageTarget(tag)) notes.push("Non-registry package specs skip npm version lookup and downgrade previews.");
+		printDryRunPreview({
+			dryRun: true,
+			root,
+			installKind,
+			mode,
+			updateInstallKind,
+			switchToGit,
+			switchToPackage,
+			restart: shouldRestart,
+			requestedChannel,
+			storedChannel,
+			effectiveChannel: channel,
+			tag: packageInstallSpec ?? tag,
+			currentVersion,
+			targetVersion,
+			downgradeRisk,
+			actions,
+			notes
+		}, Boolean(opts.json));
+		return;
+	}
+	if (downgradeRisk && !opts.yes) {
+		if (!process.stdin.isTTY || opts.json) {
+			defaultRuntime.error(["Downgrade confirmation required.", "Downgrading can break configuration. Re-run in a TTY to confirm."].join("\n"));
+			defaultRuntime.exit(1);
+			return;
+		}
+		const targetLabel = targetVersion ?? `${tag} (unknown)`;
+		const ok = await confirm({
+			message: stylePromptMessage(`Downgrading from ${currentVersion} to ${targetLabel} can break configuration. Continue?`),
+			initialValue: false
+		});
+		if (isCancel(ok) || !ok) {
+			if (!opts.json) defaultRuntime.log(theme.muted("Update cancelled."));
+			defaultRuntime.exit(0);
+			return;
+		}
+	}
+	if (updateInstallKind === "git" && opts.tag && !opts.json) defaultRuntime.log(theme.muted("Note: --tag applies to npm installs only; git updates ignore it."));
+	const showProgress = !opts.json && process.stdout.isTTY;
+	if (!opts.json) {
+		defaultRuntime.log(theme.heading("Updating OpenClaw..."));
+		defaultRuntime.log("");
+	}
+	const { progress, stop } = createUpdateProgress(showProgress);
+	const startedAt = Date.now();
+	let restartScriptPath = null;
+	let refreshGatewayServiceEnv$1 = false;
+	const gatewayPort = resolveGatewayPort(configSnapshot.valid ? configSnapshot.config : void 0, process.env);
+	if (shouldRestart) try {
+		if (await resolveGatewayService().isLoaded({ env: process.env })) {
+			restartScriptPath = await prepareRestartScript(process.env, gatewayPort);
+			refreshGatewayServiceEnv$1 = true;
+		}
+	} catch {}
+	const result = updateInstallKind === "package" ? await runPackageInstallUpdate({
+		root,
+		installKind,
+		tag,
+		timeoutMs: timeoutMs ?? 20 * 6e4,
+		startedAt,
+		progress
+	}) : await runGitUpdate({
+		root,
+		switchToGit,
+		installKind,
+		timeoutMs,
+		startedAt,
+		progress,
+		channel,
+		tag,
+		showProgress,
+		opts,
+		stop
+	});
+	stop();
+	printResult(result, {
+		...opts,
+		hideSteps: showProgress
+	});
+	if (result.status === "error") {
+		defaultRuntime.exit(1);
+		return;
+	}
+	if (result.status === "skipped") {
+		if (result.reason === "dirty") defaultRuntime.log(theme.warn("Skipped: working directory has uncommitted changes. Commit or stash them first."));
+		if (result.reason === "not-git-install") {
+			defaultRuntime.log(theme.warn(`Skipped: this OpenClaw install isn't a git checkout, and the package manager couldn't be detected. Update via your package manager, then run \`${replaceCliName(formatCliCommand("openclaw doctor"), CLI_NAME)}\` and \`${replaceCliName(formatCliCommand("openclaw gateway restart"), CLI_NAME)}\`.`));
+			defaultRuntime.log(theme.muted(`Examples: \`${replaceCliName("npm i -g openclaw@latest", CLI_NAME)}\` or \`${replaceCliName("pnpm add -g openclaw@latest", CLI_NAME)}\``));
+		}
+		defaultRuntime.exit(0);
+		return;
+	}
+	let postUpdateConfigSnapshot = configSnapshot;
+	if (requestedChannel && configSnapshot.valid && requestedChannel !== storedChannel) {
+		const next = {
+			...configSnapshot.config,
+			update: {
+				...configSnapshot.config.update,
+				channel: requestedChannel
+			}
+		};
+		await writeConfigFile(next);
+		postUpdateConfigSnapshot = {
+			...configSnapshot,
+			parsed: next,
+			resolved: next,
+			config: next
+		};
+		if (!opts.json) defaultRuntime.log(theme.muted(`Update channel set to ${requestedChannel}.`));
+	}
+	await updatePluginsAfterCoreUpdate({
+		root,
+		channel,
+		configSnapshot: postUpdateConfigSnapshot,
+		opts
+	});
+	await tryWriteCompletionCache(root, Boolean(opts.json));
+	await tryInstallShellCompletion({
+		jsonMode: Boolean(opts.json),
+		skipPrompt: Boolean(opts.yes)
+	});
+	await maybeRestartService({
+		shouldRestart,
+		result,
+		opts,
+		refreshServiceEnv: refreshGatewayServiceEnv$1,
+		gatewayPort,
+		restartScriptPath,
+		invocationCwd
+	});
+	if (!opts.json) defaultRuntime.log(theme.muted(pickUpdateQuip()));
+}
+
+//#endregion
+//#region src/cli/update-cli/wizard.ts
+async function updateWizardCommand(opts = {}) {
+	if (!process.stdin.isTTY) {
+		defaultRuntime.error("Update wizard requires a TTY. Use `openclaw update --channel <stable|beta|dev>` instead.");
+		defaultRuntime.exit(1);
+		return;
+	}
+	const timeoutMs = parseTimeoutMsOrExit(opts.timeout);
+	if (timeoutMs === null) return;
+	const root = await resolveUpdateRoot();
+	const [updateStatus, configSnapshot] = await Promise.all([checkUpdateStatus({
+		root,
+		timeoutMs: timeoutMs ?? 3500,
+		fetchGit: false,
+		includeRegistry: false
+	}), readConfigFileSnapshot()]);
+	const channelInfo = resolveEffectiveUpdateChannel({
+		configChannel: configSnapshot.valid ? normalizeUpdateChannel(configSnapshot.config.update?.channel) : null,
+		installKind: updateStatus.installKind,
+		git: updateStatus.git ? {
+			tag: updateStatus.git.tag,
+			branch: updateStatus.git.branch
+		} : void 0
+	});
+	const channelLabel = formatUpdateChannelLabel({
+		channel: channelInfo.channel,
+		source: channelInfo.source,
+		gitTag: updateStatus.git?.tag ?? null,
+		gitBranch: updateStatus.git?.branch ?? null
+	});
+	const pickedChannel = await selectStyled({
+		message: "Update channel",
+		options: [
+			{
+				value: "keep",
+				label: `Keep current (${channelInfo.channel})`,
+				hint: channelLabel
+			},
+			{
+				value: "stable",
+				label: "Stable",
+				hint: "Tagged releases (npm latest)"
+			},
+			{
+				value: "beta",
+				label: "Beta",
+				hint: "Prereleases (npm beta)"
+			},
+			{
+				value: "dev",
+				label: "Dev",
+				hint: "Git main"
+			}
+		],
+		initialValue: "keep"
+	});
+	if (isCancel(pickedChannel)) {
+		defaultRuntime.log(theme.muted("Update cancelled."));
+		defaultRuntime.exit(0);
+		return;
+	}
+	const requestedChannel = pickedChannel === "keep" ? null : pickedChannel;
+	if (requestedChannel === "dev" && updateStatus.installKind !== "git") {
+		const gitDir = resolveGitInstallDir();
+		if (!await isGitCheckout(gitDir)) {
+			if (await pathExists(gitDir)) {
+				if (!await isEmptyDir(gitDir)) {
+					defaultRuntime.error(`OPENCLAW_GIT_DIR points at a non-git directory: ${gitDir}. Set OPENCLAW_GIT_DIR to an empty folder or an openclaw checkout.`);
+					defaultRuntime.exit(1);
+					return;
+				}
+			}
+			const ok = await confirm({
+				message: stylePromptMessage(`Create a git checkout at ${gitDir}? (override via OPENCLAW_GIT_DIR)`),
+				initialValue: true
+			});
+			if (isCancel(ok) || !ok) {
+				defaultRuntime.log(theme.muted("Update cancelled."));
+				defaultRuntime.exit(0);
+				return;
+			}
+		}
+	}
+	const restart = await confirm({
+		message: stylePromptMessage("Restart the gateway service after update?"),
+		initialValue: true
+	});
+	if (isCancel(restart)) {
+		defaultRuntime.log(theme.muted("Update cancelled."));
+		defaultRuntime.exit(0);
+		return;
+	}
+	try {
+		await updateCommand({
+			channel: requestedChannel ?? void 0,
+			restart: Boolean(restart),
+			timeout: opts.timeout
+		});
+	} catch (err) {
+		defaultRuntime.error(String(err));
+		defaultRuntime.exit(1);
+	}
+}
+
+//#endregion
+//#region src/cli/update-cli.ts
+function inheritedUpdateJson(command) {
+	return Boolean(inheritOptionFromParent(command, "json"));
+}
+function inheritedUpdateTimeout(opts, command) {
+	const timeout = opts.timeout;
+	if (timeout) return timeout;
+	return inheritOptionFromParent(command, "timeout");
+}
+function registerUpdateCli(program) {
+	program.enablePositionalOptions();
+	const update = program.command("update").description("Update OpenClaw and inspect update channel status").option("--json", "Output result as JSON", false).option("--no-restart", "Skip restarting the gateway service after a successful update").option("--dry-run", "Preview update actions without making changes", false).option("--channel <stable|beta|dev>", "Persist update channel (git + npm)").option("--tag <dist-tag|version|spec>", "Override the package target for this update (dist-tag, version, or package spec)").option("--timeout <seconds>", "Timeout for each update step in seconds (default: 1200)").option("--yes", "Skip confirmation prompts (non-interactive)", false).addHelpText("after", () => {
+		const fmtExamples = [
+			["openclaw update", "Update a source checkout (git)"],
+			["openclaw update --channel beta", "Switch to beta channel (git + npm)"],
+			["openclaw update --channel dev", "Switch to dev channel (git + npm)"],
+			["openclaw update --tag beta", "One-off update to a dist-tag or version"],
+			["openclaw update --tag main", "One-off package install from GitHub main"],
+			["openclaw update --dry-run", "Preview actions without changing anything"],
+			["openclaw update --no-restart", "Update without restarting the service"],
+			["openclaw update --json", "Output result as JSON"],
+			["openclaw update --yes", "Non-interactive (accept downgrade prompts)"],
+			["openclaw update wizard", "Interactive update wizard"],
+			["openclaw --update", "Shorthand for openclaw update"]
+		].map(([cmd, desc]) => `  ${theme.command(cmd)} ${theme.muted(`# ${desc}`)}`).join("\n");
+		return `
+${theme.heading("What this does:")}
+  - Git checkouts: fetches, rebases, installs deps, builds, and runs doctor
+  - npm installs: updates via detected package manager
+
+${theme.heading("Switch channels:")}
+  - Use --channel stable|beta|dev to persist the update channel in config
+  - Run openclaw update status to see the active channel and source
+  - Use --tag <dist-tag|version|spec> for a one-off package update without persisting
+
+${theme.heading("Non-interactive:")}
+  - Use --yes to accept downgrade prompts
+  - Combine with --channel/--tag/--restart/--json/--timeout as needed
+  - Use --dry-run to preview actions without writing config/installing/restarting
+
+${theme.heading("Examples:")}
+${fmtExamples}
+
+${theme.heading("Notes:")}
+  - Switch channels with --channel stable|beta|dev
+  - For global installs: auto-updates via detected package manager when possible (see docs/install/updating.md)
+  - Downgrades require confirmation (can break configuration)
+  - Skips update if the working directory has uncommitted changes
+
+${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.openclaw.ai/cli/update")}`;
+	}).action(async (opts) => {
+		try {
+			await updateCommand({
+				json: Boolean(opts.json),
+				restart: Boolean(opts.restart),
+				dryRun: Boolean(opts.dryRun),
+				channel: opts.channel,
+				tag: opts.tag,
+				timeout: opts.timeout,
+				yes: Boolean(opts.yes)
+			});
+		} catch (err) {
+			defaultRuntime.error(String(err));
+			defaultRuntime.exit(1);
+		}
+	});
+	update.command("wizard").description("Interactive update wizard").option("--timeout <seconds>", "Timeout for each update step in seconds (default: 1200)").addHelpText("after", `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.openclaw.ai/cli/update")}\n`).action(async (opts, command) => {
+		try {
+			await updateWizardCommand({ timeout: inheritedUpdateTimeout(opts, command) });
+		} catch (err) {
+			defaultRuntime.error(String(err));
+			defaultRuntime.exit(1);
+		}
+	});
+	update.command("status").description("Show update channel and version status").option("--json", "Output result as JSON", false).option("--timeout <seconds>", "Timeout for update checks in seconds (default: 3)").addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([
+		["openclaw update status", "Show channel + version status."],
+		["openclaw update status --json", "JSON output."],
+		["openclaw update status --timeout 10", "Custom timeout."]
+	])}\n\n${theme.heading("Notes:")}\n${theme.muted("- Shows current update channel (stable/beta/dev) and source")}\n${theme.muted("- Includes git tag/branch/SHA for source checkouts")}\n\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "docs.openclaw.ai/cli/update")}`).action(async (opts, command) => {
+		try {
+			await updateStatusCommand({
+				json: Boolean(opts.json) || inheritedUpdateJson(command),
+				timeout: inheritedUpdateTimeout(opts, command)
+			});
+		} catch (err) {
+			defaultRuntime.error(String(err));
+			defaultRuntime.exit(1);
+		}
+	});
+}
+
+//#endregion
+export { registerUpdateCli };