@core-workspace/infoflow-openclaw-plugin 2026.3.8 → 2026.3.27-beta.0

package/src/channel/channel.ts

@@ -6,23 +6,38 @@ import {
   migrateBaseNameToDefaultAccount,
   normalizeAccountId,
   setAccountEnabledInConfigSection,
-  type ChannelPlugin,
-  type OpenClawConfig,
-} from "openclaw/plugin-sdk";
+} from "../compat/openclaw-sdk.js";
+import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry";
 import {
+  normalizeInfoflowTarget,
+  looksLikeInfoflowId,
+} from "../adapter/outbound/target-resolver.js";
+import { logVerbose } from "../logging.js";
+import { getInfoflowRuntime } from "../runtime.js";
+import { infoflowMessageActions } from "../tools/actions/index.js";
+import type { ResolvedInfoflowAccount } from "../types.js";
+import {
+  DEFAULT_INFOFLOW_API_HOST,
+  DEFAULT_INFOFLOW_CONNECTION_MODE,
+  DEFAULT_INFOFLOW_CRON_RELAY_POLL_INTERVAL_MS,
+  DEFAULT_INFOFLOW_CRON_RELAY_PREFIX,
+  DEFAULT_INFOFLOW_DM_MESSAGE_FORMAT,
+  DEFAULT_INFOFLOW_FOLLOW_UP_WINDOW,
+  DEFAULT_INFOFLOW_GROUP_MESSAGE_FORMAT,
+  DEFAULT_INFOFLOW_GROUP_SESSION_MODE,
+  DEFAULT_INFOFLOW_PRIVATE_DATA_DIR,
+  DEFAULT_INFOFLOW_PROCESSING_HINT_DELAY,
+  DEFAULT_INFOFLOW_TEXT_CHUNK_LIMIT,
+  DEFAULT_INFOFLOW_WS_GATEWAY,
   getChannelSection,
   listInfoflowAccountIds,
   resolveDefaultInfoflowAccountId,
   resolveInfoflowAccount,
 } from "./accounts.js";
-import { infoflowMessageActions } from "../tools/actions/index.js";
-import { logVerbose } from "../logging.js";
 import { prepareInfoflowImageBase64, sendInfoflowImageMessage } from "./media.js";
 import { startInfoflowMonitor, startInfoflowWSMonitor } from "./monitor.js";
-import { getInfoflowRuntime } from "../runtime.js";
 import { sendInfoflowMessage } from "./outbound.js";
-import { normalizeInfoflowTarget, looksLikeInfoflowId } from "../adapter/outbound/target-resolver.js";
-import type { ResolvedInfoflowAccount } from "../types.js";
 
 // Re-export types and account functions for external consumers
 export type { InfoflowAccountConfig, ResolvedInfoflowAccount } from "../types.js";
@@ -32,6 +47,434 @@ export { resolveInfoflowAccount } from "./accounts.js";
 // Channel plugin
 // ---------------------------------------------------------------------------
 
+const INFOFLOW_REPLY_MODE_ENUM = [
+  "ignore",
+  "record",
+  "mention-only",
+  "mention-and-watch",
+  "proactive",
+] as const;
+
+const infoflowGroupConfigSchemaProperties = {
+  replyMode: {
+    type: "string",
+    enum: [...INFOFLOW_REPLY_MODE_ENUM],
+    description: "群级回复模式覆盖",
+  },
+  groupSessionMode: {
+    type: "string",
+    enum: ["group", "user"],
+    default: DEFAULT_INFOFLOW_GROUP_SESSION_MODE,
+    description: "群聊会话拆分模式：group=按群，user=按群+人",
+  },
+  watchMentions: {
+    type: "array",
+    items: { type: "string" },
+    description: "当这些人被 @ 时触发观察模式",
+  },
+  watchRegex: {
+    oneOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
+    description: "群消息匹配任一正则时触发观察模式（兼容单个字符串或数组）",
+  },
+  followUp: {
+    type: "boolean",
+    default: true,
+    description: "机器人回复后是否允许一段时间内连续追问",
+  },
+  followUpWindow: {
+    type: "integer",
+    minimum: 0,
+    default: DEFAULT_INFOFLOW_FOLLOW_UP_WINDOW,
+    description: "追问窗口时长（秒）",
+  },
+  systemPrompt: {
+    type: "string",
+    description: "该群专属的附加系统提示词",
+  },
+} as const;
+
+const infoflowCronRelaySchema = {
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    enabled: {
+      type: "boolean",
+      default: true,
+      description: "是否把 OpenClaw cron 运行结果转发到如流",
+    },
+    includeAlreadyDelivered: {
+      type: "boolean",
+      default: false,
+      description: "是否也转发已由 OpenClaw delivery 投递过的任务",
+    },
+    prefix: {
+      type: "string",
+      default: DEFAULT_INFOFLOW_CRON_RELAY_PREFIX,
+      description: "定时任务转发前缀",
+    },
+    pollIntervalMs: {
+      type: "integer",
+      minimum: 500,
+      default: DEFAULT_INFOFLOW_CRON_RELAY_POLL_INTERVAL_MS,
+      description: "cron 运行日志轮询间隔（毫秒）",
+    },
+  },
+} as const;
+
+const infoflowAccountConfigSchemaProperties = {
+  enabled: {
+    type: "boolean",
+    default: true,
+    description: "是否启用当前 Infoflow 账号",
+  },
+  name: {
+    type: "string",
+    description: "账号展示名称，仅用于控制面板区分账号",
+  },
+  apiHost: {
+    type: "string",
+    default: DEFAULT_INFOFLOW_API_HOST,
+    description: "如流发送 API 域名",
+  },
+  connectionMode: {
+    type: "string",
+    enum: ["webhook", "websocket"],
+    default: DEFAULT_INFOFLOW_CONNECTION_MODE,
+    description: "消息接收模式，默认 websocket",
+  },
+  wsGateway: {
+    type: "string",
+    default: DEFAULT_INFOFLOW_WS_GATEWAY,
+    description: "WebSocket 网关域名，仅 websocket 模式使用",
+  },
+  checkToken: {
+    type: "string",
+    description: "Webhook 校验 token，仅 webhook 模式必填",
+  },
+  encodingAESKey: {
+    type: "string",
+    description: "Webhook 加密密钥，仅 webhook 模式必填",
+  },
+  appKey: {
+    type: "string",
+    description: "如流应用 AppKey",
+  },
+  appSecret: {
+    type: "string",
+    description: "如流应用 AppSecret",
+  },
+  robotName: {
+    type: "string",
+    description: "群聊中用于识别 @机器人的显示名",
+  },
+  appAgentId: {
+    type: "integer",
+    minimum: 1,
+    description: "如流应用 ID，私聊撤回依赖该字段",
+  },
+  dmPolicy: {
+    type: "string",
+    enum: ["open", "pairing", "allowlist"],
+    default: "open",
+    description: "单聊访问策略",
+  },
+  allowFrom: {
+    type: "array",
+    items: { type: "string" },
+    description: "单聊白名单，dmPolicy=allowlist 时生效",
+  },
+  groupPolicy: {
+    type: "string",
+    enum: ["open", "allowlist", "disabled"],
+    default: "open",
+    description: "群聊访问策略",
+  },
+  groupAllowFrom: {
+    type: "array",
+    items: { type: "string" },
+    description: "群聊白名单，groupPolicy=allowlist 时生效",
+  },
+  requireMention: {
+    type: "boolean",
+    default: true,
+    description: "未显式设置 replyMode 时，是否要求先 @机器人",
+  },
+  replyMode: {
+    type: "string",
+    enum: [...INFOFLOW_REPLY_MODE_ENUM],
+    description: "群聊回复模式；不填时按 requireMention/watch 配置推导",
+  },
+  groupSessionMode: {
+    type: "string",
+    enum: ["group", "user"],
+    default: DEFAULT_INFOFLOW_GROUP_SESSION_MODE,
+    description: "群聊会话拆分模式：group=按群，user=按群+人",
+  },
+  watchMentions: {
+    type: "array",
+    items: { type: "string" },
+    description: "当这些人被 @ 时触发观察模式",
+  },
+  watchRegex: {
+    oneOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
+    description: "群消息匹配任一正则时触发观察模式（兼容单个字符串或数组）",
+  },
+  followUp: {
+    type: "boolean",
+    default: true,
+    description: "机器人回复后是否允许一段时间内连续追问",
+  },
+  followUpWindow: {
+    type: "integer",
+    minimum: 0,
+    default: DEFAULT_INFOFLOW_FOLLOW_UP_WINDOW,
+    description: "追问窗口时长（秒）",
+  },
+  dmMessageFormat: {
+    type: "string",
+    enum: ["text", "markdown", "streaming-card"],
+    default: DEFAULT_INFOFLOW_DM_MESSAGE_FORMAT,
+    description: "单聊回复格式",
+  },
+  groupMessageFormat: {
+    type: "string",
+    enum: ["text", "markdown", "streaming-card"],
+    default: DEFAULT_INFOFLOW_GROUP_MESSAGE_FORMAT,
+    description: "群聊回复格式；markdown 和 streaming-card 不支持引用回复",
+  },
+  processingHint: {
+    type: "boolean",
+    default: true,
+    description: "处理较慢时先发送一条“收到啦”提示",
+  },
+  processingHintDelay: {
+    type: "integer",
+    minimum: 0,
+    default: DEFAULT_INFOFLOW_PROCESSING_HINT_DELAY,
+    description: "发送处理中提示前的等待秒数",
+  },
+  textChunkLimit: {
+    type: "integer",
+    minimum: 1,
+    default: DEFAULT_INFOFLOW_TEXT_CHUNK_LIMIT,
+    description: "长消息拆分的单段字符上限",
+  },
+  defaultTo: {
+    type: "string",
+    description: "主动发送或兼容场景的默认目标，例如 alice 或 group:12345",
+  },
+  privateDataDir: {
+    type: "string",
+    default: DEFAULT_INFOFLOW_PRIVATE_DATA_DIR,
+    description: "插件私有数据目录，相对 OpenClaw stateDir",
+  },
+  cronRelay: infoflowCronRelaySchema,
+} as const;
+
+const infoflowChannelConfigSchema = {
+  schema: {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      ...infoflowAccountConfigSchemaProperties,
+      defaultAccount: {
+        type: "string",
+        description: "多账号模式下的默认账号 ID",
+      },
+      groups: {
+        type: "object",
+        additionalProperties: {
+          type: "object",
+          additionalProperties: false,
+          properties: infoflowGroupConfigSchemaProperties,
+        },
+      },
+      accounts: {
+        type: "object",
+        additionalProperties: {
+          type: "object",
+          additionalProperties: false,
+          properties: infoflowAccountConfigSchemaProperties,
+        },
+      },
+    },
+  },
+  uiHints: {
+    appKey: {
+      label: "AppKey",
+      help: "如流应用的 AppKey。",
+    },
+    appSecret: {
+      label: "AppSecret",
+      help: "如流应用的 AppSecret。",
+      sensitive: true,
+    },
+    connectionMode: {
+      label: "接收模式",
+      help: "默认 websocket，本地开发无需公网域名。",
+    },
+    wsGateway: {
+      label: "WS 网关",
+      help: "仅 websocket 模式使用。",
+      advanced: true,
+    },
+    apiHost: {
+      label: "API 域名",
+      help: "发送消息使用的 REST API 域名。",
+      advanced: true,
+    },
+    checkToken: {
+      label: "Webhook Token",
+      help: "仅 webhook 模式需要。",
+      sensitive: true,
+      advanced: true,
+    },
+    encodingAESKey: {
+      label: "Webhook AES Key",
+      help: "仅 webhook 模式需要。",
+      sensitive: true,
+      advanced: true,
+    },
+    enabled: {
+      label: "启用通道",
+      help: "关闭后停止该账号的收发。",
+    },
+    name: {
+      label: "账号名称",
+      help: "仅用于控制台展示。",
+    },
+    robotName: {
+      label: "机器人名称",
+      help: "用于识别群里是否 @到了机器人。",
+    },
+    appAgentId: {
+      label: "应用 ID",
+      help: "私聊撤回消息需要该值。",
+    },
+    dmPolicy: {
+      label: "单聊策略",
+    },
+    allowFrom: {
+      label: "单聊白名单",
+      placeholder: "alice",
+    },
+    groupPolicy: {
+      label: "群聊策略",
+    },
+    groupAllowFrom: {
+      label: "群聊白名单",
+      placeholder: "12345678",
+    },
+    requireMention: {
+      label: "要求先 @机器人",
+      help: "只在未显式设置 replyMode 时作为推导条件。",
+    },
+    replyMode: {
+      label: "回复模式",
+      help: "不填则沿用现有兼容推导逻辑。",
+    },
+    groupSessionMode: {
+      label: "群聊会话模式",
+      help: "group=整个群共用 session，user=群内每人独立 session。",
+    },
+    watchMentions: {
+      label: "观察 @名单",
+      placeholder: "alice",
+    },
+    watchRegex: {
+      label: "观察正则",
+      placeholder: "incident|alert, error.*timeout",
+    },
+    followUp: {
+      label: "允许追问窗口",
+    },
+    followUpWindow: {
+      label: "追问窗口秒数",
+    },
+    dmMessageFormat: {
+      label: "单聊消息格式",
+      help: "支持普通文本、Markdown，或如流流式卡片。",
+    },
+    groupMessageFormat: {
+      label: "群聊消息格式",
+      help: "支持普通文本、Markdown，或如流流式卡片；markdown 和 streaming-card 不带引用回复。",
+    },
+    processingHint: {
+      label: "处理中提示",
+    },
+    processingHintDelay: {
+      label: "提示延迟秒数",
+    },
+    textChunkLimit: {
+      label: "拆分长度上限",
+      advanced: true,
+    },
+    defaultTo: {
+      label: "默认目标",
+      help: "仅主动发送和兼容场景使用；infoflow_cron 不依赖该值。",
+      advanced: true,
+      placeholder: "alice 或 group:12345",
+    },
+    privateDataDir: {
+      label: "私有数据目录",
+      help: "cron 可观测文件会写到该目录下，例如 cron-relay-status.md 和 cron-relay-state.json。",
+      advanced: true,
+    },
+    "cronRelay.enabled": {
+      label: "启用定时转发",
+      help: "开启后会把状态摘要写入私有数据目录，便于直接查看执行结果。",
+      advanced: true,
+    },
+    "cronRelay.includeAlreadyDelivered": {
+      label: "包含已投递任务",
+      advanced: true,
+    },
+    "cronRelay.prefix": {
+      label: "定时前缀",
+      advanced: true,
+    },
+    "cronRelay.pollIntervalMs": {
+      label: "定时轮询间隔",
+      help: "影响 relay 扫描 cron runs 和刷新状态摘要文件的频率。",
+      advanced: true,
+    },
+    defaultAccount: {
+      label: "默认账号",
+      advanced: true,
+    },
+    groups: {
+      label: "群级覆盖",
+      help: "按 groupId 配置群级策略覆盖。",
+      advanced: true,
+      itemTemplate: {
+        replyMode: "mention-only",
+        groupSessionMode: DEFAULT_INFOFLOW_GROUP_SESSION_MODE,
+        followUp: true,
+        followUpWindow: DEFAULT_INFOFLOW_FOLLOW_UP_WINDOW,
+      },
+    },
+    accounts: {
+      label: "多账号配置",
+      help: "按账号 ID 配置额外机器人。",
+      advanced: true,
+      itemTemplate: {
+        enabled: true,
+        connectionMode: DEFAULT_INFOFLOW_CONNECTION_MODE,
+        apiHost: DEFAULT_INFOFLOW_API_HOST,
+        wsGateway: DEFAULT_INFOFLOW_WS_GATEWAY,
+        groupSessionMode: DEFAULT_INFOFLOW_GROUP_SESSION_MODE,
+        followUp: true,
+        followUpWindow: DEFAULT_INFOFLOW_FOLLOW_UP_WINDOW,
+        processingHint: true,
+        processingHintDelay: DEFAULT_INFOFLOW_PROCESSING_HINT_DELAY,
+        dmMessageFormat: DEFAULT_INFOFLOW_DM_MESSAGE_FORMAT,
+        groupMessageFormat: DEFAULT_INFOFLOW_GROUP_MESSAGE_FORMAT,
+        textChunkLimit: DEFAULT_INFOFLOW_TEXT_CHUNK_LIMIT,
+      },
+    },
+  },
+} as const;
+
 export const infoflowPlugin: ChannelPlugin<ResolvedInfoflowAccount> = {
   id: "infoflow",
   meta: {
@@ -48,6 +491,7 @@ export const infoflowPlugin: ChannelPlugin<ResolvedInfoflowAccount> = {
     unsend: true,
   },
   reload: { configPrefixes: ["channels.infoflow"] },
+  configSchema: infoflowChannelConfigSchema,
   actions: infoflowMessageActions,
   agentPrompt: {
     messageToolHints: () => [
@@ -205,10 +649,10 @@ export const infoflowPlugin: ChannelPlugin<ResolvedInfoflowAccount> = {
     },
   },
   outbound: {
-    deliveryMode: "direct",
+    deliveryMode: "gateway",
     chunkerMode: "markdown",
-    textChunkLimit: 4000,
-    chunker: (text, limit) => getInfoflowRuntime().channel.text.chunkText(text, limit),
+    textChunkLimit: DEFAULT_INFOFLOW_TEXT_CHUNK_LIMIT,
+    chunker: (text, limit) => getInfoflowRuntime().channel.text.chunkMarkdownText(text, limit),
     sendText: async ({ cfg, to, text, accountId }) => {
       logVerbose(`[infoflow:sendText] to=${to}, accountId=${accountId}`);
       // Use "markdown" type even though param is named `text`: LLM outputs are often markdown,
@@ -322,7 +766,7 @@ export const infoflowPlugin: ChannelPlugin<ResolvedInfoflowAccount> = {
   gateway: {
     startAccount: async (ctx) => {
       const account = ctx.account;
-      const connectionMode = account.config.connectionMode ?? "webhook";
+      const connectionMode = account.config.connectionMode ?? "websocket";
       ctx.log?.info(`[${account.accountId}] starting Infoflow ${connectionMode}`);
       ctx.setStatus({
         accountId: account.accountId,

package/src/channel/media.ts

@@ -2,11 +2,13 @@
  * Infoflow native image sending: compress, base64-encode, and POST via Infoflow API.
  */
 
-import type { OpenClawConfig } from "openclaw/plugin-sdk";
-import { resolveInfoflowAccount } from "./accounts.js";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry";
 import { recordSentMessageId } from "../adapter/inbound/webhook-parser.js";
+import { coreEvents } from "../events.js";
 import { getInfoflowSendLog, formatInfoflowError, logVerbose } from "../logging.js";
 import { getInfoflowRuntime } from "../runtime.js";
+import type { ResolvedInfoflowAccount, InfoflowOutboundReply } from "../types.js";
+import { resolveInfoflowAccount } from "./accounts.js";
 import {
   getAppAccessToken,
   ensureHttps,
@@ -15,8 +17,6 @@ import {
   INFOFLOW_PRIVATE_SEND_PATH,
   INFOFLOW_GROUP_SEND_PATH,
 } from "./outbound.js";
-import { coreEvents } from "../events.js";
-import type { ResolvedInfoflowAccount, InfoflowOutboundReply } from "../types.js";
 
 /** Infoflow API image size limit: 1MB raw bytes */
 const INFOFLOW_IMAGE_MAX_BYTES = 1 * 1024 * 1024;
@@ -227,7 +227,10 @@ export async function sendInfoflowGroupImage(params: {
       coreEvents.emit("message:sent", {
         accountId: account.accountId,
         target: `group:${groupId}`,
-        from: account.config.appAgentId != null ? `agent:${account.config.appAgentId}` : "agent:unknown",
+        from:
+          account.config.appAgentId != null
+            ? `agent:${account.config.appAgentId}`
+            : "agent:unknown",
         messageid,
         msgseqid: msgseqid ?? "",
         contents: [{ type: "image", content: "image" }],
@@ -298,6 +301,14 @@ export async function sendInfoflowPrivateImage(params: {
     const data = JSON.parse(responseText) as Record<string, unknown>;
     logVerbose(`[infoflow:sendPrivateImage] response: status=${res.status}, data=${responseText}`);
 
+    // Check outer code first (same format as text message API)
+    const code = typeof data.code === "string" ? data.code : "";
+    if (code && code !== "ok") {
+      const errMsg = String(data.message ?? data.errmsg ?? `code=${code}`);
+      getInfoflowSendLog().error(`[infoflow:sendPrivateImage] failed: ${errMsg}`);
+      return { ok: false, error: errMsg };
+    }
+    // Also check inner errcode
     if (data.errcode && data.errcode !== 0) {
       const errMsg = String(data.errmsg ?? `errcode ${data.errcode}`);
       getInfoflowSendLog().error(`[infoflow:sendPrivateImage] failed: ${errMsg}`);
@@ -313,7 +324,10 @@ export async function sendInfoflowPrivateImage(params: {
       coreEvents.emit("message:sent", {
         accountId: account.accountId,
         target: toUser,
-        from: account.config.appAgentId != null ? `agent:${account.config.appAgentId}` : "agent:unknown",
+        from:
+          account.config.appAgentId != null
+            ? `agent:${account.config.appAgentId}`
+            : "agent:unknown",
         messageid: msgkey,
         msgseqid: "",
         contents: [{ type: "image", content: "image" }],

package/src/channel/monitor.ts

@@ -1,14 +1,14 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
-import type { OpenClawConfig } from "openclaw/plugin-sdk";
-import type { ResolvedInfoflowAccount } from "../types.js";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry";
 import {
   parseAndDispatchInfoflowRequest,
   loadRawBody,
   type WebhookTarget,
 } from "../adapter/inbound/webhook-parser.js";
+import { InfoflowWSReceiver } from "../adapter/inbound/ws-receiver.js";
 import { getInfoflowWebhookLog, formatInfoflowError, logVerbose } from "../logging.js";
 import { getInfoflowRuntime } from "../runtime.js";
-import { InfoflowWSReceiver } from "../adapter/inbound/ws-receiver.js";
+import type { ResolvedInfoflowAccount } from "../types.js";
 
 // ---------------------------------------------------------------------------
 // Types
@@ -97,16 +97,21 @@ export async function handleInfoflowWebhookRequest(
 
   // Check if path matches Infoflow webhook pattern
   if (!isInfoflowPath(requestPath)) {
+    logVerbose(
+      `[infoflow] skipping: path=${requestPath} does not match any registered webhook path`,
+    );
     return false;
   }
 
   // Get registered targets for the actual request path
   const targets = webhookTargets.get(requestPath);
   if (!targets || targets.length === 0) {
+    logVerbose(`[infoflow] skipping: no registered targets for path=${requestPath}`);
     return false;
   }
 
   if (req.method !== "POST") {
+    logVerbose(`[infoflow] rejecting: method=${req.method} is not POST for path=${requestPath}`);
     res.statusCode = 405;
     res.setHeader("Allow", "POST");
     res.end("Method Not Allowed");