feat: auto-detect upgrades in setup cli

Author: Yuuki-Sakura

README.md

@@ -11,9 +11,10 @@ npx -y @aitoearn/openclaw-plugin
 这个命令会自动：
 
 1. 将当前插件包安装到 OpenClaw 的扩展目录
-2. 引导输入 API Key 和环境
-3. 验证连通性
-4. 写入 `plugins.entries.aitoearn.config`
+2. 自动检测是否为已有安装
+3. 首次安装时引导输入 API Key 和环境
+4. 验证连通性
+5. 写入 `plugins.entries.aitoearn.config`
 
 ## 手动配置
 
@@ -51,6 +52,8 @@ npx -y @aitoearn/openclaw-plugin
 npx -y @aitoearn/openclaw-plugin upgrade
 ```
 
+再次执行默认命令时，如果检测到已有 `aitoearn` 配置，会自动按升级处理并跳过 setup。
+
 完成配置后，重启 Gateway：
 
 ```bash

openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "aitoearn",
   "name": "AiToEarn",
   "description": "AiToEarn social media management tools",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@aitoearn/openclaw-plugin",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package.json

@@ -115,6 +115,43 @@ describe("runSetupCli", () => {
     expect(prompts.outro).toHaveBeenCalled();
   });
 
+  it("auto-detects upgrade when existing plugin config is present", async () => {
+    installPlugin.mockResolvedValue({
+      replacedExisting: true,
+      targetDir: "/tmp/.openclaw/extensions/aitoearn",
+    });
+    readConfig.mockResolvedValue({
+      plugins: {
+        entries: {
+          aitoearn: {
+            enabled: true,
+            config: {
+              apiKey: "existing-api-key",
+              baseUrl: "https://aitoearn.ai/api",
+            },
+          },
+        },
+      },
+    });
+
+    const exitCode = await runSetupCli([], {
+      prompts,
+      loadPackageContext,
+      installPlugin,
+      readConfig,
+      writeConfig,
+      runSetupFlow,
+    });
+
+    expect(exitCode).toBe(0);
+    expect(readConfig).toHaveBeenCalledTimes(1);
+    expect(runSetupFlow).not.toHaveBeenCalled();
+    expect(writeConfig).not.toHaveBeenCalled();
+    expect(prompts.outro).toHaveBeenCalledWith(
+      'Existing configuration detected. Upgrade complete! Run "openclaw gateway restart" to apply.'
+    );
+  });
+
   it("returns success when setup is cancelled after installation", async () => {
     runSetupFlow.mockResolvedValue({ status: "cancelled" });
 
@@ -131,6 +168,57 @@ describe("runSetupCli", () => {
     expect(writeConfig).not.toHaveBeenCalled();
   });
 
+  it("continues into setup when existing installation has no saved apiKey", async () => {
+    installPlugin.mockResolvedValue({
+      replacedExisting: true,
+      targetDir: "/tmp/.openclaw/extensions/aitoearn",
+    });
+    readConfig.mockResolvedValue({
+      plugins: {
+        entries: {
+          aitoearn: {
+            enabled: true,
+            config: {},
+          },
+        },
+      },
+    });
+    runSetupFlow.mockResolvedValue({
+      status: "completed",
+      config: {
+        apiKey: "new-api-key",
+        baseUrl: "https://aitoearn.ai/api/",
+      },
+      toolCount: 3,
+    });
+
+    const exitCode = await runSetupCli([], {
+      prompts,
+      loadPackageContext,
+      installPlugin,
+      readConfig,
+      writeConfig,
+      runSetupFlow,
+    });
+
+    expect(exitCode).toBe(0);
+    expect(readConfig).toHaveBeenCalledTimes(1);
+    expect(runSetupFlow).toHaveBeenCalled();
+    expect(writeConfig).toHaveBeenCalledWith({
+      plugins: {
+        entries: {
+          aitoearn: {
+            enabled: true,
+            config: {
+              apiKey: "new-api-key",
+              baseUrl: "https://aitoearn.ai/api",
+            },
+          },
+        },
+      },
+    });
+  });
+
   it("upgrades plugin files without rerunning setup", async () => {
     installPlugin.mockResolvedValue({
       replacedExisting: true,

src/cli.test.ts

@@ -17,6 +17,7 @@ import {
   runInteractiveSetupFlow,
   type SetupFlowResult,
 } from "./setup-flow.js";
+import { configSchema, PLUGIN_ID } from "./plugin-config.js";
 
 interface SpinnerApi {
   start(message: string): void;
@@ -67,7 +68,7 @@ export async function runSetupCli(
     return 1;
   }
 
-  const command = args[0] ?? "install";
+  const command = args[0] ?? "auto";
 
   deps.prompts.intro("AiToEarn OpenClaw Setup");
 
@@ -104,6 +105,23 @@ export async function runSetupCli(
     return 0;
   }
 
+  let currentConfig: Record<string, unknown> | null = null;
+  if (command === "auto" && installResult.replacedExisting) {
+    try {
+      currentConfig = await deps.readConfig();
+    } catch (error) {
+      deps.prompts.cancel(formatError(error));
+      return 1;
+    }
+
+    if (hasConfiguredPluginEntry(currentConfig)) {
+      deps.prompts.outro(
+        'Existing configuration detected. Upgrade complete! Run "openclaw gateway restart" to apply.'
+      );
+      return 0;
+    }
+  }
+
   const setupResult = await deps.runSetupFlow({ showIntro: false });
   if (setupResult.status === "cancelled") {
     return 0;
@@ -117,7 +135,7 @@ export async function runSetupCli(
   configSpinner.start("Writing OpenClaw configuration...");
 
   try {
-    const currentConfig = await deps.readConfig();
+    currentConfig ??= await deps.readConfig();
     const nextConfig = applySetupConfigToOpenClawConfig(
       currentConfig,
       setupResult.config
@@ -153,6 +171,32 @@ function formatError(error: unknown): string {
   return error instanceof Error ? error.message : String(error);
 }
 
+function hasConfiguredPluginEntry(config: Record<string, unknown>): boolean {
+  const plugins = asRecord(config.plugins);
+  const entries = asRecord(plugins?.entries);
+  const pluginEntry = asRecord(entries?.[PLUGIN_ID]);
+  const parsed = configSchema.safeParse(pluginEntry?.config ?? {});
+
+  if (!parsed.success) {
+    return false;
+  }
+
+  const apiKey = parsed.data.apiKey;
+  if (typeof apiKey === "string") {
+    return apiKey.trim().length > 0;
+  }
+
+  return isRecord(apiKey);
+}
+
+function asRecord(value: unknown): Record<string, unknown> | null {
+  return isRecord(value) ? value : null;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 async function main(): Promise<void> {
   const exitCode = await runSetupCli(process.argv.slice(2));
   if (exitCode !== 0) {