openclaw-openagent 1.0.12 → 1.0.13

package/dist/index.js

@@ -14,6 +14,7 @@ import { registerTools, registerHooks } from './src/app/index.js';
 import { installOpenagentVerbosePreflight } from './src/app/verbose-preflight.js';
 // guard.ts removed — unhandled rejections fixed at source in ws-frame.ts send()
 import { setOpenagentPluginRuntime } from './src/runtime/plugin-runtime.js';
+import { startOpenagentUpdateChecker } from './src/runtime/update-checker.js';
 import { injectControlUiOverride } from './src/plugin-ui/index.js';
 import { createAuthProxyHandler } from './src/proxy/auth-proxy.js';
 import { logger } from './src/util/logger.js';
@@ -104,6 +105,7 @@ export default {
         injectControlUiOverride(api.runtime?.version).catch(err => {
             logger.warn(`[entry] Control UI injection failed: ${err.message}`);
         });
+        startOpenagentUpdateChecker();
         logger.info('[entry] Tools + hooks registered (full mode)');
         _fullModeRegistered = true;
     },

package/dist/src/config/config-schema.d.ts

@@ -31,6 +31,15 @@ export declare const OpenagentConfigSchema: z.ZodObject<{
     }>>>;
     api_base: z.ZodOptional<z.ZodString>;
     access_api_base: z.ZodOptional<z.ZodString>;
+    update_policy: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        off: "off";
+        notify: "notify";
+    }>>;
+    update_check: z.ZodOptional<z.ZodBoolean>;
+    auto_update: z.ZodOptional<z.ZodBoolean>;
+    update_channel: z.ZodOptional<z.ZodString>;
+    update_dist_tag: z.ZodOptional<z.ZodString>;
     accounts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         enabled: z.ZodOptional<z.ZodBoolean>;

package/dist/src/config/config-schema.js

@@ -13,6 +13,7 @@ import { z } from 'zod';
 // Zod config schema
 // ---------------------------------------------------------------------------
 const transportSchema = z.enum(['oasn', 'tim']).default('oasn');
+const updatePolicySchema = z.enum(['notify', 'auto', 'off']).optional();
 const openagentAccountSchema = z.object({
     name: z.string().optional(),
     enabled: z.boolean().optional(),
@@ -30,5 +31,10 @@ export const OpenagentConfigSchema = openagentAccountSchema.extend({
     transport: transportSchema.optional(),
     api_base: z.string().optional(),
     access_api_base: z.string().optional(),
+    update_policy: updatePolicySchema,
+    update_check: z.boolean().optional(),
+    auto_update: z.boolean().optional(),
+    update_channel: z.string().optional(),
+    update_dist_tag: z.string().optional(),
     accounts: z.record(z.string(), openagentAccountSchema).optional(),
 });

package/dist/src/plugin-ui/assets/openagent-override.js

@@ -2,7 +2,7 @@
  * OpenAgent UI Override — Auto-generated, do not edit directly!
  *
  * Source: src/plugin-ui/modules/
- * Built:  2026-07-06T03:23:32.989Z
+ * Built:  2026-07-06T09:05:33.996Z
  *
  * To modify, edit the source modules and run:
  *   npm run build:override
@@ -52,7 +52,7 @@ const CL = {
   hostVersion: '__OPENCLAW_HOST_VERSION__',
 
   // ── Override 构建标识（构建时注入，用于缓存自检）──
-  buildId: "65bf8968e270",
+  buildId: "4207d7dc1f64",
 
   // ── 配置 ──
   OPENAGENT_API: 'https://api.openagent.club',
@@ -2118,6 +2118,13 @@ function injectStyles() {
       padding: 14px;
       font-family: "PingFang SC", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
       box-sizing: border-box;
+      scrollbar-width: none;
+      -ms-overflow-style: none;
+    }
+    .openagent-agent-panel::-webkit-scrollbar {
+      width: 0;
+      height: 0;
+      display: none;
     }
     .openagent-agent-panel.visible {
       display: flex;
@@ -2357,21 +2364,13 @@ function injectStyles() {
       flex-direction: column;
       min-height: 0;
       max-height: min(56vh, 451px);
-      scrollbar-width: thin;
-      scrollbar-color: #ddd transparent;
+      scrollbar-width: none;
+      -ms-overflow-style: none;
     }
     .openagent-agent-list::-webkit-scrollbar {
-      width: 4px;
-    }
-    .openagent-agent-list::-webkit-scrollbar-track {
-      background: transparent;
-    }
-    .openagent-agent-list::-webkit-scrollbar-thumb {
-      background: #ddd;
-      border-radius: 2px;
-    }
-    .openagent-agent-list::-webkit-scrollbar-thumb:hover {
-      background: #bbb;
+      width: 0;
+      height: 0;
+      display: none;
     }
 
     .openagent-agent-section {
@@ -4923,7 +4922,13 @@ margin: 0 8px; position: relative; top: -1px;
 .trip-img-card {
 display: flex; flex-direction: row; gap: 6px;
 overflow-x: auto; padding: 8px 0; margin-left: 20px;
-scrollbar-width: thin;
+scrollbar-width: none;
+-ms-overflow-style: none;
+}
+.trip-img-card::-webkit-scrollbar {
+width: 0;
+height: 0;
+display: none;
 }
 .trip-img-item {
 position: relative; width: 191px; height: 100px; border-radius: 8px;
@@ -6983,6 +6988,14 @@ function _clScan() {
     '  overflow-x: auto;',
     '  white-space: pre-wrap;',
     '  word-break: break-all;',
+    '  scrollbar-width: none;',
+    '  -ms-overflow-style: none;',
+    '}',
+    '.cl-output-card > .cl-thought-chain-content pre::-webkit-scrollbar,',
+    '.cl-output-card > .cl-thought-chain-content code::-webkit-scrollbar {',
+    '  width: 0;',
+    '  height: 0;',
+    '  display: none;',
     '}',
     // V2 output card：统一 border/padding 与 execution card 一致
     '.cl-exec-v2.cl-output-card {',
@@ -7225,8 +7238,7 @@ function _clScan() {
     '.cl-exec-v2 .cl-exec-agent-avatar-v2 {',
     '  width: 68px !important;',
     '  height: 68px !important;',
-    '  border-radius: 50% !important;',
-    '  object-fit: cover;',
+    '  object-fit: contain;',
     '  flex-shrink: 0;',
     '}',
 
@@ -11142,9 +11154,104 @@ function _startClObserver() {
   _clObserverTarget = document.querySelector('openclaw-app') || document.body;
   _clObserver.observe(_clObserverTarget, { childList: true, subtree: true });
   setTimeout(_debouncedClScan, 2000);
+  setTimeout(_clCheckPluginUpdateStatus, 5000);
   /* muted */ void 0;
 }
 
+function _clCheckPluginUpdateStatus() {
+  fetch('/plugins/openagent/update-status', { cache: 'no-store' })
+    .then(function(res) {
+      if (!res.ok) return null;
+      return res.json();
+    })
+    .then(function(status) {
+      if (!status || !status.updateAvailable) return;
+      _clShowPluginUpdateNotice(status);
+    })
+    .catch(function() {});
+}
+
+function _clShowPluginUpdateNotice(status) {
+  var latestVersion = String(status.latestVersion || '').trim();
+  var currentVersion = String(status.currentVersion || '').trim();
+  var dismissKey = 'openagent-update-dismissed-' + latestVersion;
+  try {
+    if (latestVersion && localStorage.getItem(dismissKey) === '1') return;
+  } catch (e) {}
+
+  var existing = document.getElementById('openagent-update-notice');
+  if (existing) existing.remove();
+
+  var notice = document.createElement('div');
+  notice.id = 'openagent-update-notice';
+  notice.style.cssText = [
+    'position:fixed',
+    'right:18px',
+    'bottom:18px',
+    'z-index:2147483647',
+    'max-width:360px',
+    'padding:14px 16px',
+    'border:1px solid rgba(0,0,0,0.08)',
+    'border-radius:12px',
+    'background:#fff',
+    'box-shadow:0 12px 32px rgba(15,23,42,0.16)',
+    'font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif',
+    'color:#1f2937',
+    'font-size:13px',
+    'line-height:1.5'
+  ].join(';');
+
+  var title = document.createElement('div');
+  title.textContent = 'OpenAgent 有新版本 ' + latestVersion;
+  title.style.cssText = 'font-weight:600;font-size:14px;margin-right:22px;margin-bottom:4px;';
+  notice.appendChild(title);
+
+  var body = document.createElement('div');
+  var command = String(status.installCommand || 'npx -y openclaw-openagent-cli update');
+  body.textContent = currentVersion ? ('当前版本 ' + currentVersion + '，运行命令完成更新。') : '运行命令完成更新。';
+  body.style.cssText = 'color:#4b5563;margin-bottom:10px;';
+  notice.appendChild(body);
+
+  var code = document.createElement('code');
+  code.textContent = command;
+  code.style.cssText = 'display:block;white-space:normal;word-break:break-all;background:#f6f7f9;border-radius:8px;padding:8px 10px;color:#111827;';
+  notice.appendChild(code);
+
+  var actions = document.createElement('div');
+  actions.style.cssText = 'display:flex;justify-content:flex-end;gap:8px;margin-top:10px;';
+  var copy = document.createElement('button');
+  copy.type = 'button';
+  copy.textContent = '复制命令';
+  copy.style.cssText = 'border:1px solid #d1d5db;background:#fff;border-radius:8px;padding:6px 10px;cursor:pointer;color:#374151;';
+  copy.onclick = function() {
+    try {
+      navigator.clipboard.writeText(command);
+      copy.textContent = '已复制';
+    } catch (e) {}
+  };
+  actions.appendChild(copy);
+
+  var close = document.createElement('button');
+  close.type = 'button';
+  close.textContent = '关闭';
+  close.style.cssText = 'border:0;background:#111827;color:#fff;border-radius:8px;padding:6px 10px;cursor:pointer;';
+  close.onclick = function() {
+    try {
+      if (latestVersion) localStorage.setItem(dismissKey, '1');
+    } catch (e) {}
+    notice.remove();
+  };
+  actions.appendChild(close);
+  notice.appendChild(actions);
+
+  if (status.policy === 'auto' && status.autoUpdateStarted) {
+    body.textContent = '正在自动更新，OpenClaw Gateway 可能会自动重启。';
+    actions.remove();
+  }
+
+  document.body.appendChild(notice);
+}
+
 if (document.readyState === 'loading') {
   document.addEventListener('DOMContentLoaded', _startClObserver);
 } else {

package/dist/src/proxy/auth-proxy.js

@@ -17,6 +17,7 @@ import fs from 'node:fs';
 import nodePath from 'node:path';
 import { logger } from '../util/logger.js';
 import { registry } from '../runtime/registry.js';
+import { getOpenagentUpdateStatus } from '../runtime/update-checker.js';
 import { isUnconfiguredOasnApiBase } from '../auth/config.js';
 import { resolveOasnRelativeUrl } from '../util/url-resolver.js';
 /** TIM 路径默认上游（兼容旧版） */
@@ -90,6 +91,10 @@ export function createAuthProxyHandler() {
         if (targetPath.startsWith('/media/')) {
             return serveLocalMedia(targetPath, res);
         }
+        if (targetPath === '/update-status') {
+            writeJson(res, 200, getOpenagentUpdateStatus());
+            return true;
+        }
         // v3.9+ 双轨抽象：上游按当前 transport 切换（OASN → api.oasn.ai；TIM → auth.ai-talk.live）
         const method = req.method ?? 'GET';
         const rt = registry.getDefault();

package/dist/src/runtime/update-checker.d.ts

@@ -0,0 +1,18 @@
+export type OpenagentUpdatePolicy = 'notify' | 'auto' | 'off';
+export type OpenagentUpdateStatus = {
+    checked: boolean;
+    checking: boolean;
+    currentVersion: string;
+    latestVersion: string;
+    distTag: string;
+    updateAvailable: boolean;
+    policy: OpenagentUpdatePolicy;
+    installCommand: string;
+    autoUpdateStarted: boolean;
+    lastCheckedAt?: string;
+    error?: string;
+};
+export declare function getOpenagentUpdateStatus(): OpenagentUpdateStatus;
+export declare function startOpenagentUpdateChecker(): void;
+export declare function runOpenagentUpdateCheck(): Promise<OpenagentUpdateStatus>;
+export declare function compareVersions(a: string, b: string): number;

package/dist/src/runtime/update-checker.js

@@ -0,0 +1,253 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { logger } from '../util/logger.js';
+const PLUGIN_PACKAGE = 'openclaw-openagent';
+const CLI_PACKAGE = 'openclaw-openagent-cli';
+const DEFAULT_DIST_TAG = 'latest';
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+const CHECK_DELAY_MS = 3_000;
+let checkerStarted = false;
+const updateStatus = {
+    checked: false,
+    checking: false,
+    currentVersion: '',
+    latestVersion: '',
+    distTag: DEFAULT_DIST_TAG,
+    updateAvailable: false,
+    policy: 'notify',
+    installCommand: `npx -y ${CLI_PACKAGE}`,
+    autoUpdateStarted: false,
+};
+export function getOpenagentUpdateStatus() {
+    return { ...updateStatus };
+}
+export function startOpenagentUpdateChecker() {
+    if (checkerStarted)
+        return;
+    checkerStarted = true;
+    setTimeout(() => {
+        void runOpenagentUpdateCheck().catch((err) => {
+            updateStatus.checked = true;
+            updateStatus.checking = false;
+            updateStatus.error = err.message;
+            updateStatus.lastCheckedAt = new Date().toISOString();
+            logger.warn(`[update-check] failed: ${err.message}`);
+        });
+    }, CHECK_DELAY_MS).unref?.();
+}
+export async function runOpenagentUpdateCheck() {
+    const config = resolveUpdateConfig();
+    updateStatus.policy = config.policy;
+    updateStatus.distTag = config.distTag;
+    updateStatus.installCommand = buildInstallCommand(config);
+    updateStatus.currentVersion = resolveCurrentVersion();
+    if (config.policy === 'off') {
+        updateStatus.checked = true;
+        updateStatus.checking = false;
+        updateStatus.updateAvailable = false;
+        updateStatus.lastCheckedAt = new Date().toISOString();
+        logger.info('[update-check] disabled by policy');
+        return getOpenagentUpdateStatus();
+    }
+    updateStatus.checking = true;
+    updateStatus.error = undefined;
+    try {
+        const latestVersion = await fetchDistTagVersion(config.distTag);
+        updateStatus.latestVersion = latestVersion;
+        updateStatus.updateAvailable = compareVersions(latestVersion, updateStatus.currentVersion) > 0;
+        updateStatus.checked = true;
+        updateStatus.checking = false;
+        updateStatus.lastCheckedAt = new Date().toISOString();
+        if (!updateStatus.updateAvailable) {
+            logger.info(`[update-check] up to date: ${PLUGIN_PACKAGE}@${updateStatus.currentVersion}`);
+            return getOpenagentUpdateStatus();
+        }
+        logger.warn(`[update-check] new ${PLUGIN_PACKAGE} version available: `
+            + `${updateStatus.currentVersion} -> ${latestVersion}. Run: ${updateStatus.installCommand}`);
+        if (config.policy === 'auto') {
+            startAutoUpdate(config);
+        }
+        return getOpenagentUpdateStatus();
+    }
+    catch (err) {
+        updateStatus.checked = true;
+        updateStatus.checking = false;
+        updateStatus.error = err.message;
+        updateStatus.lastCheckedAt = new Date().toISOString();
+        throw err;
+    }
+}
+function resolveUpdateConfig() {
+    const fileConfig = readOpenagentConfig();
+    const envPolicy = normalizePolicy(process.env.OPENAGENT_UPDATE_POLICY);
+    const autoUpdateEnv = readBool(process.env.OPENAGENT_AUTO_UPDATE ?? process.env.OPENAGENT_PLUGIN_AUTO_UPDATE);
+    const checkEnabledEnv = readBool(process.env.OPENAGENT_UPDATE_CHECK);
+    const configPolicy = normalizePolicy(readString(fileConfig, 'update_policy', 'updatePolicy'));
+    const configAutoUpdate = readBool(readString(fileConfig, 'auto_update', 'autoUpdate'));
+    const configUpdateCheck = readBool(readString(fileConfig, 'update_check', 'updateCheck'));
+    let policy = configPolicy || 'notify';
+    if (configAutoUpdate === true)
+        policy = 'auto';
+    if (configUpdateCheck === false)
+        policy = 'off';
+    if (envPolicy)
+        policy = envPolicy;
+    if (autoUpdateEnv === true)
+        policy = 'auto';
+    if (checkEnabledEnv === false)
+        policy = 'off';
+    const distTag = normalizeDistTag(process.env.OPENAGENT_UPDATE_DIST_TAG
+        || readString(fileConfig, 'update_dist_tag', 'updateDistTag')
+        || process.env.OPENAGENT_PLUGIN_DIST_TAG
+        || DEFAULT_DIST_TAG);
+    const channel = normalizeDistTag(process.env.OPENAGENT_UPDATE_CHANNEL
+        || readString(fileConfig, 'update_channel', 'updateChannel')
+        || process.env.OPENAGENT_PLUGIN_CHANNEL
+        || '');
+    return {
+        policy,
+        distTag: channel || distTag,
+        channel,
+    };
+}
+function startAutoUpdate(config) {
+    if (updateStatus.autoUpdateStarted)
+        return;
+    updateStatus.autoUpdateStarted = true;
+    const npxBin = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+    const args = ['-y', CLI_PACKAGE, 'update'];
+    if (config.channel) {
+        args.push('--channel', config.channel);
+    }
+    else if (config.distTag && config.distTag !== DEFAULT_DIST_TAG) {
+        args.push('--dist-tag', config.distTag);
+    }
+    logger.warn(`[update-check] auto update started: ${npxBin} ${args.join(' ')}`);
+    const child = spawn(npxBin, args, {
+        detached: true,
+        stdio: 'ignore',
+        env: process.env,
+    });
+    child.unref();
+}
+function buildInstallCommand(config) {
+    const parts = ['npx', '-y', CLI_PACKAGE, 'update'];
+    if (config.channel) {
+        parts.push('--channel', config.channel);
+    }
+    else if (config.distTag && config.distTag !== DEFAULT_DIST_TAG) {
+        parts.push('--dist-tag', config.distTag);
+    }
+    return parts.join(' ');
+}
+async function fetchDistTagVersion(distTag) {
+    if (process.env.OPENAGENT_UPDATE_TEST_VERSION) {
+        return process.env.OPENAGENT_UPDATE_TEST_VERSION;
+    }
+    const registry = (process.env.OPENAGENT_UPDATE_REGISTRY || DEFAULT_REGISTRY).replace(/\/+$/, '');
+    const url = `${registry}/${encodeURIComponent(PLUGIN_PACKAGE)}/${encodeURIComponent(distTag)}`;
+    const res = await fetch(url, {
+        headers: { Accept: 'application/json' },
+        signal: AbortSignal.timeout(5_000),
+    });
+    if (!res.ok) {
+        throw new Error(`npm registry ${res.status} for ${PLUGIN_PACKAGE}@${distTag}`);
+    }
+    const data = await res.json();
+    const version = typeof data.version === 'string' ? data.version : '';
+    if (!version)
+        throw new Error(`npm registry response missing version for ${PLUGIN_PACKAGE}@${distTag}`);
+    return version;
+}
+function resolveCurrentVersion() {
+    const packageJson = findPackageJson();
+    if (!packageJson)
+        return '0.0.0';
+    try {
+        const data = JSON.parse(fs.readFileSync(packageJson, 'utf8'));
+        return typeof data.version === 'string' ? data.version : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function findPackageJson() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 8; i += 1) {
+        const candidate = path.join(dir, 'package.json');
+        try {
+            const data = JSON.parse(fs.readFileSync(candidate, 'utf8'));
+            if (data.name === PLUGIN_PACKAGE)
+                return candidate;
+        }
+        catch { }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+function readOpenagentConfig() {
+    const stateDir = process.env.OPENCLAW_STATE_DIR || path.join(os.homedir(), '.openclaw');
+    const configPath = path.join(stateDir, 'openclaw.json');
+    try {
+        const root = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        return root.channels?.openagent || {};
+    }
+    catch {
+        return {};
+    }
+}
+function readString(obj, ...keys) {
+    for (const key of keys) {
+        const value = obj[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+        if (typeof value === 'boolean')
+            return value ? 'true' : 'false';
+    }
+    return '';
+}
+function readBool(value) {
+    if (typeof value === 'boolean')
+        return value;
+    const text = typeof value === 'string' ? value.trim().toLowerCase() : '';
+    if (!text)
+        return null;
+    if (['1', 'true', 'yes', 'on', 'auto'].includes(text))
+        return true;
+    if (['0', 'false', 'no', 'off', 'notify'].includes(text))
+        return false;
+    return null;
+}
+function normalizePolicy(value) {
+    const text = typeof value === 'string' ? value.trim().toLowerCase() : '';
+    if (text === 'auto' || text === 'notify' || text === 'off')
+        return text;
+    return '';
+}
+function normalizeDistTag(value) {
+    const text = typeof value === 'string' ? value.trim() : '';
+    if (!text)
+        return '';
+    return /^[A-Za-z0-9._-]+$/.test(text) ? text : '';
+}
+export function compareVersions(a, b) {
+    const pa = parseVersion(a);
+    const pb = parseVersion(b);
+    for (let i = 0; i < 3; i += 1) {
+        if (pa[i] !== pb[i])
+            return pa[i] - pb[i];
+    }
+    return 0;
+}
+function parseVersion(version) {
+    const match = String(version || '').match(/(\d+)\.(\d+)\.(\d+)/);
+    if (!match)
+        return [0, 0, 0];
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}

package/index.ts

@@ -17,6 +17,7 @@ import { registerTools, registerHooks } from './src/app/index.js';
 import { installOpenagentVerbosePreflight } from './src/app/verbose-preflight.js';
 // guard.ts removed — unhandled rejections fixed at source in ws-frame.ts send()
 import { setOpenagentPluginRuntime } from './src/runtime/plugin-runtime.js';
+import { startOpenagentUpdateChecker } from './src/runtime/update-checker.js';
 import { injectControlUiOverride } from './src/plugin-ui/index.js';
 import { createAuthProxyHandler } from './src/proxy/auth-proxy.js';
 import { logger } from './src/util/logger.js';
@@ -122,6 +123,8 @@ export default {
       logger.warn(`[entry] Control UI injection failed: ${(err as Error).message}`);
     });
 
+    startOpenagentUpdateChecker();
+
     logger.info('[entry] Tools + hooks registered (full mode)');
     _fullModeRegistered = true;
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-openagent",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "type": "module",
   "description": "OpenAgent channel plugin for OpenClaw",
   "license": "MIT",

package/src/config/config-schema.ts

@@ -16,6 +16,7 @@ import { z } from 'zod';
 // ---------------------------------------------------------------------------
 
 const transportSchema = z.enum(['oasn', 'tim']).default('oasn');
+const updatePolicySchema = z.enum(['notify', 'auto', 'off']).optional();
 
 const openagentAccountSchema = z.object({
   name: z.string().optional(),
@@ -35,5 +36,10 @@ export const OpenagentConfigSchema = openagentAccountSchema.extend({
   transport: transportSchema.optional(),
   api_base: z.string().optional(),
   access_api_base: z.string().optional(),
+  update_policy: updatePolicySchema,
+  update_check: z.boolean().optional(),
+  auto_update: z.boolean().optional(),
+  update_channel: z.string().optional(),
+  update_dist_tag: z.string().optional(),
   accounts: z.record(z.string(), openagentAccountSchema).optional(),
 });

package/src/plugin-ui/assets/openagent-override.js

@@ -2,7 +2,7 @@
  * OpenAgent UI Override — Auto-generated, do not edit directly!
  *
  * Source: src/plugin-ui/modules/
- * Built:  2026-07-06T03:23:32.989Z
+ * Built:  2026-07-06T09:05:33.996Z
  *
  * To modify, edit the source modules and run:
  *   npm run build:override
@@ -52,7 +52,7 @@ const CL = {
   hostVersion: '__OPENCLAW_HOST_VERSION__',
 
   // ── Override 构建标识（构建时注入，用于缓存自检）──
-  buildId: "65bf8968e270",
+  buildId: "4207d7dc1f64",
 
   // ── 配置 ──
   OPENAGENT_API: 'https://api.openagent.club',
@@ -2118,6 +2118,13 @@ function injectStyles() {
       padding: 14px;
       font-family: "PingFang SC", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
       box-sizing: border-box;
+      scrollbar-width: none;
+      -ms-overflow-style: none;
+    }
+    .openagent-agent-panel::-webkit-scrollbar {
+      width: 0;
+      height: 0;
+      display: none;
     }
     .openagent-agent-panel.visible {
       display: flex;
@@ -2357,21 +2364,13 @@ function injectStyles() {
       flex-direction: column;
       min-height: 0;
       max-height: min(56vh, 451px);
-      scrollbar-width: thin;
-      scrollbar-color: #ddd transparent;
+      scrollbar-width: none;
+      -ms-overflow-style: none;
     }
     .openagent-agent-list::-webkit-scrollbar {
-      width: 4px;
-    }
-    .openagent-agent-list::-webkit-scrollbar-track {
-      background: transparent;
-    }
-    .openagent-agent-list::-webkit-scrollbar-thumb {
-      background: #ddd;
-      border-radius: 2px;
-    }
-    .openagent-agent-list::-webkit-scrollbar-thumb:hover {
-      background: #bbb;
+      width: 0;
+      height: 0;
+      display: none;
     }
 
     .openagent-agent-section {
@@ -4923,7 +4922,13 @@ margin: 0 8px; position: relative; top: -1px;
 .trip-img-card {
 display: flex; flex-direction: row; gap: 6px;
 overflow-x: auto; padding: 8px 0; margin-left: 20px;
-scrollbar-width: thin;
+scrollbar-width: none;
+-ms-overflow-style: none;
+}
+.trip-img-card::-webkit-scrollbar {
+width: 0;
+height: 0;
+display: none;
 }
 .trip-img-item {
 position: relative; width: 191px; height: 100px; border-radius: 8px;
@@ -6983,6 +6988,14 @@ function _clScan() {
     '  overflow-x: auto;',
     '  white-space: pre-wrap;',
     '  word-break: break-all;',
+    '  scrollbar-width: none;',
+    '  -ms-overflow-style: none;',
+    '}',
+    '.cl-output-card > .cl-thought-chain-content pre::-webkit-scrollbar,',
+    '.cl-output-card > .cl-thought-chain-content code::-webkit-scrollbar {',
+    '  width: 0;',
+    '  height: 0;',
+    '  display: none;',
     '}',
     // V2 output card：统一 border/padding 与 execution card 一致
     '.cl-exec-v2.cl-output-card {',
@@ -7225,8 +7238,7 @@ function _clScan() {
     '.cl-exec-v2 .cl-exec-agent-avatar-v2 {',
     '  width: 68px !important;',
     '  height: 68px !important;',
-    '  border-radius: 50% !important;',
-    '  object-fit: cover;',
+    '  object-fit: contain;',
     '  flex-shrink: 0;',
     '}',
 
@@ -11142,9 +11154,104 @@ function _startClObserver() {
   _clObserverTarget = document.querySelector('openclaw-app') || document.body;
   _clObserver.observe(_clObserverTarget, { childList: true, subtree: true });
   setTimeout(_debouncedClScan, 2000);
+  setTimeout(_clCheckPluginUpdateStatus, 5000);
   /* muted */ void 0;
 }
 
+function _clCheckPluginUpdateStatus() {
+  fetch('/plugins/openagent/update-status', { cache: 'no-store' })
+    .then(function(res) {
+      if (!res.ok) return null;
+      return res.json();
+    })
+    .then(function(status) {
+      if (!status || !status.updateAvailable) return;
+      _clShowPluginUpdateNotice(status);
+    })
+    .catch(function() {});
+}
+
+function _clShowPluginUpdateNotice(status) {
+  var latestVersion = String(status.latestVersion || '').trim();
+  var currentVersion = String(status.currentVersion || '').trim();
+  var dismissKey = 'openagent-update-dismissed-' + latestVersion;
+  try {
+    if (latestVersion && localStorage.getItem(dismissKey) === '1') return;
+  } catch (e) {}
+
+  var existing = document.getElementById('openagent-update-notice');
+  if (existing) existing.remove();
+
+  var notice = document.createElement('div');
+  notice.id = 'openagent-update-notice';
+  notice.style.cssText = [
+    'position:fixed',
+    'right:18px',
+    'bottom:18px',
+    'z-index:2147483647',
+    'max-width:360px',
+    'padding:14px 16px',
+    'border:1px solid rgba(0,0,0,0.08)',
+    'border-radius:12px',
+    'background:#fff',
+    'box-shadow:0 12px 32px rgba(15,23,42,0.16)',
+    'font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif',
+    'color:#1f2937',
+    'font-size:13px',
+    'line-height:1.5'
+  ].join(';');
+
+  var title = document.createElement('div');
+  title.textContent = 'OpenAgent 有新版本 ' + latestVersion;
+  title.style.cssText = 'font-weight:600;font-size:14px;margin-right:22px;margin-bottom:4px;';
+  notice.appendChild(title);
+
+  var body = document.createElement('div');
+  var command = String(status.installCommand || 'npx -y openclaw-openagent-cli update');
+  body.textContent = currentVersion ? ('当前版本 ' + currentVersion + '，运行命令完成更新。') : '运行命令完成更新。';
+  body.style.cssText = 'color:#4b5563;margin-bottom:10px;';
+  notice.appendChild(body);
+
+  var code = document.createElement('code');
+  code.textContent = command;
+  code.style.cssText = 'display:block;white-space:normal;word-break:break-all;background:#f6f7f9;border-radius:8px;padding:8px 10px;color:#111827;';
+  notice.appendChild(code);
+
+  var actions = document.createElement('div');
+  actions.style.cssText = 'display:flex;justify-content:flex-end;gap:8px;margin-top:10px;';
+  var copy = document.createElement('button');
+  copy.type = 'button';
+  copy.textContent = '复制命令';
+  copy.style.cssText = 'border:1px solid #d1d5db;background:#fff;border-radius:8px;padding:6px 10px;cursor:pointer;color:#374151;';
+  copy.onclick = function() {
+    try {
+      navigator.clipboard.writeText(command);
+      copy.textContent = '已复制';
+    } catch (e) {}
+  };
+  actions.appendChild(copy);
+
+  var close = document.createElement('button');
+  close.type = 'button';
+  close.textContent = '关闭';
+  close.style.cssText = 'border:0;background:#111827;color:#fff;border-radius:8px;padding:6px 10px;cursor:pointer;';
+  close.onclick = function() {
+    try {
+      if (latestVersion) localStorage.setItem(dismissKey, '1');
+    } catch (e) {}
+    notice.remove();
+  };
+  actions.appendChild(close);
+  notice.appendChild(actions);
+
+  if (status.policy === 'auto' && status.autoUpdateStarted) {
+    body.textContent = '正在自动更新，OpenClaw Gateway 可能会自动重启。';
+    actions.remove();
+  }
+
+  document.body.appendChild(notice);
+}
+
 if (document.readyState === 'loading') {
   document.addEventListener('DOMContentLoaded', _startClObserver);
 } else {

package/src/plugin-ui/modules/agent-book/panel/styles.js

@@ -84,6 +84,13 @@ function injectStyles() {
       padding: 14px;
       font-family: "PingFang SC", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
       box-sizing: border-box;
+      scrollbar-width: none;
+      -ms-overflow-style: none;
+    }
+    .openagent-agent-panel::-webkit-scrollbar {
+      width: 0;
+      height: 0;
+      display: none;
     }
     .openagent-agent-panel.visible {
       display: flex;
@@ -323,21 +330,13 @@ function injectStyles() {
       flex-direction: column;
       min-height: 0;
       max-height: min(56vh, 451px);
-      scrollbar-width: thin;
-      scrollbar-color: #ddd transparent;
+      scrollbar-width: none;
+      -ms-overflow-style: none;
     }
     .openagent-agent-list::-webkit-scrollbar {
-      width: 4px;
-    }
-    .openagent-agent-list::-webkit-scrollbar-track {
-      background: transparent;
-    }
-    .openagent-agent-list::-webkit-scrollbar-thumb {
-      background: #ddd;
-      border-radius: 2px;
-    }
-    .openagent-agent-list::-webkit-scrollbar-thumb:hover {
-      background: #bbb;
+      width: 0;
+      height: 0;
+      display: none;
     }
 
     .openagent-agent-section {

package/src/plugin-ui/modules/agent-book/travelcard/travel-styles.js

@@ -79,7 +79,13 @@ margin: 0 8px; position: relative; top: -1px;
 .trip-img-card {
 display: flex; flex-direction: row; gap: 6px;
 overflow-x: auto; padding: 8px 0; margin-left: 20px;
-scrollbar-width: thin;
+scrollbar-width: none;
+-ms-overflow-style: none;
+}
+.trip-img-card::-webkit-scrollbar {
+width: 0;
+height: 0;
+display: none;
 }
 .trip-img-item {
 position: relative; width: 191px; height: 100px; border-radius: 8px;

package/src/plugin-ui/modules/loader/bootstrap.js

@@ -26,9 +26,104 @@ function _startClObserver() {
   _clObserverTarget = document.querySelector('openclaw-app') || document.body;
   _clObserver.observe(_clObserverTarget, { childList: true, subtree: true });
   setTimeout(_debouncedClScan, 2000);
+  setTimeout(_clCheckPluginUpdateStatus, 5000);
   /* muted */ void 0;
 }
 
+function _clCheckPluginUpdateStatus() {
+  fetch('/plugins/openagent/update-status', { cache: 'no-store' })
+    .then(function(res) {
+      if (!res.ok) return null;
+      return res.json();
+    })
+    .then(function(status) {
+      if (!status || !status.updateAvailable) return;
+      _clShowPluginUpdateNotice(status);
+    })
+    .catch(function() {});
+}
+
+function _clShowPluginUpdateNotice(status) {
+  var latestVersion = String(status.latestVersion || '').trim();
+  var currentVersion = String(status.currentVersion || '').trim();
+  var dismissKey = 'openagent-update-dismissed-' + latestVersion;
+  try {
+    if (latestVersion && localStorage.getItem(dismissKey) === '1') return;
+  } catch (e) {}
+
+  var existing = document.getElementById('openagent-update-notice');
+  if (existing) existing.remove();
+
+  var notice = document.createElement('div');
+  notice.id = 'openagent-update-notice';
+  notice.style.cssText = [
+    'position:fixed',
+    'right:18px',
+    'bottom:18px',
+    'z-index:2147483647',
+    'max-width:360px',
+    'padding:14px 16px',
+    'border:1px solid rgba(0,0,0,0.08)',
+    'border-radius:12px',
+    'background:#fff',
+    'box-shadow:0 12px 32px rgba(15,23,42,0.16)',
+    'font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif',
+    'color:#1f2937',
+    'font-size:13px',
+    'line-height:1.5'
+  ].join(';');
+
+  var title = document.createElement('div');
+  title.textContent = 'OpenAgent 有新版本 ' + latestVersion;
+  title.style.cssText = 'font-weight:600;font-size:14px;margin-right:22px;margin-bottom:4px;';
+  notice.appendChild(title);
+
+  var body = document.createElement('div');
+  var command = String(status.installCommand || 'npx -y openclaw-openagent-cli update');
+  body.textContent = currentVersion ? ('当前版本 ' + currentVersion + '，运行命令完成更新。') : '运行命令完成更新。';
+  body.style.cssText = 'color:#4b5563;margin-bottom:10px;';
+  notice.appendChild(body);
+
+  var code = document.createElement('code');
+  code.textContent = command;
+  code.style.cssText = 'display:block;white-space:normal;word-break:break-all;background:#f6f7f9;border-radius:8px;padding:8px 10px;color:#111827;';
+  notice.appendChild(code);
+
+  var actions = document.createElement('div');
+  actions.style.cssText = 'display:flex;justify-content:flex-end;gap:8px;margin-top:10px;';
+  var copy = document.createElement('button');
+  copy.type = 'button';
+  copy.textContent = '复制命令';
+  copy.style.cssText = 'border:1px solid #d1d5db;background:#fff;border-radius:8px;padding:6px 10px;cursor:pointer;color:#374151;';
+  copy.onclick = function() {
+    try {
+      navigator.clipboard.writeText(command);
+      copy.textContent = '已复制';
+    } catch (e) {}
+  };
+  actions.appendChild(copy);
+
+  var close = document.createElement('button');
+  close.type = 'button';
+  close.textContent = '关闭';
+  close.style.cssText = 'border:0;background:#111827;color:#fff;border-radius:8px;padding:6px 10px;cursor:pointer;';
+  close.onclick = function() {
+    try {
+      if (latestVersion) localStorage.setItem(dismissKey, '1');
+    } catch (e) {}
+    notice.remove();
+  };
+  actions.appendChild(close);
+  notice.appendChild(actions);
+
+  if (status.policy === 'auto' && status.autoUpdateStarted) {
+    body.textContent = '正在自动更新，OpenClaw Gateway 可能会自动重启。';
+    actions.remove();
+  }
+
+  document.body.appendChild(notice);
+}
+
 if (document.readyState === 'loading') {
   document.addEventListener('DOMContentLoaded', _startClObserver);
 } else {

package/src/plugin-ui/modules/remote-agent/styles.js

@@ -441,6 +441,14 @@
     '  overflow-x: auto;',
     '  white-space: pre-wrap;',
     '  word-break: break-all;',
+    '  scrollbar-width: none;',
+    '  -ms-overflow-style: none;',
+    '}',
+    '.cl-output-card > .cl-thought-chain-content pre::-webkit-scrollbar,',
+    '.cl-output-card > .cl-thought-chain-content code::-webkit-scrollbar {',
+    '  width: 0;',
+    '  height: 0;',
+    '  display: none;',
     '}',
     // V2 output card：统一 border/padding 与 execution card 一致
     '.cl-exec-v2.cl-output-card {',
@@ -683,8 +691,7 @@
     '.cl-exec-v2 .cl-exec-agent-avatar-v2 {',
     '  width: 68px !important;',
     '  height: 68px !important;',
-    '  border-radius: 50% !important;',
-    '  object-fit: cover;',
+    '  object-fit: contain;',
     '  flex-shrink: 0;',
     '}',
 

package/src/proxy/auth-proxy.ts

@@ -19,6 +19,7 @@ import fs from 'node:fs';
 import nodePath from 'node:path';
 import { logger } from '../util/logger.js';
 import { registry } from '../runtime/registry.js';
+import { getOpenagentUpdateStatus } from '../runtime/update-checker.js';
 import { isUnconfiguredOasnApiBase } from '../auth/config.js';
 import { resolveOasnRelativeUrl } from '../util/url-resolver.js';
 
@@ -100,6 +101,10 @@ export function createAuthProxyHandler() {
     if (targetPath.startsWith('/media/')) {
       return serveLocalMedia(targetPath, res);
     }
+    if (targetPath === '/update-status') {
+      writeJson(res, 200, getOpenagentUpdateStatus() as unknown as Record<string, unknown>);
+      return true;
+    }
     // v3.9+ 双轨抽象：上游按当前 transport 切换（OASN → api.oasn.ai；TIM → auth.ai-talk.live）
     const method = req.method ?? 'GET';
     const rt = registry.getDefault();

package/src/runtime/update-checker.ts

@@ -0,0 +1,286 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { logger } from '../util/logger.js';
+
+const PLUGIN_PACKAGE = 'openclaw-openagent';
+const CLI_PACKAGE = 'openclaw-openagent-cli';
+const DEFAULT_DIST_TAG = 'latest';
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+const CHECK_DELAY_MS = 3_000;
+
+export type OpenagentUpdatePolicy = 'notify' | 'auto' | 'off';
+
+export type OpenagentUpdateStatus = {
+  checked: boolean;
+  checking: boolean;
+  currentVersion: string;
+  latestVersion: string;
+  distTag: string;
+  updateAvailable: boolean;
+  policy: OpenagentUpdatePolicy;
+  installCommand: string;
+  autoUpdateStarted: boolean;
+  lastCheckedAt?: string;
+  error?: string;
+};
+
+type UpdateConfig = {
+  policy: OpenagentUpdatePolicy;
+  distTag: string;
+  channel: string;
+};
+
+let checkerStarted = false;
+
+const updateStatus: OpenagentUpdateStatus = {
+  checked: false,
+  checking: false,
+  currentVersion: '',
+  latestVersion: '',
+  distTag: DEFAULT_DIST_TAG,
+  updateAvailable: false,
+  policy: 'notify',
+  installCommand: `npx -y ${CLI_PACKAGE}`,
+  autoUpdateStarted: false,
+};
+
+export function getOpenagentUpdateStatus(): OpenagentUpdateStatus {
+  return { ...updateStatus };
+}
+
+export function startOpenagentUpdateChecker(): void {
+  if (checkerStarted) return;
+  checkerStarted = true;
+  setTimeout(() => {
+    void runOpenagentUpdateCheck().catch((err) => {
+      updateStatus.checked = true;
+      updateStatus.checking = false;
+      updateStatus.error = (err as Error).message;
+      updateStatus.lastCheckedAt = new Date().toISOString();
+      logger.warn(`[update-check] failed: ${(err as Error).message}`);
+    });
+  }, CHECK_DELAY_MS).unref?.();
+}
+
+export async function runOpenagentUpdateCheck(): Promise<OpenagentUpdateStatus> {
+  const config = resolveUpdateConfig();
+  updateStatus.policy = config.policy;
+  updateStatus.distTag = config.distTag;
+  updateStatus.installCommand = buildInstallCommand(config);
+  updateStatus.currentVersion = resolveCurrentVersion();
+
+  if (config.policy === 'off') {
+    updateStatus.checked = true;
+    updateStatus.checking = false;
+    updateStatus.updateAvailable = false;
+    updateStatus.lastCheckedAt = new Date().toISOString();
+    logger.info('[update-check] disabled by policy');
+    return getOpenagentUpdateStatus();
+  }
+
+  updateStatus.checking = true;
+  updateStatus.error = undefined;
+  try {
+    const latestVersion = await fetchDistTagVersion(config.distTag);
+    updateStatus.latestVersion = latestVersion;
+    updateStatus.updateAvailable = compareVersions(latestVersion, updateStatus.currentVersion) > 0;
+    updateStatus.checked = true;
+    updateStatus.checking = false;
+    updateStatus.lastCheckedAt = new Date().toISOString();
+
+    if (!updateStatus.updateAvailable) {
+      logger.info(`[update-check] up to date: ${PLUGIN_PACKAGE}@${updateStatus.currentVersion}`);
+      return getOpenagentUpdateStatus();
+    }
+
+    logger.warn(
+      `[update-check] new ${PLUGIN_PACKAGE} version available: `
+      + `${updateStatus.currentVersion} -> ${latestVersion}. Run: ${updateStatus.installCommand}`,
+    );
+
+    if (config.policy === 'auto') {
+      startAutoUpdate(config);
+    }
+    return getOpenagentUpdateStatus();
+  } catch (err) {
+    updateStatus.checked = true;
+    updateStatus.checking = false;
+    updateStatus.error = (err as Error).message;
+    updateStatus.lastCheckedAt = new Date().toISOString();
+    throw err;
+  }
+}
+
+function resolveUpdateConfig(): UpdateConfig {
+  const fileConfig = readOpenagentConfig();
+  const envPolicy = normalizePolicy(process.env.OPENAGENT_UPDATE_POLICY);
+  const autoUpdateEnv = readBool(process.env.OPENAGENT_AUTO_UPDATE ?? process.env.OPENAGENT_PLUGIN_AUTO_UPDATE);
+  const checkEnabledEnv = readBool(process.env.OPENAGENT_UPDATE_CHECK);
+  const configPolicy = normalizePolicy(readString(fileConfig, 'update_policy', 'updatePolicy'));
+  const configAutoUpdate = readBool(readString(fileConfig, 'auto_update', 'autoUpdate'));
+  const configUpdateCheck = readBool(readString(fileConfig, 'update_check', 'updateCheck'));
+
+  let policy: OpenagentUpdatePolicy = configPolicy || 'notify';
+  if (configAutoUpdate === true) policy = 'auto';
+  if (configUpdateCheck === false) policy = 'off';
+  if (envPolicy) policy = envPolicy;
+  if (autoUpdateEnv === true) policy = 'auto';
+  if (checkEnabledEnv === false) policy = 'off';
+
+  const distTag = normalizeDistTag(
+    process.env.OPENAGENT_UPDATE_DIST_TAG
+    || readString(fileConfig, 'update_dist_tag', 'updateDistTag')
+    || process.env.OPENAGENT_PLUGIN_DIST_TAG
+    || DEFAULT_DIST_TAG,
+  );
+  const channel = normalizeDistTag(
+    process.env.OPENAGENT_UPDATE_CHANNEL
+    || readString(fileConfig, 'update_channel', 'updateChannel')
+    || process.env.OPENAGENT_PLUGIN_CHANNEL
+    || '',
+  );
+
+  return {
+    policy,
+    distTag: channel || distTag,
+    channel,
+  };
+}
+
+function startAutoUpdate(config: UpdateConfig): void {
+  if (updateStatus.autoUpdateStarted) return;
+  updateStatus.autoUpdateStarted = true;
+
+  const npxBin = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+  const args = ['-y', CLI_PACKAGE, 'update'];
+  if (config.channel) {
+    args.push('--channel', config.channel);
+  } else if (config.distTag && config.distTag !== DEFAULT_DIST_TAG) {
+    args.push('--dist-tag', config.distTag);
+  }
+
+  logger.warn(`[update-check] auto update started: ${npxBin} ${args.join(' ')}`);
+  const child = spawn(npxBin, args, {
+    detached: true,
+    stdio: 'ignore',
+    env: process.env,
+  });
+  child.unref();
+}
+
+function buildInstallCommand(config: UpdateConfig): string {
+  const parts = ['npx', '-y', CLI_PACKAGE, 'update'];
+  if (config.channel) {
+    parts.push('--channel', config.channel);
+  } else if (config.distTag && config.distTag !== DEFAULT_DIST_TAG) {
+    parts.push('--dist-tag', config.distTag);
+  }
+  return parts.join(' ');
+}
+
+async function fetchDistTagVersion(distTag: string): Promise<string> {
+  if (process.env.OPENAGENT_UPDATE_TEST_VERSION) {
+    return process.env.OPENAGENT_UPDATE_TEST_VERSION;
+  }
+  const registry = (process.env.OPENAGENT_UPDATE_REGISTRY || DEFAULT_REGISTRY).replace(/\/+$/, '');
+  const url = `${registry}/${encodeURIComponent(PLUGIN_PACKAGE)}/${encodeURIComponent(distTag)}`;
+  const res = await fetch(url, {
+    headers: { Accept: 'application/json' },
+    signal: AbortSignal.timeout(5_000),
+  });
+  if (!res.ok) {
+    throw new Error(`npm registry ${res.status} for ${PLUGIN_PACKAGE}@${distTag}`);
+  }
+  const data = await res.json() as { version?: unknown };
+  const version = typeof data.version === 'string' ? data.version : '';
+  if (!version) throw new Error(`npm registry response missing version for ${PLUGIN_PACKAGE}@${distTag}`);
+  return version;
+}
+
+function resolveCurrentVersion(): string {
+  const packageJson = findPackageJson();
+  if (!packageJson) return '0.0.0';
+  try {
+    const data = JSON.parse(fs.readFileSync(packageJson, 'utf8')) as { version?: unknown };
+    return typeof data.version === 'string' ? data.version : '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
+function findPackageJson(): string | null {
+  let dir = path.dirname(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 8; i += 1) {
+    const candidate = path.join(dir, 'package.json');
+    try {
+      const data = JSON.parse(fs.readFileSync(candidate, 'utf8')) as { name?: unknown };
+      if (data.name === PLUGIN_PACKAGE) return candidate;
+    } catch {}
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+function readOpenagentConfig(): Record<string, unknown> {
+  const stateDir = process.env.OPENCLAW_STATE_DIR || path.join(os.homedir(), '.openclaw');
+  const configPath = path.join(stateDir, 'openclaw.json');
+  try {
+    const root = JSON.parse(fs.readFileSync(configPath, 'utf8')) as {
+      channels?: { openagent?: Record<string, unknown> };
+    };
+    return root.channels?.openagent || {};
+  } catch {
+    return {};
+  }
+}
+
+function readString(obj: Record<string, unknown>, ...keys: string[]): string {
+  for (const key of keys) {
+    const value = obj[key];
+    if (typeof value === 'string' && value.trim()) return value.trim();
+    if (typeof value === 'boolean') return value ? 'true' : 'false';
+  }
+  return '';
+}
+
+function readBool(value: unknown): boolean | null {
+  if (typeof value === 'boolean') return value;
+  const text = typeof value === 'string' ? value.trim().toLowerCase() : '';
+  if (!text) return null;
+  if (['1', 'true', 'yes', 'on', 'auto'].includes(text)) return true;
+  if (['0', 'false', 'no', 'off', 'notify'].includes(text)) return false;
+  return null;
+}
+
+function normalizePolicy(value: unknown): OpenagentUpdatePolicy | '' {
+  const text = typeof value === 'string' ? value.trim().toLowerCase() : '';
+  if (text === 'auto' || text === 'notify' || text === 'off') return text;
+  return '';
+}
+
+function normalizeDistTag(value: unknown): string {
+  const text = typeof value === 'string' ? value.trim() : '';
+  if (!text) return '';
+  return /^[A-Za-z0-9._-]+$/.test(text) ? text : '';
+}
+
+export function compareVersions(a: string, b: string): number {
+  const pa = parseVersion(a);
+  const pb = parseVersion(b);
+  for (let i = 0; i < 3; i += 1) {
+    if (pa[i] !== pb[i]) return pa[i] - pb[i];
+  }
+  return 0;
+}
+
+function parseVersion(version: string): [number, number, number] {
+  const match = String(version || '').match(/(\d+)\.(\d+)\.(\d+)/);
+  if (!match) return [0, 0, 0];
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}