@imweapp/openclaw-imwe 2026.4.12-alpha.1

package/proto/PbMsgReadStampContent.proto

@@ -0,0 +1,11 @@
+// PbMsgReadStampContent.proto — 消息已读发送内容
+
+syntax = "proto3";
+
+package proto;
+
+// 消息已读 - 发送内容
+message PbMsgReadStampSendContent {
+  repeated string clientMsgIds = 1;
+  int64 readStamp = 2;
+}

package/proto/PbPacket.proto

@@ -0,0 +1,61 @@
+// PbPacket.proto — 通用长连接通道协议（业务无关）
+//
+// 来源：im_proto/MsgCore/PbPacket.proto（原样拷贝，仅保留插件所需部分）
+// 插件只处理 SERVER_REQ（type=2）方向的入站消息，
+// 以及 CLIENT_REQ（type=0）方向的出站发送请求。
+//
+// 设计原则：
+//   1. envelope 只承载路由 + 元信息，不携带任何业务字段
+//   2. body 是不透明字节流（业务自己 protobuf 序列化），通道层不解析
+//   3. 业务字段通过 headers 携带，命名约定 x-<module>-<key>，例如：
+//        x-im-acct-id  : IM 账号 ID（仅 IM 业务使用，分身场景传递）
+//        x-im-box-id   : IM 事件箱 ID（仅 IM 业务使用）
+//        x-im-box-seq  : IM 事件箱序列号（仅 IM 业务使用，用于同步）
+//   4. 业务模块各自负责 body 的编解码，通道层不依赖任何业务 .proto
+
+syntax = "proto3";
+
+package proto;
+
+// golang的编译选项
+option go_package = "./;proto";
+// java编译选项
+option java_outer_classname = "PbPacketProto";
+option java_package = "com.imwe.im.proto";
+
+enum PbType {
+  CLIENT_REQ = 0; // client 请求
+  SERVER_RSP = 1; // server 响应
+  SERVER_REQ = 2; // server 主动推送（用于服务端投递事件）
+  CLIENT_RSP = 3; // client 响应（暂未使用）
+}
+
+message PbPacket {
+  PbType type = 1; // 数据包类型
+  optional PbRequest request = 2; // 请求体
+  optional PbResponse response = 3; // 响应体
+}
+
+message PbRequest {
+  string path = 1; // 请求路径，按业务命名空间约定（/im/... · /wallet/... · /sys/...）
+  string reqId = 2; // 请求 ID
+  int64 reqStamp = 3; // 请求发起时间
+  optional bytes body = 4; // 业务 protobuf 二进制，按 path 由业务自行解码
+  map<string, string> headers = 5; // 业务字段 / 元信息（参见文件头注释）
+}
+
+message PbResponse {
+  string orgPath = 1; // 原始请求路径
+  string orgReqId = 2; // 原始请求 ID
+  int64 orgReqStamp = 3; // 原始请求发起时间
+  int64 rspStamp = 4; // 响应时间
+  int64 statusCode = 5; // 状态码（HTTP 语义）
+  optional bytes body = 6; // 业务 protobuf 二进制，按 orgPath 由业务自行解码
+  map<string, string> headers = 7; // 响应元信息
+}
+
+// Pull 消息列表
+message PbPacketList {
+  string lastUpdateTime = 1;   // 更新的游标
+  repeated PbRequest list = 2; // 消息列表
+}

package/proto/PbSingleChatMsg.proto

@@ -0,0 +1,60 @@
+// PbSingleChatMsg.proto — 单聊消息请求体
+//
+// 来源：im_proto/Core/PbSingleChatMsg.proto（精简拷贝，仅保留插件所需消息）
+// 插件发送单聊文字消息时，将 PbSingleChatMsgReqBody 编码后放入
+// PbRequest.body，再包装进 PbPacket(CLIENT_REQ) 发送给平台。
+
+syntax = "proto3";
+
+package proto;
+
+option java_outer_classname = "SingleChatProto";
+option java_package = "com.imwe.im.proto";
+
+// 单聊消息请求（客户端发送消息时使用）
+message PbSingleChatMsgReqBody {
+  string fromId = 1;            // 发送方Id（由平台从AppKey解析，可传空）
+  string toId = 2;              // 接收方Id
+  optional string winId = 3;    // 密聊窗口id
+  string clientMsgId = 4;       // 客户端消息id（用于去重和响应匹配）
+  int64 clientStamp = 5;        // 客户端消息时间戳
+  int64 envelopeType = 6;       // 信封类型：1-聊天加密类型信封，2-操作内容信封，3-支付内容信封
+  optional string fromE2eeId = 7; // 发送方端对端设备id
+  bool e2eeFlag = 8;            // 消息端对端加密标识（插件使用false，不加密）
+  bytes envelope = 9;           // 信封内容（e2eeFlag=false时为PbChatMsgEnvelope的bytes）
+
+  optional int64 msgAutoDeleteInterval = 10; // 自动删除时间配置
+  optional int64 msgTimingDeleteStamp = 11;  // 定时删除时间
+  optional bool offlinePush = 12;            // 离线推送开关，仅为true时开启离线通知
+
+  optional int64 envelopeSubType = 13;       // 信封子类型
+  optional bool needOfflinePassThrough = 14; // 离线推送消息是否需要透传
+  optional bool boldNotify = 15;             // 提醒加粗
+
+  optional int32 convType = 16; // 会话类型，单聊/闪聊等
+}
+
+// ── E2EE 单聊加密装箱结构（e2eeFlag=true 时使用）──
+// 出站：对端每台设备的密文装进 PbSingleChatDeviceMsg，
+// 同一联系人的多台设备聚合到 PbSingleChatMsgRecipient，
+// 再多联系人聚合到 PbSingleChatMsgRecipients，序列化为
+// PbSingleChatMsgReqBody.envelope 的 bytes。
+
+// 单设备密文条目
+message PbSingleChatDeviceMsg {
+  string toE2eeId = 1;           // 接收方设备 e2eeId（= 对端 Account.curve25519Key()）
+  string e2eeSid = 2;             // 发送本条消息时使用的 Session.sessionId()
+  bytes envelope = 3;             // vodozemac EncryptedMessage.body（OlmMessage JSON bytes）
+  optional bool boldNotify = 4;   // 提醒加粗（透传 PbSingleChatMsgReqBody.boldNotify 语义）
+}
+
+// 同一对端 imAcctId 的多设备分发
+message PbSingleChatMsgRecipient {
+  string acctId = 1;                        // 对端 imAcctId
+  repeated PbSingleChatDeviceMsg msgs = 2;  // 该联系人下每台活跃设备一份密文
+}
+
+// 最外层：所有联系人的设备分发集合
+message PbSingleChatMsgRecipients {
+  repeated PbSingleChatMsgRecipient recipients = 1;
+}

package/setup-entry.ts

@@ -0,0 +1,17 @@
+/**
+ * setup-entry.ts — 轻量入口（setup-only 模式）
+ *
+ * 当渠道未配置或被禁用时，core 加载这个文件而不是 index.ts。
+ * defineSetupPluginEntry 只暴露 ChannelPlugin 对象（用于 setup wizard），
+ * 不注入 runtime，不注册 CLI，不加载任何运行时代码。
+ *
+ * 这样做的好处：
+ *   - 节省内存：不加载 monitor.ts、api-client.ts 等重量级模块
+ *   - 加快启动：setup 流程不需要建立网络连接
+ *   - 安全隔离：未配置的渠道不会尝试连接平台
+ */
+
+import { defineSetupPluginEntry } from 'openclaw/plugin-sdk/channel-core';
+import { imwePlugin } from './src/channel.js';
+
+export default defineSetupPluginEntry(imwePlugin);

package/src/accounts.ts

@@ -0,0 +1,109 @@
+/**
+ * accounts.ts — 账号解析逻辑
+ *
+ * 职责：
+ *   - 从 OpenClawConfig 中读取 imwe 渠道配置
+ *   - 合并顶层默认值与账号级配置（多账号继承）
+ *   - 解析 appKey / appSecret（优先级：账号级 config > 顶层 config > 环境变量）
+ *   - 导出 listImweAccountIds / resolveImweAccount 供 ChannelConfigAdapter 使用
+ */
+
+import {
+  createAccountListHelpers,
+  resolveMergedAccountConfig,
+} from 'openclaw/plugin-sdk/account-helpers';
+import { normalizeAccountId } from 'openclaw/plugin-sdk/account-id';
+import type { OpenClawConfig } from 'openclaw/plugin-sdk/config-runtime';
+import type { ImweAccountConfig, ImweConfig, ResolvedImweAccount } from './types.js';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 账号 id 列表工具
+// ─────────────────────────────────────────────────────────────────────────────
+
+const { listAccountIds: listImweAccountIds, resolveDefaultAccountId: resolveDefaultImweAccountId } =
+  createAccountListHelpers('imwe');
+
+export { listImweAccountIds, resolveDefaultImweAccountId };
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 配置合并
+// ─────────────────────────────────────────────────────────────────────────────
+
+function mergeImweAccountConfig(cfg: OpenClawConfig, accountId: string): ImweAccountConfig {
+  return resolveMergedAccountConfig<ImweAccountConfig>({
+    channelConfig: cfg.channels?.imwe as ImweAccountConfig | undefined,
+    accounts: (cfg.channels?.imwe as ImweConfig | undefined)?.accounts as
+      | Record<string, Partial<ImweAccountConfig>>
+      | undefined,
+    accountId,
+    omitKeys: ['defaultAccount'],
+  });
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 凭证解析：优先级 账号级 config > 顶层 config > 环境变量
+// ─────────────────────────────────────────────────────────────────────────────
+
+function resolveImweCredentials(
+  merged: ImweAccountConfig,
+  accountId: string,
+): { appKey: string; appSecret: string; source: ResolvedImweAccount['credentialSource'] } {
+  // 1. config 里的 appKey + appSecret
+  if (merged.appKey?.trim() && merged.appSecret?.trim()) {
+    return {
+      appKey: merged.appKey.trim(),
+      appSecret: merged.appSecret.trim(),
+      source: 'config',
+    };
+  }
+
+  // 2. 环境变量（仅 default 账号，避免多账号混用同一组 env）
+  if (normalizeAccountId(accountId) === 'default') {
+    const envKey = process.env.IMWE_APP_KEY?.trim();
+    const envSecret = process.env.IMWE_APP_SECRET?.trim();
+    if (envKey && envSecret) {
+      return { appKey: envKey, appSecret: envSecret, source: 'env' };
+    }
+  }
+
+  return { appKey: '', appSecret: '', source: 'none' };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// 主解析函数
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function resolveImweAccount(params: {
+  cfg: OpenClawConfig;
+  accountId?: string | null;
+}): ResolvedImweAccount {
+  const accountId =
+    normalizeAccountId(params.accountId) ??
+    normalizeAccountId((params.cfg.channels?.imwe as ImweConfig | undefined)?.defaultAccount) ??
+    'default';
+
+  const baseEnabled = (params.cfg.channels?.imwe as ImweConfig | undefined)?.enabled !== false;
+  const merged = mergeImweAccountConfig(params.cfg, accountId);
+  const accountEnabled = merged.enabled !== false;
+
+  const { appKey, appSecret, source } = resolveImweCredentials(merged, accountId);
+
+  const apiBaseUrl = merged.apiBaseUrl?.trim() || process.env.IMWE_API_BASE_URL?.trim() || '';
+
+  return {
+    accountId,
+    name: merged.name,
+    enabled: baseEnabled && accountEnabled,
+    apiBaseUrl,
+    appKey,
+    appSecret,
+    credentialSource: source,
+    config: merged,
+  };
+}
+
+export function listEnabledImweAccounts(cfg: OpenClawConfig): ResolvedImweAccount[] {
+  return listImweAccountIds(cfg)
+    .map((accountId) => resolveImweAccount({ cfg, accountId }))
+    .filter((account) => account.enabled);
+}