@xgjktech/xg_cwork_im 1.0.5 → 1.0.7

package/README.md

@@ -1,6 +1,6 @@
 # XG CWork IM Channel for OpenClaw
 
-小橙工作台 IM 机器人 Channel 插件，通过 WebSocket 长连接接收 `@` 消息，由 OpenClaw AI 处理后自动回复。
+工作说说 IM 机器人 Channel 插件，通过 WebSocket 长连接接收 `@` 消息，由 OpenClaw AI 处理后自动回复。
 
 ## 工作原理
 
@@ -126,7 +126,7 @@ openclaw plugins enable xg_cwork_im
 
 ### 步骤 2：配置 Channel 账户信息
 
-编辑 `~/.openclaw/openclaw.json`，添加以下配置：
+编辑 `~/.openclaw/openclaw.json`，添加以下配置（推荐 `accounts` 使用对象 map，key 即 `accountId`）：
 
 ```json
 {
@@ -134,15 +134,17 @@ openclaw plugins enable xg_cwork_im
     "xg_cwork_im": {
       "baseUrl": "https://cwork-web-test.xgjktech.com.cn",
       "wsBaseUrl": "wss://cwork-web-test.xgjktech.com.cn",
-      "accounts": [
-        { "appKey": "你的机器人 appKey", "agentId": "main", "name": "个人助手" }
-      ]
+      "accounts": {
+        "main": { "appKey": "你的机器人 appKey", "agentId": "main", "name": "个人助手" }
+      }
     }
   }
 }
 ```
 
-> **多账户**：如有多个机器人，在 `accounts` 数组里继续追加即可，每个账户可指定不同的 `agentId` 对应不同的 OpenClaw Agent。
+> **多账户**：如有多个机器人，在 `accounts` 中继续追加即可（对象 map：key 为 `accountId`）。每个账户可指定不同的 `agentId` 对应不同的 OpenClaw Agent。
+
+> **accounts.default（可选）**：OpenClaw 的 `doctor --fix` 可能会自动生成 `accounts.default`，用于存放默认项（例如 `groupPolicy` 等）。本插件会把 `accounts.default` 作为“默认覆盖”合并到每个真实账号上，但 **不会**把它当作一个需要启动连接的账号。
 
 ### 步骤 3：重启 Gateway
 
@@ -170,15 +172,19 @@ openclaw gateway restart
       "wsBaseUrl": "wss://cwork-web-test.xgjktech.com.cn",
       "groupPolicy": "mention",
       "debug": false,
-      // 可选：首条 AI 回复超时时间（毫秒），默认 5 分钟
-      // 未配置时：5 * 60_000 = 300000
-      "firstReplyTimeoutMs": 300000,
-      "accounts": [
-        { "appKey": "appKey_机器人A", "agentId": "main",  "name": "个人助手" },
-        { "appKey": "appKey_机器人B", "agentId": "sales", "name": "销售助手" }
-      ]
+      // 可选：首条 AI 回复超时时间（毫秒），默认 30 分钟
+      // 未配置时：30 * 60_000 = 1800000
+      "firstReplyTimeoutMs": 1800000,
+      "accounts": {
+        "main": { "appKey": "appKey_机器人A", "agentId": "main",  "name": "个人助手" },
+        "sales": { "appKey": "appKey_机器人B", "agentId": "sales", "name": "销售助手" }
+      }
     }
-  }
+  },
+  "bindings": [
+    { "type": "route", "agentId": "main", "match": { "channel": "xg_cwork_im", "accountId": "main" } },
+    { "type": "route", "agentId": "sales", "match": { "channel": "xg_cwork_im", "accountId": "sales" } }
+  ]
 }
 ```
 
@@ -192,13 +198,13 @@ openclaw gateway restart
       "wsBaseUrl": "wss://sg-al-cwork-web.mediportal.com.cn",
       "groupPolicy": "mention",
       "debug": false,
-      "maxConnectionAttempts": 20,
+      "maxConnectionAttempts": 200,
       "maxReconnectDelay": 120000,
       // 生产环境可根据需要调整首回复超时时间（毫秒）
       "firstReplyTimeoutMs": 300000,
-      "accounts": [
-        { "appKey": "你的生产 appKey", "agentId": "main", "name": "个人助手" }
-      ]
+      "accounts": {
+        "main": { "appKey": "你的生产 appKey", "agentId": "main", "name": "个人助手" }
+      }
     }
   }
 }
@@ -223,7 +229,7 @@ openclaw gateway restart
 | `reconnectJitter` | number | `0.3` | 重连抖动因子（0-1） |
 | `firstReplyTimeoutMs` | number | `300000` | **首条 AI 回复超时时间（毫秒）**。用于保护「思考中」占位消息：若在该时间窗口内 AI 没有任何回复，则自动将占位消息更新为「当前请求处理超时，请稍后重试」。|
 
-### 账户配置（`accounts[n]`）
+### 账户配置（`accounts.<accountId>` / `accounts[n]`）
 
 | 选项 | 类型 | 默认值 | 说明 |
 |---|---|---|---|

package/index.ts

@@ -14,7 +14,7 @@ import type { XgCworkImPluginModule } from "./src/types.js";
 const plugin: XgCworkImPluginModule = {
     id: "xg_cwork_im",
     name: "XG CWork IM Channel",
-    description: "小橙工作台 IM 机器人 Channel 插件，通过 WebSocket 长连接接入",
+    description: "工作说说 IM 机器人 Channel 插件，通过 WebSocket 长连接接入",
     configSchema: emptyPluginConfigSchema(),
     register(api: OpenClawPluginApi): void {
         setXgImRuntime(api.runtime);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg_cwork_im",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "XG CWork IM channel plugin for OpenClaw",
   "keywords": [
     "bot",
@@ -48,8 +48,8 @@
     "channel": {
       "id": "xg_cwork_im",
       "label": "XG CWork IM",
-      "selectionLabel": "XG CWork IM (小橙工作台)",
-      "blurb": "小橙工作台 IM 机器人 Channel 插件，通过 WebSocket 长连接接收消息。",
+      "selectionLabel": "XG CWork IM (工作说说)",
+      "blurb": "工作说说 IM 机器人 Channel 插件，通过 WebSocket 长连接接收消息。",
       "aliases": [
         "xg_cwork_im",
         "im"

package/src/channel.ts

@@ -41,7 +41,9 @@ function getXgImRuntime(): PluginRuntime {
 // ─── 配置 Schema ──────────────────────────────────────────────────────────────
 
 const XgImAccountConfigSchema = z.object({
-    appKey: z.string().min(1, "appKey is required"),
+    // 注意：为了兼容 OpenClaw doctor 生成的 accounts.default（仅包含默认项，不含 appKey），这里先放宽为 optional，
+    // 然后在 XgImConfigSchema.superRefine 中强制校验：除 default 之外的账号必须提供 appKey。
+    appKey: z.string().min(1, "appKey is required").optional(),
     agentId: z.string().optional().default("main"),
     name: z.string().optional(),
     groupPolicy: z.enum(["open", "mention"]).optional().default("mention"),
@@ -61,7 +63,22 @@ const XgImConfigSchema = z.object({
     initialReconnectDelay: z.number().int().positive().optional().default(1_000),
     maxReconnectDelay: z.number().int().positive().optional().default(60_000),
     reconnectJitter: z.number().min(0).max(1).optional().default(0.3),
-    accounts: z.array(XgImAccountConfigSchema).optional(),
+    // 多账户：对象 map（key 为 accountId）
+    accounts: z.record(z.string(), XgImAccountConfigSchema).optional(),
+}).superRefine((val, ctx) => {
+    const accounts = val.accounts;
+    if (!accounts) return;
+    for (const [key, acc] of Object.entries(accounts)) {
+        if (key === "default") continue;
+        if (!acc || typeof acc !== "object") continue;
+        if (!("appKey" in acc) || !acc.appKey) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: ["accounts", key, "appKey"],
+                message: "appKey is required for account entries (except accounts.default)",
+            });
+        }
+    }
 });
 
 // ─── 辅助函数 ─────────────────────────────────────────────────────────────────
@@ -71,19 +88,25 @@ function getXgImConfig(cfg: OpenClawConfig, accountId?: string | null): XgImConf
     const raw = (cfg as Record<string, Record<string, unknown>>)?.channels?.xg_cwork_im as XgImConfig | undefined;
     if (!raw) throw new Error("[cwork_im] channels.xg_cwork_im config not found");
 
-    // 指定了具体账户 ID（数组下标）时，合并对应账户配置
-    if (accountId && accountId !== "default" && raw.accounts) {
-        const accIdx = parseInt(accountId, 10);
-        const sub = raw.accounts[accIdx];
-        if (sub) {
-            return { ...raw, ...sub };
-        }
+    const accounts = raw.accounts as unknown;
+    const accountMap =
+        accounts && typeof accounts === "object" && !Array.isArray(accounts)
+            ? (accounts as Record<string, Partial<XgImConfig> | undefined>)
+            : undefined;
+    const defaults = accountMap?.default ? { ...accountMap.default } : undefined;
+
+    // 指定了具体账户 ID 时，优先合并对应账户配置
+    if (accountId && accountId !== "default" && accountMap) {
+        const sub = accountMap[accountId];
+        if (sub) return { ...raw, ...(defaults ?? {}), ...sub };
     }
 
-    // 没有指定 accountId（如 Cron outbound 场景），自动 fallback 到 accounts[0]
+    // 没有指定 accountId（如 Cron outbound 场景），自动 fallback 到「第一个账户」
     // 避免顶层 raw 没有 appKey 时 getToken 失败
-    if (raw.accounts && raw.accounts.length > 0 && !raw.appKey) {
-        return { ...raw, ...raw.accounts[0] };
+    if (accountMap && !raw.appKey) {
+        const firstKey = Object.keys(accountMap).find((k) => k !== "default");
+        const first = firstKey ? accountMap[firstKey] : undefined;
+        if (first) return { ...raw, ...(defaults ?? {}), ...first };
     }
 
     return raw;
@@ -124,9 +147,9 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
     meta: {
         id: "xg_cwork_im",
         label: "XG CWork IM",
-        selectionLabel: "XG CWork IM (小橙工作台)",
+        selectionLabel: "XG CWork IM (工作说说)",
         docsPath: "/channels/xg_cwork_im",
-        blurb: "小橙工作台 IM 机器人，通过 WebSocket 长连接接收 @ 消息。",
+        blurb: "工作说说 IM 机器人，通过 WebSocket 长连接接收 @ 消息。",
         aliases: ["xg_cwork_im", "im"],
     },
     // 双重类型转换绕过 zod v3/v4 的 TS 类型不兼容
@@ -147,9 +170,13 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
         listAccountIds: (cfg: OpenClawConfig): string[] => {
             try {
                 const config = getXgImConfig(cfg);
-                if (config.accounts && config.accounts.length > 0) {
-                    // 使用数组下标作为 ID
-                    return config.accounts.map((_, i) => i.toString());
+                const accounts = config.accounts as unknown;
+                if (accounts) {
+                    if (!Array.isArray(accounts) && typeof accounts === "object") {
+                        // 推荐写法：对象 key 作为 accountId
+                        const keys = Object.keys(accounts as Record<string, unknown>).filter((k) => k !== "default");
+                        return keys;
+                    }
                 }
                 return isConfigured(cfg) ? ["default"] : [];
             } catch {
@@ -179,6 +206,8 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
             }
         },
 
+        // 注意：OpenClaw 可能在缺省路由时使用 defaultAccountId。
+        // 我们使用 "default" 作为别名：getXgImConfig 会自动 fallback 到第一个非 default 的真实账号。
         defaultAccountId: (): string => "default",
 
         isConfigured: (account: ResolvedAccount): boolean => account.configured,
@@ -432,10 +461,10 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                         });
                         log.info(`${logPrefix} [stream] START acknowledged: msgId=${msgId}`);
 
-                        // 1.1 为“思考中”占位增加首回复超时保护（默认 5 分钟，可通过 firstReplyTimeoutMs 配置）
+                        // 1.1 为“思考中”占位增加首回复超时保护（默认 30分钟，可通过 firstReplyTimeoutMs 配置）
                         let hasFirstReply = false;
                         let firstReplyTimedOut = false;
-                        const firstReplyTimeoutMs = config.firstReplyTimeoutMs ?? 5 * 60_000;
+                        const firstReplyTimeoutMs = config.firstReplyTimeoutMs ?? 30 * 60_000;
                         const timeoutLabel = `${logPrefix} [stream] First reply timeout after ${firstReplyTimeoutMs}ms, updating thinking message as error`;
                         const firstReplyTimeout = setTimeout(async () => {
                             if (hasFirstReply) {

package/src/group-history-tool.ts

@@ -25,7 +25,8 @@ const GroupHistoryParams = Type.Object({
     ),
     accountId: Type.Optional(
         Type.String({
-            description: "（可选）要使用的 xg_cwork_im 账户下标（数字字符串，默认 0）",
+            description:
+                "（可选）要使用的 xg_cwork_im 账户 ID（即 accounts 的 key，例如 main/orchestrator）。",
         }),
     ),
     limit: Type.Optional(
@@ -54,19 +55,21 @@ export function extractXgCworkImConfig(cfg: unknown): XgImConfig | null {
  * - 否则：有 accounts 时默认使用 accounts[0]；无 accounts 时使用顶层配置。
  */
 export function resolveAccountConfig(base: XgImConfig, accountId?: string | null): XgImConfig {
-    const accounts = base.accounts ?? [];
-    if (accounts.length === 0) {
+    const accounts = base.accounts;
+    if (!accounts) {
         return base;
     }
-    let idx = 0;
+
+    const map = accounts as Record<string, XgImConfig | undefined>;
+    const defaults = map.default ? { ...map.default } : undefined;
+
     if (accountId && accountId !== "default") {
-        const parsed = Number.parseInt(accountId, 10);
-        if (!Number.isNaN(parsed) && parsed >= 0 && parsed < accounts.length) {
-            idx = parsed;
-        }
+        const hit = map[accountId];
+        if (hit) return { ...base, ...(defaults ?? {}), ...hit };
     }
-    const acc = accounts[idx] ?? accounts[0];
-    return { ...base, ...acc };
+    const firstKey = Object.keys(map).find((k) => k !== "default");
+    const first = firstKey ? map[firstKey] : undefined;
+    return first ? { ...base, ...(defaults ?? {}), ...first } : base;
 }
 
 /** 调用 IM 接口拉取群聊最近 N 条消息 */

package/src/send-group-message-tool.ts

@@ -24,7 +24,8 @@ const SendGroupMessageParams = Type.Object({
     }),
     accountId: Type.Optional(
         Type.String({
-            description: "（可选）要使用的 xg_cwork_im 账户下标（数字字符串，默认 0）",
+            description:
+                "（可选）要使用的 xg_cwork_im 账户 ID（即 accounts 的 key，例如 main/orchestrator）。",
         }),
     ),
     text: Type.String({

package/src/types.ts

@@ -30,7 +30,7 @@ export type XgCworkImPluginModule = XgImPluginModule;
 /** 单个机器人账户配置 */
 export interface XgImAccountConfig {
     /** 机器人 appKey，从 IM 后台注册获取 */
-    appKey: string;
+    appKey?: string;
     /** 对应 OpenClaw 的 Agent ID，默认为 'main' */
     agentId?: string;
     /** 账户显示名称 */
@@ -41,7 +41,7 @@ export interface XgImAccountConfig {
 
 export interface XgImConfig extends OpenClawConfig {
     /** 多账户列表 */
-    accounts?: XgImAccountConfig[];
+    accounts?: Record<string, XgImAccountConfig>;
 
     /** 机器人 appKey（单账户模式） */
     appKey?: string;
@@ -72,7 +72,7 @@ export interface XgImConfig extends OpenClawConfig {
     /**
      * 首次 AI 回复超时时间（毫秒）。
      *
-     * - 未配置时默认 5 分钟（300_000ms）。
+     * - 未配置时默认 30 分钟（1800_000ms）。
      * - 仅用于保护「思考中」占位消息，避免长时间不被更新。
      */
     firstReplyTimeoutMs?: number;