@core-workspace/infoflow-openclaw-plugin 2026.3.8

package/docs/dev-guide.md

@@ -0,0 +1,611 @@
+# OpenClaw Infoflow 插件开发规范
+
+> 面向 `openclaw_infoflow` 插件的开发者，涵盖目录结构、模块职责、核心 API、配置规范、测试要求和提交流程。
+
+---
+
+## 目录
+
+1. [项目概览](#1-项目概览)
+2. [目录结构与模块职责](#2-目录结构与模块职责)
+3. [核心数据流](#3-核心数据流)
+4. [配置参数规范](#4-配置参数规范)
+5. [如流 API 接口](#5-如流-api-接口)
+6. [消息格式规范](#6-消息格式规范)
+7. [安全策略模块](#7-安全策略模块)
+8. [工具与 Hook 开发](#8-工具与-hook-开发)
+9. [测试规范](#9-测试规范)
+10. [开发工作流](#10-开发工作流)
+11. [常见问题与注意事项](#11-常见问题与注意事项)
+
+---
+
+## 1. 项目概览
+
+`openclaw_infoflow` 是 OpenClaw 的如流（Baidu Infoflow）渠道插件，支持：
+
+- **私聊（DM）** 与 **群聊（Group）** 双模式
+- **Webhook** 与 **WebSocket** 双接入方式
+- 消息发送、撤回、图片发送
+- 群聊多种触发模式（mention-only / mention-and-watch / proactive / record / ignore）
+- @mention 检测、follow-up 窗口、条件回复（NO_REPLY）
+
+**技术栈**：TypeScript (ESM)，Node.js 22+，运行时由 OpenClaw gateway 加载（无单独构建步骤）。
+
+---
+
+## 2. 目录结构与模块职责
+
+```
+openclaw_infoflow/
+├── index.ts                    # 插件入口：注册 channel、HTTP route、tools、hooks
+├── src/
+│   ├── types.ts                # 所有类型定义（Policy、Config、Event、Params 等）
+│   ├── runtime.ts              # 插件运行时单例（getInfoflowRuntime / setInfoflowRuntime）
+│   ├── logging.ts              # 日志工具（getInfoflowBotLog 等）
+│   ├── events.ts               # 内部事件总线（coreEvents，解耦 outbound → store）
+│   │
+│   ├── channel/                # Plugin Entry Layer：插件接入层
+│   │   ├── channel.ts          # ChannelPlugin 定义，与 OpenClaw SDK 集成
+│   │   ├── accounts.ts         # 多账号配置解析（resolveInfoflowAccount）
+│   │   ├── monitor.ts          # Webhook HTTP handler + WebSocket 启动
+│   │   ├── outbound.ts         # 发送 API（sendInfoflowMessage、recallInfoflowGroupMessage 等）
+│   │   └── media.ts            # 图片处理（base64 编解码、发送图片消息）
+│   │
+│   ├── adapter/                # Message Adapter Layer：消息格式转换（纯函数）
+│   │   ├── inbound/
+│   │   │   ├── webhook-parser.ts   # AES 解密、消息路由、dedup 缓存
+│   │   │   └── ws-receiver.ts      # WebSocket 接收、心跳、重连
+│   │   └── outbound/
+│   │       ├── reply-dispatcher.ts # Reply dispatcher，负责分块、@mention 解析
+│   │       └── target-resolver.ts  # 目标地址规范化（group:<id> / username）
+│   │
+│   ├── handler/                # Event Bridge Layer：事件桥接层
+│   │   └── message-handler.ts  # 核心消息处理（私聊/群聊路由 → LLM dispatch）
+│   │
+│   ├── security/               # Security Policy Layer：安全策略层
+│   │   ├── group-policy.ts     # 群聊策略（@mention 检测、replyMode、follow-up、prompt 构建）
+│   │   └── dm-policy.ts        # 接入控制（dmPolicy、groupPolicy 检查）
+│   │
+│   ├── tools/                  # Tool Registration Layer：工具注册层
+│   │   ├── index.ts            # 注册 infoflow_send、infoflow_recall 工具
+│   │   ├── actions/index.ts    # ChannelMessageActionAdapter（send/delete 动作）
+│   │   └── hooks/index.ts      # before_agent_start hook（注入如流 intro）
+│   │
+│   └── utils/                  # Shared Utilities：共享工具
+│       ├── token-adapter.ts    # SDK TokenManager 适配（appKey/appSecret → token）
+│       └── store/
+│           └── message-store.ts # SQLite 持久化已发消息（用于撤回查询）
+│
+└── tests/                      # 测试文件（镜像 src/ 结构）
+    ├── adapter/
+    ├── channel/
+    ├── handler/
+    ├── tools/
+    └── utils/
+```
+
+### 模块职责边界
+
+| 层 | 职责 | 禁止 |
+|---|---|---|
+| `channel/` | 与 OpenClaw SDK 交互、网络 I/O | 直接处理业务逻辑 |
+| `adapter/` | 消息格式转换，纯函数为主 | 副作用、网络请求 |
+| `handler/` | 事件路由，调用 security/ 决策 | 直接调用如流 API |
+| `security/` | 纯策略判断，无网络 I/O | 发送消息、修改状态 |
+| `tools/` | Tool/Hook 注册 | 包含核心业务逻辑 |
+| `utils/` | 跨层共享工具 | 依赖上层模块 |
+
+---
+
+## 3. 核心数据流
+
+### 3.1 入站消息（Webhook 模式）
+
+```
+如流服务器
+  │  POST /webhook/infoflow
+  ▼
+channel/monitor.ts (handleInfoflowWebhookRequest)
+  │  AES 解密 + checkToken 验证
+  ▼
+adapter/inbound/webhook-parser.ts (parseAndDispatchInfoflowRequest)
+  │  dedup 过滤 + MsgType 路由
+  ▼
+handler/message-handler.ts
+  ├── handlePrivateChatMessage  → security/dm-policy (checkDmPolicy)
+  └── handleGroupChatMessage    → security/dm-policy (checkGroupPolicy)
+                                → security/group-policy (checkBotMentioned, replyMode 判断)
+  │
+  ▼
+handleInfoflowMessage
+  │  resolveGroupConfig → 判断 replyMode / follow-up / watch
+  │  buildAgentEnvelope → 注入历史上下文
+  │  core.channel.reply.dispatchReplyWithBufferedBlockDispatcher (LLM)
+  ▼
+adapter/outbound/reply-dispatcher.ts
+  │  分块、@mention 解析、reply-to 构建
+  ▼
+channel/outbound.ts (sendInfoflowMessage)
+  │  POST 到如流 API
+  ▼
+utils/store/message-store.ts (记录 messageId 用于撤回)
+```
+
+### 3.2 出站消息撤回
+
+```
+LLM → tools/actions/index.ts (action="delete")
+  │  从 message-store 查询 msgseqid
+  ▼
+channel/outbound.ts (recallInfoflowGroupMessage / recallInfoflowPrivateMessage)
+  │  POST /api/v1/robot/group/msgRecall 或 /api/v1/app/message/revoke
+  ▼
+message-store 清理已撤回记录
+```
+
+---
+
+## 4. 配置参数规范
+
+配置路径：`channels.infoflow` 或 `channels.infoflow.accounts.<id>`
+
+### 4.1 基础鉴权参数（必填）
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `checkToken` | string | Webhook 验证 Token（如流企业后台配置） |
+| `encodingAESKey` | string | 消息加密 AES Key（43 位 Base64） |
+| `appKey` | string | 应用 AppKey |
+| `appSecret` | string | 应用 AppSecret |
+| `apiHost` | string | 如流 API 域名，默认 `https://im.baidu.com` |
+
+### 4.2 连接方式
+
+| 参数 | 类型 | 默认 | 说明 |
+|------|------|------|------|
+| `connectionMode` | `"webhook"` \| `"websocket"` | `"webhook"` | 接入方式 |
+| `wsGateway` | string | - | WebSocket Gateway 域名（仅 websocket 模式） |
+
+### 4.3 私聊策略（dmPolicy）
+
+| 值 | 行为 |
+|----|------|
+| `"open"` | 所有用户可发消息（默认） |
+| `"pairing"` | 配对模式，由框架处理（插件仅记录日志） |
+| `"allowlist"` | 仅 `allowFrom` 列表内的 uuapName 可触发 |
+
+```yaml
+channels:
+  infoflow:
+    dmPolicy: allowlist
+    allowFrom:
+      - zhangsan
+      - lisi
+```
+
+### 4.4 群聊策略（groupPolicy）
+
+| 值 | 行为 |
+|----|------|
+| `"open"` | 所有群可触发（默认，**建议修改为 allowlist**） |
+| `"disabled"` | 所有群消息忽略 |
+| `"allowlist"` | 仅 `groupAllowFrom` 内的 groupId 可触发 |
+
+```yaml
+channels:
+  infoflow:
+    groupPolicy: allowlist
+    groupAllowFrom:
+      - "12345678"
+      - "87654321"
+```
+
+### 4.5 群聊触发模式（replyMode）
+
+| 值 | 触发条件 |
+|----|---------|
+| `"mention-only"` | 仅 @机器人时回复（默认），支持 follow-up 窗口 |
+| `"mention-and-watch"` | @机器人 或 @watchMentions 中的人 或 watchRegex 匹配时回复 |
+| `"proactive"` | 所有消息都进入 LLM 判断，由 LLM 决定是否回复 |
+| `"record"` | 仅记录消息到 session，不回复 |
+| `"ignore"` | 完全忽略，不记录不回复 |
+
+可在 account 级别配置，也可在 `groups.<groupId>` 级别覆盖：
+
+```yaml
+channels:
+  infoflow:
+    replyMode: mention-only
+    robotName: "小助手"
+    followUp: true
+    followUpWindow: 300       # 秒，默认 5 分钟
+    watchMentions:
+      - xuejian
+      - zhangsan
+    watchRegex: "上线|发布|故障"
+    groups:
+      "12345678":
+        replyMode: proactive   # 该群单独配置为 proactive
+        systemPrompt: "你是该群的专属助手，聚焦代码 review 相关问题"
+```
+
+### 4.6 其他配置
+
+| 参数 | 类型 | 默认 | 说明 |
+|------|------|------|------|
+| `robotName` | string | - | 机器人名称，用于识别 @机器人 |
+| `processingHint` | boolean | `true` | LLM 超时后发送 "⏳ 处理中..." 提示 |
+| `processingHintDelay` | number | `5` | 提示延迟秒数 |
+| `dmMessageFormat` | `"text"` \| `"markdown"` | `"text"` | 私聊消息格式 |
+| `groupMessageFormat` | `"text"` \| `"markdown"` | `"text"` | 群聊消息格式（markdown 不支持 reply-to） |
+| `appAgentId` | number | - | 应用 AgentId（私聊消息撤回依赖此字段） |
+
+---
+
+## 5. 如流 API 接口
+
+### 5.1 API 路径常量（`src/channel/outbound.ts`）
+
+```typescript
+INFOFLOW_PRIVATE_SEND_PATH  = "/api/v1/app/message/send"
+INFOFLOW_GROUP_SEND_PATH    = "/api/v1/robot/msg/groupmsgsend"
+INFOFLOW_GROUP_RECALL_PATH  = "/api/v1/robot/group/msgRecall"
+INFOFLOW_PRIVATE_RECALL_PATH = "/api/v1/app/message/revoke"
+```
+
+### 5.2 鉴权方式
+
+使用 `utils/token-adapter.ts` 中的 `getOrCreateAdapter(account)` 获取 token，自动处理 appKey/appSecret 换取 access_token 及缓存刷新。
+
+**不要直接在业务代码中手动构造鉴权 Header**，统一通过 `sendInfoflowMessage` 函数发送。
+
+### 5.3 发送消息
+
+```typescript
+import { sendInfoflowMessage } from "../channel/outbound.js";
+
+await sendInfoflowMessage({
+  cfg,
+  to: "username",           // 私聊：uuapName；群聊：group:<groupId>
+  contents: [
+    { type: "text", content: "Hello" },
+    { type: "markdown", content: "**Bold**" },
+    { type: "at", content: "zhangsan" },       // @人
+    { type: "at-agent", content: "123456" },   // @机器人（robotid）
+    { type: "link", content: "[标题]https://..." },
+    { type: "image", content: "<base64>" },
+  ],
+  accountId: account.accountId,
+  replyTo: {               // 可选，群聊引用回复
+    messageid: "...",
+    preview: "被引用的消息摘要",
+    imid: "...",           // 发送者数字 ID
+    replytype: "2",        // "1"=reply, "2"=quote
+  },
+  atOptions: {             // 可选，群聊 @
+    atAll: false,
+    atUserIds: ["zhangsan", "lisi"],
+  },
+});
+```
+
+### 5.4 消息撤回
+
+```typescript
+// 群消息撤回（需要 msgseqid）
+await recallInfoflowGroupMessage({
+  account,
+  groupId: 12345678,
+  messageid: "消息ID",
+  msgseqid: "消息序号ID",
+});
+
+// 私聊消息撤回（需要 appAgentId）
+await recallInfoflowPrivateMessage({
+  account,
+  toUser: "zhangsan",
+  msgKey: "消息key",
+});
+```
+
+**注意**：撤回群消息必须同时提供 `messageid` 和 `msgseqid`，`msgseqid` 通过 `utils/store/message-store.ts` 的 `findSentMessage` 查询。
+
+---
+
+## 6. 消息格式规范
+
+### 6.1 入站消息字段提取
+
+群消息结构嵌套较深，取字段需注意优先级：
+
+```typescript
+// 发送者 ID：header 优先
+const fromuser = String(header?.fromuserid ?? msgData.fromuserid ?? "");
+
+// 发送者数字 imid（用于 reply-to）
+const senderImid = msgData.fromid ?? header?.imid ?? header?.fromimid;
+
+// 消息 ID（防重放 + 撤回）
+const messageId = header?.messageid ?? header?.msgid ?? msgData.MsgId;
+
+// GroupId
+const rawGroupId = msgData.groupid ?? header?.groupid;
+const groupid = typeof rawGroupId === "number" ? rawGroupId : Number(rawGroupId);
+```
+
+### 6.2 Body 类型
+
+入站群消息 body 为数组，每个 item 的 `type` 含义：
+
+| type | 含义 |
+|------|------|
+| `"TEXT"` | 文本内容，取 `content` |
+| `"AT"` | @mention，机器人有 `robotid`（number），人有 `userid`（string） |
+| `"LINK"` | 链接，取 `label` 作为显示文本 |
+| `"IMAGE"` | 图片，取 `downloadurl` 下载 |
+| `"replyData"` | 引用回复，取 `content` 作为被引用消息文本 |
+
+**提取消息文本时，AT 元素不计入 `mes`（CommandBody），但计入 `rawMes`（RawBody）**。
+
+### 6.3 大整数处理
+
+如流 API 返回的 `messageid` / `msgseqid` 为 64 位整数，超过 JS 安全整数范围。**必须用字符串保存**，不要用 `JSON.parse` 后的数字类型。使用 `extractIdFromRawJson` 从原始 JSON 字符串中提取：
+
+```typescript
+import { extractIdFromRawJson } from "../channel/outbound.js";
+const messageId = extractIdFromRawJson(rawJsonText, "messageid");
+```
+
+---
+
+## 7. 安全策略模块
+
+所有安全判断集中在 `src/security/`，**不要在 handler 或 channel 层内联策略代码**。
+
+### 7.1 接入控制（`dm-policy.ts`）
+
+```typescript
+import { checkDmPolicy, checkGroupPolicy } from "../security/dm-policy.js";
+
+// 私聊
+const result = checkDmPolicy(account, fromuser);
+if (!result.allowed) { /* 拒绝，发送无权限提示 */ return; }
+
+// 群聊
+const result = checkGroupPolicy(account, groupId, wasMentioned);
+if (!result.allowed) {
+  if (result.reason === "allowlist-rejected" && result.wasMentioned) {
+    // 仅 @机器人时才发无权限提示，避免在无关群刷屏
+  }
+  return;
+}
+```
+
+### 7.2 群聊触发判断（`group-policy.ts`）
+
+```typescript
+import {
+  checkBotMentioned,      // 机器人是否被 @
+  checkWatchMentioned,    // watchMentions 中的人是否被 @
+  checkWatchRegex,        // 消息内容是否匹配 watchRegex
+  extractMentionIds,      // 提取所有非机器人 @mention
+  resolveGroupConfig,     // 合并 account 级 + group 级配置
+  isWithinFollowUpWindow, // 是否在 follow-up 窗口内
+  recordGroupReply,       // 记录机器人回复时间
+} from "../security/group-policy.js";
+```
+
+### 7.3 条件回复 Prompt
+
+当触发 watch/follow-up/proactive 时，向 LLM 注入特殊 `GroupSystemPrompt`，要求不确定时输出 `NO_REPLY`：
+
+```typescript
+import {
+  buildWatchMentionPrompt,  // watchMentions 触发
+  buildWatchRegexPrompt,    // watchRegex 触发
+  buildFollowUpPrompt,      // follow-up 窗口触发
+  buildProactivePrompt,     // proactive 模式
+} from "../security/group-policy.js";
+
+ctxPayload.GroupSystemPrompt = buildWatchMentionPrompt(matchedId);
+```
+
+**LLM 输出 `NO_REPLY` 时，reply-dispatcher 不发送任何消息。**
+
+---
+
+## 8. 工具与 Hook 开发
+
+### 8.1 注册工具
+
+在 `src/tools/index.ts` 中通过 `api.registerTool` 注册，工具在 `src/tools/actions/` 中实现：
+
+```typescript
+// src/tools/index.ts
+export function registerInfoflowTools(api: OpenClawPluginApi): void {
+  api.registerTool({
+    name: "infoflow_send",
+    description: "...",
+    inputSchema: { /* JSON Schema */ },
+    handler: async (params, ctx) => { ... },
+  });
+}
+```
+
+### 8.2 注册 Hook
+
+```typescript
+// src/tools/hooks/index.ts
+export function registerInfoflowHooks(api: OpenClawPluginApi): void {
+  api.registerHook("before_agent_start", async (ctx) => {
+    // 在 LLM 开始前注入上下文
+    ctx.systemPrompt += "\n\n...";
+  });
+}
+```
+
+### 8.3 ChannelMessageActionAdapter
+
+`src/tools/actions/index.ts` 实现 `ChannelMessageActionAdapter`，拦截 message tool 的 `send` 和 `delete` 动作，添加如流特有的 @mention、reply-to、撤回逻辑。
+
+新增动作时：
+1. 在 `listActions()` 中声明
+2. 在 `handleAction()` 中用 `if (action === "xxx")` 处理
+3. 返回 `jsonResult({ ok, channel, ... })`
+
+---
+
+## 9. 测试规范
+
+### 9.1 测试框架
+
+使用 **vitest**，配置在 `package.json`。
+
+```bash
+npm test           # 运行全部测试
+npm test -- --watch  # 监听模式
+```
+
+### 9.2 目录规则
+
+测试文件放在 `tests/` 下，**镜像 `src/` 结构**：
+
+```
+src/security/group-policy.ts
+→ tests/security/group-policy.test.ts
+
+src/channel/outbound.ts
+→ tests/channel/outbound.test.ts
+```
+
+### 9.3 Mock 规范
+
+`vi.mock` 路径必须使用 `.js` 扩展名（ESM 规范）：
+
+```typescript
+import { describe, it, expect, vi } from "vitest";
+
+vi.mock("../../src/channel/outbound.js", () => ({
+  sendInfoflowMessage: vi.fn().mockResolvedValue({ ok: true }),
+}));
+```
+
+### 9.4 测试要求
+
+- **新增公共函数**必须有对应单测，核心逻辑覆盖率不低于 80%
+- `security/` 中的策略函数（纯函数）要求覆盖所有分支
+- 涉及网络请求的函数（`sendInfoflowMessage` 等）通过 mock 测试，不真实发请求
+
+---
+
+## 10. 开发工作流
+
+### 10.1 本地开发
+
+```bash
+# 1. 安装依赖
+npm install
+
+# 2. 同步到 openclaw extensions 目录
+rsync -av --delete . ~/.openclaw/extensions/infoflow/ \
+  --exclude node_modules --exclude dist --exclude .git
+
+# 3. 重启 openclaw gateway（热加载）
+pkill -f "openclaw" && nohup openclaw gateway > /tmp/openclaw.log 2>&1 &
+
+# 4. 查看实时日志
+tail -f /tmp/openclaw.log
+```
+
+### 10.2 静态检查
+
+项目无 `tsc` 可执行文件，使用 Python 脚本验证 import 路径：
+
+```bash
+python3 << 'EOF'
+import os, re
+src_root = "src"
+errors = []
+for dirpath, _, filenames in os.walk(src_root):
+    for fname in filenames:
+        if not fname.endswith(".ts"): continue
+        fpath = os.path.join(dirpath, fname)
+        with open(fpath) as f:
+            lines = f.readlines()
+        for i, line in enumerate(lines, 1):
+            m = re.search(r'from\s+"(\.\.?/[^"]+\.js)"', line)
+            if not m: continue
+            ts = os.path.normpath(os.path.join(dirpath, m.group(1).replace(".js", ".ts")))
+            if not os.path.exists(ts):
+                errors.append(f"{fpath}:{i}: {m.group(1)} NOT FOUND")
+print("OK" if not errors else "\n".join(errors))
+EOF
+```
+
+### 10.3 提交规范
+
+- commit message 必须包含 iCafe 卡片 ID（格式：`so-cli-XXXXX`）
+- 推送命令：`git push origin HEAD:refs/for/master`
+- CR 地址格式：`http://icode.baidu.com/myreview/changes/c/baidu/hi/openclaw_infoflow/+/<id>`
+
+```bash
+git commit -m "feat: 添加 xxx 功能
+
+so-cli-XXXXX
+
+Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>"
+
+git push origin HEAD:refs/for/master
+```
+
+### 10.4 import 规范
+
+TypeScript 文件中 import 路径**必须使用 `.js` 扩展名**（ESM 运行时要求）：
+
+```typescript
+// ✅ 正确
+import { sendInfoflowMessage } from "../channel/outbound.js";
+
+// ❌ 错误
+import { sendInfoflowMessage } from "../channel/outbound";
+```
+
+---
+
+## 11. 常见问题与注意事项
+
+### 11.1 消息 ID 精度丢失
+
+**问题**：如流消息 ID 为 64 位整数，`JSON.parse` 后精度丢失（超过 `Number.MAX_SAFE_INTEGER`）。
+
+**解决**：使用 `extractIdFromRawJson(rawText, "messageid")` 从原始字符串中提取，以字符串形式存储和传递。
+
+### 11.2 群消息撤回需要 msgseqid
+
+**问题**：群消息撤回 API 要求同时提供 `messageid` 和 `msgseqid`，而 `msgseqid` 只在发送响应中返回。
+
+**解决**：所有出站消息都通过 `utils/store/message-store.ts` 持久化（SQLite），撤回时用 `findSentMessage(accountId, messageId)` 查询。
+
+### 11.3 HTTPS 强制
+
+`ensureHttps(apiHost)` 会自动将 HTTP 升级为 HTTPS（localhost 除外）。配置 `apiHost` 时无论写 HTTP 还是 HTTPS，发请求都会用 HTTPS。
+
+### 11.4 群消息 markdown 不支持 reply-to
+
+`groupMessageFormat: "markdown"` 时，消息体为 markdown 格式，但如流 API 的 markdown 消息**不支持 reply-to（引用回复）**，reply-dispatcher 会自动忽略 `replyTo` 字段。
+
+### 11.5 proactive / watchRegex 模式注意频率
+
+`proactive` 模式下所有群消息都会进入 LLM 判断，对高频群建议搭配 `watchRegex` 过滤。LLM 返回 `NO_REPLY` 时插件不发送任何内容。
+
+### 11.6 WebSocket 模式
+
+设置 `connectionMode: "websocket"` 时需额外配置 `wsGateway` 域名。WebSocket 模式由 `adapter/inbound/ws-receiver.ts` 处理，与 Webhook 模式共享 `webhook-parser.ts` 的消息分发和 dedup 逻辑。
+
+### 11.7 新增配置字段
+
+如需新增配置字段，按以下步骤操作：
+1. 在 `src/types.ts` 的 `InfoflowAccountConfig` 和 `ResolvedInfoflowAccount.config` 中同步添加
+2. 在 `src/channel/accounts.ts` 的 `resolveInfoflowAccount` 中传递该字段
+3. 如果是群粒度配置，同步更新 `InfoflowGroupConfig` 和 `security/group-policy.ts` 的 `resolveGroupConfig`

package/index.ts

@@ -0,0 +1,29 @@
+import { emptyPluginConfigSchema, type OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { infoflowPlugin } from "./src/channel/channel.js";
+import { handleInfoflowWebhookRequest } from "./src/channel/monitor.js";
+import { setInfoflowRuntime } from "./src/runtime.js";
+import { registerInfoflowTools } from "./src/tools/index.js";
+import { registerInfoflowHooks } from "./src/tools/hooks/index.js";
+import { registerStoreListeners } from "./src/utils/store/message-store.js";
+
+const plugin = {
+  id: "infoflow",
+  name: "Infoflow",
+  description: "OpenClaw Infoflow channel plugin",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setInfoflowRuntime(api.runtime);
+    api.registerChannel({ plugin: infoflowPlugin });
+    api.registerHttpRoute({
+      path: "/webhook/infoflow",
+      auth: "plugin",
+      match: "exact",
+      handler: handleInfoflowWebhookRequest,
+    });
+    registerInfoflowTools(api);
+    registerInfoflowHooks(api);
+    registerStoreListeners();
+  },
+};
+
+export default plugin;