openclaw-clawtown-plugin 1.1.12 → 1.1.14

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

package/package.json

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

package/reporter.ts

@@ -124,6 +124,20 @@ interface ReporterRuntimeInfo {
   pluginHash: string;
   syncedAt: number;
   pluginDir: string;
+  openClawHome?: string | null;
+  isolationMode?: string;
+  isolationActive?: boolean;
+}
+
+interface AuthHealthCheck {
+  ok: boolean;
+  storePath: string;
+  modelsPath: string;
+  requiredProviders: string[];
+  availableProviders: string[];
+  invalidProfileIds: string[];
+  missingProviders: string[];
+  reason: string;
 }
 
 class Reporter {
@@ -158,8 +172,17 @@ class Reporter {
   private reporterRuntime: ReporterRuntimeInfo = readReporterRuntimeInfo();
   private forcedOpenClawHome = "";
   private openClawIsolationMode = "unknown";
+  private authHealth: AuthHealthCheck | null = null;
 
   constructor() {
+    const legacyRuntime = handleLegacyRuntimeConflict(this.reporterRuntime);
+    if (legacyRuntime.summary) {
+      console.warn(`[forum-reporter-v2] ${legacyRuntime.summary}`);
+    }
+    if (legacyRuntime.disableCurrentRuntime) {
+      this.bridgeDisabled = true;
+      return;
+    }
     const initialLocal = readLocalReporterConfig();
     const forumHomeBootstrap = ensureForumIsolatedHome(this.reporterRuntime, initialLocal);
     if (forumHomeBootstrap.summary) {
@@ -191,6 +214,11 @@ class Reporter {
       isolationMode: this.openClawIsolationMode,
       isolationActive: Boolean(this.forcedOpenClawHome),
     };
+    const authHealth = inspectAuthHealthForStateDir(resolveStateDirForConfiguredHome(this.forcedOpenClawHome));
+    this.authHealth = authHealth;
+    if (!authHealth.ok) {
+      console.error(`[forum-reporter-v2] ${formatAuthHealthFailure(authHealth)}`);
+    }
     if (!this.userId || !this.apiKey) {
       console.warn("[forum-reporter-v2] 未配置 userId/apiKey，插件已禁用");
     }
@@ -667,9 +695,17 @@ class Reporter {
       const pairCode = String(payload?.pairCode ?? "").trim();
       if (/^\d{6}$/.test(pairCode) && pairCode !== this.lastPairCodeShown) {
         this.lastPairCodeShown = pairCode;
-        console.log(`✅ 你的机器人「${payload?.displayName || this.userId}」已接入共答社区 V2`);
-        console.log(`🔑 配对码：${pairCode}`);
-        console.log("请在论坛首页「我的机器人」中输入此配对码进行绑定");
+        const displayName = String(payload?.displayName ?? "").trim() || this.userId;
+        if (this.authHealth?.ok === false) {
+          console.error(`❌ 机器人「${displayName}」已连上共答社区 V2，但本地模型鉴权无效，任务暂时不会执行`);
+          console.error(`🔑 配对码：${pairCode}`);
+          console.error(`[forum-reporter-v2] ${formatAuthHealthFailure(this.authHealth)}`);
+          console.error("请先修复主 OpenClaw 的模型鉴权，再重启本地 OpenClaw 网关");
+        } else {
+          console.log(`✅ 你的机器人「${displayName}」已接入共答社区 V2`);
+          console.log(`🔑 配对码：${pairCode}`);
+          console.log("请在论坛首页「我的机器人」中输入此配对码进行绑定");
+        }
       }
     } catch (error) {
       console.warn("[forum-reporter-v2] profile sync failed", error);
@@ -1575,6 +1611,86 @@ function looksLikeOpenClawHome(homePath: string) {
   }
 }
 
+function handleLegacyRuntimeConflict(runtimeInfo: ReporterRuntimeInfo) {
+  const runtimeDir = path.resolve(String(runtimeInfo?.pluginDir ?? "").trim() || ".");
+  if (path.basename(runtimeDir) !== LEGACY_PLUGIN_ID) {
+    return { disableCurrentRuntime: false, summary: "" };
+  }
+  const canonicalCandidates = [
+    path.join(path.dirname(runtimeDir), PLUGIN_ID),
+    path.join(os.homedir(), DEFAULT_OPENCLAW_HOME_DIRNAME, "extensions", PLUGIN_ID),
+    path.join(os.homedir(), FORUM_ISOLATED_HOME_DIRNAME, DEFAULT_OPENCLAW_HOME_DIRNAME, "extensions", PLUGIN_ID),
+  ];
+  const hasCanonical = canonicalCandidates.some((candidate) => {
+    const resolved = path.resolve(candidate);
+    return resolved !== runtimeDir && hasUsablePluginDir(resolved);
+  });
+  if (!hasCanonical) {
+    return { disableCurrentRuntime: false, summary: "" };
+  }
+
+  const changedParts = new Set<string>();
+  const defaultStateDir = path.join(os.homedir(), DEFAULT_OPENCLAW_HOME_DIRNAME);
+  const forumStateDir = path.join(os.homedir(), FORUM_ISOLATED_HOME_DIRNAME, DEFAULT_OPENCLAW_HOME_DIRNAME);
+  if (stripLegacyPluginState(defaultStateDir, runtimeDir)) changedParts.add("default legacy state cleaned");
+  if (stripLegacyPluginState(forumStateDir, runtimeDir)) changedParts.add("forum legacy state cleaned");
+  if (quarantineLegacyRuntimeDir(runtimeDir)) changedParts.add("legacy dir quarantined");
+
+  const detail = changedParts.size ? ` (${Array.from(changedParts).join(", ")})` : "";
+  return {
+    disableCurrentRuntime: true,
+    summary: `legacy forum-reporter runtime detected at ${runtimeDir}; disabling this instance to avoid mixed execution${detail}`,
+  };
+}
+
+function stripLegacyPluginState(stateDir: string, activeLegacyDir = "") {
+  if (!stateDir || !fs.existsSync(stateDir)) return false;
+  let changed = false;
+  const configInfo = readOpenClawConfigInfo(stateDir);
+  if (configInfo.path && configInfo.config) {
+    const nextConfig = cloneJson(configInfo.config);
+    const plugins = (nextConfig.plugins ??= {});
+    const allow = Array.isArray(plugins.allow) ? plugins.allow : [];
+    const nextAllow = allow.filter((item: any) => String(item) !== LEGACY_PLUGIN_ID);
+    if (nextAllow.length !== allow.length) {
+      plugins.allow = nextAllow;
+      changed = true;
+    }
+    if (plugins.entries && Object.prototype.hasOwnProperty.call(plugins.entries, LEGACY_PLUGIN_ID)) {
+      delete plugins.entries[LEGACY_PLUGIN_ID];
+      changed = true;
+    }
+    if (plugins.installs && Object.prototype.hasOwnProperty.call(plugins.installs, LEGACY_PLUGIN_ID)) {
+      delete plugins.installs[LEGACY_PLUGIN_ID];
+      changed = true;
+    }
+    if (changed) {
+      writeOpenClawConfig(configInfo.path, nextConfig);
+    }
+  }
+  const legacyDir = path.join(stateDir, "extensions", LEGACY_PLUGIN_ID);
+  if (path.resolve(legacyDir) !== path.resolve(activeLegacyDir || "")) {
+    changed = removeDirectoryIfExists(legacyDir) || changed;
+  }
+  return changed;
+}
+
+function quarantineLegacyRuntimeDir(runtimeDir: string) {
+  if (!runtimeDir || !fs.existsSync(runtimeDir)) return false;
+  const parent = path.dirname(runtimeDir);
+  const targetDir = path.join(parent, `${LEGACY_PLUGIN_ID}-disabled`);
+  if (path.resolve(targetDir) === path.resolve(runtimeDir)) return false;
+  try {
+    if (fs.existsSync(targetDir)) {
+      fs.rmSync(targetDir, { recursive: true, force: true });
+    }
+    fs.renameSync(runtimeDir, targetDir);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function ensureForumIsolatedHome(
   runtimeInfo: ReporterRuntimeInfo,
   sourceLocalConfig: ReturnType<typeof readLocalReporterConfig>,
@@ -1664,6 +1780,237 @@ function hashDirectory(dirPath: string) {
   }
 }
 
+function resolveStateDirForConfiguredHome(openclawHome: string) {
+  if (openclawHome) {
+    const resolved = path.resolve(openclawHome);
+    if (path.basename(resolved) === DEFAULT_OPENCLAW_HOME_DIRNAME) return resolved;
+    return path.join(resolved, DEFAULT_OPENCLAW_HOME_DIRNAME);
+  }
+  return path.join(os.homedir(), DEFAULT_OPENCLAW_HOME_DIRNAME);
+}
+
+function inspectAuthHealthForStateDir(stateDir: string): AuthHealthCheck {
+  const configInfo = readOpenClawConfigInfo(stateDir);
+  const requiredProviders = resolveConfiguredProviders(configInfo.config);
+  const storePath = path.join(stateDir, "agents", "main", "agent", "auth-profiles.json");
+  const modelsPath = path.join(stateDir, "agents", "main", "agent", "models.json");
+  const availableProviders = new Set<string>(readInlineCredentialProviders(stateDir, configInfo.config));
+  const invalidProfileIds: string[] = [];
+  if (!fs.existsSync(storePath)) {
+    const missingProviders = requiredProviders.filter((provider) => !availableProviders.has(provider));
+    return {
+      ok: missingProviders.length === 0,
+      storePath,
+      modelsPath,
+      requiredProviders,
+      availableProviders: Array.from(availableProviders),
+      invalidProfileIds,
+      missingProviders,
+      reason: missingProviders.length ? "missing_store" : "ok",
+    };
+  }
+  let parsed: Record<string, any> | null = null;
+  try {
+    parsed = JSON.parse(fs.readFileSync(storePath, "utf-8"));
+  } catch {
+    return {
+      ok: false,
+      storePath,
+      modelsPath,
+      requiredProviders,
+      availableProviders: Array.from(availableProviders),
+      invalidProfileIds,
+      missingProviders: requiredProviders.filter((provider) => !availableProviders.has(provider)),
+      reason: "invalid_json",
+    };
+  }
+  const profiles = parsed?.profiles && typeof parsed.profiles === "object"
+    ? parsed.profiles as Record<string, any>
+    : null;
+  if (!profiles) {
+    return {
+      ok: false,
+      storePath,
+      modelsPath,
+      requiredProviders,
+      availableProviders: Array.from(availableProviders),
+      invalidProfileIds,
+      missingProviders: requiredProviders.filter((provider) => !availableProviders.has(provider)),
+      reason: "invalid_store",
+    };
+  }
+  for (const [profileId, profile] of Object.entries(profiles)) {
+    const normalized = normalizeAuthProfile(profile);
+    if (!normalized.valid || !normalized.provider) {
+      invalidProfileIds.push(profileId);
+      continue;
+    }
+    availableProviders.add(normalized.provider);
+  }
+  const missingProviders = requiredProviders.filter((provider) => !availableProviders.has(provider));
+  return {
+    ok: missingProviders.length === 0,
+    storePath,
+    modelsPath,
+    requiredProviders,
+    availableProviders: Array.from(availableProviders),
+    invalidProfileIds,
+    missingProviders,
+    reason: missingProviders.length ? "missing_provider" : "ok",
+  };
+}
+
+function normalizeAuthProfile(profile: any) {
+  if (!profile || typeof profile !== "object") {
+    return { valid: false, provider: "" };
+  }
+  const type = String(profile.type ?? "").trim().toLowerCase();
+  const provider = String(profile.provider ?? "").trim().toLowerCase();
+  if (!type || !provider) {
+    return { valid: false, provider };
+  }
+  if (type === "api_key") {
+    return {
+      valid: hasNonEmptyString(profile.key) || hasNonEmptyString(profile.keyRef),
+      provider,
+    };
+  }
+  if (type === "token") {
+    return {
+      valid: hasNonEmptyString(profile.token) || hasNonEmptyString(profile.tokenRef),
+      provider,
+    };
+  }
+  if (type === "oauth") {
+    return {
+      valid: hasNonEmptyString(profile.access) || hasNonEmptyString(profile.refresh),
+      provider,
+    };
+  }
+  return { valid: false, provider };
+}
+
+function hasNonEmptyString(value: unknown) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+
+function resolveConfiguredProviders(config: Record<string, any> | null) {
+  const out = new Set<string>();
+  const pushModelRef = (value: unknown) => {
+    const raw = String(value ?? "").trim();
+    if (!raw) return;
+    const provider = raw.includes("/") ? raw.slice(0, raw.indexOf("/")).trim().toLowerCase() : raw.toLowerCase();
+    if (provider) out.add(provider);
+  };
+  const visitModelNode = (value: unknown) => {
+    if (typeof value === "string") {
+      if (value.includes("/")) pushModelRef(value);
+      return;
+    }
+    if (Array.isArray(value)) {
+      for (const item of value) visitModelNode(item);
+      return;
+    }
+    if (!value || typeof value !== "object") return;
+    for (const [key, nested] of Object.entries(value)) {
+      if (key === "providers" || key === "mode") continue;
+      if (typeof nested === "string") {
+        if (key === "primary" || key === "fallback" || key === "model" || nested.includes("/")) {
+          pushModelRef(nested);
+        }
+        continue;
+      }
+      visitModelNode(nested);
+    }
+  };
+  pushModelRef(config?.agent?.model?.primary);
+  pushModelRef(config?.agents?.defaults?.model?.primary);
+  pushModelRef(config?.model?.primary);
+  const modelMaps = [
+    config?.agent?.models,
+    config?.agents?.defaults?.models,
+    config?.models,
+  ];
+  for (const map of modelMaps) {
+    visitModelNode(map);
+  }
+  const providerMaps = [
+    config?.agent?.models?.providers,
+    config?.agents?.defaults?.models?.providers,
+    config?.models?.providers,
+  ];
+  for (const map of providerMaps) {
+    if (!map || typeof map !== "object") continue;
+    for (const key of Object.keys(map)) pushModelRef(key);
+  }
+  return Array.from(out);
+}
+
+function readInlineCredentialProviders(stateDir: string, config: Record<string, any> | null) {
+  const providers = new Set<string>();
+  const mergeProviderMap = (map: Record<string, any> | null | undefined) => {
+    if (!map || typeof map !== "object") return;
+    for (const [providerName, value] of Object.entries(map)) {
+      if (!hasInlineProviderCredential(value)) continue;
+      const normalized = String(providerName ?? "").trim().toLowerCase();
+      if (normalized) providers.add(normalized);
+    }
+  };
+
+  mergeProviderMap(config?.agent?.models?.providers);
+  mergeProviderMap(config?.agents?.defaults?.models?.providers);
+  mergeProviderMap(config?.models?.providers);
+
+  try {
+    const modelsPath = path.join(stateDir, "agents", "main", "agent", "models.json");
+    if (fs.existsSync(modelsPath)) {
+      const parsed = JSON.parse(fs.readFileSync(modelsPath, "utf-8"));
+      mergeProviderMap(parsed?.providers);
+    }
+  } catch {}
+
+  return Array.from(providers);
+}
+
+function hasInlineProviderCredential(value: any) {
+  if (!value || typeof value !== "object") return false;
+  const headers = value.headers && typeof value.headers === "object" ? value.headers : {};
+  return hasNonEmptyString(value.apiKey)
+    || hasNonEmptyString(value.api_key)
+    || hasNonEmptyString(value.key)
+    || hasNonEmptyString(value.token)
+    || hasNonEmptyString(value.accessToken)
+    || hasNonEmptyString(value.access_token)
+    || hasNonEmptyString(value.authToken)
+    || hasNonEmptyString(value.auth_token)
+    || hasNonEmptyString(headers.Authorization)
+    || hasNonEmptyString(headers.authorization)
+    || hasNonEmptyString(headers["x-api-key"])
+    || hasNonEmptyString(headers["X-API-Key"]);
+}
+
+function formatAuthHealthFailure(health: AuthHealthCheck) {
+  const parts: string[] = [`forum auth check failed: ${health.storePath}`];
+  if (health.reason === "missing_store") {
+    parts.push("auth-profiles.json not found");
+  } else if (health.reason === "invalid_json") {
+    parts.push("auth-profiles.json is not valid JSON");
+  } else if (health.reason === "invalid_store") {
+    parts.push("auth-profiles.json missing required profiles object");
+  }
+  if (health.invalidProfileIds.length) {
+    parts.push(`invalid profiles: ${health.invalidProfileIds.slice(0, 5).join(", ")}`);
+  }
+  if (health.modelsPath) {
+    parts.push(`models: ${health.modelsPath}`);
+  }
+  if (health.requiredProviders.length) {
+    const available = health.availableProviders.length ? health.availableProviders.join(", ") : "none";
+    parts.push(`required providers: ${health.requiredProviders.join(", ")}; available: ${available}`);
+  }
+  return parts.join(" | ");
+}
+
 function syncReporterConfigToForum(
   sourceLocalConfig: ReturnType<typeof readLocalReporterConfig>,
   forumStateDir: string,
@@ -1685,7 +2032,10 @@ function syncAgentAuthProfiles(sourceStateDir: string, targetStateDir: string) {
   if (!fs.existsSync(sourceAgentsDir)) return false;
   let changed = false;
   const relFiles = listFilesRecursive(sourceAgentsDir)
-    .filter((rel) => path.basename(rel) === "auth-profiles.json");
+    .filter((rel) => {
+      const base = path.basename(rel);
+      return base === "auth-profiles.json" || base === "models.json" || base === "auth.json";
+    });
   for (const rel of relFiles) {
     const sourcePath = path.join(sourceAgentsDir, rel);
     const targetPath = path.join(targetStateDir, "agents", rel);
@@ -1759,6 +2109,7 @@ function normalizeForumHomeConfig(
   forumConfig: Record<string, any> | null,
 ) {
   const config = cloneJson(inputConfig);
+  delete config.channels;
   const gateway = (config.gateway ??= {});
   const auth = (gateway.auth ??= {});
   const authToken = typeof auth.token === "string" ? auth.token.trim() : "";