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

package/openclaw.plugin.json

@@ -1,13 +1,13 @@
 {
-  "id": "infoflow",
+  "id": "infoflow-openclaw-plugin",
   "channels": ["infoflow"],
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
-      "apiHost": { "type": "string" },
-      "enabled": { "type": "boolean" },
+      "apiHost": { "type": "string", "default": "https://api.im.baidu.com" },
+      "enabled": { "type": "boolean", "default": true },
       "name": { "type": "string" },
       "checkToken": { "type": "string" },
       "encodingAESKey": { "type": "string" },
@@ -16,32 +16,67 @@
       "connectionMode": {
         "type": "string",
         "enum": ["webhook", "websocket"],
-        "default": "webhook",
+        "default": "websocket",
         "description": "消息接收方式：webhook（HTTP 回调）或 websocket（长连接）"
       },
       "wsGateway": {
         "type": "string",
-        "description": "WebSocket Gateway 域名（仅 websocket 模式使用）"
+        "default": "infoflow-open-gateway.baidu.com",
+        "description": "WebSocket Gateway 域名，用于 Phase 1 端点分配请求（仅 websocket 模式使用）"
+      },
+      "wsConnectDomain": {
+        "type": "string",
+        "description": "WebSocket 连接域名，用于 Phase 2 实际 WS 握手（不填则使用服务端返回的地址，内网环境可配置此项）"
       },
       "robotName": { "type": "string" },
+      "robotId": {
+        "type": "string",
+        "description": "无需手动填写，自动发现。如流机器人实际ID（首次被@时从消息体中提取，用于忽略自身消息）"
+      },
       "appAgentId": {
         "type": "number",
         "description": "如流企业后台的应用ID，私聊消息撤回依赖此字段"
       },
-      "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist"] },
+      "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist"], "default": "open" },
       "allowFrom": { "type": "array", "items": { "type": "string" } },
-      "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"] },
+      "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"], "default": "open" },
       "groupAllowFrom": { "type": "array", "items": { "type": "string" } },
-      "requireMention": { "type": "boolean" },
+      "requireMention": { "type": "boolean", "default": true },
       "replyMode": {
         "type": "string",
-        "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"],
-        "default": "mention-and-watch"
+        "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
+      },
+      "groupSessionMode": {
+        "type": "string",
+        "enum": ["group", "user"],
+        "default": "group",
+        "description": "群聊会话拆分模式：group=按群拆分，user=按群+人拆分"
       },
       "followUp": { "type": "boolean", "default": true },
       "followUpWindow": { "type": "number", "default": 300 },
       "watchMentions": { "type": "array", "items": { "type": "string" } },
-      "watchRegex": { "type": "string" },
+      "watchRegex": {
+        "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }]
+      },
+      "defaultTo": {
+        "type": "string",
+        "description": "定时任务转发的默认目标，例如 zhangsan 或 group:123456"
+      },
+      "privateDataDir": {
+        "type": "string",
+        "default": "plugins/infoflow-private",
+        "description": "插件私有数据目录，相对 OpenClaw stateDir"
+      },
+      "cronRelay": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": { "type": "boolean", "default": true },
+          "includeAlreadyDelivered": { "type": "boolean", "default": false },
+          "prefix": { "type": "string", "default": "【定时任务】" },
+          "pollIntervalMs": { "type": "number", "default": 2000 }
+        }
+      },
       "groups": {
         "type": "object",
         "additionalProperties": {
@@ -51,8 +86,15 @@
               "type": "string",
               "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
             },
+            "groupSessionMode": {
+              "type": "string",
+              "enum": ["group", "user"],
+              "description": "群聊会话拆分模式：group=按群拆分，user=按群+人拆分"
+            },
             "watchMentions": { "type": "array", "items": { "type": "string" } },
-            "watchRegex": { "type": "string" },
+            "watchRegex": {
+              "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }]
+            },
             "followUp": { "type": "boolean" },
             "followUpWindow": { "type": "number" },
             "systemPrompt": { "type": "string" }
@@ -65,8 +107,9 @@
         "additionalProperties": {
           "type": "object",
           "properties": {
-            "enabled": { "type": "boolean" },
+            "enabled": { "type": "boolean", "default": true },
             "name": { "type": "string" },
+            "apiHost": { "type": "string", "default": "https://api.im.baidu.com" },
             "checkToken": { "type": "string" },
             "encodingAESKey": { "type": "string" },
             "appKey": { "type": "string" },
@@ -74,27 +117,51 @@
             "connectionMode": {
               "type": "string",
               "enum": ["webhook", "websocket"],
-              "default": "webhook"
+              "default": "websocket"
             },
-            "wsGateway": { "type": "string" },
+            "wsGateway": { "type": "string", "default": "infoflow-open-gateway.baidu.com" },
+            "wsConnectDomain": { "type": "string" },
             "robotName": { "type": "string" },
+            "robotId": {
+              "type": "string",
+              "description": "无需手动填写，自动发现。如流机器人实际ID（首次被@时从消息体中提取，用于忽略自身消息）"
+            },
             "appAgentId": {
               "type": "number",
               "description": "如流企业后台的应用ID，私聊消息撤回依赖此字段"
             },
-            "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist"] },
+            "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist"], "default": "open" },
             "allowFrom": { "type": "array", "items": { "type": "string" } },
-            "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"] },
+            "groupPolicy": { "type": "string", "enum": ["open", "allowlist", "disabled"], "default": "open" },
             "groupAllowFrom": { "type": "array", "items": { "type": "string" } },
-            "requireMention": { "type": "boolean" },
+            "requireMention": { "type": "boolean", "default": true },
             "replyMode": {
               "type": "string",
               "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
             },
+            "groupSessionMode": {
+              "type": "string",
+              "enum": ["group", "user"],
+              "description": "群聊会话拆分模式：group=按群拆分，user=按群+人拆分"
+            },
             "followUp": { "type": "boolean" },
             "followUpWindow": { "type": "number" },
             "watchMentions": { "type": "array", "items": { "type": "string" } },
-            "watchRegex": { "type": "string" },
+            "watchRegex": {
+              "oneOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }]
+            },
+            "defaultTo": { "type": "string" },
+            "privateDataDir": { "type": "string", "default": "plugins/infoflow-private" },
+            "cronRelay": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "enabled": { "type": "boolean", "default": true },
+                "includeAlreadyDelivered": { "type": "boolean", "default": false },
+                "prefix": { "type": "string", "default": "【定时任务】" },
+                "pollIntervalMs": { "type": "number", "default": 2000 }
+              }
+            },
             "groups": {
               "type": "object",
               "additionalProperties": {
@@ -104,14 +171,46 @@
                     "type": "string",
                     "enum": ["ignore", "record", "mention-only", "mention-and-watch", "proactive"]
                   },
+                  "groupSessionMode": {
+                    "type": "string",
+                    "enum": ["group", "user"],
+                    "description": "群聊会话拆分模式：group=按群拆分，user=按群+人拆分"
+                  },
                   "watchMentions": { "type": "array", "items": { "type": "string" } },
-                  "watchRegex": { "type": "string" },
+                  "watchRegex": {
+                    "oneOf": [
+                      { "type": "string" },
+                      { "type": "array", "items": { "type": "string" } }
+                    ]
+                  },
                   "followUp": { "type": "boolean" },
                   "followUpWindow": { "type": "number" },
                   "systemPrompt": { "type": "string" }
                 },
                 "additionalProperties": false
               }
+            },
+            "processingHint": {
+              "type": "boolean",
+              "default": true
+            },
+            "processingHintDelay": {
+              "type": "number",
+              "default": 5
+            },
+            "dmMessageFormat": {
+              "type": "string",
+              "enum": ["text", "markdown"],
+              "default": "text"
+            },
+            "groupMessageFormat": {
+              "type": "string",
+              "enum": ["text", "markdown"],
+              "default": "text"
+            },
+            "textChunkLimit": {
+              "type": "number",
+              "default": 1800
             }
           }
         }
@@ -127,11 +226,22 @@
         "default": 5,
         "description": "发送处理中提示前的等待秒数，设为 0 则立即发送"
       },
-      "messageFormat": {
+      "dmMessageFormat": {
+        "type": "string",
+        "enum": ["text", "markdown"],
+        "default": "text",
+        "description": "单聊消息格式：text（纯文本）或 markdown（富文本）"
+      },
+      "groupMessageFormat": {
         "type": "string",
         "enum": ["text", "markdown"],
         "default": "text",
         "description": "群聊消息格式：text（纯文本）或 markdown（富文本，不支持引用回复）"
+      },
+      "textChunkLimit": {
+        "type": "number",
+        "default": 1800,
+        "description": "长消息自动拆分的字符上限"
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@core-workspace/infoflow-openclaw-plugin",
-  "version": "2026.3.9",
+  "version": "2026.3.27-beta.0",
   "description": "OpenClaw Infoflow (如流) channel plugin for Baidu enterprise messaging",
   "type": "module",
   "main": "index.ts",
@@ -9,6 +9,7 @@
     "openclaw",
     "openclaw-plugin",
     "infoflow",
+    "infoflow-openclaw-plugin",
     "baidu",
     "chatbot",
     "ai-agent",
@@ -21,15 +22,21 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.2"
   },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
   "dependencies": {
-    "@core-workspace/infoflow-sdk-nodejs": "^0.1.5"
+    "@core-workspace/infoflow-sdk-nodejs": "2026.3.26-beta.1",
+    "@sinclair/typebox": "0.34.48"
   },
   "openclaw": {
     "extensions": [
       "./index.ts"
     ],
     "channel": {
-      "id": "infoflow",
+      "id": "infoflow-openclaw-plugin",
       "label": "Infoflow",
       "selectionLabel": "Infoflow (如流)",
       "docsPath": "/channels/infoflow",
@@ -40,5 +47,11 @@
       "npmSpec": "@core-workspace/infoflow-openclaw-plugin",
       "defaultChoice": "npm"
     }
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.cjs"
+  },
+  "devDependencies": {
+    "openclaw": "^2026.3.23"
   }
 }

package/scripts/deploy.sh

@@ -3,7 +3,9 @@
 
 set -e
 
-PLUGIN_DIR="$HOME/.openclaw/extensions/infoflow"
+PLUGIN_ID="infoflow-openclaw-plugin"
+PLUGIN_DIR="$HOME/.openclaw/extensions/$PLUGIN_ID"
+CONFIG_FILE="$HOME/.openclaw/openclaw.json"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
 
@@ -16,17 +18,74 @@ rsync -av --delete "$PROJECT_DIR/" "$PLUGIN_DIR/" \
   --exclude scripts
 
 echo "==> 安装依赖"
-cd "$PLUGIN_DIR" && npm install --silent
+cd "$PLUGIN_DIR" && npm_config_registry=http://registry.npm.baidu-int.com npm install --silent
+
+echo "==> 链接 openclaw peer dependency"
+OPENCLAW_GLOBAL="$(npm root -g)/openclaw"
+if [ -d "$OPENCLAW_GLOBAL" ]; then
+  mkdir -p "$PLUGIN_DIR/node_modules"
+  rm -rf "$PLUGIN_DIR/node_modules/openclaw"
+  ln -s "$OPENCLAW_GLOBAL" "$PLUGIN_DIR/node_modules/openclaw"
+  echo "  ✓ 已链接 $OPENCLAW_GLOBAL -> $PLUGIN_DIR/node_modules/openclaw"
+else
+  echo "  ✗ 找不到全局 openclaw 安装，尝试使用 which openclaw 推断..."
+  OPENCLAW_BIN="$(which openclaw 2>/dev/null)"
+  if [ -n "$OPENCLAW_BIN" ]; then
+    OPENCLAW_GLOBAL="$(cd "$(dirname "$OPENCLAW_BIN")/.." && pwd)/lib/node_modules/openclaw"
+    if [ -d "$OPENCLAW_GLOBAL" ]; then
+      mkdir -p "$PLUGIN_DIR/node_modules"
+      rm -rf "$PLUGIN_DIR/node_modules/openclaw"
+      ln -s "$OPENCLAW_GLOBAL" "$PLUGIN_DIR/node_modules/openclaw"
+      echo "  ✓ 已链接 $OPENCLAW_GLOBAL -> $PLUGIN_DIR/node_modules/openclaw"
+    else
+      echo "  ✗ 无法找到 openclaw 安装目录，跳过链接（插件可能无法加载）"
+    fi
+  else
+    echo "  ✗ openclaw 未安装，跳过链接"
+  fi
+fi
+
+echo "==> 更新 OpenClaw 配置"
+node -e "
+  const fs = require('fs');
+  const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+  const id = '$PLUGIN_ID';
+
+  // 1. plugins.entries: 确保插件已启用
+  cfg.plugins = cfg.plugins ?? {};
+  cfg.plugins.entries = cfg.plugins.entries ?? {};
+  if (!cfg.plugins.entries[id]) {
+    cfg.plugins.entries[id] = { enabled: true };
+    console.log('  + 已添加 plugins.entries.' + id);
+  } else if (!cfg.plugins.entries[id].enabled) {
+    cfg.plugins.entries[id].enabled = true;
+    console.log('  + 已启用 plugins.entries.' + id);
+  } else {
+    console.log('  ✓ plugins.entries.' + id + ' 已存在');
+  }
+
+  // 2. plugins.allow: 如果配置了白名单，确保插件在列表中
+  if (Array.isArray(cfg.plugins.allow)) {
+    if (!cfg.plugins.allow.includes(id)) {
+      cfg.plugins.allow.push(id);
+      console.log('  + 已添加到 plugins.allow');
+    } else {
+      console.log('  ✓ plugins.allow 已包含 ' + id);
+    }
+  } else {
+    console.log('  - plugins.allow 未配置，跳过');
+  }
+
+  fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 2) + '\n');
+"
 
 echo "==> 重启 OpenClaw gateway"
-pkill -f "openclaw" 2>/dev/null || true
-sleep 1
-nohup openclaw gateway > /tmp/openclaw.log 2>&1 &
-sleep 2
+openclaw gateway restart
 
 echo "==> 检查启动状态"
+sleep 2
 if pgrep -f "openclaw" > /dev/null; then
-  echo "✓ gateway 已启动（PID: $(pgrep -f openclaw | head -1)）"
+  echo "✓ gateway 已启动（PID: $(pgrep -f 'openclaw' | head -1)）"
   echo "  日志: tail -f /tmp/openclaw.log"
 else
   echo "✗ gateway 启动失败，查看日志: cat /tmp/openclaw.log"

package/scripts/postinstall.cjs

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+/**
+ * postinstall.cjs
+ *
+ * Creates a symlink: node_modules/openclaw -> <global npm root>/openclaw
+ *
+ * Why: `openclaw` is a peerDependency (optional). When the openclaw gateway
+ * runs `npm install` for this plugin, npm does not install peerDeps.
+ * At runtime the plugin needs `openclaw/plugin-sdk/*` to resolve, so we
+ * link it from the global installation that is already running the gateway.
+ *
+ * No circular dependency risk: Node.js caches modules by resolved path.
+ * The gateway already holds openclaw in memory; the plugin just gets the
+ * same cached exports through the symlink.
+ */
+
+"use strict";
+
+const { execSync, spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const PLUGIN_DIR = path.resolve(__dirname, "..");
+const TARGET = path.join(PLUGIN_DIR, "node_modules", "openclaw");
+
+// Already linked or installed — nothing to do.
+if (fs.existsSync(TARGET)) {
+  process.exit(0);
+}
+
+/** Try to locate the global openclaw package directory. */
+function findGlobalOpenclaw() {
+  // Strategy 1: npm root -g
+  try {
+    const globalRoot = execSync("npm root -g", { encoding: "utf8" }).trim();
+    const candidate = path.join(globalRoot, "openclaw");
+    if (fs.existsSync(candidate)) return candidate;
+  } catch {
+    // ignore
+  }
+
+  // Strategy 2: resolve from `openclaw` binary on PATH
+  try {
+    const bin =
+      spawnSync("which", ["openclaw"], { encoding: "utf8" }).stdout?.trim() ||
+      spawnSync("where", ["openclaw"], { encoding: "utf8" }).stdout?.trim();
+    if (bin) {
+      // binary lives at <prefix>/bin/openclaw → package at <prefix>/lib/node_modules/openclaw
+      const prefix = path.resolve(path.dirname(bin), "..");
+      const candidate = path.join(prefix, "lib", "node_modules", "openclaw");
+      if (fs.existsSync(candidate)) return candidate;
+    }
+  } catch {
+    // ignore
+  }
+
+  return null;
+}
+
+const src = findGlobalOpenclaw();
+if (!src) {
+  // Not fatal — openclaw may inject itself via other means at runtime.
+  console.log(
+    "[infoflow-openclaw-plugin] postinstall: openclaw not found globally, skipping symlink."
+  );
+  process.exit(0);
+}
+
+try {
+  fs.mkdirSync(path.join(PLUGIN_DIR, "node_modules"), { recursive: true });
+  fs.symlinkSync(src, TARGET, "junction"); // "junction" works on Windows too
+  console.log(
+    `[infoflow-openclaw-plugin] postinstall: linked ${src} -> ${TARGET}`
+  );
+} catch (err) {
+  // Non-fatal: e.g. permission error in some CI envs.
+  console.warn(
+    `[infoflow-openclaw-plugin] postinstall: failed to create symlink (${err.message})`
+  );
+}

package/skills/infoflow-dev/SKILL.md

@@ -23,12 +23,12 @@ Authorization: Bearer-<token>   ← 注意是连字符，不是空格
 
 ### 发群消息端点
 ```
-POST http://apiin.im.baidu.com/api/v1/robot/msg/groupmsgsend
+POST http://api.im.baidu.com/api/v1/robot/msg/groupmsgsend
 ```
 
 ### 发私聊端点
 ```
-POST http://apiin.im.baidu.com/api/v1/app/message/send
+POST http://api.im.baidu.com/api/v1/app/message/send
 ```
 
 ### 消息类型

package/skills/infoflow-dev/references/api.md

@@ -8,7 +8,7 @@
 
 ### API 端点
 
-- **生产环境**: `http://apiin.im.baidu.com/api/v1/robot/msg/groupmsgsend`
+- **生产环境**: `http://api.im.baidu.com/api/v1/robot/msg/groupmsgsend`
 - **预发布环境**: `http://xplatform-preonline.dev.weiyun.baidu.com/open-plat/api/devp/v1/robot/msg/groupmsgsend`
 
 ### 权限要求

package/src/adapter/inbound/webhook-parser.ts

@@ -1,13 +1,13 @@
 import { createHash, createDecipheriv, timingSafeEqual } from "node:crypto";
 import type { IncomingMessage } from "node:http";
-import type { OpenClawConfig } from "openclaw/plugin-sdk";
-import { createDedupeCache } from "openclaw/plugin-sdk";
+import type { OpenClawConfig } from "openclaw/plugin-sdk/plugin-entry";
+import { createDedupeCache } from "../../compat/openclaw-sdk.js";
 // ---------------------------------------------------------------------------
 // Message deduplication
 // ---------------------------------------------------------------------------
 import { handlePrivateChatMessage, handleGroupChatMessage } from "../../handler/message-handler.js";
-import type { ResolvedInfoflowAccount } from "../../types.js";
 import { getInfoflowParseLog, formatInfoflowError, logVerbose } from "../../logging.js";
+import type { ResolvedInfoflowAccount } from "../../types.js";
 
 const DEDUP_TTL_MS = 5 * 60 * 1000; // 5 minutes
 const DEDUP_MAX_SIZE = 1000;
@@ -67,6 +67,22 @@ export function recordSentMessageId(messageId: string | null): void {
   messageCache.check(messageId);
 }
 
+// ---------------------------------------------------------------------------
+// Large-integer ID precision fix
+// ---------------------------------------------------------------------------
+
+/**
+ * Matches large-integer ID fields in raw JSON text before parsing.
+ * Converts bare integers (16+ digits) to quoted strings in-place,
+ * preventing precision loss from JSON.parse for IDs exceeding
+ * Number.MAX_SAFE_INTEGER (2^53-1).
+ */
+const LARGE_INT_ID_RE = /("(?:messageid|msgid|MsgId|msgkey)")\s*:\s*(\d{16,})/g;
+
+export function patchPreciseIds(rawText: string): string {
+  return rawText.replace(LARGE_INT_ID_RE, (_, key, val) => `${key}:"${val}"`);
+}
+
 // ---------------------------------------------------------------------------
 // AES-ECB Decryption Utilities
 // ---------------------------------------------------------------------------
@@ -313,7 +329,7 @@ function tryDecryptAndDispatch(params: DecryptDispatchParams): ParseResult {
     // Parse as JSON first, then try fallback parser (XML for private)
     let msgData: Record<string, unknown> | null = null;
     try {
-      msgData = JSON.parse(decryptedContent) as Record<string, unknown>;
+      msgData = JSON.parse(patchPreciseIds(decryptedContent)) as Record<string, unknown>;
     } catch {
       if (fallbackParser) {
         msgData = fallbackParser(decryptedContent);
@@ -326,6 +342,9 @@ function tryDecryptAndDispatch(params: DecryptDispatchParams): ParseResult {
         return { handled: true, statusCode: 200, body: "success" };
       }
 
+      getInfoflowParseLog().info(
+        `[infoflow:raw] ${chatType} decrypted: ${JSON.stringify(msgData).slice(0, 2000)}`,
+      );
       target.statusSink?.({ lastInboundAt: Date.now() });
 
       // Fire-and-forget with centralized error handling
@@ -357,7 +376,7 @@ function tryDecryptAndDispatch(params: DecryptDispatchParams): ParseResult {
 function handlePrivateMessage(messageJsonStr: string, targets: WebhookTarget[]): ParseResult {
   let messageJson: Record<string, unknown>;
   try {
-    messageJson = JSON.parse(messageJsonStr) as Record<string, unknown>;
+    messageJson = JSON.parse(patchPreciseIds(messageJsonStr)) as Record<string, unknown>;
   } catch {
     getInfoflowParseLog().error(`[infoflow] private: invalid messageJson`);
     return { handled: true, statusCode: 400, body: "invalid messageJson" };
@@ -431,3 +450,6 @@ export const _parseXmlMessage = parseXmlMessage;
 export function _resetMessageCache(): void {
   messageCache.clear();
 }
+
+/** @internal */
+export const _patchPreciseIds = patchPreciseIds;