fix: gate runtime startup behind gateway_start; migrate to current plugin SDK

Lifecycle:
- Move runtime.start() and shutdown handlers out of register() into
  api.on("gateway_start", ...) and api.on("gateway_stop", ...). register()
  runs in every CLI subprocess that loads plugins (e.g. `openclaw completion`,
  `openclaw doctor`); without this gate the runtime would open a network
  connection / bind a listener every time those one-shot commands ran.
- Drop process.once("SIGTERM"/"SIGINT") in favour of the gateway_stop hook,
  which is the documented way for plugins to react to shutdown.
- Stop relying on the non-standard `api.rootDir` field (not present on the
  current OpenClawPluginApi); compute the per-plugin data directory as
  ~/.openclaw/yonexus-client and ensure it exists before use.

Plugin SDK convention update:
- Wrap default export with definePluginEntry({ id, name, description, register })
  per the current openclaw plugin authoring contract.
- Re-type the register function to accept OpenClawPluginApi instead of the
  hand-crafted { rootDir, pluginConfig, ... } shape.
- Use focused subpath imports openclaw/plugin-sdk/plugin-entry and
  openclaw/plugin-sdk/core.
- Add openclaw as a devDependency (file:/usr/lib/node_modules/openclaw) so
  tsc resolves the SDK type subpaths at build time.
- Modernize openclaw.plugin.json: drop version/entry/permissions, add
  activation.onStartup so gateway_start fires for this plugin at boot.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

package-lock.json

@@ -12,14 +12,10 @@
       },
       "devDependencies": {
         "@types/node": "^25.5.2",
-        "openclaw": "file:/usr/lib/node_modules/openclaw",
         "typescript": "^5.6.3",
         "vitest": "^4.1.3"
       }
     },
-    "../../../../../usr/lib/node_modules/openclaw": {
-      "dev": true
-    },
     "node_modules/@emnapi/core": {
       "version": "1.9.1",
       "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.9.1.tgz",
@@ -918,10 +914,6 @@
       ],
       "license": "MIT"
     },
-    "node_modules/openclaw": {
-      "resolved": "../../../../../usr/lib/node_modules/openclaw",
-      "link": true
-    },
     "node_modules/pathe": {
       "version": "2.0.3",
       "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",

plugin/core/config.ts

@@ -1,12 +1,8 @@
 export interface YonexusClientConfig {
   mainHost: string;
   identifier: string;
-  /**
+  notifyBotToken: string;
-   * Optional. The client never sends pairing notifications (the server
+  adminUserId: string;
-   * does); accepted for back-compat but no longer required.
-   */
-  notifyBotToken?: string;
-  adminUserId?: string;
 }
 
 export class YonexusClientConfigError extends Error {
@@ -48,9 +44,15 @@ export function validateYonexusClientConfig(raw: unknown): YonexusClientConfig {
     issues.push("identifier is required");
   }
 
-  // Optional (back-compat): the client does not send notifications.
   const rawNotifyBotToken = source.notifyBotToken;
+  if (!isNonEmptyString(rawNotifyBotToken)) {
+    issues.push("notifyBotToken is required");
+  }
+
   const rawAdminUserId = source.adminUserId;
+  if (!isNonEmptyString(rawAdminUserId)) {
+    issues.push("adminUserId is required");
+  }
 
   if (issues.length > 0) {
     throw new YonexusClientConfigError(issues);
@@ -58,15 +60,13 @@ export function validateYonexusClientConfig(raw: unknown): YonexusClientConfig {
 
   const mainHost = (rawMainHost as string).trim();
   const identifier = (rawIdentifier as string).trim();
+  const notifyBotToken = (rawNotifyBotToken as string).trim();
+  const adminUserId = (rawAdminUserId as string).trim();
 
   return {
     mainHost,
     identifier,
-    notifyBotToken: isNonEmptyString(rawNotifyBotToken)
+    notifyBotToken,
-      ? rawNotifyBotToken.trim()
+    adminUserId
-      : undefined,
-    adminUserId: isNonEmptyString(rawAdminUserId)
-      ? rawAdminUserId.trim()
-      : undefined
   };
 }

plugin/openclaw.plugin.json

@@ -14,6 +14,6 @@
       "notifyBotToken": { "type": "string" },
       "adminUserId": { "type": "string" }
     },
-    "required": ["mainHost", "identifier"]
+    "required": ["mainHost", "identifier", "notifyBotToken", "adminUserId"]
   }
 }