@wu529778790/open-im 1.10.9-beta.2 → 1.10.9-beta.21

package/dist/config.js

@@ -23,7 +23,9 @@ function resolveFilePlatformAi(file, platform) {
                     ? pf?.wework?.aiCommand
                     : platform === 'dingtalk'
                         ? pf?.dingtalk?.aiCommand
-                        : pf?.workbuddy?.aiCommand;
+                        : platform === 'clawbot'
+                            ? pf?.clawbot?.aiCommand
+                            : pf?.workbuddy?.aiCommand;
     return normalizeAiCommand(raw ?? process.env.AI_COMMAND ?? file.aiCommand, 'claude');
 }
 // Re-export file I/O and credential helpers from sub-modules
@@ -53,6 +55,7 @@ export function needsSetup() {
     const ww = file.platforms?.wework;
     const dt = file.platforms?.dingtalk;
     const wb = file.platforms?.workbuddy;
+    const cb = file.platforms?.clawbot;
     // Also check legacy platforms.wechat for migration path
     const legacyWc = file.platforms?.wechat;
     const hasTelegram = !!tg?.botToken;
@@ -61,8 +64,9 @@ export function needsSetup() {
     const hasWework = !!(ww?.corpId && ww?.secret);
     const hasDingtalk = !!(dt?.clientId && dt?.clientSecret);
     const hasWorkBuddy = !!(wb?.accessToken && wb?.refreshToken && wb?.userId);
+    const hasClawBot = !!(cb?.apiToken);
     const hasLegacyWechat = !!(legacyWc?.workbuddyAccessToken && legacyWc?.workbuddyRefreshToken);
-    return !hasTelegram && !hasFeishu && !hasQQ && !hasWework && !hasDingtalk && !hasWorkBuddy && !hasLegacyWechat;
+    return !hasTelegram && !hasFeishu && !hasQQ && !hasWework && !hasDingtalk && !hasWorkBuddy && !hasClawBot && !hasLegacyWechat;
 }
 export function loadConfig() {
     const file = loadFileConfig();
@@ -73,6 +77,7 @@ export function loadConfig() {
     const fileQQ = file.platforms?.qq;
     const fileWework = file.platforms?.wework;
     const fileDingtalk = file.platforms?.dingtalk;
+    const fileClawbot = file.platforms?.clawbot;
     // Auto-migrate legacy platforms.wechat WorkBuddy credentials → platforms.workbuddy
     const legacyWechat = file.platforms?.wechat;
     const fileWorkBuddy = file.platforms?.workbuddy ?? (legacyWechat?.workbuddyAccessToken && legacyWechat?.workbuddyRefreshToken
@@ -122,6 +127,11 @@ export function loadConfig() {
         fileWorkBuddy?.guid;
     const workbuddyWorkspacePath = process.env.WORKBUDDY_WORKSPACE_PATH ??
         fileWorkBuddy?.workspacePath;
+    // ClawBot credentials
+    const clawbotApiUrl = process.env.CLAWBOT_API_URL ??
+        fileClawbot?.apiUrl;
+    const clawbotApiToken = process.env.CLAWBOT_API_TOKEN ??
+        fileClawbot?.apiToken;
     // 2. 计算启用平台
     const enabledPlatforms = [];
     const telegramEnabledFlag = fileTelegram?.enabled;
@@ -130,12 +140,14 @@ export function loadConfig() {
     const weworkEnabledFlag = fileWework?.enabled;
     const dingtalkEnabledFlag = fileDingtalk?.enabled;
     const workbuddyEnabledFlag = fileWorkBuddy?.enabled;
+    const clawbotEnabledFlag = fileClawbot?.enabled;
     const telegramEnabled = !!telegramBotToken && (telegramEnabledFlag !== false);
     const feishuEnabled = !!(feishuAppId && feishuAppSecret) && (feishuEnabledFlag !== false);
     const qqEnabled = !!(qqAppId && qqSecret) && (qqEnabledFlag !== false);
     const weworkEnabled = !!(weworkCorpId && weworkSecret) && (weworkEnabledFlag !== false);
     const dingtalkEnabled = !!(dingtalkClientId && dingtalkClientSecret) && (dingtalkEnabledFlag !== false);
     const workbuddyEnabled = !!(workbuddyAccessToken && workbuddyRefreshToken && workbuddyUserId) && (workbuddyEnabledFlag !== false);
+    const clawbotEnabled = !!clawbotApiToken && (clawbotEnabledFlag !== false);
     if (telegramEnabled)
         enabledPlatforms.push('telegram');
     if (feishuEnabled)
@@ -148,6 +160,8 @@ export function loadConfig() {
         enabledPlatforms.push('dingtalk');
     if (workbuddyEnabled)
         enabledPlatforms.push('workbuddy');
+    if (clawbotEnabled)
+        enabledPlatforms.push('clawbot');
     if (enabledPlatforms.length === 0) {
         throw new Error('至少需要配置 Telegram、Feishu、WeChat、WeWork 或 DingTalk 其中一个平台（可以通过环境变量或 config.json）');
     }
@@ -174,6 +188,9 @@ export function loadConfig() {
     const workbuddyAllowedUserIds = process.env.WORKBUDDY_ALLOWED_USER_IDS !== undefined
         ? parseCommaSeparated(process.env.WORKBUDDY_ALLOWED_USER_IDS)
         : fileWorkBuddy?.allowedUserIds ?? allowedUserIds;
+    const clawbotAllowedUserIds = process.env.CLAWBOT_ALLOWED_USER_IDS !== undefined
+        ? parseCommaSeparated(process.env.CLAWBOT_ALLOWED_USER_IDS)
+        : fileClawbot?.allowedUserIds ?? allowedUserIds;
     // 5. AI / 工作目录 / 安全配置（从 tools 读取）
     const tc = file.tools?.claude ?? {};
     const tcod = file.tools?.codex ?? {};
@@ -507,6 +524,21 @@ export function loadConfig() {
                 guid: workbuddyGuid,
                 workspacePath: workbuddyWorkspacePath,
             },
+        clawbot: clawbotEnabled
+            ? {
+                enabled: true,
+                aiCommand: resolveFilePlatformAi(file, 'clawbot'),
+                allowedUserIds: clawbotAllowedUserIds,
+                apiUrl: clawbotApiUrl,
+                apiToken: clawbotApiToken,
+            }
+            : {
+                enabled: false,
+                aiCommand: resolveFilePlatformAi(file, 'clawbot'),
+                allowedUserIds: clawbotAllowedUserIds,
+                apiUrl: clawbotApiUrl,
+                apiToken: clawbotApiToken,
+            },
     };
     return {
         enabledPlatforms,
@@ -528,6 +560,7 @@ export function loadConfig() {
         weworkAllowedUserIds,
         dingtalkAllowedUserIds,
         workbuddyAllowedUserIds,
+        clawbotAllowedUserIds,
         codexCliPath,
         codebuddyCliPath,
         claudeProxy,
@@ -562,6 +595,9 @@ export function getPlatformsWithCredentials(config) {
     const wb = config.platforms.workbuddy;
     if (wb?.accessToken && wb?.refreshToken)
         r.push('workbuddy');
+    const cb = config.platforms.clawbot;
+    if (cb?.apiToken)
+        r.push('clawbot');
     return r;
 }
 export function resolvePlatformAiCommand(config, platform) {

package/dist/constants.d.ts

@@ -38,3 +38,9 @@ export declare const MAX_WEWORK_MESSAGE_LENGTH = 2048;
 export declare const MAX_DINGTALK_MESSAGE_LENGTH = 2048;
 /** WeChat KF (微信客服) 单条消息最大字符数 */
 export declare const MAX_WORKBUDDY_MESSAGE_LENGTH = 2000;
+/** ClawBot 流式更新节流 */
+export declare const CLAWBOT_THROTTLE_MS = 1000;
+/** ClawBot 单条消息最大字符数 */
+export declare const MAX_CLAWBOT_MESSAGE_LENGTH = 2000;
+/** ClawBot 长轮询间隔 */
+export declare const CLAWBOT_POLL_INTERVAL_MS = 3000;

package/dist/constants.js

@@ -68,3 +68,9 @@ export const MAX_WEWORK_MESSAGE_LENGTH = 2048;
 export const MAX_DINGTALK_MESSAGE_LENGTH = 2048;
 /** WeChat KF (微信客服) 单条消息最大字符数 */
 export const MAX_WORKBUDDY_MESSAGE_LENGTH = 2000;
+/** ClawBot 流式更新节流 */
+export const CLAWBOT_THROTTLE_MS = 1000;
+/** ClawBot 单条消息最大字符数 */
+export const MAX_CLAWBOT_MESSAGE_LENGTH = 2000;
+/** ClawBot 长轮询间隔 */
+export const CLAWBOT_POLL_INTERVAL_MS = 3000;

package/dist/dingtalk/client.js

@@ -1,5 +1,6 @@
 import { DWClient, TOPIC_ROBOT } from 'dingtalk-stream';
 import { createLogger } from '../logger.js';
+import { jitteredDelay } from '../shared/reconnect.js';
 import { registerSessionWebhook as registerWebhook, clearWebhooks, sendText as webhookSendText, sendMarkdown as webhookSendMarkdown, downloadRobotMessageFile as webhookDownloadFile, sendProactiveText as webhookSendProactive, } from './webhook.js';
 import { prepareStreamingCard as cardPrepare, updateStreamingCard as cardUpdate, finishStreamingCard as cardFinish, createAndDeliverCard as cardCreateAndDeliver, updateCardInstance as cardUpdateInstance, sendRobotInteractiveCard as cardSendInteractive, updateRobotInteractiveCard as cardUpdateInteractive, clearUnionIdCache, } from './streaming-card.js';
 const log = createLogger('DingTalk');
@@ -111,7 +112,7 @@ export async function initDingTalk(cfg, eventHandler) {
             lastErr = err;
             if (is429(err) && attempt < maxTries) {
                 log.warn(`DingTalk gateway 429 (attempt ${attempt}/${maxTries}), retrying in ${retryDelayMs / 1000}s...`);
-                await new Promise((r) => setTimeout(r, retryDelayMs));
+                await new Promise((r) => setTimeout(r, jitteredDelay(retryDelayMs)));
                 continue;
             }
             throw new Error(formatDingTalkInitError(err));

package/dist/dingtalk/event-handler.js

@@ -163,7 +163,7 @@ export function setupDingTalkHandlers(config, sessionManager) {
         sessionManager,
         sender: { sendTextReply, sendDirectorySelection },
     });
-    const { accessControl, requestQueue, runningTasks, commandHandler } = ctx;
+    const { accessControl, requestQueue, runningTasks } = ctx;
     // DingTalk-specific sender callbacks for the factory
     const dingtalkSender = {
         sendThinkingMessage: async (chatId, replyToMessageId, toolId) => {

package/dist/index.js

@@ -24,14 +24,20 @@ import { setupDingTalkHandlers } from "./dingtalk/event-handler.js";
 import { initWorkBuddy, stopWorkBuddy } from "./workbuddy/client.js";
 import { setupWorkBuddyHandlers } from "./workbuddy/event-handler.js";
 import { sendTextReply as sendWorkBuddyTextReply } from "./workbuddy/message-sender.js";
+import { initClawbot, stopClawbot } from "./clawbot/client.js";
+import { setupClawbotHandlers } from "./clawbot/event-handler.js";
+import { sendTextReply as sendClawbotTextReply } from "./clawbot/message-sender.js";
+import { initClawBotSender } from "./clawbot/message-sender.js";
 import { initAdapters, cleanupAdapters } from "./adapters/registry.js";
 import { SessionManager } from "./session/session-manager.js";
 import { loadActiveChats, getActiveChatId, flushActiveChats, } from "./shared/active-chats.js";
+import { destroyAllLiveChildren } from "./shared/process-kill.js";
 import { initLogger, createLogger, closeLogger, emitStructuredEvent, shutdownLoggerTelemetry, } from "./logger.js";
 import { APP_HOME, SHUTDOWN_PORT } from "./constants.js";
 import { createRequire } from "node:module";
 import { escapePathForMarkdown } from "./shared/utils.js";
 import { applyOpenImGitCoauthorToProcessEnv } from "./shared/git-coauthor.js";
+import { emitInterruptedTerminals } from "./shared/task-cleanup.js";
 const require = createRequire(import.meta.url);
 const { version: APP_VERSION } = require("../package.json");
 const log = createLogger("Main");
@@ -92,6 +98,19 @@ const PLATFORM_MODULES = {
         stop: () => stopWorkBuddy(),
         sendNotification: (chatId, msg) => sendWorkBuddyTextReply(null, chatId, msg, randomUUID()),
     },
+    clawbot: {
+        init: async (config, sessionManager) => {
+            const pc = config.platforms.clawbot;
+            if (pc?.apiUrl && pc?.apiToken) {
+                initClawBotSender(pc.apiUrl, pc.apiToken);
+            }
+            const handle = setupClawbotHandlers(config, sessionManager);
+            await initClawbot(config, handle.handleEvent);
+            return handle;
+        },
+        stop: () => stopClawbot(),
+        sendNotification: (chatId, msg) => sendClawbotTextReply(chatId, msg),
+    },
 };
 async function sendLifecycleNotification(platform, message) {
     const mod = PLATFORM_MODULES[platform];
@@ -262,6 +281,15 @@ export async function main() {
         const uptimeSec = Math.floor((Date.now() - startedAt) / 1000);
         const m = Math.floor(uptimeSec / 60);
         const shutdownMsg = buildShutdownMessage(m);
+        // 在任何异步等待之前，先为仍在运行的任务补发终态遥测事件。
+        // 这样即使后续 await（通知发送、platform.stop）期间进程被第二次信号杀死，
+        // ai.task.start 也有对应的 interrupted 终态，避免遥测里的 miss。
+        for (const platform of successfulPlatforms) {
+            const handle = activeHandles.get(platform);
+            if (handle?.runningTasks && handle.runningTasks.size > 0) {
+                emitInterruptedTerminals(handle.runningTasks);
+            }
+        }
         // Send notification only to successfully initialized platforms
         for (const platform of successfulPlatforms) {
             await sendLifecycleNotification(platform, shutdownMsg).catch((err) => {
@@ -299,6 +327,16 @@ export async function main() {
     };
     process.on("SIGINT", () => shutdown().catch(() => process.exit(1)));
     process.on("SIGTERM", () => shutdown().catch(() => process.exit(1)));
+    // 兜底：进程退出（含异常路径，如未捕获异常 / SIGKILL）时强制清理 CLI 子进程，
+    // 避免僵尸 / 孤儿。正常 shutdown 已在 cleanupAdapters() 里清理过。
+    process.on("exit", () => {
+        try {
+            destroyAllLiveChildren();
+        }
+        catch {
+            /* 退出期间 best effort */
+        }
+    });
     // Global error handlers to prevent unhandled crashes
     process.on("unhandledRejection", (reason) => {
         log.error("Unhandled Promise rejection (this indicates a bug — the affected request may hang without a response):", reason);
@@ -312,6 +350,18 @@ export async function main() {
             return;
         }
         log.error("Uncaught exception (process will exit):", err);
+        // 进程即将因未捕获异常退出：补发在途任务的终态，避免 miss
+        for (const platform of successfulPlatforms) {
+            const handle = activeHandles.get(platform);
+            if (handle?.runningTasks && handle.runningTasks.size > 0) {
+                try {
+                    emitInterruptedTerminals(handle.runningTasks);
+                }
+                catch {
+                    /* best effort：不能因遥测失败再次抛出 */
+                }
+            }
+        }
         void shutdownLoggerTelemetry()
             .then(() => closeLogger())
             .finally(() => process.exit(1));

package/dist/qq/client.js

@@ -1,5 +1,6 @@
 import WebSocket from "ws";
 import { createLogger } from "../logger.js";
+import { jitteredDelay, SLOW_PROBE_MS } from "../shared/reconnect.js";
 const log = createLogger("QQ");
 const TOKEN_URL = "https://bots.qq.com/app/getAppAccessToken";
 const API_BASE = "https://api.sgroup.qq.com";
@@ -271,7 +272,12 @@ async function connectWebSocket(config, handler) {
                     sessionId = null;
                     seq = null;
                 }
-                const delay = RECONNECT_DELAYS_MS[Math.min(reconnectAttempt, RECONNECT_DELAYS_MS.length - 1)];
+                const isFatalClose = code === 4004 || code === 4006 || code === 4007;
+                const baseDelay = RECONNECT_DELAYS_MS[Math.min(reconnectAttempt, RECONNECT_DELAYS_MS.length - 1)];
+                const delay = isFatalClose ? jitteredDelay(SLOW_PROBE_MS) : jitteredDelay(baseDelay);
+                if (isFatalClose) {
+                    log.warn(`QQ 致命关闭码 ${code}（鉴权失败），转慢探测（每 ${Math.round(SLOW_PROBE_MS / 1000)}s 一次）`);
+                }
                 reconnectAttempt += 1;
                 reconnectTimer = setTimeout(() => {
                     if (currentConfig && currentHandler) {

package/dist/queue/request-queue.js

@@ -80,17 +80,18 @@ export class RequestQueue {
         finally {
             this.runningControllers.delete(key);
             const q = this.queues.get(key);
-            if (!q)
-                return;
-            const next = q.tasks.shift();
-            if (next) {
-                setImmediate(() => this.run(key, next.prompt, next.execute).catch((err) => {
-                    log.error(`Unhandled error in next task execution for ${key}:`, err);
-                }));
-            }
+            if (!q) { /* queue already cleared */ }
             else {
-                q.running = false;
-                this.queues.delete(key);
+                const next = q.tasks.shift();
+                if (next) {
+                    setImmediate(() => this.run(key, next.prompt, next.execute).catch((err) => {
+                        log.error(`Unhandled error in next task execution for ${key}:`, err);
+                    }));
+                }
+                else {
+                    q.running = false;
+                    this.queues.delete(key);
+                }
             }
         }
     }

package/dist/setup.js

@@ -31,6 +31,7 @@ function getConfiguredPlatforms(existing) {
         { k: "wework", label: "企业微信" },
         { k: "dingtalk", label: "钉钉" },
         { k: "workbuddy", label: "WorkBuddy (微信)" },
+        { k: "clawbot", label: "ClawBot (微信 iLink)" },
     ];
     return names
         .filter(({ k }) => {
@@ -49,6 +50,8 @@ function getConfiguredPlatforms(existing) {
             return !!(p.corpId && p.secret);
         if (k === "dingtalk")
             return !!(p.clientId && p.clientSecret);
+        if (k === "clawbot")
+            return !!p.apiToken;
         return false;
     })
         .map(({ label }) => label);
@@ -125,12 +128,19 @@ function printManualInstructions(configPath) {
       "workbuddyRefreshToken": "",
       "userId": "",
       "allowedUserIds": ["允许访问的微信用户 ID（可选）"]
+    },
+    "clawbot": {
+      "enabled": false,
+      "aiCommand": "claude",
+      "apiUrl": "http://127.0.0.1:26322",
+      "apiToken": "你的 ClawBot Bearer Token（可选）",
+      "allowedUserIds": ["允许访问的微信用户 ID（可选）"]
     }
   }
 }`);
     console.log("");
-    console.log("提示：至少需要配置 Telegram、Feishu、QQ、WeChat、WeWork 或 DingTalk 其中一个平台");
-    console.log("或设置环境变量: TELEGRAM_BOT_TOKEN=xxx、FEISHU_APP_ID=xxx、QQ_BOT_APPID=xxx、WECHAT_WORKBUDDY_ACCESS_TOKEN=xxx、WEWORK_CORP_ID=xxx 或 DINGTALK_CLIENT_ID=xxx 后再运行");
+    console.log("提示：至少需要配置 Telegram、Feishu、QQ、WeChat、WeWork、DingTalk 或 ClawBot 其中一个平台");
+    console.log("或设置环境变量: TELEGRAM_BOT_TOKEN=xxx、FEISHU_APP_ID=xxx、QQ_BOT_APPID=xxx、WECHAT_WORKBUDDY_ACCESS_TOKEN=xxx、WEWORK_CORP_ID=xxx、DINGTALK_CLIENT_ID=xxx 或 CLAWBOT_API_TOKEN=xxx 后再运行");
     console.log("");
 }
 const CLAUDE_SETTINGS_PATH = join(homedir(), ".claude", "settings.json");
@@ -317,6 +327,11 @@ export async function runInteractiveSetup() {
                     (hasWc ? " ✓已配置" : ""),
                 value: "workbuddy",
             },
+            {
+                title: "ClawBot 微信 iLink (需要 API Token)" +
+                    (!!existing?.platforms?.clawbot?.apiToken ? " ✓已配置" : ""),
+                value: "clawbot",
+            },
             { title: "配置多个平台", value: "multi" },
         ],
         initial: 0,
@@ -339,6 +354,7 @@ export async function runInteractiveSetup() {
                 { title: "企业微信 (WeWork)" + (hasWw ? " ✓已配置" : ""), value: "wework", selected: hasWw },
                 { title: "钉钉 (DingTalk)" + (hasDt ? " ✓已配置" : ""), value: "dingtalk", selected: hasDt },
                 { title: "WorkBuddy 微信客服 (WeChat KF)" + (hasWc ? " ✓已配置" : ""), value: "workbuddy", selected: hasWc },
+                { title: "ClawBot 微信 iLink" + (!!existing?.platforms?.clawbot?.apiToken ? " ✓已配置" : ""), value: "clawbot" },
             ],
         }, { onCancel });
         if (!multiResp.platforms || multiResp.platforms.length === 0) {
@@ -563,6 +579,84 @@ export async function runInteractiveSetup() {
             return false;
         }
     }
+    if (selectedPlatforms.includes("clawbot")) {
+        const hasCbToken = !!existing?.platforms?.clawbot?.apiToken;
+        const cbModeResp = await prompts({
+            type: "select",
+            name: "mode",
+            message: "ClawBot 微信 iLink",
+            choices: [
+                { title: "扫码登录（自动获取 Token）", value: "qr" },
+                { title: "使用已有 Token" + (hasCbToken ? " ✓" : ""), value: "token", disabled: !hasCbToken },
+            ],
+            initial: 0,
+        }, { onCancel });
+        let cbApiToken = "";
+        let cbApiUrl = existing?.platforms?.clawbot?.apiUrl ?? "http://127.0.0.1:26322";
+        if (cbModeResp.mode === "qr") {
+            console.log("\n正在获取二维码...\n");
+            try {
+                const { startQRLogin, waitForQRLogin } = await import("./clawbot/qr-login.js");
+                const session = await startQRLogin();
+                console.log("请用微信扫描以下链接中的二维码：");
+                console.log(session.qrcodeUrl);
+                console.log("\n等待扫码...（最长 5 分钟）\n");
+                const result = await waitForQRLogin(session, (status) => {
+                    if (status === "scaned")
+                        process.stdout.write("已扫码，验证中...\n");
+                });
+                if (result.connected && result.botToken) {
+                    cbApiToken = result.botToken;
+                    if (result.baseUrl)
+                        cbApiUrl = result.baseUrl;
+                    console.log("\n✅ 登录成功！");
+                    if (result.userId) {
+                        console.log(`   用户 ID: ${result.userId}`);
+                        console.log("   提示：可将此 ID 添加到白名单");
+                    }
+                }
+                else {
+                    console.log(`\n❌ 登录失败: ${result.message}`);
+                    if (platform === "clawbot")
+                        return false;
+                }
+            }
+            catch (err) {
+                console.error(`\n❌ 二维码获取失败: ${err instanceof Error ? err.message : String(err)}`);
+                if (platform === "clawbot")
+                    return false;
+            }
+        }
+        else {
+            const cbResp = await prompts([
+                {
+                    type: "text",
+                    name: "apiUrl",
+                    message: "ClawBot iLink API 地址（默认 http://127.0.0.1:26322）",
+                    initial: cbApiUrl,
+                },
+                {
+                    type: "text",
+                    name: "apiToken",
+                    message: "ClawBot Bearer Token",
+                    initial: existing?.platforms?.clawbot?.apiToken ?? "",
+                    validate: (v) => (v.trim() ? true : "Token 不能为空"),
+                },
+            ], { onCancel });
+            cbApiUrl = cbResp.apiUrl?.trim() || cbApiUrl;
+            cbApiToken = cbResp.apiToken?.trim() || "";
+        }
+        if (cbApiToken) {
+            config.platforms.clawbot = {
+                enabled: true,
+                apiUrl: cbApiUrl,
+                apiToken: cbApiToken,
+            };
+        }
+        else if (platform === "clawbot") {
+            return false;
+        }
+    }
     if (selectedPlatforms.includes("wework")) {
         const weworkResp = await prompts([
             {
@@ -687,6 +781,15 @@ export async function runInteractiveSetup() {
             initial: dtIds,
         });
     }
+    if (selectedPlatforms.includes("clawbot")) {
+        const cbIds = existing?.platforms?.clawbot?.allowedUserIds?.join(", ") ?? "";
+        commonPrompts.push({
+            type: "text",
+            name: "clawbotAllowedUserIds",
+            message: "ClawBot 白名单用户 ID（可选，逗号分隔，留空=所有人可访问）",
+            initial: cbIds,
+        });
+    }
     commonPrompts.push({
         type: "text",
         name: "workDir",
@@ -796,6 +899,9 @@ export async function runInteractiveSetup() {
     const dingtalkIds = selectedPlatforms.includes("dingtalk")
         ? parseIds(commonResp.dingtalkAllowedUserIds)
         : parseIds(existing?.platforms?.dingtalk?.allowedUserIds?.join(", "));
+    const clawbotIds = selectedPlatforms.includes("clawbot")
+        ? parseIds(commonResp.clawbotAllowedUserIds)
+        : parseIds(existing?.platforms?.clawbot?.allowedUserIds?.join(", "));
     // 增量合并：以已有配置为底，只覆盖本次选中的平台（不写入根级旧字段 telegramBotToken 等）
     const base = existing
         ? JSON.parse(JSON.stringify(existing))
@@ -985,6 +1091,27 @@ export async function runInteractiveSetup() {
     else {
         outPlatforms.dingtalk = { enabled: false, aiCommand: "claude", allowedUserIds: dingtalkIds };
     }
+    if (selectedPlatforms.includes("clawbot")) {
+        const cbConfig = config.platforms?.clawbot;
+        const baseCb = base?.platforms?.clawbot;
+        outPlatforms.clawbot = {
+            enabled: true,
+            aiCommand: defaultPlatformAi(baseCb?.aiCommand),
+            apiUrl: String(cbConfig?.apiUrl ?? baseCb?.apiUrl ?? "http://127.0.0.1:26322"),
+            apiToken: String(cbConfig?.apiToken ?? baseCb?.apiToken ?? ""),
+            allowedUserIds: clawbotIds,
+        };
+    }
+    else if (basePlatforms?.clawbot) {
+        outPlatforms.clawbot = {
+            ...basePlatforms.clawbot,
+            aiCommand: defaultPlatformAi(basePlatforms.clawbot.aiCommand),
+            allowedUserIds: clawbotIds.length > 0 ? clawbotIds : basePlatforms.clawbot.allowedUserIds ?? [],
+        };
+    }
+    else {
+        outPlatforms.clawbot = { enabled: false, aiCommand: "claude", allowedUserIds: clawbotIds };
+    }
     const dir = dirname(configPath);
     if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });
@@ -1005,8 +1132,9 @@ const PLATFORM_LABELS = {
     wework: "企业微信",
     dingtalk: "钉钉",
     workbuddy: "WorkBuddy 微信客服",
+    clawbot: "ClawBot 微信 iLink",
 };
-const ALL_PLATFORMS = ["telegram", "feishu", "qq", "wework", "dingtalk", "workbuddy"];
+const ALL_PLATFORMS = ["telegram", "feishu", "qq", "wework", "dingtalk", "workbuddy", "clawbot"];
 /**
  * 启动时让用户选择要启用的平台（无论单通道还是多通道）
  * 显示全部 4 个平台，已配置的预选；若用户选择未配置的，引导运行 init

package/dist/shared/active-chats.d.ts

@@ -6,8 +6,8 @@ export interface DingTalkActiveTarget {
     updatedAt: number;
 }
 export declare function loadActiveChats(): void;
-export declare function getActiveChatId(platform: 'dingtalk' | 'feishu' | 'qq' | 'telegram' | 'wechat' | 'wework' | 'workbuddy'): string | undefined;
-export declare function setActiveChatId(platform: 'dingtalk' | 'feishu' | 'qq' | 'telegram' | 'wechat' | 'wework' | 'workbuddy', chatId: string): void;
+export declare function getActiveChatId(platform: 'dingtalk' | 'feishu' | 'qq' | 'telegram' | 'wechat' | 'wework' | 'workbuddy' | 'clawbot'): string | undefined;
+export declare function setActiveChatId(platform: 'dingtalk' | 'feishu' | 'qq' | 'telegram' | 'wechat' | 'wework' | 'workbuddy' | 'clawbot', chatId: string): void;
 export declare function getDingTalkActiveTarget(): DingTalkActiveTarget | undefined;
 export declare function setDingTalkActiveTarget(target: Omit<DingTalkActiveTarget, 'updatedAt'>): void;
 export declare function flushActiveChats(): void;

package/dist/shared/ai-task.d.ts

@@ -42,5 +42,19 @@ export interface TaskRunState {
     startedAt: number;
     /** AI 工具标识，用于动态显示工具名称。 */
     toolId: string;
+    /**
+     * 进程退出（shutdown / 崩溃）时，用于为仍在运行的任务补发一条终态遥测事件，
+     * 避免 `ai.task.start` 没有对应的 complete/error（遥测里的 `miss`）。
+     * 已哈希（与 ai.task.* emit 处一致），不含原始 userId/msgId。
+     */
+    taskKey: string;
+    platform: string;
+    /** 已哈希的 userId，与 ai.task.start/complete/error 中的 userKey 一致。 */
+    userKey: string;
 }
+/**
+ * 将 AI/CLI 错误文本归类为一个稳定的 errorType 字符串，用于遥测聚合。
+ * 分类基于线上真实错误签名（见 logs/r2-events），新增分支时同步更新测试。
+ */
+export declare function classifyErrorType(error: string): string;
 export declare function runAITask(deps: TaskDeps, ctx: TaskContext, prompt: string, toolAdapter: ToolAdapter, platformAdapter: TaskAdapter): Promise<void>;