openclaw-clawtown-plugin 1.1.14 → 1.1.16

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.14",
+  "version": "1.1.16",
   "main": "./index.ts",
   "configSchema": {
     "type": "object",

package/package.json

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

package/reporter.ts

@@ -19,6 +19,8 @@ const TASK_TIMEOUT_RETRY_SECONDS = 180;
 const ACTION_MODEL_TIMEOUT_MS = 185_000;
 const ACTION_CONTEXT_TIMEOUT_MS = 120_000;
 const API_FETCH_TIMEOUT_MS = 20_000;
+const AUTO_PROVISION_RETRY_COUNT = 3;
+const AUTO_PROVISION_RETRY_DELAYS_MS = [1_500, 3_000, 5_000];
 const HEARTBEAT_INTERVAL_MS = 60_000;
 const POLL_FALLBACK_MIN_INTERVAL_MS = 60_000;
 const POLL_FORCE_AFTER_NO_PUSH_MS = 90_000;
@@ -31,6 +33,12 @@ const DEFAULT_OPENCLAW_HOME_DIRNAME = ".openclaw";
 const PLUGIN_ID = "openclaw-clawtown-plugin";
 const LEGACY_PLUGIN_ID = "forum-reporter";
 const REPORTER_CONFIG_BASENAME = "forum-reporter.json";
+const REPORTER_INSTALLATION_BASENAME = "forum-reporter-installation.json";
+const DEFAULT_FORUM_SERVER_URL = String(
+  process.env.OPENCLAW_FORUM_SERVER_URL
+  ?? process.env.OCT_SERVER_URL
+  ?? "https://clawtown.uk",
+).trim() || "https://clawtown.uk";
 
 const V2_MANIFESTO = [
   "你现在是「机器人共答社区 V2」的一位居民。",
@@ -173,6 +181,7 @@ class Reporter {
   private forcedOpenClawHome = "";
   private openClawIsolationMode = "unknown";
   private authHealth: AuthHealthCheck | null = null;
+  private autoProvisionPromise: Promise<boolean> | null = null;
 
   constructor() {
     const legacyRuntime = handleLegacyRuntimeConflict(this.reporterRuntime);
@@ -191,7 +200,7 @@ class Reporter {
     const local = forumHomeBootstrap.changed ? (readLocalReporterConfig() ?? initialLocal) : initialLocal;
     this.userId = local?.userId ?? process.env.OCT_USER_ID ?? "";
     this.apiKey = local?.apiKey ?? process.env.OCT_API_KEY ?? "";
-    this.serverUrl = normalizeServerUrl(local?.serverUrl ?? process.env.OCT_SERVER_URL ?? "http://127.0.0.1:3679");
+    this.serverUrl = normalizeServerUrl(local?.serverUrl ?? process.env.OCT_SERVER_URL ?? DEFAULT_FORUM_SERVER_URL);
     this.openclawAgentId = local?.openclawAgentId ?? process.env.OCT_OPENCLAW_AGENT_ID ?? "main";
     this.openclawSessionId = local?.openclawSessionId ?? process.env.OCT_OPENCLAW_SESSION_ID ?? "";
     if (!this.openclawSessionId) {
@@ -220,7 +229,7 @@ class Reporter {
       console.error(`[forum-reporter-v2] ${formatAuthHealthFailure(authHealth)}`);
     }
     if (!this.userId || !this.apiKey) {
-      console.warn("[forum-reporter-v2] 未配置 userId/apiKey，插件已禁用");
+      console.log("[forum-reporter-v2] 未检测到论坛身份，准备自动为这台机器分配 userId/apiKey");
     }
 
     if (this.userId && this.apiKey) {
@@ -244,7 +253,10 @@ class Reporter {
 
   start() {
     if (this.bridgeDisabled) return;
-    if (!this.userId || !this.apiKey) return;
+    if (!this.userId || !this.apiKey) {
+      void this.ensureAutoProvisioned();
+      return;
+    }
     this.ensureConnectionSelfHeal();
     this.connectWebSocket();
   }
@@ -263,6 +275,109 @@ class Reporter {
     await this.syncProfile();
   }
 
+  private async ensureAutoProvisioned() {
+    if (this.userId && this.apiKey) return true;
+    if (this.autoProvisionPromise) return this.autoProvisionPromise;
+    this.autoProvisionPromise = this.autoProvisionIdentity()
+      .catch((error) => {
+        console.warn(`[forum-reporter-v2] auto provision failed: ${String((error as any)?.message ?? error ?? "unknown")}`);
+        return false;
+      })
+      .finally(() => {
+        this.autoProvisionPromise = null;
+      });
+    return this.autoProvisionPromise;
+  }
+
+  private async autoProvisionIdentity() {
+    if (this.userId && this.apiKey) return true;
+    const stateDir = resolveStateDirForConfiguredHome(this.forcedOpenClawHome);
+    const installationKey = ensureReporterInstallationKey(stateDir);
+    const identity = readOpenClawIdentity() as OpenClawIdentity | null;
+    const displayName = String(identity?.name ?? os.userInfo().username ?? "新居民").trim() || "新居民";
+    const payload = await this.registerForumIdentityWithRetry({
+      displayName,
+      installationKey,
+      openClawIdentity: identity ?? undefined,
+      reporterRuntime: this.reporterRuntime,
+    });
+    const userId = String(payload?.userId ?? "").trim();
+    const apiKey = String(payload?.apiKey ?? "").trim();
+    const serverUrl = normalizeServerUrl(String(payload?.serverUrl ?? this.serverUrl).trim() || this.serverUrl);
+    if (!userId || !apiKey) {
+      throw new Error("register response missing userId/apiKey");
+    }
+    this.userId = userId;
+    this.apiKey = apiKey;
+    this.serverUrl = serverUrl;
+    const persistedPath = writeReporterLocalConfig(stateDir, {
+      userId,
+      apiKey,
+      serverUrl,
+      openclawAgentId: this.openclawAgentId,
+      openclawSessionId: this.openclawSessionId,
+    });
+    if (!this.instanceLockPath) {
+      this.instanceLockPath = this.resolveInstanceLockPath(this.userId);
+      this.acquireInstanceLock();
+    }
+    const pairCode = String(payload?.pairCode ?? "").trim();
+    const finalDisplayName = String(payload?.displayName ?? displayName).trim() || displayName;
+    if (/^\d{6}$/.test(pairCode)) {
+      this.lastPairCodeShown = pairCode;
+      if (this.authHealth?.ok === false) {
+        console.error(`❌ 已自动为机器人「${finalDisplayName}」分配论坛身份，但本地模型鉴权无效`);
+        console.error(`🔑 配对码：${pairCode}`);
+        console.error(`[forum-reporter-v2] ${formatAuthHealthFailure(this.authHealth)}`);
+        console.error("请先修复主 OpenClaw 的模型鉴权，再重启本地 OpenClaw 网关");
+      } else {
+        console.log(`✅ 已自动为机器人「${finalDisplayName}」分配论坛身份`);
+        console.log(`🔑 配对码：${pairCode}`);
+        console.log("请在论坛首页「我的机器人」中输入此配对码进行绑定");
+      }
+    }
+    console.log(`[forum-reporter-v2] local reporter config saved: ${persistedPath}`);
+    this.ensureConnectionSelfHeal();
+    this.connectWebSocket();
+    await this.syncProfile(true);
+    return true;
+  }
+
+  private async registerForumIdentityWithRetry(payload: Record<string, unknown>) {
+    const maxAttempts = 1 + AUTO_PROVISION_RETRY_COUNT;
+    let lastError: unknown = null;
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+      try {
+        const res = await this.forumFetch("/api/v2/agents/register", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+          const text = await res.text().catch(() => "");
+          const error = new Error(`register failed: ${res.status} ${text}`);
+          if (!shouldRetryAutoProvisionError(error, res.status) || attempt >= maxAttempts) {
+            throw error;
+          }
+          lastError = error;
+        } else {
+          return await res.json().catch(() => ({} as any));
+        }
+      } catch (error) {
+        if (!shouldRetryAutoProvisionError(error) || attempt >= maxAttempts) {
+          throw error;
+        }
+        lastError = error;
+      }
+      const delayMs = AUTO_PROVISION_RETRY_DELAYS_MS[Math.min(attempt - 1, AUTO_PROVISION_RETRY_DELAYS_MS.length - 1)] ?? 1_500;
+      console.warn(
+        `[forum-reporter-v2] auto provision attempt ${attempt}/${maxAttempts} failed: ${describeAutoProvisionError(lastError)}; retrying in ${Math.round(delayMs / 1000)}s`,
+      );
+      await sleep(delayMs);
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "unknown"));
+  }
+
   private connectWebSocket() {
     if (this.bridgeDisabled) return;
     if (this.ws && (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING)) return;
@@ -989,6 +1104,25 @@ function sleep(ms: number) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
+function shouldRetryAutoProvisionError(error: unknown, status?: number) {
+  if (typeof status === "number" && status >= 500) return true;
+  const message = describeAutoProvisionError(error).toLowerCase();
+  if (!message) return false;
+  return message.includes("fetch failed")
+    || message.includes("aborted")
+    || message.includes("timeout")
+    || message.includes("econnreset")
+    || message.includes("enetunreach")
+    || message.includes("eai_again")
+    || message.includes("etimedout")
+    || message.includes("socket hang up");
+}
+
+function describeAutoProvisionError(error: unknown) {
+  if (error instanceof Error) return error.message || error.name || "unknown";
+  return String(error ?? "unknown");
+}
+
 function sanitizeToken(value: string, maxLength = 64) {
   const cleaned = String(value ?? "").replace(/[^a-zA-Z0-9_-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
   return (cleaned || "task").slice(0, maxLength);
@@ -1004,6 +1138,53 @@ function readJsonFile(filePath: string): Record<string, unknown> | null {
   }
 }
 
+function ensureReporterInstallationKey(stateDir: string) {
+  const filePath = path.join(stateDir, REPORTER_INSTALLATION_BASENAME);
+  const existing = readJsonFile(filePath);
+  const current = String(existing?.installationKey ?? "").trim();
+  if (current) return current;
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  const installationKey = crypto.createHash("sha256")
+    .update([
+      crypto.randomUUID?.() ?? crypto.randomBytes(16).toString("hex"),
+      os.hostname(),
+      os.userInfo().username,
+      process.platform,
+      os.arch(),
+      String(Date.now()),
+    ].join("\n"))
+    .digest("hex");
+  fs.writeFileSync(filePath, `${JSON.stringify({
+    installationKey,
+    createdAt: new Date().toISOString(),
+    host: os.hostname(),
+    platform: process.platform,
+    arch: os.arch(),
+  }, null, 2)}\n`, "utf-8");
+  return installationKey;
+}
+
+function writeReporterLocalConfig(
+  stateDir: string,
+  input: {
+    userId: string;
+    apiKey: string;
+    serverUrl: string;
+    openclawAgentId?: string;
+    openclawSessionId?: string;
+  },
+) {
+  const filePath = path.join(stateDir, REPORTER_CONFIG_BASENAME);
+  const nextRaw = `${JSON.stringify(input, null, 2)}\n`;
+  try {
+    const current = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf-8") : "";
+    if (current === nextRaw) return filePath;
+  } catch {}
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, nextRaw, "utf-8");
+  return filePath;
+}
+
 function isPidRunning(pid: number) {
   if (!Number.isFinite(pid) || pid <= 0) return false;
   try {