@core-workspace/infoflow-openclaw-plugin 2026.3.8

package/src/tools/actions/index.ts

@@ -0,0 +1,456 @@
+/**
+ * Infoflow channel message actions adapter.
+ * Intercepts the "send" action from the message tool to support
+ * @all and @user mentions in group messages.
+ */
+
+import type { ChannelMessageActionAdapter, ChannelMessageActionName } from "openclaw/plugin-sdk";
+import { extractToolSend, jsonResult, readStringParam } from "openclaw/plugin-sdk";
+import { resolveInfoflowAccount } from "../../channel/accounts.js";
+import { logVerbose } from "../../logging.js";
+import { prepareInfoflowImageBase64, sendInfoflowImageMessage } from "../../channel/media.js";
+import {
+  sendInfoflowMessage,
+  recallInfoflowGroupMessage,
+  recallInfoflowPrivateMessage,
+  isLikelyLocalPath,
+} from "../../channel/outbound.js";
+import {
+  findSentMessage,
+  querySentMessages,
+  removeRecalledMessages,
+} from "../../utils/store/message-store.js";
+import { normalizeInfoflowTarget } from "../../adapter/outbound/target-resolver.js";
+import type { InfoflowMessageContentItem, InfoflowOutboundReply } from "../../types.js";
+
+// Recall result hint constants — reused across single/batch, group/private recall paths
+const RECALL_OK_HINT = "Recall succeeded. output only NO_REPLY with no other text.";
+const RECALL_FAIL_HINT = "Recall failed. Send a brief reply stating only the failure reason.";
+const RECALL_PARTIAL_HINT =
+  "Some recalls failed. Send a brief reply stating only the failure reason(s).";
+
+export const infoflowMessageActions: ChannelMessageActionAdapter = {
+  listActions: (): ChannelMessageActionName[] => ["send", "delete"],
+
+  extractToolSend: ({ args }) => extractToolSend(args, "sendMessage"),
+  
+  handleAction: async ({ action, params, cfg, accountId }) => {
+      // -----------------------------------------------------------------------
+    // delete (群消息撤回) — Mode A: by messageId, Mode B: by count
+    // -----------------------------------------------------------------------
+    if (action === "delete") {
+      const rawTo = readStringParam(params, "to", { required: true });
+      if (!rawTo) {
+        throw new Error("delete requires a target (to).");
+      }
+      const to = normalizeInfoflowTarget(rawTo) ?? rawTo;
+      const target = to.replace(/^infoflow:/i, "");
+
+      const account = resolveInfoflowAccount({ cfg, accountId: accountId ?? undefined });
+      if (!account.config.appKey || !account.config.appSecret) {
+        throw new Error("Infoflow appKey/appSecret not configured.");
+      }
+
+      const messageId = readStringParam(params, "messageId");
+      // Default to count=1 (recall latest message) when neither messageId nor count is provided
+      const countStr = readStringParam(params, "count") ?? (messageId ? undefined : "1");
+
+      const groupMatch = target.match(/^group:(\d+)/i);
+
+      if (groupMatch) {
+        // -----------------------------------------------------------------
+        // 群消息撤回
+        // -----------------------------------------------------------------
+        const groupId = Number(groupMatch[1]);
+
+        // Mode A: single message recall by messageId
+        if (messageId) {
+          let msgseqid = readStringParam(params, "msgseqid") ?? "";
+          if (!msgseqid) {
+            const stored = findSentMessage(account.accountId, messageId);
+            if (stored?.msgseqid) {
+              msgseqid = stored.msgseqid;
+            }
+          }
+          if (!msgseqid) {
+            throw new Error(
+              "delete requires msgseqid (not found in store; provide it explicitly or send messages first).",
+            );
+          }
+
+          const result = await recallInfoflowGroupMessage({
+            account,
+            groupId,
+            messageid: messageId,
+            msgseqid,
+          });
+
+          if (result.ok) {
+            try {
+              removeRecalledMessages(account.accountId, [messageId]);
+            } catch {
+              // ignore cleanup errors
+            }
+          }
+
+          return jsonResult({
+            ok: result.ok,
+            channel: "infoflow",
+            to,
+            ...(result.error ? { error: result.error } : {}),
+            _hint: result.ok ? RECALL_OK_HINT : RECALL_FAIL_HINT,
+          });
+        }
+
+        // Mode B: batch recall by count
+        if (countStr) {
+          const count = Number(countStr);
+          if (!Number.isFinite(count) || count < 1) {
+            throw new Error("count must be a positive integer.");
+          }
+
+          const records = querySentMessages(account.accountId, {
+            target: `group:${groupId}`,
+            count,
+          });
+          // Filter to records that have msgseqid (required for group recall)
+          const recallable = records.filter((r) => r.msgseqid);
+
+          if (recallable.length === 0) {
+            return jsonResult({
+              ok: true,
+              channel: "infoflow",
+              to,
+              recalled: 0,
+              message: "No recallable messages found in store.",
+              _hint: "No messages found to recall. Briefly inform the user.",
+            });
+          }
+
+          let succeeded = 0;
+          let failed = 0;
+          const recalledIds: string[] = [];
+          const details: Array<{
+            messageid: string;
+            digest: string;
+            ok: boolean;
+            error?: string;
+          }> = [];
+
+          for (const record of recallable) {
+            const result = await recallInfoflowGroupMessage({
+              account,
+              groupId,
+              messageid: record.messageid,
+              msgseqid: record.msgseqid,
+            });
+
+            if (result.ok) {
+              succeeded++;
+              recalledIds.push(record.messageid);
+              details.push({ messageid: record.messageid, digest: record.digest, ok: true });
+            } else {
+              failed++;
+              details.push({
+                messageid: record.messageid,
+                digest: record.digest,
+                ok: false,
+                error: result.error,
+              });
+            }
+          }
+
+          if (recalledIds.length > 0) {
+            try {
+              removeRecalledMessages(account.accountId, recalledIds);
+            } catch {
+              // ignore cleanup errors
+            }
+          }
+
+          return jsonResult({
+            ok: failed === 0,
+            channel: "infoflow",
+            to,
+            recalled: succeeded,
+            failed,
+            total: recallable.length,
+            details,
+            _hint: failed === 0 ? RECALL_OK_HINT : RECALL_PARTIAL_HINT,
+          });
+        }
+      } else {
+        // -----------------------------------------------------------------
+        // 私聊消息撤回
+        // -----------------------------------------------------------------
+        const appAgentId = account.config.appAgentId;
+        if (!appAgentId) {
+          throw new Error(
+            "Infoflow private message recall requires appAgentId configuration. " +
+              "Set channels.infoflow.appAgentId to your application ID (如流企业后台的应用ID).",
+          );
+        }
+
+        // Mode A: single message recall by messageId (msgkey)
+        if (messageId) {
+          const result = await recallInfoflowPrivateMessage({
+            account,
+            msgkey: messageId,
+            appAgentId,
+          });
+
+          if (result.ok) {
+            try {
+              removeRecalledMessages(account.accountId, [messageId]);
+            } catch {
+              // ignore cleanup errors
+            }
+          }
+
+          return jsonResult({
+            ok: result.ok,
+            channel: "infoflow",
+            to,
+            ...(result.error ? { error: result.error } : {}),
+            _hint: result.ok ? RECALL_OK_HINT : RECALL_FAIL_HINT,
+          });
+        }
+
+        // Mode B: batch recall by count
+        if (countStr) {
+          const count = Number(countStr);
+          if (!Number.isFinite(count) || count < 1) {
+            throw new Error("count must be a positive integer.");
+          }
+
+          const records = querySentMessages(account.accountId, { target, count });
+          // 私聊消息的 msgseqid 为空，只需要有 messageid (即 msgkey) 即可撤回
+          const recallable = records.filter((r) => r.messageid);
+
+          if (recallable.length === 0) {
+            return jsonResult({
+              ok: true,
+              channel: "infoflow",
+              to,
+              recalled: 0,
+              message: "No recallable messages found in store.",
+              _hint: "No messages found to recall. Briefly inform the user.",
+            });
+          }
+
+          let succeeded = 0;
+          let failed = 0;
+          const recalledIds: string[] = [];
+          const details: Array<{
+            messageid: string;
+            digest: string;
+            ok: boolean;
+            error?: string;
+          }> = [];
+
+          for (const record of recallable) {
+            const result = await recallInfoflowPrivateMessage({
+              account,
+              msgkey: record.messageid,
+              appAgentId,
+            });
+
+            if (result.ok) {
+              succeeded++;
+              recalledIds.push(record.messageid);
+              details.push({ messageid: record.messageid, digest: record.digest, ok: true });
+            } else {
+              failed++;
+              details.push({
+                messageid: record.messageid,
+                digest: record.digest,
+                ok: false,
+                error: result.error,
+              });
+            }
+          }
+
+          if (recalledIds.length > 0) {
+            try {
+              removeRecalledMessages(account.accountId, recalledIds);
+            } catch {
+              // ignore cleanup errors
+            }
+          }
+
+          return jsonResult({
+            ok: failed === 0,
+            channel: "infoflow",
+            to,
+            recalled: succeeded,
+            failed,
+            total: recallable.length,
+            details,
+            _hint: failed === 0 ? RECALL_OK_HINT : RECALL_PARTIAL_HINT,
+          });
+        }
+      }
+    }
+
+    // -----------------------------------------------------------------------
+    // send
+    // -----------------------------------------------------------------------
+    if (action !== "send") {
+      throw new Error(`Action "${action}" is not supported for Infoflow.`);
+    }
+
+    const account = resolveInfoflowAccount({ cfg, accountId: accountId ?? undefined });
+    if (!account.config.appKey || !account.config.appSecret) {
+      throw new Error("Infoflow appKey/appSecret not configured.");
+    }
+
+    const rawTo = readStringParam(params, "to", { required: true });
+    if (!rawTo) {
+      throw new Error("send requires a target (to).");
+    }
+    const to = normalizeInfoflowTarget(rawTo) ?? rawTo;
+    const message = readStringParam(params, "message", { required: false, allowEmpty: true }) ?? "";
+    const mediaUrl = readStringParam(params, "media", { trim: false });
+
+    // Log sendMessage action call
+    logVerbose(`[DEBUG actions:send] action=send, to=${to}, message="${message}", mediaUrl="${mediaUrl}"`);
+
+    // Infoflow-specific mention params
+    const atAll = params.atAll === true || params.atAll === "true";
+    const mentionUserIdsRaw = readStringParam(params, "mentionUserIds");
+
+    const isGroup = /^group:\d+$/i.test(to);
+    const contents: InfoflowMessageContentItem[] = [];
+
+    // Infoflow reply-to params (group only)
+    const replyToMessageId = readStringParam(params, "replyToMessageId");
+    const replyToPreview = readStringParam(params, "replyToPreview");
+    const replyTypeRaw = readStringParam(params, "replyType");
+    const replyTo: InfoflowOutboundReply | undefined =
+      replyToMessageId && isGroup
+        ? {
+            messageid: replyToMessageId,
+            preview: replyToPreview ?? undefined,
+            replytype: replyTypeRaw === "2" ? "2" : "1",
+          }
+        : undefined;
+
+    // Build AT content nodes (group messages only)
+    if (isGroup) {
+      if (atAll) {
+        contents.push({ type: "at", content: "all" });
+      } else if (mentionUserIdsRaw) {
+        const userIds = mentionUserIdsRaw
+          .split(",")
+          .map((s) => s.trim())
+          .filter(Boolean);
+        if (userIds.length > 0) {
+          contents.push({ type: "at", content: userIds.join(",") });
+        }
+      }
+    }
+
+    // Prepend @all/@user prefix to display text (same pattern as reply-dispatcher.ts)
+    let messageText = message;
+    if (isGroup) {
+      if (atAll) {
+        messageText = `@all ${message}`;
+      } else if (mentionUserIdsRaw) {
+        const userIds = mentionUserIdsRaw
+          .split(",")
+          .map((s) => s.trim())
+          .filter(Boolean);
+        if (userIds.length > 0) {
+          const prefix = userIds.map((id) => `@${id}`).join(" ");
+          messageText = `${prefix} ${message}`;
+        }
+      }
+    }
+
+    if (messageText.trim()) {
+      contents.push({ type: "markdown", content: messageText });
+    }
+
+    if (mediaUrl) {
+      logVerbose(
+        `[infoflow:action:send] to=${to}, atAll=${atAll}, mentionUserIds=${mentionUserIdsRaw ?? "none"}`,
+      );
+
+      // Send text+mentions first (if any)
+      if (contents.length > 0) {
+        await sendInfoflowMessage({
+          cfg,
+          to,
+          contents,
+          accountId: accountId ?? undefined,
+          replyTo,
+        });
+      }
+
+      // Try native image send, fallback to link
+      try {
+        const paths = isLikelyLocalPath(mediaUrl)?[mediaUrl]:undefined;
+        const prepared = await prepareInfoflowImageBase64({ mediaUrl, mediaLocalRoots:paths });
+        logVerbose(`prepareInfoflowImageBase64 result: isImage=${prepared.isImage}`);
+        if (prepared.isImage) {
+          const imgResult = await sendInfoflowImageMessage({
+            cfg,
+            to,
+            base64Image: prepared.base64,
+            accountId: accountId ?? undefined,
+            replyTo: contents.length > 0 ? undefined : replyTo,
+          });
+          return jsonResult({
+            ok: imgResult.ok,
+            channel: "infoflow",
+            to,
+            messageId: imgResult.messageId ?? (imgResult.ok ? "sent" : "failed"),
+            ...(imgResult.error ? { error: imgResult.error } : {}),
+          });
+        }
+      } catch (e) {
+        logVerbose(`[DEBUG actions:send] prepareInfoflowImageBase64 error: ${e}`);
+      }
+
+      // Non-image or native send failed → send as link
+      const linkResult = await sendInfoflowMessage({
+        cfg,
+        to,
+        contents: [{ type: "link", content: mediaUrl }],
+        accountId: accountId ?? undefined,
+        replyTo: contents.length > 0 ? undefined : replyTo,
+      });
+      return jsonResult({
+        ok: linkResult.ok,
+        channel: "infoflow",
+        to,
+        messageId: linkResult.messageId ?? (linkResult.ok ? "sent" : "failed"),
+        ...(linkResult.error ? { error: linkResult.error } : {}),
+      });
+    }
+
+    if (contents.length === 0) {
+      throw new Error("send requires text or media");
+    }
+
+    logVerbose(
+      `[infoflow:action:send] to=${to}, atAll=${atAll}, mentionUserIds=${mentionUserIdsRaw ?? "none"}`,
+    );
+
+    const result = await sendInfoflowMessage({
+      cfg,
+      to,
+      contents,
+      accountId: accountId ?? undefined,
+      replyTo,
+    });
+
+    return jsonResult({
+      ok: result.ok,
+      channel: "infoflow",
+      to,
+      messageId: result.messageId ?? (result.ok ? "sent" : "failed"),
+      ...(result.error ? { error: result.error } : {}),
+    });
+  },
+};

package/src/tools/hooks/index.ts

@@ -0,0 +1,82 @@
+/**
+ * Infoflow Agent Hooks（生命周期钩子）
+ *
+ * 通过 api.on() 注册 OpenClaw Agent 生命周期钩子，
+ * 在 Agent 启动前向 system prompt 注入如流平台背景知识，
+ * 让 LLM 无需用户解释就能理解如流的功能和配置。
+ *
+ * 目前注册的 hook：
+ *   - before_agent_start：每次 Agent 运行时触发，追加如流平台介绍到 system prompt。
+ *     注入内容会被 server 端缓存（prompt caching），首次之后不产生额外 token 消耗。
+ *
+ * 新增 hook 的方法：
+ *   1. 编写一个返回字符串的函数作为注入内容。
+ *   2. 在 registerInfoflowHooks 中调用 api.on("before_agent_start", ...) 注册。
+ *   3. 如果是可选功能，可以加配置开关。
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+
+// ---------------------------------------------------------------------------
+// Hook: infoflow-intro（注入如流平台背景知识）
+// ---------------------------------------------------------------------------
+
+/**
+ * 构建注入 system prompt 的如流平台介绍文本。
+ * 抽为独立函数便于单独测试。
+ */
+export function buildInfoflowIntroContext(): string {
+  return `
+## 如流 (Infoflow) 平台 — 背景知识
+
+如流是百度自研的企业即时通讯平台，运行于百度内网，类似飞书/钉钉。
+当前 OpenClaw Agent 通过如流 Bot（机器人）与用户通信，具备以下能力：
+
+### 会话类型
+- **私聊 (DM)**：用户直接与机器人一对一对话。
+- **群聊 (Group)**：机器人加入多人群，通过 @mention 触发回复，也支持主动发送通知。
+
+### 消息格式
+- **text**：纯文本，所有终端兼容。
+- **markdown (MD)**：支持标题、加粗、代码块、列表（仅群聊支持引用回复时请用 text 格式）。
+
+### Bot 能力
+- **infoflow_send 工具**：主动向用户或群发送消息，支持 Markdown 和 @mention。
+- **infoflow_recall 工具**：撤回近期发出的消息（群消息需 msgseqid，私聊需 appAgentId）。
+- **@mention**：群消息中可 @全体成员 或 @指定成员（uuapName/邮箱前缀）。
+- **消息撤回**：群消息 2 分钟内可撤回；私聊消息撤回需配置 appAgentId。
+
+### 典型使用场景
+- 收到用户提问后，通过私聊回复详细答案。
+- 在指定群中发送项目进度通知，并 @相关人员。
+- 定时播报天气、日程、监控告警等信息。
+- 撤回误发的消息。
+
+### 消息访问控制
+- 私聊：通过 dmPolicy 控制（open / pairing / allowlist）。
+- 群聊：通过 groupPolicy 控制（open / allowlist / disabled）。
+- 白名单通过 allowFrom / groupAllowFrom 配置。
+
+> 注意：如流消息 API 使用非标准 Bearer 格式（Bearer-<token>，含连字符），
+> 且大整数 messageid / msgseqid 需保留原始字符串精度。
+`.trim();
+}
+
+// ---------------------------------------------------------------------------
+// 注册函数
+// ---------------------------------------------------------------------------
+
+/**
+ * 向 OpenClaw 插件 API 注册如流生命周期钩子。
+ * 在插件的 register() 函数中调用。
+ */
+export function registerInfoflowHooks(api: OpenClawPluginApi): void {
+  // 每次 Agent 启动前，将如流平台介绍追加到 system prompt
+  api.on("before_agent_start", (_event, _ctx) => {
+    return {
+      appendSystemContext: buildInfoflowIntroContext(),
+    };
+  });
+
+  api.logger.info?.("infoflow_hooks: Registered before_agent_start hook (infoflow-intro)");
+}