fix: support external plugin upgrades

Author: Yuuki-Sakura

README.md

@@ -45,6 +45,12 @@ openclaw config set plugins.entries.aitoearn.config.apiKey \
 npx -y @aitoearn/openclaw-plugin
 ```
 
+升级插件：
+
+```bash
+npx -y @aitoearn/openclaw-plugin upgrade
+```
+
 完成配置后，重启 Gateway：
 
 ```bash

openclaw.plugin.json

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

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@aitoearn/openclaw-plugin",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -44,13 +44,10 @@
     "@modelcontextprotocol/sdk": "^1.12.0",
     "@sinclair/typebox": "^0.34.0",
     "json5": "^2.2.3",
+    "openclaw": ">=2026.3.24",
     "zod": "^3.24.0"
   },
-  "peerDependencies": {
-    "openclaw": ">=2026.3.24"
-  },
   "devDependencies": {
-    "openclaw": ">=2026.3.24",
     "typescript": "^5.4.0",
     "vitest": "^3.0.0"
   }

package.json

@@ -131,6 +131,30 @@ describe("runSetupCli", () => {
     expect(writeConfig).not.toHaveBeenCalled();
   });
 
+  it("upgrades plugin files without rerunning setup", async () => {
+    installPlugin.mockResolvedValue({
+      replacedExisting: true,
+      targetDir: "/tmp/.openclaw/extensions/aitoearn",
+    });
+
+    const exitCode = await runSetupCli(["upgrade"], {
+      prompts,
+      loadPackageContext,
+      installPlugin,
+      readConfig,
+      writeConfig,
+      runSetupFlow,
+    });
+
+    expect(exitCode).toBe(0);
+    expect(installPlugin).toHaveBeenCalledWith(packageContext);
+    expect(runSetupFlow).not.toHaveBeenCalled();
+    expect(writeConfig).not.toHaveBeenCalled();
+    expect(prompts.outro).toHaveBeenCalledWith(
+      'Upgrade complete! Run "openclaw gateway restart" to apply.'
+    );
+  });
+
   it("surfaces installation errors", async () => {
     installPlugin.mockRejectedValue(new Error("copy failed"));
 

src/cli.test.ts

@@ -39,12 +39,13 @@ interface CliDependencies {
   runSetupFlow: (options?: { showIntro?: boolean }) => Promise<SetupFlowResult>;
 }
 
-const HELP_TEXT = `Usage: npx -y @aitoearn/openclaw-plugin
+const HELP_TEXT = `Usage: npx -y @aitoearn/openclaw-plugin [upgrade]
 
 Bootstrap installer for the AiToEarn OpenClaw plugin.
 
 Examples:
-  npx -y @aitoearn/openclaw-plugin`;
+  npx -y @aitoearn/openclaw-plugin
+  npx -y @aitoearn/openclaw-plugin upgrade`;
 
 export async function runSetupCli(
   args: string[],
@@ -57,12 +58,17 @@ export async function runSetupCli(
 
   if (
     args.length > 1 ||
-    (args.length === 1 && args[0] !== "setup" && args[0] !== "install")
+    (args.length === 1 &&
+      args[0] !== "setup" &&
+      args[0] !== "install" &&
+      args[0] !== "upgrade")
   ) {
     console.error(HELP_TEXT);
     return 1;
   }
 
+  const command = args[0] ?? "install";
+
   deps.prompts.intro("AiToEarn OpenClaw Setup");
 
   let packageContext: PackageContext;
@@ -91,6 +97,13 @@ export async function runSetupCli(
       : "AiToEarn plugin installed."
   );
 
+  if (command === "upgrade") {
+    deps.prompts.outro(
+      'Upgrade complete! Run "openclaw gateway restart" to apply.'
+    );
+    return 0;
+  }
+
   const setupResult = await deps.runSetupFlow({ showIntro: false });
   if (setupResult.status === "cancelled") {
     return 0;

src/cli.ts

@@ -1,4 +1,6 @@
 import { workerData } from "node:worker_threads";
+import { resolveConfiguredSecretInputString } from "openclaw/plugin-sdk/config-runtime";
+import { getMcpClient } from "./mcp-client.js";
 import { runToolDiscoveryHelper } from "./tool-discovery-helper.js";
 
 interface ToolDiscoveryWorkerData {
@@ -28,10 +30,8 @@ async function main(): Promise<void> {
   const data = workerData as ToolDiscoveryWorkerData;
   const result = await runToolDiscoveryHelper(data.payload, {
     env: data.env ?? process.env,
-    getMcpClient: (await import("./mcp-client.js")).getMcpClient,
-    resolveConfiguredSecretInputString: (
-      await import("openclaw/plugin-sdk/config-runtime")
-    ).resolveConfiguredSecretInputString,
+    getMcpClient,
+    resolveConfiguredSecretInputString,
   });
 
   writeResult(result);