@imweapp/openclaw-imwe 2026.4.12-alpha.1 → 2026.4.12-alpha.2

package/README.md

@@ -2,73 +2,6 @@
 
 imwe 即时通讯渠道插件，AppKey/AppSecret HMAC-SHA256 签名认证，支持多账号、私聊文字消息。
 
-## 目录结构
-
-```
-extensions/imwe/
-├── proto/                        # Protobuf 消息定义（语言无关的契约文件）
-│   ├── PbPacket.proto            # 传输层：PbPacket / PbRequest / PbResponse
-│   ├── PbChatDeliverMsg.proto    # 投递层：PbChatMsgDeliverBody
-│   ├── PbChatMsg.proto           # 信封层：PbChatMsgEnvelope / PbMsgRspBody
-│   ├── PbChatTextContent.proto   # 内容层：PbChatTextContent / BodyRange
-│   ├── PbSingleChatMsg.proto     # 发送层：PbSingleChatMsgReqBody
-│   └── PbBoxPullProto.proto      # 事件箱：PbBoxPullReq / PbBoxPullRsp
-├── index.ts                      # 插件主入口（defineChannelPluginEntry）
-├── setup-entry.ts                # 轻量入口（setup-only 模式）
-├── package.json                  # npm 包配置
-└── src/
-    ├── proto/                    # Protobuf 编解码层（TypeScript）
-    │   ├── codec.ts              # encode/decode 统一导出入口
-    │   ├── registry.ts           # protobufjs 类型注册表（单例）
-    │   ├── proto-types.ts        # decode 结果的 TypeScript 接口（仅用于类型断言）
-    │   ├── inbound.codec.ts      # 入站消息四层解包
-    │   └── send.codec.ts         # 出站消息编码 + 发送响应解码
-    ├── types.ts                  # 类型定义（三层：Config / ImweConfig / ResolvedAccount）
-    ├── accounts.ts               # 账号解析（listAccountIds / resolveImweAccount）
-    ├── config-schema.ts          # Zod 配置 schema
-    ├── api-client.ts             # HTTP API 客户端（签名 + protobuf 传输）
-    ├── monitor.ts                # 事件箱短轮询消息监听器
-    ├── send.ts                   # 发送文字消息（outbound 适配器入口）
-    ├── setup-core.ts             # setup 适配器（openclaw setup imwe）
-    ├── channel.ts                # ChannelPlugin 主对象（组装所有适配器）
-    └── channel.runtime.ts        # 运行时模块统一导出（懒加载目标）
-```
-
-## 认证方式
-
-每次 HTTP 请求携带以下签名头（对应文档 §1）：
-
-```
-X-Api-Key:   <appKey>
-X-Timestamp: <毫秒时间戳>
-X-Signature: Base64(HMAC-SHA256(appSecret, signString))
-```
-
-签名原文（signString）：
-
-```
-{METHOD}&{PATH}&{TIMESTAMP}&{BODY_HASH}
-```
-
-- `METHOD`：HTTP 方法大写，固定为 `POST`
-- `PATH`：请求路径，如 `/api/im/open/bot/sendMessage`
-- `TIMESTAMP`：与 `X-Timestamp` 相同的毫秒时间戳字符串
-- `BODY_HASH`：`hex(SHA-256(body))`，body 为空时对空字符串 `""` 哈希
-
-无需登录流程，无需持久化任何凭证，AppKey/AppSecret 写入 config 即可。
-
-## 数据流
-
-```
-用户消息
-  → imwe 平台
-    → monitor.ts (long polling POST /messages/poll)
-      → channelRuntime.reply.dispatchReply(...)
-        → OpenClaw AI 推理
-          → outbound.sendText(...)
-            → api-client.sendTextMessage (POST /messages/send + HMAC 签名)
-              → imwe 平台 → 用户
-```
 
 ## 配置示例
 
@@ -81,7 +14,10 @@ X-Signature: Base64(HMAC-SHA256(appSecret, signString))
       "apiBaseUrl": "https://api.imwe.example.com",
       "appKey": "your-app-key",
       "appSecret": "your-app-secret",
-      "dmPolicy": "pairing"
+      "dmPolicy": "open",
+      "allowFrom": [
+        "*"
+      ],
     }
   }
 }
@@ -94,18 +30,25 @@ X-Signature: Base64(HMAC-SHA256(appSecret, signString))
   "channels": {
     "imwe": {
       "apiBaseUrl": "https://api.imwe.example.com",
-      "defaultAccount": "bot1",
+      "defaultAccount": "default",
       "accounts": {
-        "bot1": {
-          "appKey": "key-a",
-          "appSecret": "secret-a",
-          "dmPolicy": "pairing"
+        "default": {
+          "apiBaseUrl": "https://api.imwe.example.com",
+          "appKey": "your-app-key",
+          "appSecret": "your-app-secret",
+          "dmPolicy": "open",
+          "allowFrom": [
+            "*"
+          ],
         },
         "bot2": {
-          "appKey": "key-b",
-          "appSecret": "secret-b",
-          "dmPolicy": "allowlist",
-          "allowFrom": ["123456"]
+          "apiBaseUrl": "https://api.imwe.example.com",
+          "appKey": "your-app-key",
+          "appSecret": "your-app-secret",
+          "dmPolicy": "open",
+          "allowFrom": [
+            "*"
+          ],
         }
       }
     }
@@ -121,52 +64,4 @@ IMWE_APP_KEY=your-app-key
 IMWE_APP_SECRET=your-app-secret
 ```
 
-## E2EE 端到端加密
-
-单聊消息默认启用 E2EE（端到端加密），与 imwe iOS 客户端完全互通。无需额外配置，插件启动时自动完成密钥协商。
-
-### 安全边界
-
-- **加密范围**：单聊文本 / Markdown / 媒体消息的 `PbChatMsgEnvelope`（含 URL、caption、blurHash 等元数据）均经 E2EE 加密
-- **不在加密范围内**：媒体文件正文（CDN 资源本身以明文上传/下载，仅信令层走 E2EE）；typing signal 保持明文
-- 加解密失败时消息**不会降级为明文**发送或投递
-
-### 本地状态
-
-首次启动时，插件会在以下路径创建 E2EE 状态目录：
-
-```
-~/.openclaw/channel-data/imwe/<accountId>/e2ee/
-├── state.json          # 密钥、session、PreKey 批次等持久化状态
-├── state.json.tmp      # 两阶段写临时文件
-└── state.lock          # proper-lockfile 进程锁
-```
-
-`state.json` 损坏时会自动重命名为 `state.json.corrupt-<timestamp>` 并重新 bootstrap。
-
-### Mock Server（开发/测试）
-
-项目提供了一个轻量 mock E2EE 服务端，用于本地开发与集成测试：
-
-```bash
-# 启动（默认端口 3456）
-node tests/mock-server/server.js
-
-# 自定义端口
-PORT=4000 node tests/mock-server/server.js
-```
-
-mock server 覆盖 `getMe` / `pullMessages` / `sendMessage` + 5 个 E2EE 端点（create / replenish / apply / queryRequireNum / query），状态机行为详见 `tests/mock-server/README.md`。
-
-在集成测试中可 programmatic 引入：
-
-```js
-import { server, PORT, resetState } from './tests/mock-server/server.js';
-```
-
 ## 安装与配置
-
-```bash
-openclaw plugins install @openclaw/imwe
-openclaw setup imwe --http-url https://api.imwe.example.com --token <appKey> --private-key <appSecret>
-```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imweapp/openclaw-imwe",
-  "version": "2026.4.12-alpha.1",
+  "version": "2026.4.12-alpha.2",
   "description": "OpenClaw imwe 渠道插件 —— AppKey/AppSecret 签名认证，支持多账号、私聊文字消息",
   "type": "module",
   "publishConfig": {
@@ -69,5 +69,5 @@
       "pluginApi": ">=2026.4.11"
     }
   },
-  "gitHead": "0feb00ac2bc3a2bbd3e7a5ade033c5319f574a68"
+  "gitHead": "a47db5b9829b4e94f68a7016f024164faa6e09ad"
 }

package/src/send.ts

@@ -211,14 +211,15 @@ async function encryptAndSendWithRetry(
     return await encryptAndSend(outbound, to, envelopeBytes, clientMsgId);
   } catch (err) {
     if (err instanceof DeviceNotMatchError && outbound.e2eeService) {
-      // DEVICE_NOT_MATCH 重试：handleDeviceNotMatch → 用同 clientMsgId 重发一次
+      // DEVICE_NOT_MATCH 重试：handleDeviceNotMatch → 生成新 clientMsgId 重发一次
+      const retryClientMsgId = genClientMsgId();
       outbound.log?.info?.(
-        `${prefix}: DEVICE_NOT_MATCH，执行单次重试, to=${to}, clientMsgId=${clientMsgId}, errData=${JSON.stringify(err.data)}`,
+        `${prefix}: DEVICE_NOT_MATCH，执行单次重试, to=${to}, oldClientMsgId=${clientMsgId}, newClientMsgId=${retryClientMsgId}, errData=${JSON.stringify(err.data)}`,
       );
       await outbound.e2eeService.handleDeviceNotMatch(err.data);
-      const result = await encryptAndSend(outbound, to, envelopeBytes, clientMsgId);
+      const result = await encryptAndSend(outbound, to, envelopeBytes, retryClientMsgId);
       outbound.log?.info?.(
-        `${prefix}: DEVICE_NOT_MATCH 重试成功, to=${to}, clientMsgId=${clientMsgId}`,
+        `${prefix}: DEVICE_NOT_MATCH 重试成功, to=${to}, clientMsgId=${retryClientMsgId}`,
       );
       return result;
     }