@heretek-ai/openclaw 2026.3.27 → 2026.3.29

package/dist/chunks/register.maintenance-BdaRRBo0.mjs

@@ -0,0 +1,685 @@
+import "./chunk-CQFkT1cY.mjs";
+import "./redact-CtGOTRBK.mjs";
+import "./errors-CbvpN2RP.mjs";
+import "./logger-vRSRu9wD.mjs";
+import { _ as resolveStateDir, h as resolveOAuthDir, i as isNixMode, o as resolveConfigPath, 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 { _ as resolveHomeDir } from "./utils-Dc9DiBqf.mjs";
+import { t as formatDocsLink } from "./links-BNNF54ea.mjs";
+import "./paths-B5L5nZjW.mjs";
+import "./auth-profiles-DZOU8QNa.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 "./openclaw-root-CSfnLaqO.mjs";
+import "./workspace-CoFl73GV.mjs";
+import "./model-selection-BJk_hQeE.mjs";
+import { d as readConfigFileSnapshot, s as loadConfig } 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 "./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 "./cli-name-lEyorNIN.mjs";
+import { t as formatCliCommand } from "./command-format-D1DrcTDP.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 { d as readGatewayTokenEnv } from "./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 { d as openUrl, g as resolveControlUiLinks, i as detectBrowserOpenSupport, o as formatControlUiSshHint } from "./onboard-helpers-C5GCWoDO.mjs";
+import "./wsl-BW8_A9_i.mjs";
+import { n as stylePromptMessage, r as stylePromptTitle, t as stylePromptHint } 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 "./kill-tree-C7sbsfc4.mjs";
+import "./ports-0KspCIU9.mjs";
+import "./ports-probe-CW8QePv6.mjs";
+import "./systemd-B1Tl3zeB.mjs";
+import "./systemd-hints-CLxWQM3C.mjs";
+import "./logging-CO6W9Zis.mjs";
+import "./issue-format-C5C4zFWv.mjs";
+import "./diagnostics-CXwZ82ru.mjs";
+import "./inspect-CBu749pN.mjs";
+import "./progress-BxDdsPK3.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-CwDz1Jy9.mjs";
+import "./api-key-rotation-CuLnDVwp.mjs";
+import "./provider-runtime-D7FpDXts.mjs";
+import "./providers.runtime-ReQb49ui.mjs";
+import "./accounts-DFOEzDJ7.mjs";
+import "./loader-BIAV9Iig.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-CitpD6LX.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 "./fs-safe-DvWloqcG.mjs";
+import "./path-alias-guards-Dq2I3ITG.mjs";
+import "./status-helpers-BmYd-e9Q.mjs";
+import "./accounts-BI2OGfP5.mjs";
+import "./format-VDvpfVJp.mjs";
+import "./api-Ciu0IVWd.mjs";
+import "./telegram-DZaimX0b.mjs";
+import "./poll-params-DWHBuRx9.mjs";
+import "./token-BNIxZjju.mjs";
+import "./sticker-cache-DJkSXsnY.mjs";
+import "./status-issues-BnLYwoca.mjs";
+import "./fetch-BI0FMqrI.mjs";
+import "./update-offset-store-3hPuz7sI.mjs";
+import "./api-CE6hZv7r.mjs";
+import "./audit-BkbWkLoN.mjs";
+import "./runtime-api-CLv8kHRq.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-CSUHhxgP.mjs";
+import "./provider-catalog-BDbid2d6.mjs";
+import "./models-config.providers-BGCDFJHy.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 "./target-registry-B8jHfrX7.mjs";
+import "./runtime-web-tools-C1rIl936.mjs";
+import "./web-search-providers.runtime-4epgumbu.mjs";
+import "./image-generation-provider-6Bn9TpiN.mjs";
+import "./web-search-providers-QuPYL01Y.mjs";
+import "./client-fetch-BLpjnLN8.mjs";
+import { n as resolveConfiguredSecretInputWithFallback } from "./resolve-configured-secret-input-string-BG1RVESA.mjs";
+import "./config-BBc-AI9Q.mjs";
+import "./store-CgM2S6uo.mjs";
+import "./stagger-DL_NciFx.mjs";
+import "./restart-sentinel-BkRzS474.mjs";
+import "./model-catalog-BQE3APtu.mjs";
+import "./command-secret-gateway-Uq9_F22I.mjs";
+import "./command-secret-targets-DskfH4zj.mjs";
+import "./bindings-B0u6nL3P.mjs";
+import "./plugin-auto-enable-z42_IiV3.mjs";
+import "./accounts-BuIAUa8N.mjs";
+import "./account-inspect-MeUCOkS_.mjs";
+import "./runtime-api-C0iKN3es.mjs";
+import "./send-BKtMg4M2.mjs";
+import "./mentions-zhy7pfW_.mjs";
+import "./api-DXEplirz.mjs";
+import "./allow-list-BmsN9jdO.mjs";
+import "./handle-action-QiVBVVNQ.mjs";
+import "./status-issues-BwaBWQvq.mjs";
+import "./normalize-Bnt1XiaY.mjs";
+import "./pluralkit-BrMYZvsn.mjs";
+import "./api-BcbhfW_y.mjs";
+import "./send-DFvZt_SI.mjs";
+import "./threading-tool-context-AJ99m0j4.mjs";
+import "./sent-thread-cache-CS98UTLj.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-Duuceu1W.mjs";
+import "./dm-policy-shared-CnmKIKQO.mjs";
+import { a as removePath, i as listAgentSessionDirs, o as removeStateAndLinkedPaths, r as buildCleanupPlan, s as removeWorkspaceDirs } from "./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 "./status-Baz1y8H2.mjs";
+import "./auth-health-BcpqSZL0.mjs";
+import { n as runCommandWithRuntime } from "./cli-utils-DA6vWpDg.mjs";
+import "./note-CaQ2HD-A.mjs";
+import "./completion-cli-B8M--XTS.mjs";
+import "./register.subclis-CVkk-8A3.mjs";
+import "./command-registry-B9Orjysx.mjs";
+import "./program-context-9v4H9od4.mjs";
+import "./heartbeat-summary-CUbo9b9F.mjs";
+import "./health-MT8VazgK.mjs";
+import "./control-ui-assets-CW49D85b.mjs";
+import "./server-startup-matrix-migration-BYVP8K4t.mjs";
+import "./update-check-CinGDRx-.mjs";
+import "./channels-status-issues-DxKcDmEl.mjs";
+import "./provider-auth-guidance-CQF0XUYa.mjs";
+import "./systemd-linger-CMHj3APL.mjs";
+import "./health-format-DnRUP-NJ.mjs";
+import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-CxHtgKpu.mjs";
+import "./doctor-completion-CyOOf-GM.mjs";
+import "./doctor-config-preflight-BgQMWEcI.mjs";
+import "./channel-account-context-M7MFNDNz.mjs";
+import "./doctor-state-migrations-Bbyafdyk.mjs";
+import "./provider-openai-codex-oauth-tls-CVsiK51M.mjs";
+import path from "node:path";
+import { cancel, confirm, isCancel, multiselect } from "@clack/prompts";
+
+//#region src/infra/clipboard.ts
+async function copyToClipboard(value) {
+	for (const attempt of [
+		{ argv: ["pbcopy"] },
+		{ argv: [
+			"xclip",
+			"-selection",
+			"clipboard"
+		] },
+		{ argv: ["wl-copy"] },
+		{ argv: ["clip.exe"] },
+		{ argv: [
+			"powershell",
+			"-NoProfile",
+			"-Command",
+			"Set-Clipboard"
+		] }
+	]) try {
+		const result = await runCommandWithTimeout(attempt.argv, {
+			timeoutMs: 3e3,
+			input: value
+		});
+		if (result.code === 0 && !result.killed) return true;
+	} catch {}
+	return false;
+}
+
+//#endregion
+//#region src/commands/dashboard.ts
+async function resolveDashboardToken(cfg, env = process.env) {
+	const resolved = await resolveConfiguredSecretInputWithFallback({
+		config: cfg,
+		env,
+		value: cfg.gateway?.auth?.token,
+		path: "gateway.auth.token",
+		readFallback: () => readGatewayTokenEnv(env)
+	});
+	return {
+		token: resolved.value,
+		source: resolved.source === "config" ? "config" : resolved.source === "secretRef" ? "secretRef" : resolved.source === "fallback" ? "env" : void 0,
+		unresolvedRefReason: resolved.unresolvedRefReason,
+		tokenSecretRefConfigured: resolved.secretRefConfigured
+	};
+}
+async function dashboardCommand(runtime = defaultRuntime, options = {}) {
+	const snapshot = await readConfigFileSnapshot();
+	const cfg = snapshot.valid ? snapshot.config : {};
+	const port = resolveGatewayPort(cfg);
+	const bind = cfg.gateway?.bind ?? "loopback";
+	const basePath = cfg.gateway?.controlUi?.basePath;
+	const customBindHost = cfg.gateway?.customBindHost;
+	const resolvedToken = await resolveDashboardToken(cfg, process.env);
+	const token = resolvedToken.token ?? "";
+	const links = resolveControlUiLinks({
+		port,
+		bind: bind === "lan" ? "loopback" : bind,
+		customBindHost,
+		basePath
+	});
+	const includeTokenInUrl = token.length > 0 && !resolvedToken.tokenSecretRefConfigured;
+	const dashboardUrl = includeTokenInUrl ? `${links.httpUrl}#token=${encodeURIComponent(token)}` : links.httpUrl;
+	runtime.log(`Dashboard URL: ${dashboardUrl}`);
+	if (resolvedToken.tokenSecretRefConfigured && token) runtime.log("Token auto-auth is disabled for SecretRef-managed gateway.auth.token; use your external token source if prompted.");
+	if (resolvedToken.unresolvedRefReason) {
+		runtime.log(`Token auto-auth unavailable: ${resolvedToken.unresolvedRefReason}`);
+		runtime.log("Set OPENCLAW_GATEWAY_TOKEN in this shell or resolve your secret provider, then rerun `openclaw dashboard`.");
+	}
+	const copied = await copyToClipboard(dashboardUrl).catch(() => false);
+	runtime.log(copied ? "Copied to clipboard." : "Copy to clipboard unavailable.");
+	let opened = false;
+	let hint;
+	if (!options.noOpen) {
+		if ((await detectBrowserOpenSupport()).ok) opened = await openUrl(dashboardUrl);
+		if (!opened) hint = formatControlUiSshHint({
+			port,
+			basePath,
+			token: includeTokenInUrl ? token || void 0 : void 0
+		});
+	} else hint = "Browser launch disabled (--no-open). Use the URL above.";
+	if (opened) runtime.log("Opened in your browser. Keep that tab to control OpenClaw.");
+	else if (hint) runtime.log(hint);
+}
+
+//#endregion
+//#region src/commands/cleanup-plan.ts
+function resolveCleanupPlanFromDisk() {
+	const cfg = loadConfig();
+	const stateDir = resolveStateDir();
+	const configPath = resolveConfigPath();
+	const oauthDir = resolveOAuthDir();
+	return {
+		cfg,
+		stateDir,
+		configPath,
+		oauthDir,
+		...buildCleanupPlan({
+			cfg,
+			stateDir,
+			configPath,
+			oauthDir
+		})
+	};
+}
+
+//#endregion
+//#region src/commands/reset.ts
+async function stopGatewayIfRunning(runtime) {
+	if (isNixMode) return;
+	const service = resolveGatewayService();
+	let loaded = false;
+	try {
+		loaded = await service.isLoaded({ env: process.env });
+	} catch (err) {
+		runtime.error(`Gateway service check failed: ${String(err)}`);
+		return;
+	}
+	if (!loaded) return;
+	try {
+		await service.stop({
+			env: process.env,
+			stdout: process.stdout
+		});
+	} catch (err) {
+		runtime.error(`Gateway stop failed: ${String(err)}`);
+	}
+}
+function logBackupRecommendation$1(runtime) {
+	runtime.log(`Recommended first: ${formatCliCommand("openclaw backup create")}`);
+}
+async function resetCommand(runtime, opts) {
+	const interactive = !opts.nonInteractive;
+	if (!interactive && !opts.yes) {
+		runtime.error("Non-interactive mode requires --yes.");
+		runtime.exit(1);
+		return;
+	}
+	let scope = opts.scope;
+	if (!scope) {
+		if (!interactive) {
+			runtime.error("Non-interactive mode requires --scope.");
+			runtime.exit(1);
+			return;
+		}
+		const selection = await selectStyled({
+			message: "Reset scope",
+			options: [
+				{
+					value: "config",
+					label: "Config only",
+					hint: "openclaw.json"
+				},
+				{
+					value: "config+creds+sessions",
+					label: "Config + credentials + sessions",
+					hint: "keeps workspace + auth profiles"
+				},
+				{
+					value: "full",
+					label: "Full reset",
+					hint: "state dir + workspace"
+				}
+			],
+			initialValue: "config+creds+sessions"
+		});
+		if (isCancel(selection)) {
+			cancel(stylePromptTitle("Reset cancelled.") ?? "Reset cancelled.");
+			runtime.exit(0);
+			return;
+		}
+		scope = selection;
+	}
+	if (![
+		"config",
+		"config+creds+sessions",
+		"full"
+	].includes(scope)) {
+		runtime.error("Invalid --scope. Expected \"config\", \"config+creds+sessions\", or \"full\".");
+		runtime.exit(1);
+		return;
+	}
+	if (interactive && !opts.yes) {
+		const ok = await confirm({ message: stylePromptMessage(`Proceed with ${scope} reset?`) });
+		if (isCancel(ok) || !ok) {
+			cancel(stylePromptTitle("Reset cancelled.") ?? "Reset cancelled.");
+			runtime.exit(0);
+			return;
+		}
+	}
+	const dryRun = Boolean(opts.dryRun);
+	const { stateDir, configPath, oauthDir, configInsideState, oauthInsideState, workspaceDirs } = resolveCleanupPlanFromDisk();
+	if (scope !== "config") {
+		logBackupRecommendation$1(runtime);
+		if (dryRun) runtime.log("[dry-run] stop gateway service");
+		else await stopGatewayIfRunning(runtime);
+	}
+	if (scope === "config") {
+		await removePath(configPath, runtime, {
+			dryRun,
+			label: configPath
+		});
+		return;
+	}
+	if (scope === "config+creds+sessions") {
+		await removePath(configPath, runtime, {
+			dryRun,
+			label: configPath
+		});
+		await removePath(oauthDir, runtime, {
+			dryRun,
+			label: oauthDir
+		});
+		const sessionDirs = await listAgentSessionDirs(stateDir);
+		for (const dir of sessionDirs) await removePath(dir, runtime, {
+			dryRun,
+			label: dir
+		});
+		runtime.log(`Next: ${formatCliCommand("openclaw onboard --install-daemon")}`);
+		return;
+	}
+	if (scope === "full") {
+		await removeStateAndLinkedPaths({
+			stateDir,
+			configPath,
+			oauthDir,
+			configInsideState,
+			oauthInsideState
+		}, runtime, { dryRun });
+		await removeWorkspaceDirs(workspaceDirs, runtime, { dryRun });
+		runtime.log(`Next: ${formatCliCommand("openclaw onboard --install-daemon")}`);
+		return;
+	}
+}
+
+//#endregion
+//#region src/commands/uninstall.ts
+const multiselectStyled = (params) => multiselect({
+	...params,
+	message: stylePromptMessage(params.message),
+	options: params.options.map((opt) => opt.hint === void 0 ? opt : {
+		...opt,
+		hint: stylePromptHint(opt.hint)
+	})
+});
+function buildScopeSelection(opts) {
+	const hadExplicit = Boolean(opts.all || opts.service || opts.state || opts.workspace || opts.app);
+	const scopes = /* @__PURE__ */ new Set();
+	if (opts.all || opts.service) scopes.add("service");
+	if (opts.all || opts.state) scopes.add("state");
+	if (opts.all || opts.workspace) scopes.add("workspace");
+	if (opts.all || opts.app) scopes.add("app");
+	return {
+		scopes,
+		hadExplicit
+	};
+}
+async function stopAndUninstallService(runtime) {
+	if (isNixMode) {
+		runtime.error("Nix mode detected; service uninstall is disabled.");
+		return false;
+	}
+	const service = resolveGatewayService();
+	let loaded = false;
+	try {
+		loaded = await service.isLoaded({ env: process.env });
+	} catch (err) {
+		runtime.error(`Gateway service check failed: ${String(err)}`);
+		return false;
+	}
+	if (!loaded) {
+		runtime.log(`Gateway service ${service.notLoadedText}.`);
+		return true;
+	}
+	try {
+		await service.stop({
+			env: process.env,
+			stdout: process.stdout
+		});
+	} catch (err) {
+		runtime.error(`Gateway stop failed: ${String(err)}`);
+	}
+	try {
+		await service.uninstall({
+			env: process.env,
+			stdout: process.stdout
+		});
+		return true;
+	} catch (err) {
+		runtime.error(`Gateway uninstall failed: ${String(err)}`);
+		return false;
+	}
+}
+async function removeMacApp(runtime, dryRun) {
+	if (process.platform !== "darwin") return;
+	await removePath("/Applications/OpenClaw.app", runtime, {
+		dryRun,
+		label: "/Applications/OpenClaw.app"
+	});
+}
+function logBackupRecommendation(runtime) {
+	runtime.log(`Recommended first: ${formatCliCommand("openclaw backup create")}`);
+}
+async function uninstallCommand(runtime, opts) {
+	const { scopes, hadExplicit } = buildScopeSelection(opts);
+	const interactive = !opts.nonInteractive;
+	if (!interactive && !opts.yes) {
+		runtime.error("Non-interactive mode requires --yes.");
+		runtime.exit(1);
+		return;
+	}
+	if (!hadExplicit) {
+		if (!interactive) {
+			runtime.error("Non-interactive mode requires explicit scopes (use --all).");
+			runtime.exit(1);
+			return;
+		}
+		const selection = await multiselectStyled({
+			message: "Uninstall which components?",
+			options: [
+				{
+					value: "service",
+					label: "Gateway service",
+					hint: "launchd / systemd / schtasks"
+				},
+				{
+					value: "state",
+					label: "State + config",
+					hint: "~/.openclaw"
+				},
+				{
+					value: "workspace",
+					label: "Workspace",
+					hint: "agent files"
+				},
+				{
+					value: "app",
+					label: "macOS app",
+					hint: "/Applications/OpenClaw.app"
+				}
+			],
+			initialValues: [
+				"service",
+				"state",
+				"workspace"
+			]
+		});
+		if (isCancel(selection)) {
+			cancel(stylePromptTitle("Uninstall cancelled.") ?? "Uninstall cancelled.");
+			runtime.exit(0);
+			return;
+		}
+		for (const value of selection) scopes.add(value);
+	}
+	if (scopes.size === 0) {
+		runtime.log("Nothing selected.");
+		return;
+	}
+	if (interactive && !opts.yes) {
+		const ok = await confirm({ message: stylePromptMessage("Proceed with uninstall?") });
+		if (isCancel(ok) || !ok) {
+			cancel(stylePromptTitle("Uninstall cancelled.") ?? "Uninstall cancelled.");
+			runtime.exit(0);
+			return;
+		}
+	}
+	const dryRun = Boolean(opts.dryRun);
+	const { stateDir, configPath, oauthDir, configInsideState, oauthInsideState, workspaceDirs } = resolveCleanupPlanFromDisk();
+	if (scopes.has("state") || scopes.has("workspace")) logBackupRecommendation(runtime);
+	if (scopes.has("service")) if (dryRun) runtime.log("[dry-run] remove gateway service");
+	else await stopAndUninstallService(runtime);
+	if (scopes.has("state")) await removeStateAndLinkedPaths({
+		stateDir,
+		configPath,
+		oauthDir,
+		configInsideState,
+		oauthInsideState
+	}, runtime, { dryRun });
+	if (scopes.has("workspace")) await removeWorkspaceDirs(workspaceDirs, runtime, { dryRun });
+	if (scopes.has("app")) await removeMacApp(runtime, dryRun);
+	runtime.log("CLI still installed. Remove via npm/pnpm if desired.");
+	if (scopes.has("state") && !scopes.has("workspace")) {
+		const home = resolveHomeDir();
+		if (home && workspaceDirs.some((dir) => dir.startsWith(path.resolve(home)))) runtime.log("Tip: workspaces were preserved. Re-run with --workspace to remove them.");
+	}
+}
+
+//#endregion
+//#region src/cli/program/register.maintenance.ts
+function registerMaintenanceCommands(program) {
+	program.command("doctor").description("Health checks + quick fixes for the gateway and channels").addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/doctor", "docs.openclaw.ai/cli/doctor")}\n`).option("--no-workspace-suggestions", "Disable workspace memory system suggestions", false).option("--yes", "Accept defaults without prompting", false).option("--repair", "Apply recommended repairs without prompting", false).option("--fix", "Apply recommended repairs (alias for --repair)", false).option("--force", "Apply aggressive repairs (overwrites custom service config)", false).option("--non-interactive", "Run without prompts (safe migrations only)", false).option("--generate-gateway-token", "Generate and configure a gateway token", false).option("--deep", "Scan system services for extra gateway installs", false).action(async (opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await doctorCommand(defaultRuntime, {
+				workspaceSuggestions: opts.workspaceSuggestions,
+				yes: Boolean(opts.yes),
+				repair: Boolean(opts.repair) || Boolean(opts.fix),
+				force: Boolean(opts.force),
+				nonInteractive: Boolean(opts.nonInteractive),
+				generateGatewayToken: Boolean(opts.generateGatewayToken),
+				deep: Boolean(opts.deep)
+			});
+			defaultRuntime.exit(0);
+		});
+	});
+	program.command("dashboard").description("Open the Control UI with your current token").addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/dashboard", "docs.openclaw.ai/cli/dashboard")}\n`).option("--no-open", "Print URL but do not launch a browser").action(async (opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await dashboardCommand(defaultRuntime, { noOpen: opts.open === false });
+		});
+	});
+	program.command("reset").description("Reset local config/state (keeps the CLI installed)").addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/reset", "docs.openclaw.ai/cli/reset")}\n`).option("--scope <scope>", "config|config+creds+sessions|full (default: interactive prompt)").option("--yes", "Skip confirmation prompts", false).option("--non-interactive", "Disable prompts (requires --scope + --yes)", false).option("--dry-run", "Print actions without removing files", false).action(async (opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await resetCommand(defaultRuntime, {
+				scope: opts.scope,
+				yes: Boolean(opts.yes),
+				nonInteractive: Boolean(opts.nonInteractive),
+				dryRun: Boolean(opts.dryRun)
+			});
+		});
+	});
+	program.command("uninstall").description("Uninstall the gateway service + local data (CLI remains)").addHelpText("after", () => `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/uninstall", "docs.openclaw.ai/cli/uninstall")}\n`).option("--service", "Remove the gateway service", false).option("--state", "Remove state + config", false).option("--workspace", "Remove workspace dirs", false).option("--app", "Remove the macOS app", false).option("--all", "Remove service + state + workspace + app", false).option("--yes", "Skip confirmation prompts", false).option("--non-interactive", "Disable prompts (requires --yes)", false).option("--dry-run", "Print actions without removing files", false).action(async (opts) => {
+		await runCommandWithRuntime(defaultRuntime, async () => {
+			await uninstallCommand(defaultRuntime, {
+				service: Boolean(opts.service),
+				state: Boolean(opts.state),
+				workspace: Boolean(opts.workspace),
+				app: Boolean(opts.app),
+				all: Boolean(opts.all),
+				yes: Boolean(opts.yes),
+				nonInteractive: Boolean(opts.nonInteractive),
+				dryRun: Boolean(opts.dryRun)
+			});
+		});
+	});
+}
+
+//#endregion
+export { registerMaintenanceCommands };