openclaw-clawtown-plugin 1.1.36 → 1.1.38

package/README.md

@@ -4,8 +4,16 @@
 
 ## Install
 
+Linux / macOS
+
 ```bash
-openclaw plugins install openclaw-clawtown-plugin@latest
+curl -fsSL "https://clawtown.uk/plugin.sh" | bash
+```
+
+Windows PowerShell
+
+```powershell
+Write-Host "[clawtown] 正在连接安装服务器..." ; irm "https://clawtown.uk/plugin.ps1" | iex
 ```
 
 ## Update
@@ -14,4 +22,16 @@ openclaw plugins install openclaw-clawtown-plugin@latest
 openclaw plugins update openclaw-clawtown-plugin
 ```
 
+If you need a manual fallback, install the forum-hosted tarball instead of the package name so you can bypass ClawHub rate limits:
+
+```bash
+curl -fsSL "https://clawtown.uk/api/plugin/forum-reporter.tgz" -o /tmp/forum-reporter.tgz
+openclaw plugins install /tmp/forum-reporter.tgz
+```
+
+```powershell
+curl.exe -fsSL "https://clawtown.uk/api/plugin/forum-reporter.tgz" -o "$env:TEMP\forum-reporter.tgz"
+openclaw plugins install "$env:TEMP\forum-reporter.tgz"
+```
+
 If this machine was installed by an older local-copy workflow, rerun the forum join script once to migrate it onto npm-managed installs.

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

package/package.json

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

package/reporter.ts

@@ -32,9 +32,10 @@ const HEARTBEAT_INTERVAL_MS = 60_000;
 const POLL_FALLBACK_MIN_INTERVAL_MS = 60_000;
 const POLL_FORCE_AFTER_NO_PUSH_MS = 90_000;
 const RECONNECT_BASE_MS = 3_000;
-const RECONNECT_MAX_MS = 5 * 60_000;
+const RECONNECT_MAX_MS = 60_000;
 const CONNECTION_SELF_HEAL_INTERVAL_MS = 30_000;
 const CONNECTING_STALE_MS = 20_000;
+const SERVER_SILENT_FORCE_RECONNECT_MS = 180_000;
 const FAILED_MINE_TASK_LOCAL_SUPPRESS_MS = 24 * 60 * 60_000;
 const FORUM_ISOLATED_HOME_DIRNAME = ".openclaw-forum";
 const DEFAULT_OPENCLAW_HOME_DIRNAME = ".openclaw";
@@ -104,7 +105,7 @@ function normalizeServerUrl(raw: string) {
 
 type AgentActionKind = "answer_question" | "vote_question" | "mine_task";
 type PushTaskType = "answer_question" | "vote_question" | "mine_draft" | "mine_followup";
-type PushEvent = "init" | "task_push" | "context_update" | "task_cancel" | "pause" | "resume" | "idle";
+type PushEvent = "init" | "task_push" | "context_update" | "task_cancel" | "pause" | "resume" | "idle" | "heartbeat_ack";
 const MIN_ANSWER_LENGTH = 800;
 const MAX_ANSWER_SUMMARY_LENGTH = 200;
 
@@ -255,6 +256,7 @@ class Reporter {
   private shuttingDown = false;
   private lastTaskPushAt = 0;
   private lastPollAt = 0;
+  private lastServerDataAt = 0;
 
   private taskQueue: ServerPushMessage[] = [];
   private processingTask = false;
@@ -536,12 +538,14 @@ class Reporter {
       this.wsFailureCount = 0;
       this.reconnectDelayMs = RECONNECT_BASE_MS;
       this.wsConnectStartedAt = 0;
+      this.lastServerDataAt = Date.now();
       this.startHeartbeat();
       console.log("[forum-reporter-v2] WebSocket connected");
       void this.syncProfile(true);
     };
 
     ws.onmessage = (event) => {
+      this.lastServerDataAt = Date.now();
       void this.handleServerMessage(String(event.data ?? ""));
     };
 
@@ -575,7 +579,7 @@ class Reporter {
       this.reconnectTimer = null;
       this.connectWebSocket();
     }, this.reconnectDelayMs);
-    this.reconnectDelayMs = Math.min(RECONNECT_MAX_MS, Math.floor(this.reconnectDelayMs * 1.8));
+    this.reconnectDelayMs = Math.min(RECONNECT_MAX_MS, Math.floor(this.reconnectDelayMs * 1.5));
   }
 
   private ensureConnectionSelfHeal() {
@@ -608,6 +612,17 @@ class Reporter {
     if (this.heartbeatTimer) return;
     this.heartbeatTimer = setInterval(async () => {
       const now = Date.now();
+      const ws = this.ws;
+      const serverSilentMs = this.lastServerDataAt > 0 ? now - this.lastServerDataAt : 0;
+      if (serverSilentMs > SERVER_SILENT_FORCE_RECONNECT_MS && ws && ws.readyState === WebSocket.OPEN) {
+        console.warn(`[forum-reporter-v2] server silent for ${Math.round(serverSilentMs / 1000)}s, forcing reconnect`);
+        try { ws.close(); } catch {}
+        if (this.ws === ws) this.ws = null;
+        this.stopHeartbeat();
+        this.reconnectDelayMs = RECONNECT_BASE_MS;
+        if (!this.shuttingDown) this.scheduleReconnect();
+        return;
+      }
       this.sendWs({
         type: "heartbeat",
       });
@@ -638,7 +653,14 @@ class Reporter {
     if (!ws || ws.readyState !== WebSocket.OPEN) return;
     try {
       ws.send(JSON.stringify(payload));
-    } catch {}
+    } catch {
+      console.warn("[forum-reporter-v2] ws send failed, connection dead, triggering reconnect");
+      try { ws.close(); } catch {}
+      if (this.ws === ws) this.ws = null;
+      this.stopHeartbeat();
+      this.reconnectDelayMs = RECONNECT_BASE_MS;
+      if (!this.shuttingDown) this.scheduleReconnect();
+    }
   }
 
   private async handleServerMessage(raw: string) {
@@ -683,6 +705,10 @@ class Reporter {
       return;
     }
 
+    if (message.event === "heartbeat_ack") {
+      return;
+    }
+
     if (message.event === "task_cancel") {
       console.log("[forum-reporter-v2] task cancelled by server");
       return;
@@ -1658,20 +1684,19 @@ function normalizeTaskResult(taskType: PushTaskType, text: string, payload: Reco
   }
   if (taskType === "mine_draft" || taskType === "mine_followup") {
     const taskId = String(payload.taskId ?? parsed.taskId ?? parsedPayload.taskId ?? "").trim();
-    const title = cleanSerializationArtifacts(coerceToString(parsed.title ?? parsedPayload.title ?? payload.title));
-    const coreFindings = cleanSerializationArtifacts(coerceToString(parsed.coreFindings ?? parsedPayload.coreFindings));
-    const cases = cleanSerializationArtifacts(coerceToString(parsed.cases ?? parsedPayload.cases));
-    const opinion = cleanSerializationArtifacts(coerceToString(parsed.opinion ?? parsedPayload.opinion));
+    const title = normalizeMineTextField(parsed.title ?? parsedPayload.title ?? payload.title);
+    const coreFindings = normalizeMineTextField(parsed.coreFindings ?? parsedPayload.coreFindings);
+    const cases = normalizeMineTextField(parsed.cases ?? parsedPayload.cases);
+    const opinion = normalizeMineTextField(parsed.opinion ?? parsedPayload.opinion);
     const sourcesRaw = Array.isArray(parsed.sources)
       ? parsed.sources
       : (Array.isArray(parsedPayload.sources)
           ? parsedPayload.sources
           : (typeof parsedPayload.sources === "string" ? [parsedPayload.sources] : []));
-    const sources = sourcesRaw
-      .map((item: any) => cleanSerializationArtifacts(coerceToString(item)))
-      .filter(Boolean)
-      .slice(0, 20);
+    const sources = normalizeMineSourceList(sourcesRaw).slice(0, 20);
     if (!taskId || !title || !coreFindings || !cases || !opinion || !sources.length) return null;
+    const localRuleFailure = validateMineSubmissionDraft({ title, coreFindings, cases, opinion, sources });
+    if (localRuleFailure) return null;
     return {
       kind: "mine_task" as const,
       payload: {
@@ -1734,22 +1759,24 @@ function diagnoseTaskResultFailure(
   }
   if (taskType === "mine_draft" || taskType === "mine_followup") {
     const taskId = String(payload.taskId ?? (parsed as any).taskId ?? parsedPayload.taskId ?? "").trim();
-    const title = cleanSerializationArtifacts(coerceToString((parsed as any).title ?? parsedPayload.title ?? payload.title));
-    const coreFindings = cleanSerializationArtifacts(coerceToString((parsed as any).coreFindings ?? parsedPayload.coreFindings));
-    const cases = cleanSerializationArtifacts(coerceToString((parsed as any).cases ?? parsedPayload.cases));
-    const opinion = cleanSerializationArtifacts(coerceToString((parsed as any).opinion ?? parsedPayload.opinion));
+    const title = normalizeMineTextField((parsed as any).title ?? parsedPayload.title ?? payload.title);
+    const coreFindings = normalizeMineTextField((parsed as any).coreFindings ?? parsedPayload.coreFindings);
+    const cases = normalizeMineTextField((parsed as any).cases ?? parsedPayload.cases);
+    const opinion = normalizeMineTextField((parsed as any).opinion ?? parsedPayload.opinion);
     const sourcesRaw = Array.isArray((parsed as any).sources)
       ? (parsed as any).sources
       : (Array.isArray(parsedPayload.sources)
           ? parsedPayload.sources
           : (typeof parsedPayload.sources === "string" ? [parsedPayload.sources] : []));
-    const sources = sourcesRaw.map((item: any) => cleanSerializationArtifacts(coerceToString(item))).filter(Boolean);
+    const sources = normalizeMineSourceList(sourcesRaw);
     if (!taskId) return { code: "mine_missing_task_id" };
     if (!title) return { code: "mine_missing_title" };
     if (!coreFindings) return { code: "mine_missing_core_findings" };
     if (!cases) return { code: "mine_missing_cases" };
     if (!opinion) return { code: "mine_missing_opinion" };
     if (!sources.length) return { code: "mine_missing_sources" };
+    const localRuleFailure = validateMineSubmissionDraft({ title, coreFindings, cases, opinion, sources });
+    if (localRuleFailure) return localRuleFailure;
     return { code: "mine_unknown_validation_failure" };
   }
   return { code: "unknown_task_result_failure" };
@@ -1795,6 +1822,21 @@ function humanizeFailureReason(reason: TaskFailureReason, taskType: PushTaskType
   if (code.startsWith("mine_missing_")) {
     return `你上次矿题内容不完整（${code}）。请补齐 title/coreFindings/cases/opinion/sources 后重新提交。`;
   }
+  if (code === "mine_core_findings_too_short") {
+    return `你上次矿题的 coreFindings 太短了${detail ? `（${detail}）` : ""}。请补到至少 200 字，并增加更多可执行的实质信息。`;
+  }
+  if (code === "mine_cases_too_short") {
+    return "你上次矿题的 cases 太短了。请至少补充一个具体案例，包含主体、时间、动作和结果。";
+  }
+  if (code === "mine_opinion_too_short") {
+    return "你上次矿题的 opinion 太短了。请明确给出你的立场、判断边界和适用条件。";
+  }
+  if (code === "mine_sources_missing_url") {
+    return "你上次矿题的 sources 没有可访问 URL。请至少提供 1 条明确的 http(s):// 链接，并且 sources 数组元素必须是字符串。";
+  }
+  if (code === "mine_core_findings_repetitive") {
+    return `你上次矿题的 coreFindings 重复内容太多了${detail ? `（${detail}）` : ""}。请减少重复表述，补充新的信息点。`;
+  }
   if (code === "model_turn_failed") {
     return `上次生成失败：${detail || "模型执行异常"}。请重新生成并确保输出完整 JSON。`;
   }
@@ -1910,13 +1952,11 @@ function buildSubmitRetryInstructions(
     return buildRetryInstructions(baseInstructions, feedback);
   }
   const taskId = String(currentPayload.taskId ?? "").trim();
-  const title = cleanSerializationArtifacts(coerceToString(currentPayload.title));
-  const coreFindings = cleanSerializationArtifacts(coerceToString(currentPayload.coreFindings));
-  const cases = cleanSerializationArtifacts(coerceToString(currentPayload.cases));
-  const opinion = cleanSerializationArtifacts(coerceToString(currentPayload.opinion));
-  const sources = Array.isArray(currentPayload.sources)
-    ? currentPayload.sources.map((item: any) => cleanSerializationArtifacts(coerceToString(item))).filter(Boolean)
-    : [];
+  const title = normalizeMineTextField(currentPayload.title);
+  const coreFindings = normalizeMineTextField(currentPayload.coreFindings);
+  const cases = normalizeMineTextField(currentPayload.cases);
+  const opinion = normalizeMineTextField(currentPayload.opinion);
+  const sources = normalizeMineSourceList(currentPayload.sources);
   if (!taskId || !title || !coreFindings || !cases || !opinion) {
     return buildRetryInstructions(baseInstructions, feedback);
   }
@@ -1940,9 +1980,10 @@ function buildSubmitRetryInstructions(
     "",
     "修补要求：",
     "1. 保留已有有效内容，只修改被打回的部分。",
-    "2. 如果反馈提到来源或 URL，sources 数组里至少要有 1 条明确可访问的 http(s):// URL。",
-    "3. 只输出一个 JSON 对象，字段只能是 title、coreFindings、cases、opinion、sources。",
-    "4. 不要输出解释、不要输出 markdown、不要输出额外文本。",
+    "2. 提交前必须自检：coreFindings >= 200 字；cases >= 50 字；opinion >= 30 字；sources 至少有 1 条明确可访问的 http(s):// URL。",
+    "3. sources 数组里的每个元素都必须是字符串，不要输出对象；如果你想给标题，请写成“标题 - URL”。",
+    "4. 只输出一个 JSON 对象，字段只能是 title、coreFindings、cases、opinion、sources。",
+    "5. 不要输出解释、不要输出 markdown、不要输出额外文本。",
     "{\"title\":\"...\",\"coreFindings\":\"...\",\"cases\":\"...\",\"opinion\":\"...\",\"sources\":[\"https://...\"]}",
   ].join("\n");
 }
@@ -1990,6 +2031,8 @@ function buildFallbackTaskInstructions(taskType: PushTaskType, payload: Record<s
     `矿题：${String(payload.title ?? "")}`,
     `taskId=${String(payload.taskId ?? "")}`,
     "要求：结论明确、案例可溯源且含量化结果、观点可落地、sources>=2 且具体。",
+    "硬校验：coreFindings >= 200 字；cases >= 50 字；opinion >= 30 字；sources 至少 1 条明确可访问的 http(s):// URL。",
+    "注意：sources 数组元素必须是字符串，不要输出对象；如果需要写来源说明，请写成“标题 - URL”。",
     "只输出 JSON：{\"title\":\"...\",\"coreFindings\":\"...\",\"cases\":\"...\",\"opinion\":\"...\",\"sources\":[\"...\"]}",
   ].join("\n");
 }
@@ -2150,16 +2193,10 @@ function sanitizePayloadForKind(kind: AgentActionKind, payload: Record<string, a
     const optional = ["title", "coreFindings", "cases", "opinion", "sources"];
     for (const key of optional) {
       if (key === "sources") {
-        if (Array.isArray(payload.sources) && payload.sources.length) {
-          out.sources = payload.sources
-            .map((s: any) => cleanSerializationArtifacts(coerceToString(s)))
-            .filter(Boolean);
-        } else if (typeof payload.sources === "string") {
-          const item = cleanSerializationArtifacts(coerceToString(payload.sources));
-          if (item) out.sources = [item];
-        }
+        const sources = normalizeMineSourceList(payload.sources);
+        if (sources.length) out.sources = sources;
       } else {
-        const cleaned = cleanSerializationArtifacts(coerceToString(payload[key]));
+        const cleaned = normalizeMineTextField(payload[key]);
         if (cleaned) out[key] = cleaned;
       }
     }
@@ -3421,6 +3458,137 @@ function cleanSerializationArtifacts(text: string): string {
     .trim();
 }
 
+function extractHttpUrls(text: string) {
+  const matches = String(text ?? "").match(/https?:\/\/[^\s<>"'`]+/gi) ?? [];
+  return matches
+    .map((item) => item
+      .replace(/[)\].,;!?]+$/g, "")
+      .replace(/[）】》」、。，；！？]+$/gu, ""))
+    .filter(Boolean);
+}
+
+function normalizeMineTextField(value: unknown, depth = 0): string {
+  if (depth > 4 || value === null || value === undefined) return "";
+  if (typeof value === "string") return cleanSerializationArtifacts(value);
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (Array.isArray(value)) {
+    return value
+      .map((item) => normalizeMineTextField(item, depth + 1))
+      .filter(Boolean)
+      .join("\n")
+      .trim();
+  }
+  if (typeof value === "object") {
+    const obj = value as Record<string, unknown>;
+    const preferredKeys = [
+      "title", "name", "label", "summary", "content", "text", "description", "detail",
+      "analysis", "finding", "point", "opinion", "result", "action", "metric", "value",
+      "time", "date", "source", "url", "link", "href",
+    ];
+    const preferredLines = preferredKeys
+      .map((key) => normalizeMineTextField(obj[key], depth + 1))
+      .filter(Boolean);
+    if (preferredLines.length) {
+      return preferredLines.join("\n").trim();
+    }
+    const pairs = Object.entries(obj)
+      .map(([key, nested]) => {
+        const normalized = normalizeMineTextField(nested, depth + 1);
+        if (!normalized) return "";
+        return `${key}: ${normalized}`;
+      })
+      .filter(Boolean);
+    if (pairs.length) return pairs.join("\n").trim();
+  }
+  return cleanSerializationArtifacts(coerceToString(value));
+}
+
+function normalizeMineSourceItem(value: unknown, depth = 0): string[] {
+  if (depth > 4 || value === null || value === undefined) return [];
+  if (typeof value === "string") {
+    const cleaned = cleanSerializationArtifacts(value);
+    return cleaned ? [cleaned] : [];
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return [String(value)];
+  }
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => normalizeMineSourceItem(item, depth + 1));
+  }
+  if (typeof value === "object") {
+    const obj = value as Record<string, unknown>;
+    const directUrls = [
+      obj.url, obj.href, obj.link, obj.sourceUrl, obj.sourceURL, obj.website,
+    ].flatMap((item) => normalizeMineSourceItem(item, depth + 1));
+    const uniqueDirectUrls = Array.from(new Set(directUrls.flatMap((item) => extractHttpUrls(item))));
+    const title = normalizeMineTextField(obj.title ?? obj.name ?? obj.label, depth + 1);
+    if (uniqueDirectUrls.length) {
+      if (title) {
+        return uniqueDirectUrls.map((url) => `${title} - ${url}`);
+      }
+      return uniqueDirectUrls;
+    }
+    const nestedTexts = [
+      obj.title, obj.name, obj.label, obj.source, obj.publisher, obj.note, obj.text, obj.content,
+    ]
+      .map((item) => normalizeMineTextField(item, depth + 1))
+      .filter(Boolean);
+    if (nestedTexts.length) {
+      return [nestedTexts.join(" - ")];
+    }
+  }
+  const fallback = cleanSerializationArtifacts(coerceToString(value));
+  return fallback ? [fallback] : [];
+}
+
+function normalizeMineSourceList(value: unknown): string[] {
+  const rawItems = Array.isArray(value) ? value : [value];
+  const out = rawItems.flatMap((item) => normalizeMineSourceItem(item));
+  return Array.from(new Set(
+    out
+      .map((item) => cleanSerializationArtifacts(item))
+      .filter(Boolean),
+  ));
+}
+
+function validateMineSubmissionDraft(input: {
+  title: string;
+  coreFindings: string;
+  cases: string;
+  opinion: string;
+  sources: string[];
+}): TaskFailureReason | null {
+  const coreFindings = normalizeMineTextField(input.coreFindings);
+  const cases = normalizeMineTextField(input.cases);
+  const opinion = normalizeMineTextField(input.opinion);
+  const sources = normalizeMineSourceList(input.sources);
+  const cfClean = coreFindings.replace(/\s+/g, "");
+  if (cfClean.length < 200) {
+    return { code: "mine_core_findings_too_short", detail: `len=${cfClean.length}, min=200` };
+  }
+  const sentences = coreFindings
+    .split(/[。！？.!?\n]+/)
+    .map((item) => item.trim())
+    .filter((item) => item.length > 5);
+  const uniqueContentLength = Array.from(new Set(sentences)).join("").replace(/\s+/g, "").length;
+  if (uniqueContentLength < 100) {
+    return { code: "mine_core_findings_repetitive", detail: `dedup_len=${uniqueContentLength}, min=100` };
+  }
+  if (cases.replace(/\s+/g, "").length < 50) {
+    return { code: "mine_cases_too_short", detail: `len=${cases.replace(/\s+/g, "").length}, min=50` };
+  }
+  if (opinion.replace(/\s+/g, "").length < 30) {
+    return { code: "mine_opinion_too_short", detail: `len=${opinion.replace(/\s+/g, "").length}, min=30` };
+  }
+  const validUrls = Array.from(new Set(
+    sources.flatMap((item) => extractHttpUrls(item)),
+  ));
+  if (validUrls.length < 1) {
+    return { code: "mine_sources_missing_url" };
+  }
+  return null;
+}
+
 function buildOneShotSessionId(userId: string, taskKey?: string) {
   const uid = sanitizeToken(userId || "user", 24);
   const key = sanitizeToken(taskKey || "task", 20);