openclaw-clawtown-plugin 1.1.33 → 1.1.35

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-clawtown-plugin",
   "name": "OpenClaw Clawtown Plugin",
   "description": "Connects an OpenClaw agent to OpenClaw Forum and reports forum actions",
-  "version": "1.1.33",
+  "version": "1.1.35",
   "main": "./index.ts",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-clawtown-plugin",
-  "version": "1.1.33",
+  "version": "1.1.35",
   "description": "Forum reporter plugin for OpenClaw Forum (Clawtown)",
   "license": "MIT",
   "main": "index.ts",

package/reporter.ts

@@ -11,6 +11,7 @@ import { normalizeForumServerUrl, readLocalReporterConfig, readOpenClawIdentity
 const execFileAsync = promisify(execFile);
 
 const DISABLE_BRIDGE_ENV = "OPENCLAW_FORUM_DISABLE_BRIDGE";
+const PLUGIN_MANAGEMENT_PAIRING_PROBE_ENV = "OPENCLAW_FORUM_PAIRING_PROBE_ON_PLUGIN_COMMAND";
 const BRIDGE_DISABLED = process.env[DISABLE_BRIDGE_ENV] === "1";
 
 const PROFILE_SYNC_MIN_INTERVAL_MS = 5 * 60_000;
@@ -75,6 +76,28 @@ function isCurrentPluginLifecycleSuppressedInvocation(argv = process.argv.slice(
     || action === "disable";
 }
 
+function shouldProbePairingStatusInPluginManagementInvocation(argv = process.argv.slice(2), env = process.env) {
+  if (String(env[PLUGIN_MANAGEMENT_PAIRING_PROBE_ENV] ?? "").trim() !== "1") return false;
+  const tokens = Array.isArray(argv)
+    ? argv.map((token) => String(token ?? "").trim()).filter(Boolean)
+    : [];
+  if (tokens.length < 2) return false;
+  if (tokens[0] !== "plugins") return false;
+  const action = tokens[1];
+  return action === "install" || action === "update";
+}
+
+function shouldProbePairingStatusInCliInvocation(argv = process.argv.slice(2), env = process.env) {
+  if (String(env.OPENCLAW_SERVICE_MARKER ?? "").trim()) return false;
+  const tokens = Array.isArray(argv)
+    ? argv.map((token) => String(token ?? "").trim()).filter(Boolean)
+    : [];
+  if (tokens.length < 2) return false;
+  if (tokens[0] !== "gateway") return false;
+  const action = tokens[1];
+  return action === "restart" || action === "start" || action === "status";
+}
+
 function normalizeServerUrl(raw: string) {
   return normalizeForumServerUrl(raw, "http://127.0.0.1:3679") || "http://127.0.0.1:3679";
 }
@@ -253,11 +276,15 @@ class Reporter {
   private suppressLifecycleForCliCommand = false;
 
   constructor() {
+    const shouldProbePairingStatusInCurrentInvocation = shouldProbePairingStatusInCliInvocation()
+      || shouldProbePairingStatusInPluginManagementInvocation();
     if (isCurrentPluginLifecycleSuppressedInvocation()) {
       this.bridgeDisabled = true;
       this.suppressLifecycleForCliCommand = true;
       console.log("[forum-reporter-v2] lifecycle suppressed during plugin management command");
-      return;
+      if (!shouldProbePairingStatusInCurrentInvocation) {
+        return;
+      }
     }
     const legacyRuntime = handleLegacyRuntimeConflict(this.reporterRuntime);
     if (legacyRuntime.summary) {
@@ -284,7 +311,9 @@ class Reporter {
     }
     if (this.bridgeDisabled) {
       console.log("[forum-reporter-v2] bridge disabled by env flag");
-      return;
+      if (!shouldProbePairingStatusInCurrentInvocation) {
+        return;
+      }
     }
     const homeDecision = resolvePreferredOpenClawHome();
     this.forcedOpenClawHome = homeDecision.home;
@@ -314,6 +343,14 @@ class Reporter {
       console.log("[forum-reporter-v2] 未检测到论坛身份，准备自动为这台机器分配 userId/apiKey");
     }
 
+    if (shouldProbePairingStatusInCurrentInvocation) {
+      this.pairingStatusProbeOnly = true;
+      queueMicrotask(() => {
+        void this.runCliPairingStatusProbe();
+      });
+      return;
+    }
+
     if (this.userId && this.apiKey) {
       this.instanceLockPath = this.resolveInstanceLockPath(this.userId);
       const lockOk = this.acquireInstanceLock();
@@ -364,15 +401,16 @@ class Reporter {
 
   async onHeartbeat(_agentId: string) {
     if (this.suppressLifecycleForCliCommand) return;
+    if (this.pairingStatusProbeOnly) return;
     if (this.bridgeDisabled) return;
     this.start();
     await this.syncProfile();
   }
 
-  private async ensureAutoProvisioned() {
+  private async ensureAutoProvisioned(options?: { probeOnly?: boolean }) {
     if (this.userId && this.apiKey) return true;
     if (this.autoProvisionPromise) return this.autoProvisionPromise;
-    this.autoProvisionPromise = this.autoProvisionIdentity()
+    this.autoProvisionPromise = this.autoProvisionIdentity(options)
       .catch((error) => {
         console.warn(`[forum-reporter-v2] auto provision failed: ${String((error as any)?.message ?? error ?? "unknown")}`);
         return false;
@@ -383,7 +421,7 @@ class Reporter {
     return this.autoProvisionPromise;
   }
 
-  private async autoProvisionIdentity() {
+  private async autoProvisionIdentity(options?: { probeOnly?: boolean }) {
     if (this.userId && this.apiKey) return true;
     const stateDir = resolveStateDirForConfiguredHome(this.forcedOpenClawHome);
     const installationKey = ensureReporterInstallationKey(stateDir);
@@ -411,7 +449,7 @@ class Reporter {
       openclawAgentId: this.openclawAgentId,
       openclawSessionId: this.openclawSessionId,
     });
-    if (!this.instanceLockPath) {
+    if (!options?.probeOnly && !this.instanceLockPath) {
       this.instanceLockPath = this.resolveInstanceLockPath(this.userId);
       this.acquireInstanceLock();
     }
@@ -420,12 +458,32 @@ class Reporter {
     const finalDisplayName = String(payload?.displayName ?? displayName).trim() || displayName;
     this.logPairingStatus({ pairCode, isBound, displayName: finalDisplayName }, { autoProvisioned: true });
     console.log(`[forum-reporter-v2] local reporter config saved: ${persistedPath}`);
-    this.ensureConnectionSelfHeal();
-    this.connectWebSocket();
+    if (!options?.probeOnly) {
+      this.ensureConnectionSelfHeal();
+      this.connectWebSocket();
+    }
     await this.syncProfile(true);
     return true;
   }
 
+  private async runCliPairingStatusProbe() {
+    if (!this.userId || !this.apiKey) {
+      const provisioned = await this.ensureAutoProvisioned({ probeOnly: true });
+      if (!provisioned || !this.userId || !this.apiKey) {
+        if (!this.lastPairingStatusShown) {
+          console.warn("[forum-reporter-v2] pairing status probe did not finish forum identity provisioning");
+        }
+        return;
+      }
+      return;
+    }
+    const result = await this.syncProfile(true);
+    if (!result.ok && !this.lastPairingStatusShown) {
+      const reason = String((result.error as any)?.message ?? result.error ?? "unknown").trim() || "unknown";
+      console.warn(`[forum-reporter-v2] pairing status probe failed: ${reason}`);
+    }
+  }
+
   private async registerForumIdentityWithRetry(payload: Record<string, unknown>) {
     const maxAttempts = 1 + AUTO_PROVISION_RETRY_COUNT;
     let lastError: unknown = null;