openclaw-multi-auto 1.0.9 → 1.1.1

package/scripts/sparkle-build.ts

@@ -0,0 +1,76 @@
+#!/usr/bin/env -S node --import tsx
+
+import { pathToFileURL } from "node:url";
+
+export type SparkleBuildFloors = {
+  dateKey: number;
+  legacyFloor: number;
+  laneFloor: number;
+  lane: number;
+};
+
+const CALVER_REGEX = /^([0-9]{4})\.([0-9]{1,2})\.([0-9]{1,2})([.-].*)?$/;
+
+export function sparkleBuildFloorsFromShortVersion(
+  shortVersion: string,
+): SparkleBuildFloors | null {
+  const match = CALVER_REGEX.exec(shortVersion.trim());
+  if (!match) {
+    return null;
+  }
+
+  const year = Number.parseInt(match[1], 10);
+  const month = Number.parseInt(match[2], 10);
+  const day = Number.parseInt(match[3], 10);
+  if (
+    !Number.isInteger(year) ||
+    !Number.isInteger(month) ||
+    !Number.isInteger(day) ||
+    month < 1 ||
+    month > 12 ||
+    day < 1 ||
+    day > 31
+  ) {
+    return null;
+  }
+
+  const dateKey = Number(`${year}${String(month).padStart(2, "0")}${String(day).padStart(2, "0")}`);
+  const legacyFloor = Number(`${dateKey}0`);
+
+  let lane = 90;
+  const suffix = match[4] ?? "";
+  if (suffix.length > 0) {
+    const numericSuffix = /([0-9]+)$/.exec(suffix)?.[1];
+    if (numericSuffix) {
+      lane = Math.min(Number.parseInt(numericSuffix, 10), 89);
+    } else {
+      lane = 1;
+    }
+  }
+
+  const laneFloor = Number(`${dateKey}${String(lane).padStart(2, "0")}`);
+  return { dateKey, legacyFloor, laneFloor, lane };
+}
+
+export function canonicalSparkleBuildFromVersion(shortVersion: string): number | null {
+  return sparkleBuildFloorsFromShortVersion(shortVersion)?.laneFloor ?? null;
+}
+
+function runCli(args: string[]): number {
+  const [command, version] = args;
+  if (command !== "canonical-build" || !version) {
+    return 1;
+  }
+
+  const build = canonicalSparkleBuildFromVersion(version);
+  if (build === null) {
+    return 1;
+  }
+
+  console.log(String(build));
+  return 0;
+}
+
+if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
+  process.exit(runCli(process.argv.slice(2)));
+}

package/scripts/sqlite-vec-smoke.mjs

@@ -0,0 +1,38 @@
+import { DatabaseSync } from "node:sqlite";
+import { load, getLoadablePath } from "sqlite-vec";
+
+function vec(values) {
+  return Buffer.from(new Float32Array(values).buffer);
+}
+
+const db = new DatabaseSync(":memory:", { allowExtension: true });
+
+try {
+  load(db);
+} catch (err) {
+  const message = err instanceof Error ? err.message : String(err);
+  console.error("sqlite-vec load failed:");
+  console.error(message);
+  console.error("expected extension path:", getLoadablePath());
+  process.exit(1);
+}
+
+db.exec(`
+  CREATE VIRTUAL TABLE v USING vec0(
+    id TEXT PRIMARY KEY,
+    embedding FLOAT[4]
+  );
+`);
+
+const insert = db.prepare("INSERT INTO v (id, embedding) VALUES (?, ?)");
+insert.run("a", vec([1, 0, 0, 0]));
+insert.run("b", vec([0, 1, 0, 0]));
+insert.run("c", vec([0.2, 0.2, 0, 0]));
+
+const query = vec([1, 0, 0, 0]);
+const rows = db
+  .prepare("SELECT id, vec_distance_cosine(embedding, ?) AS dist FROM v ORDER BY dist ASC")
+  .all(query);
+
+console.log("sqlite-vec ok");
+console.log(rows);

package/scripts/sync-dist.sh

@@ -0,0 +1,171 @@
+#!/usr/bin/env bash
+# =================================================================
+# OpenClaw 深度集成初始化工具 (init-instance.sh)
+# 合并逻辑：全量配置生成 + 跨目录代码分发 + 依赖固化 + launchd 注册
+# =================================================================
+
+set -e
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\133[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# --- 1. 路径溯源与环境检查 ---
+GLOBAL_PREFIX=$(npm config get prefix)
+DEFAULT_SOURCE="${GLOBAL_PREFIX}/lib/node_modules/openclaw-multi-auto"
+[ -d "$HOME/projects/openclaw" ] && DEFAULT_SOURCE="$HOME/projects/openclaw"
+
+SOURCE_CODE="$DEFAULT_SOURCE"
+INSTANCES_BASE="$HOME/openclaws"
+
+# --- 2. 参数与交互式获取 ---
+INSTANCE_NAME="${1:-}"
+if [ -z "$INSTANCE_NAME" ]; then
+    read -p "请输入实例名称 (默认: yunwei): " INPUT_NAME
+    INSTANCE_NAME="${INPUT_NAME:-yunwei}"
+fi
+
+# 端口自动计算逻辑 (保留原始逻辑)
+if [ -n "$2" ]; then
+    PORT="$2"
+else
+    EXISTING_COUNT=$(ls -d "$INSTANCES_BASE"/*/ 2>/dev/null | wc -l | tr -d ' ')
+    PORT=$((18790 + EXISTING_COUNT))
+fi
+
+MODEL_PROVIDER="${3:-}"
+if [ -z "$MODEL_PROVIDER" ]; then
+    echo "--- 请选择模型供应商 ---"
+    echo "1) zai (智谱) 2) deepseek 3) minimax 4) kimi 5) qwen"
+    read -p "请输入编号 (1-5): " MODEL_INDEX
+    case $MODEL_INDEX in
+        1) MODEL_PROVIDER="zai" ;;
+        2) MODEL_PROVIDER="deepseek" ;;
+        3) MODEL_PROVIDER="minimax" ;;
+        4) MODEL_PROVIDER="kimi" ;;
+        5) MODEL_PROVIDER="qwen" ;;
+        *) MODEL_PROVIDER="zai" ;;
+    esac
+fi
+
+API_KEY="${4:-}"
+if [ -z "$API_KEY" ]; then
+    read -p "请输入您的 ${MODEL_PROVIDER} API Key: " API_KEY
+fi
+
+# 路径定义
+INSTANCE_DIR="$INSTANCES_BASE/${INSTANCE_NAME}"
+DIST_DIR="${INSTANCE_DIR}/dist"
+
+if [ -d "$INSTANCE_DIR" ]; then
+    echo -e "${RED}❌ 实例已存在: ${INSTANCE_DIR}${NC}"; exit 1
+fi
+
+echo -e "${BLUE}🏗️  正在深度初始化实例: ${INSTANCE_NAME} (端口 ${PORT})${NC}"
+
+# --- 3. 完整目录结构创建 ---
+mkdir -p "${INSTANCE_DIR}/config" "${INSTANCE_DIR}/tmp" "${INSTANCE_DIR}/workspace"
+mkdir -p "${INSTANCE_DIR}/agents/main/agent/sessions"
+mkdir -p "${INSTANCE_DIR}/credentials" "${INSTANCE_DIR}/media"
+
+# --- 4. 生成深度配置文件 (保留原复杂逻辑) ---
+DEFAULT_MODEL="zai/glm-5"
+ZAI_KEY=""; DS_KEY=""; MX_KEY=""; KIMI_KEY=""; QWEN_KEY=""
+
+case "$MODEL_PROVIDER" in
+    zai) DEFAULT_MODEL="zai/glm-4-flash"; ZAI_KEY="$API_KEY" ;;
+    deepseek) DEFAULT_MODEL="deepseek/deepseek-chat"; DS_KEY="$API_KEY" ;;
+    minimax) DEFAULT_MODEL="minimax-cn/MiniMax-M2.5-highspeed"; MX_KEY="$API_KEY" ;;
+    kimi) DEFAULT_MODEL="kimi/moonshot-v1-8k"; KIMI_KEY="$API_KEY" ;;
+    qwen) DEFAULT_MODEL="qwen/qwen-plus"; QWEN_KEY="$API_KEY" ;;
+esac
+
+cat > "${INSTANCE_DIR}/config/openclaw.json" << EOF
+{
+  "meta": {
+    "lastTouchedVersion": "2026.3.3",
+    "lastTouchedAt": "$(date -u +"%Y-%m-%dT%H:%M:%S.%3NZ")"
+  },
+  "agents": {
+    "defaults": {
+      "model": { "primary": "${DEFAULT_MODEL}" },
+      "workspace": "${INSTANCE_DIR}/workspace",
+      "compaction": { "mode": "safeguard" }
+    }
+  },
+  "commands": { "native": "auto", "restart": false },
+  "env": {
+    "ZAI_API_KEY": "${ZAI_KEY}",
+    "DEEPSEEK_API_KEY": "${DS_KEY}",
+    "MINIMAX_API_KEY": "${MX_KEY}",
+    "KIMI_API_KEY": "${KIMI_KEY}",
+    "QWEN_API_KEY": "${QWEN_KEY}"
+  },
+  "gateway": { "port": ${PORT}, "mode": "local" }
+}
+EOF
+
+# --- 5. 核心代码同步 (原 sync-dist 增强逻辑) ---
+echo -e "${BLUE}🔄 分发代码产物与元数据...${NC}"
+mkdir -p "$DIST_DIR"
+if [ -d "${SOURCE_CODE}/dist" ]; then
+    rsync -av --delete "${SOURCE_CODE}/dist/" "${DIST_DIR}/" 2>/dev/null | head -n 3
+else
+    echo -e "${RED}❌ 错误: 母本 dist 不存在，同步终止。${NC}"; exit 1
+fi
+
+cp "${SOURCE_CODE}/package.json" "${INSTANCE_DIR}/package.json"
+[ -f "${SOURCE_CODE}/pnpm-lock.yaml" ] && cp "${SOURCE_CODE}/pnpm-lock.yaml" "${INSTANCE_DIR}/pnpm-lock.yaml"
+
+# --- 6. 固化本地依赖 (提升依赖层级) ---
+echo -e "${BLUE}📦 固化实例运行环境 (pnpm)...${NC}"
+export SHARP_BINARY_HOST="https://npmmirror.com/mirrors/sharp"
+export SHARP_LIBVIPS_BINARY_HOST="https://npmmirror.com/mirrors/sharp-libvips"
+
+cd "${INSTANCE_DIR}"
+pnpm install --shamefully-hoist --registry=https://registry.npmmirror.com 2>&1 | grep -v "WARN" | head -n 5
+
+# --- 7. 生成增强型启动脚本 (含 launchd 逻辑) ---
+cat > "${INSTANCE_DIR}/start.sh" << 'EOF'
+#!/usr/bin/env bash
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+INSTANCE_NAME=$(basename "$SCRIPT_DIR")
+export OPENCLAW_CONFIG_PATH="$SCRIPT_DIR/config/openclaw.json"
+export OPENCLAW_TMP_DIR="$SCRIPT_DIR/tmp"
+
+# 导出环境变量
+eval $(node -e "const env = require('$OPENCLAW_CONFIG_PATH').env || {}; Object.keys(env).forEach(k => console.log('export ' + k + '=\"' + env[k] + '\"'))")
+
+# macOS launchd 注册逻辑
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    PLIST_LABEL="ai.openclaw.$INSTANCE_NAME"
+    PLIST_PATH="$HOME/Library/LaunchAgents/$PLIST_LABEL.plist"
+    if [ ! -f "$PLIST_PATH" ]; then
+        echo "📦 注册 launchd 服务..."
+        cat > "$PLIST_PATH" <<EOP
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0"><dict><key>Label</key><string>$PLIST_LABEL</string><key>ProgramArguments</key><array><string>/bin/bash</string><string>$SCRIPT_DIR/start.sh</string></array><key>RunAtLoad</key><true/><key>KeepAlive</key><true/></dict></plist>
+EOP
+        launchctl load "$PLIST_PATH" 2>/dev/null || true
+    fi
+fi
+
+echo "🚀 启动 OpenClaw-$INSTANCE_NAME..."
+exec node "./dist/index.js" gateway run --port $(node -e "console.log(require('$OPENCLAW_CONFIG_PATH').gateway.port)")
+EOF
+chmod +x "${INSTANCE_DIR}/start.sh"
+
+# --- 8. 全自动执行启动 ---
+echo -e "${BLUE}⚡ 正在拉起服务...${NC}"
+nohup ./start.sh > "${INSTANCE_DIR}/workspace/server.log" 2>&1 &
+
+sleep 2
+if ps -p $! > /dev/null; then
+    echo -e "${GREEN}✅ 实例 [${INSTANCE_NAME}] 已上线！端口: ${PORT}${NC}"
+else
+    echo -e "${RED}❌ 启动失败，日志: ${INSTANCE_DIR}/workspace/server.log${NC}"
+fi

package/scripts/sync-labels.ts

@@ -0,0 +1,100 @@
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+type RepoLabel = {
+  name: string;
+  color?: string;
+};
+
+const COLOR_BY_PREFIX = new Map<string, string>([
+  ["channel", "1d76db"],
+  ["app", "6f42c1"],
+  ["extensions", "0e8a16"],
+  ["docs", "0075ca"],
+  ["cli", "f9d0c4"],
+  ["gateway", "d4c5f9"],
+  ["size", "fbca04"],
+]);
+
+const configPath = resolve(".github/labeler.yml");
+const EXTRA_LABELS = ["size: XS", "size: S", "size: M", "size: L", "size: XL"] as const;
+const labelNames = [
+  ...new Set([...extractLabelNames(readFileSync(configPath, "utf8")), ...EXTRA_LABELS]),
+];
+
+if (!labelNames.length) {
+  throw new Error("labeler.yml must declare at least one label.");
+}
+
+const repo = resolveRepo();
+const existing = fetchExistingLabels(repo);
+
+const missing = labelNames.filter((label) => !existing.has(label));
+if (!missing.length) {
+  console.log("All labeler labels already exist.");
+  process.exit(0);
+}
+
+for (const label of missing) {
+  const color = pickColor(label);
+  execFileSync(
+    "gh",
+    ["api", "-X", "POST", `repos/${repo}/labels`, "-f", `name=${label}`, "-f", `color=${color}`],
+    { stdio: "inherit" },
+  );
+  console.log(`Created label: ${label}`);
+}
+
+function extractLabelNames(contents: string): string[] {
+  const labels: string[] = [];
+  for (const line of contents.split("\n")) {
+    if (!line.trim() || line.trimStart().startsWith("#")) {
+      continue;
+    }
+    if (/^\s/.test(line)) {
+      continue;
+    }
+    const match = line.match(/^(["'])(.+)\1\s*:/) ?? line.match(/^([^:]+):/);
+    if (match) {
+      const name = (match[2] ?? match[1] ?? "").trim();
+      if (name) {
+        labels.push(name);
+      }
+    }
+  }
+  return labels;
+}
+
+function pickColor(label: string): string {
+  const prefix = label.includes(":") ? label.split(":", 1)[0].trim() : label.trim();
+  return COLOR_BY_PREFIX.get(prefix) ?? "ededed";
+}
+
+function resolveRepo(): string {
+  const remote = execFileSync("git", ["config", "--get", "remote.origin.url"], {
+    encoding: "utf8",
+  }).trim();
+
+  if (!remote) {
+    throw new Error("Unable to determine repository from git remote.");
+  }
+
+  if (remote.startsWith("git@github.com:")) {
+    return remote.replace("git@github.com:", "").replace(/\.git$/, "");
+  }
+
+  if (remote.startsWith("https://github.com/")) {
+    return remote.replace("https://github.com/", "").replace(/\.git$/, "");
+  }
+
+  throw new Error(`Unsupported GitHub remote: ${remote}`);
+}
+
+function fetchExistingLabels(repo: string): Map<string, RepoLabel> {
+  const raw = execFileSync("gh", ["api", `repos/${repo}/labels?per_page=100`, "--paginate"], {
+    encoding: "utf8",
+  });
+  const labels = JSON.parse(raw) as RepoLabel[];
+  return new Map(labels.map((label) => [label.name, label]));
+}

package/scripts/sync-moonshot-docs.ts

@@ -0,0 +1,125 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import {
+  MOONSHOT_KIMI_K2_CONTEXT_WINDOW,
+  MOONSHOT_KIMI_K2_COST,
+  MOONSHOT_KIMI_K2_INPUT,
+  MOONSHOT_KIMI_K2_MAX_TOKENS,
+  MOONSHOT_KIMI_K2_MODELS,
+} from "../ui/src/ui/data/moonshot-kimi-k2";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(here, "..");
+
+function replaceBlockLines(
+  text: string,
+  startMarker: string,
+  endMarker: string,
+  lines: string[],
+): string {
+  const startIndex = text.indexOf(startMarker);
+  if (startIndex === -1) {
+    throw new Error(`Missing start marker: ${startMarker}`);
+  }
+  const endIndex = text.indexOf(endMarker, startIndex);
+  if (endIndex === -1) {
+    throw new Error(`Missing end marker: ${endMarker}`);
+  }
+
+  const startLineStart = text.lastIndexOf("\n", startIndex);
+  const startLineStartIndex = startLineStart === -1 ? 0 : startLineStart + 1;
+  const indent = text.slice(startLineStartIndex, startIndex);
+
+  const endLineEnd = text.indexOf("\n", endIndex);
+  const endLineEndIndex = endLineEnd === -1 ? text.length : endLineEnd + 1;
+
+  const before = text.slice(0, startLineStartIndex);
+  const after = text.slice(endLineEndIndex);
+
+  const replacementLines = [
+    `${indent}${startMarker}`,
+    ...lines.map((line) => `${indent}${line}`),
+    `${indent}${endMarker}`,
+  ];
+
+  const replacement = replacementLines.join("\n");
+  if (!after) {
+    return `${before}${replacement}`;
+  }
+  return `${before}${replacement}\n${after}`;
+}
+
+function renderKimiK2Ids(prefix: string) {
+  return MOONSHOT_KIMI_K2_MODELS.map((model) => `- \`${prefix}${model.id}\``);
+}
+
+function renderMoonshotAliases() {
+  return MOONSHOT_KIMI_K2_MODELS.map((model, index) => {
+    const isLast = index === MOONSHOT_KIMI_K2_MODELS.length - 1;
+    const suffix = isLast ? "" : ",";
+    return `"moonshot/${model.id}": { alias: "${model.alias}" }${suffix}`;
+  });
+}
+
+function renderMoonshotModels() {
+  const input = JSON.stringify([...MOONSHOT_KIMI_K2_INPUT]);
+  const cost = `input: ${MOONSHOT_KIMI_K2_COST.input}, output: ${MOONSHOT_KIMI_K2_COST.output}, cacheRead: ${MOONSHOT_KIMI_K2_COST.cacheRead}, cacheWrite: ${MOONSHOT_KIMI_K2_COST.cacheWrite}`;
+
+  return MOONSHOT_KIMI_K2_MODELS.flatMap((model, index) => {
+    const isLast = index === MOONSHOT_KIMI_K2_MODELS.length - 1;
+    const closing = isLast ? "}" : "},";
+    return [
+      "{",
+      `  id: "${model.id}",`,
+      `  name: "${model.name}",`,
+      `  reasoning: ${model.reasoning},`,
+      `  input: ${input},`,
+      `  cost: { ${cost} },`,
+      `  contextWindow: ${MOONSHOT_KIMI_K2_CONTEXT_WINDOW},`,
+      `  maxTokens: ${MOONSHOT_KIMI_K2_MAX_TOKENS}`,
+      closing,
+    ];
+  });
+}
+
+async function syncMoonshotDocs() {
+  const moonshotDoc = path.join(repoRoot, "docs/providers/moonshot.md");
+  const conceptsDoc = path.join(repoRoot, "docs/concepts/model-providers.md");
+
+  let moonshotText = await readFile(moonshotDoc, "utf8");
+  moonshotText = replaceBlockLines(
+    moonshotText,
+    "{/_ moonshot-kimi-k2-ids:start _/ && null}",
+    "{/_ moonshot-kimi-k2-ids:end _/ && null}",
+    renderKimiK2Ids(""),
+  );
+  moonshotText = replaceBlockLines(
+    moonshotText,
+    "// moonshot-kimi-k2-aliases:start",
+    "// moonshot-kimi-k2-aliases:end",
+    renderMoonshotAliases(),
+  );
+  moonshotText = replaceBlockLines(
+    moonshotText,
+    "// moonshot-kimi-k2-models:start",
+    "// moonshot-kimi-k2-models:end",
+    renderMoonshotModels(),
+  );
+
+  let conceptsText = await readFile(conceptsDoc, "utf8");
+  conceptsText = replaceBlockLines(
+    conceptsText,
+    "{/_ moonshot-kimi-k2-model-refs:start _/ && null}",
+    "{/_ moonshot-kimi-k2-model-refs:end _/ && null}",
+    renderKimiK2Ids("moonshot/"),
+  );
+
+  await writeFile(moonshotDoc, moonshotText);
+  await writeFile(conceptsDoc, conceptsText);
+}
+
+syncMoonshotDocs().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

package/scripts/sync-plugin-versions.ts

@@ -0,0 +1,108 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+
+type PackageJson = {
+  name?: string;
+  version?: string;
+  devDependencies?: Record<string, string>;
+};
+
+function ensureChangelogEntry(changelogPath: string, version: string): boolean {
+  if (!existsSync(changelogPath)) {
+    return false;
+  }
+  const content = readFileSync(changelogPath, "utf8");
+  if (content.includes(`## ${version}`)) {
+    return false;
+  }
+  const entry = `## ${version}\n\n### Changes\n- Version alignment with core OpenClaw release numbers.\n\n`;
+  if (content.startsWith("# Changelog\n\n")) {
+    const next = content.replace("# Changelog\n\n", `# Changelog\n\n${entry}`);
+    writeFileSync(changelogPath, next);
+    return true;
+  }
+  const next = `# Changelog\n\n${entry}${content.trimStart()}`;
+  writeFileSync(changelogPath, `${next}\n`);
+  return true;
+}
+
+function stripWorkspaceOpenclawDevDependency(pkg: PackageJson): boolean {
+  const devDeps = pkg.devDependencies;
+  if (!devDeps || devDeps.openclaw !== "workspace:*") {
+    return false;
+  }
+  delete devDeps.openclaw;
+  if (Object.keys(devDeps).length === 0) {
+    delete pkg.devDependencies;
+  }
+  return true;
+}
+
+export function syncPluginVersions(rootDir = resolve(".")) {
+  const rootPackagePath = join(rootDir, "package.json");
+  const rootPackage = JSON.parse(readFileSync(rootPackagePath, "utf8")) as PackageJson;
+  const targetVersion = rootPackage.version;
+  if (!targetVersion) {
+    throw new Error("Root package.json missing version.");
+  }
+
+  const extensionsDir = join(rootDir, "extensions");
+  const dirs = readdirSync(extensionsDir, { withFileTypes: true }).filter((entry) =>
+    entry.isDirectory(),
+  );
+
+  const updated: string[] = [];
+  const changelogged: string[] = [];
+  const skipped: string[] = [];
+  const strippedWorkspaceDevDeps: string[] = [];
+
+  for (const dir of dirs) {
+    const packagePath = join(extensionsDir, dir.name, "package.json");
+    let pkg: PackageJson;
+    try {
+      pkg = JSON.parse(readFileSync(packagePath, "utf8")) as PackageJson;
+    } catch {
+      continue;
+    }
+
+    if (!pkg.name) {
+      skipped.push(dir.name);
+      continue;
+    }
+
+    const changelogPath = join(extensionsDir, dir.name, "CHANGELOG.md");
+    if (ensureChangelogEntry(changelogPath, targetVersion)) {
+      changelogged.push(pkg.name);
+    }
+
+    const removedWorkspaceDevDependency = stripWorkspaceOpenclawDevDependency(pkg);
+    if (removedWorkspaceDevDependency) {
+      strippedWorkspaceDevDeps.push(pkg.name);
+    }
+
+    const versionChanged = pkg.version !== targetVersion;
+    if (!versionChanged && !removedWorkspaceDevDependency) {
+      skipped.push(pkg.name);
+      continue;
+    }
+
+    pkg.version = targetVersion;
+    writeFileSync(packagePath, `${JSON.stringify(pkg, null, 2)}\n`);
+    updated.push(pkg.name);
+  }
+
+  return {
+    targetVersion,
+    updated,
+    changelogged,
+    skipped,
+    strippedWorkspaceDevDeps,
+  };
+}
+
+if (import.meta.main) {
+  const summary = syncPluginVersions();
+  console.log(
+    `Synced plugin versions to ${summary.targetVersion}. Updated: ${summary.updated.length}. Changelogged: ${summary.changelogged.length}. Stripped workspace devDeps: ${summary.strippedWorkspaceDevDeps.length}. Skipped: ${summary.skipped.length}.`,
+  );
+}

package/scripts/systemd/openclaw-auth-monitor.service

@@ -0,0 +1,14 @@
+[Unit]
+Description=OpenClaw Auth Expiry Monitor
+After=network.target
+
+[Service]
+Type=oneshot
+ExecStart=/home/admin/openclaw/scripts/auth-monitor.sh
+# Configure notification channels via environment
+Environment=WARN_HOURS=2
+# Environment=NOTIFY_PHONE=+1234567890
+# Environment=NOTIFY_NTFY=openclaw-alerts
+
+[Install]
+WantedBy=default.target

package/scripts/systemd/openclaw-auth-monitor.timer

@@ -0,0 +1,10 @@
+[Unit]
+Description=Check OpenClaw auth expiry every 30 minutes
+
+[Timer]
+OnBootSec=5min
+OnUnitActiveSec=30min
+Persistent=true
+
+[Install]
+WantedBy=timers.target