@core-workspace/infoflow-openclaw-plugin 2026.3.9 → 2026.3.32

package/src/commands/doctor.ts

@@ -0,0 +1,391 @@
+/**
+ * /infoflow-doctor command
+ *
+ * 自检命令：逐项检查 Infoflow 插件的配置和连通性，
+ * 帮助用户快速定位"为什么群聊/私聊收不到回复"的问题。
+ *
+ * 用法：/infoflow-doctor
+ */
+
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import { listInfoflowAccountIds, resolveInfoflowAccount } from "../channel/accounts.js";
+import { sendInfoflowMessage } from "../channel/outbound.js";
+import { sendInfoflowImageMessage } from "../channel/media.js";
+import { getOrCreateAdapter } from "../utils/token-adapter.js";
+
+// 从 package.json 读取插件版本号
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let PLUGIN_VERSION = "unknown";
+try {
+  const pkg = JSON.parse(readFileSync(resolve(__dirname, "../../package.json"), "utf-8"));
+  PLUGIN_VERSION = pkg.version ?? "unknown";
+} catch { /* ignore */ }
+
+// 48x48 绿色圆形+白色对勾，用于发图片自检（可视化验证）
+const TEST_IMAGE_BASE64 =
+  "iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAIAAADYYG7QAAAA8klEQVR42u3ZSw6DMAwE0DkUN+kle0vaJRIkGtvx2KmKWAblASH+gLPZgZ8FHe9XJeg7PXOmg0hHRIZsipUFmYY0QalhTFBSGBZKNBPTJiCBZmRCoebRhFrN3aQDTaYYgmTvZTJAAWKWqQ5EfsUPoELNdTD0MasG5AgAiSBfOMoCuYOjFMRfCP5h8nfp3v2pJ2RdlRGNBzQaGU9j/KD74CVJlWFRz+dblXNGQfPy2f15wrRrpVaV5mgv0JjTD0HxD99+urxWCeXUeRp/kr+2NFhTl2VoNqlc/82GTftDHTtoTXuMHbuwHfvUTTv5ff915B0fHgSvRnMJWVsAAAAASUVORK5CYII=";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+type CheckResult = {
+  name: string;
+  ok: boolean;
+  detail: string;
+};
+
+// ---------------------------------------------------------------------------
+// Individual checks
+// ---------------------------------------------------------------------------
+
+function checkAccountConfig(cfg: OpenClawConfig): CheckResult[] {
+  const results: CheckResult[] = [];
+  const accountIds = listInfoflowAccountIds(cfg);
+
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      results.push({ name: `${prefix}账号解析`, ok: false, detail: "resolveInfoflowAccount 抛出异常" });
+      continue;
+    }
+
+    const c = account.config;
+
+    results.push({
+      name: `${prefix}appKey`,
+      ok: !!c.appKey,
+      detail: c.appKey ? `已配置 (${c.appKey.slice(0, 8)}...)` : "未配置",
+    });
+    results.push({
+      name: `${prefix}appSecret`,
+      ok: !!c.appSecret,
+      detail: c.appSecret ? "已配置" : "未配置",
+    });
+    results.push({
+      name: `${prefix}apiHost`,
+      ok: !!c.apiHost,
+      detail: c.apiHost ?? "未配置（将使用默认值）",
+    });
+    results.push({
+      name: `${prefix}connectionMode`,
+      ok: true,
+      detail: c.connectionMode ?? "websocket（默认）",
+    });
+    if ((c.connectionMode ?? "websocket") === "websocket") {
+      results.push({
+        name: `${prefix}wsGateway`,
+        ok: true,
+        detail: c.wsGateway ?? "未配置（将使用默认值 infoflow-open-gateway.weiyun.baidu.com）",
+      });
+    } else {
+      results.push({
+        name: `${prefix}checkToken`,
+        ok: !!c.checkToken,
+        detail: c.checkToken ? "已配置" : "未配置（webhook 签名验证将失败）",
+      });
+      results.push({
+        name: `${prefix}encodingAESKey`,
+        ok: !!c.encodingAESKey,
+        detail: c.encodingAESKey ? "已配置" : "未配置（消息解密将失败）",
+      });
+    }
+    results.push({
+      name: `${prefix}dmPolicy`,
+      ok: true,
+      detail: c.dmPolicy ?? "open（默认）",
+    });
+    results.push({
+      name: `${prefix}groupPolicy`,
+      ok: true,
+      detail: c.groupPolicy ?? "open（默认）",
+    });
+    if (c.groupPolicy === "disabled") {
+      results.push({
+        name: `${prefix}群聊提醒`,
+        ok: false,
+        detail: "groupPolicy=disabled，群聊消息不会被处理！如需群聊支持请设置为 open 或 allowlist",
+      });
+    }
+  }
+
+  return results;
+}
+
+async function checkTokenFetch(cfg: OpenClawConfig): Promise<CheckResult[]> {
+  const results: CheckResult[] = [];
+  const accountIds = listInfoflowAccountIds(cfg);
+
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      continue;
+    }
+    if (!account.config.appKey || !account.config.appSecret) {
+      results.push({ name: `${prefix}access_token 获取`, ok: false, detail: "appKey/appSecret 未配置，跳过" });
+      continue;
+    }
+
+    try {
+      const adapter = getOrCreateAdapter({
+        appKey: account.config.appKey,
+        appSecret: account.config.appSecret,
+        apiHost: account.config.apiHost ?? "http://apiin.im.baidu.com",
+      });
+      const token = await adapter.getToken();
+      results.push({
+        name: `${prefix}access_token 获取`,
+        ok: !!token,
+        detail: token ? `成功 (${String(token).slice(0, 12)}...)` : "返回为空",
+      });
+    } catch (err: any) {
+      results.push({
+        name: `${prefix}access_token 获取`,
+        ok: false,
+        detail: `失败: ${err?.message ?? String(err)}`,
+      });
+    }
+  }
+
+  return results;
+}
+
+async function checkSendMessage(cfg: OpenClawConfig, senderId: string): Promise<CheckResult[]> {
+  const results: CheckResult[] = [];
+  if (!senderId) {
+    results.push({ name: "发消息自检", ok: false, detail: "无法确定发送目标（senderId 为空）" });
+    return results;
+  }
+
+  const accountIds = listInfoflowAccountIds(cfg);
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      continue;
+    }
+    if (!account.config.appKey || !account.config.appSecret) continue;
+
+    try {
+      const result = await sendInfoflowMessage({
+        cfg,
+        to: senderId,
+        contents: [{ type: "text", content: "✅ [infoflow-doctor] 发消息自检通过" }],
+        accountId: account.accountId,
+      });
+      results.push({
+        name: `${prefix}发消息到 ${senderId}`,
+        ok: result.ok,
+        detail: result.ok ? `成功 (messageId: ${result.messageId ?? "N/A"})` : `失败: ${result.error ?? "unknown"}`,
+      });
+    } catch (err: any) {
+      results.push({
+        name: `${prefix}发消息到 ${senderId}`,
+        ok: false,
+        detail: `异常: ${err?.message ?? String(err)}`,
+      });
+    }
+  }
+
+  return results;
+}
+
+async function checkSendImage(cfg: OpenClawConfig, to: string): Promise<CheckResult[]> {
+  const results: CheckResult[] = [];
+  const accountIds = listInfoflowAccountIds(cfg);
+
+  for (const accountId of accountIds) {
+    const prefix = accountIds.length > 1 ? `[${accountId}] ` : "";
+    let account: ReturnType<typeof resolveInfoflowAccount>;
+    try {
+      account = resolveInfoflowAccount({ cfg, accountId });
+    } catch {
+      continue;
+    }
+    if (!account.config.appKey || !account.config.appSecret) continue;
+
+    const isGroup = to.includes(":group:");
+    const target = to.replace(/^.*?:group:/, "group:");
+    const label = isGroup ? `群 ${target}` : to;
+
+    try {
+      const result = await sendInfoflowImageMessage({
+        cfg,
+        to: target,
+        base64Image: TEST_IMAGE_BASE64,
+        accountId: account.accountId,
+      });
+      results.push({
+        name: `${prefix}发图片到 ${label}`,
+        ok: result.ok,
+        detail: result.ok
+          ? `成功 (messageId: ${result.messageId ?? "N/A"})`
+          : `失败: ${result.error ?? "unknown"}`,
+      });
+    } catch (err: any) {
+      results.push({
+        name: `${prefix}发图片到 ${label}`,
+        ok: false,
+        detail: `异常: ${err?.message ?? String(err)}`,
+      });
+    }
+  }
+
+  return results;
+}
+
+// ---------------------------------------------------------------------------
+// Format output
+// ---------------------------------------------------------------------------
+
+// 将技术字段名映射为用户友好的中文描述
+const FIELD_LABELS: Record<string, string> = {
+  appKey: "应用 Key",
+  appSecret: "应用密钥",
+  apiHost: "API 地址",
+  connectionMode: "连接方式",
+  wsGateway: "WebSocket 网关地址",
+  checkToken: "Webhook 验签 Token",
+  encodingAESKey: "消息加密密钥",
+  dmPolicy: "私聊权限策略",
+  groupPolicy: "群聊权限策略",
+  "群聊提醒": "群聊权限警告",
+  "账号解析": "账号配置读取",
+  "access_token 获取": "API 登录验证",
+  "发消息自检": "发消息测试",
+};
+
+function friendlyName(name: string): string {
+  // 处理带账号前缀的名字，如 "[main] appKey"
+  const match = name.match(/^(\[.+?\] )(.+)$/);
+  if (match) {
+    const prefix = match[1];
+    const field = match[2];
+    return `${prefix}${FIELD_LABELS[field] ?? field}`;
+  }
+  // 处理 "发消息到 xxx" / "发图片到 xxx"
+  if (name.startsWith("发消息到 ") || name.startsWith("发图片到 ")) return name;
+  return FIELD_LABELS[name] ?? name;
+}
+
+function friendlyDetail(name: string, detail: string): string {
+  // 连接方式特殊处理
+  if (name.endsWith("connectionMode")) {
+    if (detail.includes("websocket")) return "WebSocket 长连接（无需公网域名）";
+    return "Webhook 回调（需配置公网地址）";
+  }
+  // dmPolicy
+  if (name.endsWith("dmPolicy")) {
+    if (detail.includes("open")) return "开放（任何人可私聊）";
+    if (detail.includes("allowlist")) return "白名单（仅允许名单内用户）";
+    if (detail.includes("pairing")) return "配对授权";
+    return detail;
+  }
+  // groupPolicy
+  if (name.endsWith("groupPolicy")) {
+    if (detail.includes("disabled")) return "已关闭群聊（所有群消息不处理）";
+    if (detail.includes("allowlist")) return "白名单（仅允许名单内的群）";
+    if (detail.includes("open")) return "开放（所有群可触发）";
+    return detail;
+  }
+  // wsGateway 默认值
+  if (detail.includes("infoflow-open-gateway.weiyun.baidu.com")) {
+    return detail.includes("未配置") ? "使用默认网关" : detail;
+  }
+  // apiHost 默认值
+  if (detail.includes("将使用默认值")) return "使用默认地址";
+  // groupPolicy=disabled 警告
+  if (detail.includes("groupPolicy=disabled")) {
+    return "群聊功能已关闭，机器人不会响应任何群消息。如需开启，请将 groupPolicy 设置为 open";
+  }
+  return detail;
+}
+
+function formatResults(results: CheckResult[]): string {
+  const lines: string[] = [`**如流机器人自检报告**  v${PLUGIN_VERSION}`, ""];
+
+  const failed = results.filter((r) => !r.ok);
+  const passed = results.filter((r) => r.ok);
+
+  for (const r of results) {
+    const icon = r.ok ? "✅" : "❌";
+    const label = friendlyName(r.name);
+    const detail = friendlyDetail(r.name, r.detail);
+    lines.push(`${icon} **${label}**：${detail}`);
+  }
+
+  lines.push("");
+  lines.push("---");
+
+  if (failed.length === 0) {
+    lines.push(`✅ 自检全部通过（共 ${results.length} 项），机器人运行正常！`);
+  } else {
+    lines.push(`⚠️ 发现 ${failed.length} 个问题，请根据上方提示修复后重试`);
+  }
+
+  lines.push("");
+  lines.push("📋 **排查工具**");
+  lines.push("- `/infoflow-logs` — 查看最近 50 条收发消息日志");
+  lines.push("- `/infoflow-logs 100` — 查看最近 100 条");
+  lines.push("- `/infoflow-changelog` — 查看插件更新记录");
+
+  return lines.join("\n");
+}
+
+// ---------------------------------------------------------------------------
+// Command handler
+// ---------------------------------------------------------------------------
+
+export async function runDoctorCommand(ctx: {
+  config: OpenClawConfig;
+  senderId?: string;
+  /** 消息目标：群聊时为 "group:<groupId>"，私聊时与 senderId 相同 */
+  to?: string;
+}): Promise<{ text: string }> {
+  const { config, senderId, to } = ctx;
+  const results: CheckResult[] = [];
+
+  // 1. 配置检查（同步）
+  results.push(...checkAccountConfig(config));
+
+  // 2. Token 获取（异步）
+  results.push(...(await checkTokenFetch(config)));
+
+  // 网页 UI 触发时 senderId 为系统账号，无法发消息，跳过发送自检
+  const isWebUI = !senderId || senderId === "openclaw-control-ui" || senderId.startsWith("openclaw-");
+  const realSenderId = isWebUI ? undefined : senderId;
+
+  if (isWebUI) {
+    results.push({ name: "发消息自检", ok: true, detail: "网页 UI 触发，跳过发送自检（请从如流客户端触发以完整测试）" });
+  }
+
+  // 3. 发私聊消息自检（发给触发命令的用户）
+  if (realSenderId) {
+    results.push(...(await checkSendMessage(config, realSenderId)));
+  }
+
+  // 4. 发群消息自检（仅群聊中执行命令时）
+  const groupTo = to?.includes(":group:") ? to.replace(/^.*?:group:/, "group:") : undefined;
+  if (groupTo) {
+    results.push(...(await checkSendMessage(config, groupTo)));
+  }
+
+  // 5. 发图片自检（群聊发到群，私聊发给用户）
+  const imageTarget = groupTo ?? realSenderId;
+  if (imageTarget) {
+    results.push(...(await checkSendImage(config, imageTarget)));
+  }
+
+  return { text: formatResults(results) };
+}

package/src/commands/logs.ts

@@ -0,0 +1,212 @@
+/**
+ * /infoflow-logs command
+ *
+ * 读取 OpenClaw 网关的结构化日志文件，筛选 Infoflow 相关条目并格式化输出。
+ * 帮助用户快速了解"收到了哪些消息、回复了什么、有没有报错"。
+ *
+ * 日志文件位置：/tmp/openclaw/openclaw-YYYY-MM-DD.log（jsonl 格式）
+ *
+ * 用法：
+ *   /infoflow-logs          — 展示最近 50 条
+ *   /infoflow-logs 100      — 展示最近 100 条（最大 200）
+ *   /infoflow-logs 0-50     — 最近第 0~50 条
+ *   /infoflow-logs 50-100   — 最近第 50~100 条（往前翻页）
+ *
+ * 长输出由框架的 textChunkLimit（默认 1800 字符/条）自动分片发送，
+ * 可通过 channels.infoflow.textChunkLimit 配置调整每片大小。
+ * 总输出上限由 LOGS_TOTAL_CHAR_LIMIT 控制（默认 20000 字符）。
+ */
+
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+
+const LOG_DIR = "/tmp/openclaw";
+const DEFAULT_LINES = 50;
+const MAX_LINES = 200;
+/** 总输出字符上限，防止输出过多刷屏 */
+const LOGS_TOTAL_CHAR_LIMIT = 20_000;
+
+// ---------------------------------------------------------------------------
+// Infoflow log filter
+// ---------------------------------------------------------------------------
+
+function isInfoflowRelevant(msg: string): boolean {
+  // Exclude SDK internal heartbeat noise
+  if (msg.includes("[dispatch] 分发事件: heartbeat")) return false;
+  if (msg.includes("[dispatch] 分发事件: connected")) return false;
+  if (msg.includes("[dispatch] 分发事件: disconnected")) return false;
+
+  return (
+    msg.includes("[inbound:") ||
+    msg.includes("[outbound") ||
+    msg.includes("[dispatch") ||
+    msg.includes("[ws:") ||
+    msg.includes("[infoflow:") ||
+    msg.includes("[infoflow]") ||
+    (msg.includes("infoflow") && msg.includes("error"))
+  );
+}
+
+function formatLogEntry(raw: string): string | null {
+  const trimmed = raw.trim();
+  if (!trimmed) return null;
+
+  try {
+    const obj = JSON.parse(trimmed) as Record<string, unknown>;
+    // jsonl: { "0": binding-json, "1": message } or { "0": message }
+    let msg = "";
+    const field0 = String(obj["0"] ?? "");
+    const field1 = String(obj["1"] ?? "");
+    if (field1) {
+      msg = field1;
+    } else if (field0 && !field0.startsWith("{")) {
+      msg = field0;
+    }
+    if (!msg || !isInfoflowRelevant(msg)) return null;
+
+    const time = obj["time"] as string | undefined;
+    let timeStr = "";
+    if (time) {
+      try {
+        timeStr = `${new Date(time).toLocaleTimeString("en-US", { hour12: false })} `;
+      } catch { /* ignore */ }
+    }
+
+    const meta = obj["_meta"] as Record<string, unknown> | undefined;
+    const levelName = String(meta?.["logLevelName"] ?? "");
+    const level = Number(obj["level"] ?? (levelName === "ERROR" ? 50 : levelName === "WARN" ? 40 : 30));
+    const levelStr = level >= 50 ? "❌ " : level >= 40 ? "⚠️  " : "";
+
+    return `${timeStr}${levelStr}${msg}`;
+  } catch {
+    return null;
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Log file discovery
+// ---------------------------------------------------------------------------
+
+function getTodayLogPath(): string {
+  const now = new Date();
+  const yyyy = now.getFullYear();
+  const mm = String(now.getMonth() + 1).padStart(2, "0");
+  const dd = String(now.getDate()).padStart(2, "0");
+  return join(LOG_DIR, `openclaw-${yyyy}-${mm}-${dd}.log`);
+}
+
+function getYesterdayLogPath(): string {
+  const yesterday = new Date(Date.now() - 86_400_000);
+  const yyyy = yesterday.getFullYear();
+  const mm = String(yesterday.getMonth() + 1).padStart(2, "0");
+  const dd = String(yesterday.getDate()).padStart(2, "0");
+  return join(LOG_DIR, `openclaw-${yyyy}-${mm}-${dd}.log`);
+}
+
+// ---------------------------------------------------------------------------
+// Command handler
+// ---------------------------------------------------------------------------
+
+export async function runLogsCommand(ctx: {
+  config?: unknown;
+  senderId?: string;
+  args?: string;
+}): Promise<{ text: string }> {
+  // Parse optional argument:
+  //   /infoflow-logs        → 最近 50 条
+  //   /infoflow-logs 100    → 最近 100 条
+  //   /infoflow-logs 50-100 → 第 50~100 条（从末尾倒数）
+  const arg = ctx.args?.trim() ?? "";
+  let startOffset = 0;
+  let limit = DEFAULT_LINES;
+
+  if (arg) {
+    const rangeMatch = arg.match(/^(\d+)-(\d+)$/);
+    if (rangeMatch) {
+      const a = parseInt(rangeMatch[1], 10);
+      const b = parseInt(rangeMatch[2], 10);
+      const lo = Math.min(a, b);
+      const hi = Math.max(a, b);
+      startOffset = lo;
+      limit = Math.min(hi - lo, MAX_LINES);
+    } else {
+      const n = parseInt(arg, 10);
+      limit = Number.isFinite(n) && n > 0 ? Math.min(n, MAX_LINES) : DEFAULT_LINES;
+    }
+  }
+
+  const todayPath = getTodayLogPath();
+  const yesterdayPath = getYesterdayLogPath();
+  const logPath = existsSync(todayPath) ? todayPath
+    : existsSync(yesterdayPath) ? yesterdayPath
+    : null;
+
+  if (!logPath) {
+    return {
+      text: [
+        "**Infoflow 日志**",
+        "",
+        "未找到日志文件。",
+        `期望位置：${todayPath}`,
+        "",
+        "可能的原因：",
+        "- Gateway 尚未启动过",
+        "- 日志路径与预期不符",
+      ].join("\n"),
+    };
+  }
+
+  let lines: string[];
+  try {
+    const content = readFileSync(logPath, "utf-8");
+    lines = content.split("\n");
+  } catch (err: unknown) {
+    return {
+      text: `**Infoflow 日志**\n\n读取日志文件失败：${err instanceof Error ? err.message : String(err)}`,
+    };
+  }
+
+  // Parse and filter
+  const entries: string[] = [];
+  for (const line of lines) {
+    const formatted = formatLogEntry(line);
+    if (formatted) entries.push(formatted);
+  }
+
+  // Slice window (from end)
+  const end = entries.length - startOffset;
+  const start = Math.max(0, end - limit);
+  let recent = entries.slice(start, end > 0 ? end : undefined);
+
+  const rangeDesc = startOffset > 0
+    ? `第 ${startOffset}~${startOffset + recent.length} 条`
+    : `最近 ${recent.length} 条`;
+
+  if (recent.length === 0) {
+    return {
+      text: `**Infoflow 日志** (${rangeDesc}，来自 ${logPath.split("/").pop()})\n\n暂无相关日志。`,
+    };
+  }
+
+  // Apply total char limit: drop oldest entries until within budget
+  let totalChars = recent.reduce((sum, e) => sum + e.length + 1, 0);
+  let dropped = 0;
+  while (recent.length > 0 && totalChars > LOGS_TOTAL_CHAR_LIMIT) {
+    totalChars -= recent[0].length + 1;
+    recent = recent.slice(1);
+    dropped++;
+  }
+
+  const title = `**Infoflow 日志** (${rangeDesc}，来自 ${logPath.split("/").pop()})`;
+  const body = "```\n" + recent.join("\n") + "\n```";
+  const limitNote = dropped > 0
+    ? `\n\n⚠️ 超出 ${LOGS_TOTAL_CHAR_LIMIT} 字符上限，已跳过最早 ${dropped} 条。`
+    : "";
+
+  // Long output is automatically chunked by the framework (textChunkLimit per message).
+  return { text: `${title}\n\n${body}${limitNote}` };
+}