@core-workspace/infoflow-openclaw-plugin 2026.3.36 → 2026.4.10

package/README.md

@@ -168,10 +168,8 @@ openclaw directory groups infoflow
       groupAllowFrom: ["12345678"], // 群聊白名单（群ID字符串），groupPolicy="allowlist" 时生效
 
       // ── 群聊回复行为 ───────────────────────────────────────
-      replyMode: "mention-and-watch", // "ignore" / "record" / "mention-only" / "mention-and-watch" / "proactive"
+      replyMode: "mention-only",   // "ignore" / "record" / "mention-only"
       requireMention: false,          // 是否强制要求 @ 机器人才触发
-      watchMentions: ["alice"],       // 监控指定人被 @，机器人代为判断是否回答
-      watchRegex: "故障|告警",        // 群消息命中正则时触发
       followUp: true,                 // 机器人回复后时间窗口内免 @ 追问
       followUpWindow: 300,            // 跟进时间窗口（秒）
 
@@ -190,7 +188,7 @@ openclaw directory groups infoflow
       // ── 群级别覆盖 ────────────────────────────────────────
       groups: {
         "12345678": {
-          replyMode: "proactive",
+          replyMode: "mention-only",
           groupSessionMode: "user", // 此群按群+人拆分会话
           systemPrompt: "你是该群的专属助手，回答要简洁。",
         },
@@ -246,7 +244,7 @@ https://your-domain/webhook/infoflow
 | `appKey` | `string` | ✅ | — | 应用 Key，从如流企业后台获取 |
 | `appSecret` | `string` | ✅ | — | 应用 Secret，从如流企业后台获取 |
 | `appAgentId` | `number` | — | — | 企业后台"应用ID"（数字），私聊消息撤回需要此字段 |
-| `robotName` | `string` | — | — | 机器人在群里的显示名称，用于检测消息中的 @ 提及。**未配置时无法识别 @机器人，`mention-only` / `mention-and-watch` 模式将退化为对所有群消息触发** |
+| `robotName` | `string` | — | — | 机器人在群里的显示名称，用于检测消息中的 @ 提及。**未配置时无法识别 @机器人，`mention-only` 模式将退化为对所有群消息触发** |
 | `connectionMode` | `string` | — | `"webhook"` | 消息接收方式：`"webhook"` 如流主动推送；`"websocket"` 插件主动长连接 |
 | `wsGateway` | `string` | — | `"infoflow-open-gateway.baidu.com"` | WebSocket 网关域名，仅 `websocket` 模式使用 |
 | `enabled` | `boolean` | — | `true` | 是否启用该插件 |
@@ -265,12 +263,10 @@ https://your-domain/webhook/infoflow
 
 | 字段 | 类型 | 必填 | 默认值 | 说明 |
 |------|------|:----:|--------|------|
-| `replyMode` | `string` | — | `"mention-and-watch"` | 群聊回复策略：`ignore`（丢弃）/ `record`（仅记录）/ `mention-only`（仅被@时）/ `mention-and-watch`（被@或关注人被@时）/ `proactive`（主动参与） |
+| `replyMode` | `string` | — | `"mention-only"` | 群聊回复策略：`ignore`（丢弃）/ `record`（仅记录）/ `mention-only`（仅被@时） |
 | `groupSessionMode` | `string` | — | `"group"` | 群聊会话拆分模式：`"group"` = 按群拆分；`"user"` = 按群+人拆分 |
 | `followUp` | `boolean` | — | `true` | 机器人回复后，时间窗口内自动识别追问，无需再次 @ |
 | `followUpWindow` | `number` | — | `300` | 跟进时间窗口（秒） |
-| `watchMentions` | `string[]` | — | `[]` | 监控指定人员被 @，机器人作为其助手代为判断是否回答，填写 uuapName |
-| `watchRegex` | `string` | — | — | JavaScript 正则表达式，群消息内容命中时触发回复 |
 
 #### 消息格式
 
@@ -298,8 +294,6 @@ https://your-domain/webhook/infoflow
 |------|------|------|
 | `replyMode` | `string` | 覆盖该群的回复策略 |
 | `groupSessionMode` | `string` | 覆盖该群的会话拆分模式：`"group"` = 按群拆分；`"user"` = 按群+人拆分 |
-| `watchMentions` | `string[]` | 覆盖该群监控的人员列表 |
-| `watchRegex` | `string` | 覆盖该群的正则匹配规则 |
 | `followUp` | `boolean` | 覆盖该群的跟进开关 |
 | `followUpWindow` | `number` | 覆盖该群的跟进时间窗口（秒） |
 | `systemPrompt` | `string` | 该群专属系统提示词，覆盖全局 Agent 的 system prompt |
@@ -484,6 +478,50 @@ tail -200 ~/.openclaw/logs/gateway.log | grep "sendInfoflowMessage"
 | `messageId` | string | — | 撤回指定消息 ID（优先于 count） |
 | `accountId` | string | — | 多账号时指定账号 ID |
 
+#### `infoflow_emoji_reply` — 表情回复
+
+为如流消息添加或移除表情回复，支持 146 种表情（d01-d146）。
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `messageId` | string | ✅ | 要添加表情回复的消息 ID |
+| `msgId2` | string | ✅ | 消息的 msgId2（辅助 ID） |
+| `chatType` | 2 \| 7 | ✅ | 聊天类型：2 = 群聊，7 = 私聊 |
+| `chatId` | number | — | 群聊 ID（仅群聊时需要） |
+| `fromUid` | string | — | 消息发送者 ID（私聊时自动从会话上下文提取） |
+| `emojiId` | string | ✅ | 表情 ID，如 d135（敲键盘）、d101（收到）、d48（赞） |
+| `action` | "add" \| "remove" | ✅ | 操作类型：add = 添加表情，remove = 移除表情 |
+| `accountId` | string | — | 多账号时指定账号 ID |
+
+**常用表情**：
+- 确认：d101（收到）、d105（搞定）、d48（赞）
+- 情绪：d01（微笑）、d02（大笑）、d71（爱心）
+- 工作：d135（敲键盘）、d118（优秀）、d124（编码中）
+
+**主动使用场景**（LLM 会在以下情况主动添加表情）：
+1. **长任务开始时**：执行耗时任务前，先用 d101（收到）或 d124（编码中）快速响应
+2. **出错/失败时**：处理失败或遇到错误，用 d19（衰）或 d32（委屈）表达歉意
+3. **理解/确认时**：收到用户指令后，用 d101（收到）或 d47（OK）确认理解
+4. **用户表扬时**：用户说"厉害"、"棒"、"谢谢"、"牛"等夸赞词，用 d13（害羞）、d01（微笑）或 d71（爱心）回应
+5. **幽默/轻松时**：对话轻松愉快，用 d03（哈哈）、d07（偷笑）或 d15（调皮）增加趣味
+
+#### `infoflow_list_emojis` — 查询表情列表
+
+查询如流支持的所有表情或指定类别的表情。
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `category` | string | — | 表情类别，默认为 "all"（全部表情） |
+
+**可用类别**：
+- `all`：全部 146 种表情
+- `confirm`：确认类（收到、搞定、OK 等）
+- `emotion`：情绪类（微笑、大笑、爱心等）
+- `work`：工作类（敲键盘、优秀、编码中等）
+- `status`：状态类（工作中、会议中、休息中等）
+- `gesture`：手势类（赞、握手、胜利等）
+- `symbol`：符号类（爱心、月亮、太阳等）
+
 ### 添加自定义 Tool
 
 在 `src/tools/` 下新建文件，在 `src/tools/index.ts` 的 `registerInfoflowTools` 中注册：
@@ -619,7 +657,7 @@ description: Skill 描述，说明何时触发（这是触发机制，写清楚
    ```bash
    tail -200 ~/.openclaw/logs/gateway.log | grep "webhook"
    ```
-3. 检查 `robotName` 是否与如流后台机器人显示名一致（影响 @mention 检测）。**注意：不配置 `robotName` 时，`mention-only` / `mention-and-watch` 模式将退化为对所有群消息触发，而非完全不触发**
+3. 检查 `robotName` 是否与如流后台机器人显示名一致（影响 @mention 检测）。**注意：不配置 `robotName` 时，`mention-only` 模式将退化为对所有群消息触发，而非完全不触发**
 4. 检查 `groupPolicy` 是否允许该群
 5. 在如流中发送 `/infoflow-doctor` 进行自检
 
@@ -769,7 +807,7 @@ For more options (access control, group policies, message format, etc.) see [Con
       // ── Connection ────────────────────────────────────────
       enabled: true,
       apiHost: "https://api.im.baidu.com",           // required
-      connectionMode: "websocket",                       // "webhook" (default) or "websocket"
+      connectionMode: "websocket",                       // "websocket" (default) or "webhook"
       wsGateway: "infoflow-open-gateway.baidu.com", // websocket mode only
       checkToken: "your-check-token",                    // required
       encodingAESKey: "your-encoding-aes-key",           // required
@@ -785,10 +823,8 @@ For more options (access control, group policies, message format, etc.) see [Con
       groupAllowFrom: ["12345678"], // Group whitelist (group ID string), used when groupPolicy="allowlist"
 
       // ── Reply Behavior ────────────────────────────────────
-      replyMode: "mention-and-watch", // "ignore" / "record" / "mention-only" / "mention-and-watch" / "proactive"
+      replyMode: "mention-only",   // "ignore" / "record" / "mention-only"
       requireMention: false,
-      watchMentions: ["alice"],       // act as assistant when these users are @mentioned
-      watchRegex: "incident|alert",   // trigger on regex match in group messages
       followUp: true,                 // allow follow-up questions without re-mentioning
       followUpWindow: 300,            // follow-up window in seconds
 
@@ -807,7 +843,7 @@ For more options (access control, group policies, message format, etc.) see [Con
       // ── Per-group Overrides ───────────────────────────────
       groups: {
         "12345678": {
-          replyMode: "proactive",
+          replyMode: "mention-only",
           systemPrompt: "You are the dedicated assistant for this group.",
         },
       },
@@ -852,7 +888,7 @@ https://your-domain/webhook/infoflow
 | `appKey` | `string` | ✅ | — | App Key from Infoflow enterprise console |
 | `appSecret` | `string` | ✅ | — | App Secret from Infoflow enterprise console |
 | `appAgentId` | `number` | — | — | App Agent ID (numeric); required for private message recall |
-| `robotName` | `string` | — | — | Bot display name in groups, used for @mention detection. **Without this, `mention-only` / `mention-and-watch` modes fall back to triggering on every message** |
+| `robotName` | `string` | — | — | Bot display name in groups, used for @mention detection. **Without this, `mention-only` mode falls back to triggering on every message** |
 | `connectionMode` | `string` | — | `"webhook"` | `"webhook"` (Infoflow pushes to your server) or `"websocket"` (plugin connects to Infoflow) |
 | `wsGateway` | `string` | — | `"infoflow-open-gateway.baidu.com"` | WebSocket gateway hostname, only used in `websocket` mode |
 | `enabled` | `boolean` | — | `true` | Whether to enable the plugin |
@@ -871,11 +907,9 @@ https://your-domain/webhook/infoflow
 
 | Field | Type | Required | Default | Description |
 |-------|------|:--------:|---------|-------------|
-| `replyMode` | `string` | — | `"mention-and-watch"` | `ignore` (discard) / `record` (save only) / `mention-only` (when @mentioned) / `mention-and-watch` (default) / `proactive` (always active) |
+| `replyMode` | `string` | — | `"mention-only"` | `ignore` (discard) / `record` (save only) / `mention-only` (when @mentioned) |
 | `followUp` | `boolean` | — | `true` | Auto-detect follow-up questions after bot replies (no @ needed) |
 | `followUpWindow` | `number` | — | `300` | Follow-up window in seconds |
-| `watchMentions` | `string[]` | — | `[]` | Watch these users; bot acts as assistant when they are @mentioned |
-| `watchRegex` | `string` | — | — | JavaScript regex; trigger reply when group message content matches |
 
 #### Message Format
 
@@ -895,7 +929,7 @@ https://your-domain/webhook/infoflow
 | `defaultAccount` | `string` | — | Default account ID |
 | `groups` | `object` | — | Per-group overrides; key = group ID (numeric string) |
 
-Per-group fields: `replyMode`, `watchMentions`, `watchRegex`, `followUp`, `followUpWindow`, `systemPrompt`
+Per-group fields: `replyMode`, `followUp`, `followUpWindow`, `systemPrompt`
 
 **Priority**: per-group > account-level > top-level defaults
 
@@ -1056,7 +1090,7 @@ Declare the skill path in `openclaw.plugin.json`:
 
 1. Check `replyMode` — confirm the group is allowed to trigger
 2. Check logs for incoming webhook requests
-3. Verify `robotName` matches the bot's display name in Infoflow (affects @mention detection). **Note: without `robotName`, `mention-only` / `mention-and-watch` modes fall back to triggering on every message**
+3. Verify `robotName` matches the bot's display name in Infoflow (affects @mention detection). **Note: without `robotName`, `mention-only` mode falls back to triggering on every message**
 4. Check `groupPolicy` allows the group
 5. Send `/infoflow-doctor` in Infoflow to run self-checks