axon-code 2.4.0

package/dist/web/server/channels/adapters/slack-bot.js

@@ -0,0 +1,226 @@
+/**
+ * Slack Bot 适配器
+ *
+ * 使用 @slack/bolt 的 Socket Mode 连接 Slack。
+ * 参考 OpenClaw extensions/slack/ 的设计，但大幅精简：
+ * - 只支持 Socket Mode（无需公网 URL）
+ * - 只处理文本和图片消息
+ * - 白名单通过 allowList 配置
+ */
+/** Slack 消息长度限制 */
+const SLACK_TEXT_LIMIT = 4000;
+export class SlackBotAdapter {
+    id = 'slack-bot';
+    name = 'Slack Bot';
+    app = null;
+    status = 'disconnected';
+    config = null;
+    onMessage = null;
+    /** Bot 自己的 User ID（用于过滤自己的消息） */
+    botUserId = '';
+    async start(config, onMessage) {
+        const botToken = config.credentials?.botToken;
+        const appToken = config.credentials?.appToken;
+        if (!botToken) {
+            throw new Error('Slack Bot Token (xoxb-) is required. Set channels.slack-bot.credentials.botToken in settings.');
+        }
+        if (!appToken) {
+            throw new Error('Slack App Token (xapp-) is required for Socket Mode. Set channels.slack-bot.credentials.appToken in settings.');
+        }
+        this.config = config;
+        this.onMessage = onMessage;
+        this.status = 'connecting';
+        try {
+            const { App } = await import('@slack/bolt');
+            this.app = new App({
+                token: botToken,
+                appToken,
+                socketMode: true,
+            });
+            // 获取 Bot 信息
+            const authResult = await this.app.client.auth.test({ token: botToken });
+            this.botUserId = authResult.user_id || '';
+            console.log(`[Slack] Bot connected: @${authResult.user} (team: ${authResult.team})`);
+            // 注册消息事件处理器
+            this.registerHandlers();
+            // 启动 Socket Mode
+            await this.app.start();
+            this.status = 'connected';
+            console.log('[Slack] Socket Mode started');
+        }
+        catch (error) {
+            this.status = 'error';
+            const msg = error instanceof Error ? error.message : String(error);
+            if (msg.includes("Cannot find package '@slack/bolt'") || msg.includes('ERR_MODULE_NOT_FOUND')) {
+                throw new Error('@slack/bolt is not installed. Run: npm install @slack/bolt');
+            }
+            throw error;
+        }
+    }
+    async stop() {
+        if (this.app) {
+            await this.app.stop();
+            this.app = null;
+        }
+        this.status = 'disconnected';
+        console.log('[Slack] Bot stopped');
+    }
+    async sendText(chatId, text, options) {
+        if (!this.app)
+            throw new Error('Slack bot not started');
+        const result = await this.app.client.chat.postMessage({
+            channel: chatId,
+            text,
+            mrkdwn: options?.parseMode === 'Markdown',
+            ...(options?.replyToMessageId ? { thread_ts: options.replyToMessageId } : {}),
+        });
+        return result.ts; // Slack 用时间戳作消息 ID
+    }
+    async editText(chatId, messageId, text, options) {
+        if (!this.app)
+            return false;
+        try {
+            await this.app.client.chat.update({
+                channel: chatId,
+                ts: messageId,
+                text,
+            });
+            return true;
+        }
+        catch (error) {
+            // "message_not_found" 或 "cant_update_message" 不算致命错误
+            console.error('[Slack] editText failed:', error?.data?.error || error?.message || error);
+            return false;
+        }
+    }
+    async sendImage(chatId, imageData, mimeType, caption) {
+        if (!this.app)
+            throw new Error('Slack bot not started');
+        // Slack 新版文件上传 3 步流程
+        const ext = mimeType.split('/')[1] || 'png';
+        const filename = `image.${ext}`;
+        // 1. 获取上传 URL
+        const uploadResult = await this.app.client.files.getUploadURLExternal({
+            filename,
+            length: imageData.length,
+        });
+        if (!uploadResult.upload_url || !uploadResult.file_id) {
+            throw new Error('Failed to get Slack upload URL');
+        }
+        // 2. 上传文件
+        await fetch(uploadResult.upload_url, {
+            method: 'POST',
+            body: imageData,
+            headers: { 'Content-Type': mimeType },
+        });
+        // 3. 完成上传并分享到频道
+        await this.app.client.files.completeUploadExternal({
+            files: [{ id: uploadResult.file_id, title: caption || filename }],
+            channel_id: chatId,
+            initial_comment: caption,
+        });
+    }
+    getStatus() {
+        return this.status;
+    }
+    // ==========================================================================
+    // 消息处理
+    // ==========================================================================
+    registerHandlers() {
+        if (!this.app)
+            return;
+        // 普通消息事件（私聊 + 频道消息）
+        this.app.message(async ({ message, say }) => {
+            // 类型守卫：只处理标准消息
+            const msg = message;
+            if (msg.subtype)
+                return; // 忽略系统消息、编辑等
+            // 忽略 Bot 自己的消息
+            if (msg.user === this.botUserId)
+                return;
+            if (msg.bot_id)
+                return;
+            const channelType = msg.channel_type;
+            const isGroup = channelType === 'channel' || channelType === 'group' || channelType === 'mpim';
+            const chatId = msg.channel;
+            const senderId = msg.user || '';
+            // 白名单检查
+            if (!this.isAllowed(senderId, chatId, isGroup))
+                return;
+            // 群组消息处理
+            if (isGroup) {
+                if (!this.config?.allowGroups)
+                    return;
+                const trigger = this.config.groupTrigger || 'mention';
+                if (trigger === 'mention') {
+                    // 普通 message 事件不是 @mention，跳过（@mention 由 app_mention 处理）
+                    return;
+                }
+                // trigger === 'always' 时处理所有消息
+            }
+            this.emitMessage(msg, isGroup, false);
+        });
+        // @mention 事件（群组中 @机器人）
+        this.app.event('app_mention', async ({ event }) => {
+            const msg = event;
+            // 忽略 DM 中的 app_mention（和 message 事件重复）
+            if (msg.channel_type === 'im')
+                return;
+            const chatId = msg.channel;
+            const senderId = msg.user || '';
+            const isGroup = true;
+            // 白名单检查
+            if (!this.isAllowed(senderId, chatId, isGroup))
+                return;
+            // 群组必须允许
+            if (!this.config?.allowGroups)
+                return;
+            this.emitMessage(msg, isGroup, true);
+        });
+    }
+    emitMessage(msg, isGroup, isMentioned) {
+        if (!this.onMessage)
+            return;
+        let text = msg.text || '';
+        // 去掉 @mention
+        if (isMentioned && this.botUserId) {
+            text = text.replace(new RegExp(`<@${this.botUserId}>`, 'g'), '').trim();
+        }
+        // 忽略空消息
+        if (!text.trim())
+            return;
+        const inbound = {
+            channel: 'slack-bot',
+            senderId: msg.user || '',
+            senderName: msg.user || 'Unknown',
+            chatId: msg.channel,
+            text: text.trim(),
+            isGroup,
+            isMentioned,
+            messageId: msg.ts, // Slack 用时间戳作消息 ID
+            timestamp: msg.ts ? Math.floor(parseFloat(msg.ts) * 1000) : Date.now(),
+        };
+        this.onMessage(inbound);
+    }
+    // ==========================================================================
+    // 权限检查
+    // ==========================================================================
+    isAllowed(senderId, chatId, isGroup) {
+        const allowList = this.config?.allowList;
+        // 没有白名单 = 全部拒绝（安全默认值）
+        if (!allowList || allowList.length === 0) {
+            return false;
+        }
+        // '*' = 全部放行
+        if (allowList.includes('*'))
+            return true;
+        // 检查 senderId (U开头)
+        if (allowList.includes(senderId))
+            return true;
+        // 群组：检查 chatId (C/G/D 开头)
+        if (isGroup && allowList.includes(chatId))
+            return true;
+        return false;
+    }
+}
+//# sourceMappingURL=slack-bot.js.map

package/dist/web/server/channels/adapters/slack-bot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-bot.js","sourceRoot":"","sources":["../../../../../src/web/server/channels/adapters/slack-bot.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,mBAAmB;AACnB,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,OAAO,eAAe;IACjB,EAAE,GAAG,WAAW,CAAC;IACjB,IAAI,GAAG,WAAW,CAAC;IAEpB,GAAG,GAAoB,IAAI,CAAC;IAC5B,MAAM,GAAkB,cAAc,CAAC;IACvC,MAAM,GAAyB,IAAI,CAAC;IACpC,SAAS,GAA2C,IAAI,CAAC;IACjE,iCAAiC;IACzB,SAAS,GAAW,EAAE,CAAC;IAE/B,KAAK,CAAC,KAAK,CAAC,MAAqB,EAAE,SAAwC;QACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC;QAE9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;QACnH,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,+GAA+G,CAAC,CAAC;QACnI,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YAE5C,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC;gBACjB,KAAK,EAAE,QAAQ;gBACf,QAAQ;gBACR,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YAEH,YAAY;YACZ,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,2BAA2B,UAAU,CAAC,IAAI,WAAW,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;YAErF,YAAY;YACZ,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAExB,iBAAiB;YACjB,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAE7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACtB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,IAAI,GAAG,CAAC,QAAQ,CAAC,mCAAmC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;gBAC9F,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAChF,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,IAAY,EAAE,OAAqB;QAChE,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;YACpD,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,MAAM,EAAE,OAAO,EAAE,SAAS,KAAK,UAAU;YACzC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9E,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,mBAAmB;IACvC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,SAAiB,EAAE,IAAY,EAAE,OAAqB;QACnF,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAE5B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;gBAChC,OAAO,EAAE,MAAM;gBACf,EAAE,EAAE,SAAS;gBACb,IAAI;aACL,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,qDAAqD;YACrD,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,CAAC;YACzF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,SAAiB,EAAE,QAAgB,EAAE,OAAgB;QACnF,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAExD,qBAAqB;QACrB,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;QAC5C,MAAM,QAAQ,GAAG,SAAS,GAAG,EAAE,CAAC;QAEhC,cAAc;QACd,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC;YACpE,QAAQ;YACR,MAAM,EAAE,SAAS,CAAC,MAAM;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,UAAU,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,UAAU;QACV,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE;YACnC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE;SACtC,CAAC,CAAC;QAEH,gBAAgB;QAChB,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC;YACjD,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,EAAE,CAAC;YACjE,UAAU,EAAE,MAAM;YAClB,eAAe,EAAE,OAAO;SACzB,CAAC,CAAC;IACL,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,6EAA6E;IAC7E,OAAO;IACP,6EAA6E;IAErE,gBAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO;QAEtB,oBAAoB;QACpB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;YAC1C,eAAe;YACf,MAAM,GAAG,GAAG,OAAc,CAAC;YAC3B,IAAI,GAAG,CAAC,OAAO;gBAAE,OAAO,CAAC,aAAa;YAEtC,eAAe;YACf,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS;gBAAE,OAAO;YACxC,IAAI,GAAG,CAAC,MAAM;gBAAE,OAAO;YAEvB,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC;YACrC,MAAM,OAAO,GAAG,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,OAAO,IAAI,WAAW,KAAK,MAAM,CAAC;YAC/F,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;YAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAEhC,QAAQ;YACR,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,OAAO;YAEvD,SAAS;YACT,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW;oBAAE,OAAO;gBAEtC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,SAAS,CAAC;gBACtD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,yDAAyD;oBACzD,OAAO;gBACT,CAAC;gBACD,+BAA+B;YACjC,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,wBAAwB;QACxB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YAChD,MAAM,GAAG,GAAG,KAAY,CAAC;YAEzB,uCAAuC;YACvC,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI;gBAAE,OAAO;YAEtC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;YAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC;YAErB,QAAQ;YACR,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;gBAAE,OAAO;YAEvD,SAAS;YACT,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW;gBAAE,OAAO;YAEtC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,GAAQ,EAAE,OAAgB,EAAE,WAAoB;QAClE,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAE5B,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAE1B,cAAc;QACd,IAAI,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1E,CAAC;QAED,QAAQ;QACR,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO;QAEzB,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;YACxB,UAAU,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS;YACjC,MAAM,EAAE,GAAG,CAAC,OAAO;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,OAAO;YACP,WAAW;YACX,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,mBAAmB;YACtC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;SACvE,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,6EAA6E;IAC7E,OAAO;IACP,6EAA6E;IAErE,SAAS,CAAC,QAAgB,EAAE,MAAc,EAAE,OAAgB;QAClE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC;QAEzC,sBAAsB;QACtB,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,aAAa;QACb,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzC,oBAAoB;QACpB,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAE9C,0BAA0B;QAC1B,IAAI,OAAO,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAEvD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/web/server/channels/adapters/telegram.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Telegram Bot 适配器
+ *
+ * 使用 grammY 库连接 Telegram Bot API。
+ * 参考 OpenClaw extensions/telegram/ 的设计，但大幅简化：
+ * - 只处理文本和图片消息
+ * - 只支持 Long Polling（不搞 Webhook）
+ * - 白名单通过 allowList 配置
+ */
+import type { ChannelAdapter, ChannelConfig, ChannelStatus, InboundMessage, SendOptions } from '../types.js';
+export declare class TelegramAdapter implements ChannelAdapter {
+    readonly id = "telegram";
+    readonly name = "Telegram";
+    private bot;
+    private status;
+    private config;
+    private onMessage;
+    /** Bot 自己的 username（用于群消息 @mention 检测） */
+    private botUsername;
+    start(config: ChannelConfig, onMessage: (msg: InboundMessage) => void): Promise<void>;
+    stop(): Promise<void>;
+    sendText(chatId: string, text: string, options?: SendOptions): Promise<string | void>;
+    editText(chatId: string, messageId: string, text: string, options?: SendOptions): Promise<boolean>;
+    sendImage(chatId: string, imageData: Buffer, mimeType: string, caption?: string): Promise<void>;
+    getStatus(): ChannelStatus;
+    private registerHandlers;
+    private handleMessage;
+    private isAllowed;
+    private checkMention;
+    private removeMention;
+}
+//# sourceMappingURL=telegram.d.ts.map

package/dist/web/server/channels/adapters/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../../../../src/web/server/channels/adapters/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM7G,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAAgD;IACjE,0CAA0C;IAC1C,OAAO,CAAC,WAAW,CAAc;IAE3B,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDrF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkCrF,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAkClG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrG,SAAS,IAAI,aAAa;IAQ1B,OAAO,CAAC,gBAAgB;IAkCxB,OAAO,CAAC,aAAa;IAwDrB,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;CAItB"}

package/dist/web/server/channels/adapters/telegram.js

@@ -0,0 +1,261 @@
+/**
+ * Telegram Bot 适配器
+ *
+ * 使用 grammY 库连接 Telegram Bot API。
+ * 参考 OpenClaw extensions/telegram/ 的设计，但大幅简化：
+ * - 只处理文本和图片消息
+ * - 只支持 Long Polling（不搞 Webhook）
+ * - 白名单通过 allowList 配置
+ */
+export class TelegramAdapter {
+    id = 'telegram';
+    name = 'Telegram';
+    bot = null;
+    status = 'disconnected';
+    config = null;
+    onMessage = null;
+    /** Bot 自己的 username（用于群消息 @mention 检测） */
+    botUsername = '';
+    async start(config, onMessage) {
+        const botToken = config.credentials?.botToken;
+        if (!botToken) {
+            throw new Error('Telegram Bot Token is required. Set channels.telegram.credentials.botToken in settings.');
+        }
+        this.config = config;
+        this.onMessage = onMessage;
+        this.status = 'connecting';
+        try {
+            // 动态导入 grammY（用户可能没装）
+            const grammy = await import('grammy');
+            this.bot = new grammy.Bot(botToken);
+            // 获取 Bot 信息
+            const me = await this.bot.api.getMe();
+            this.botUsername = me.username || '';
+            console.log(`[Telegram] Bot connected: @${this.botUsername} (${me.first_name})`);
+            // 注册消息处理器
+            this.registerHandlers();
+            // 启动 Long Polling（不阻塞，在后台运行）
+            this.bot.start({
+                onStart: () => {
+                    this.status = 'connected';
+                    console.log('[Telegram] Long polling started');
+                },
+            });
+            // bot.start() 是非阻塞的（grammY v1 行为），但错误处理需要 catch
+            this.bot.catch((err) => {
+                console.error('[Telegram] Bot error:', err.message || err);
+                // 不改状态为 error，grammY 会自动重试
+            });
+        }
+        catch (error) {
+            this.status = 'error';
+            const msg = error instanceof Error ? error.message : String(error);
+            if (msg.includes("Cannot find package 'grammy'") || msg.includes('ERR_MODULE_NOT_FOUND')) {
+                throw new Error('grammy package is not installed. Run: npm install grammy');
+            }
+            throw error;
+        }
+    }
+    async stop() {
+        if (this.bot) {
+            await this.bot.stop();
+            this.bot = null;
+        }
+        this.status = 'disconnected';
+        console.log('[Telegram] Bot stopped');
+    }
+    async sendText(chatId, text, options) {
+        if (!this.bot)
+            throw new Error('Telegram bot not started');
+        const sendOpts = {};
+        // 解析模式
+        if (options?.parseMode === 'Markdown') {
+            sendOpts.parse_mode = 'Markdown';
+        }
+        else if (options?.parseMode === 'HTML') {
+            sendOpts.parse_mode = 'HTML';
+        }
+        // 回复
+        if (options?.replyToMessageId) {
+            sendOpts.reply_parameters = { message_id: Number(options.replyToMessageId) };
+        }
+        try {
+            const result = await this.bot.api.sendMessage(Number(chatId), text, sendOpts);
+            return String(result.message_id);
+        }
+        catch (error) {
+            // Markdown 解析失败，降级为纯文本
+            if (error?.description?.includes("can't parse")) {
+                const result = await this.bot.api.sendMessage(Number(chatId), text, {
+                    ...sendOpts,
+                    parse_mode: undefined,
+                });
+                return String(result.message_id);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    async editText(chatId, messageId, text, options) {
+        if (!this.bot)
+            return false;
+        const editOpts = {};
+        if (options?.parseMode === 'Markdown') {
+            editOpts.parse_mode = 'Markdown';
+        }
+        else if (options?.parseMode === 'HTML') {
+            editOpts.parse_mode = 'HTML';
+        }
+        try {
+            await this.bot.api.editMessageText(Number(chatId), Number(messageId), text, editOpts);
+            return true;
+        }
+        catch (error) {
+            // "message is not modified" 不算错误
+            if (error?.description?.includes('message is not modified')) {
+                return true;
+            }
+            // Markdown 解析失败，降级纯文本
+            if (error?.description?.includes("can't parse")) {
+                try {
+                    await this.bot.api.editMessageText(Number(chatId), Number(messageId), text, {
+                        ...editOpts,
+                        parse_mode: undefined,
+                    });
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            }
+            return false;
+        }
+    }
+    async sendImage(chatId, imageData, mimeType, caption) {
+        if (!this.bot)
+            throw new Error('Telegram bot not started');
+        const file = new (await import('grammy')).InputFile(imageData, `image.${mimeType.split('/')[1] || 'png'}`);
+        await this.bot.api.sendPhoto(Number(chatId), file, { caption });
+    }
+    getStatus() {
+        return this.status;
+    }
+    // ==========================================================================
+    // 消息处理
+    // ==========================================================================
+    registerHandlers() {
+        if (!this.bot)
+            return;
+        // 文本消息
+        this.bot.on('message:text', (ctx) => {
+            this.handleMessage(ctx, ctx.message.text);
+        });
+        // 图片消息（带可选 caption）
+        this.bot.on('message:photo', async (ctx) => {
+            const caption = ctx.message.caption || '';
+            // 获取最大分辨率的图片
+            const photos = ctx.message.photo;
+            const largest = photos[photos.length - 1];
+            try {
+                const file = await ctx.api.getFile(largest.file_id);
+                const fileUrl = `https://api.telegram.org/file/bot${this.config?.credentials?.botToken}/${file.file_path}`;
+                // 下载图片转 base64
+                const response = await fetch(fileUrl);
+                const buffer = Buffer.from(await response.arrayBuffer());
+                const base64 = buffer.toString('base64');
+                this.handleMessage(ctx, caption || 'Please analyze this image', [
+                    { data: base64, mimeType: 'image/jpeg' },
+                ]);
+            }
+            catch (error) {
+                console.error('[Telegram] Failed to download photo:', error);
+                this.handleMessage(ctx, caption || '(photo)');
+            }
+        });
+    }
+    handleMessage(ctx, text, images) {
+        if (!ctx.from || !ctx.chat || !this.onMessage)
+            return;
+        const isGroup = ctx.chat.type === 'group' || ctx.chat.type === 'supergroup';
+        const senderId = String(ctx.from.id);
+        const chatId = String(ctx.chat.id);
+        // 白名单检查
+        if (!this.isAllowed(senderId, ctx.from.username, chatId, isGroup)) {
+            return;
+        }
+        // 群组消息处理
+        if (isGroup) {
+            if (!this.config?.allowGroups)
+                return;
+            const trigger = this.config.groupTrigger || 'mention';
+            if (trigger === 'mention') {
+                // 检查是否 @了机器人
+                const isMentioned = this.checkMention(text, ctx);
+                if (!isMentioned)
+                    return;
+                // 去掉 @mention 文本
+                text = this.removeMention(text);
+            }
+            // trigger === 'always' 时所有消息都处理
+            // trigger === 'keyword' 暂不实现
+        }
+        // 忽略空消息
+        if (!text.trim() && (!images || images.length === 0))
+            return;
+        const msg = {
+            channel: 'telegram',
+            senderId,
+            senderName: [ctx.from.first_name, ctx.from.last_name].filter(Boolean).join(' '),
+            chatId,
+            text: text.trim(),
+            isGroup,
+            isMentioned: isGroup,
+            messageId: String(ctx.message?.message_id || ''),
+            images,
+            timestamp: (ctx.message?.date || Math.floor(Date.now() / 1000)) * 1000,
+        };
+        this.onMessage(msg);
+    }
+    // ==========================================================================
+    // 权限检查
+    // ==========================================================================
+    isAllowed(senderId, username, chatId, isGroup) {
+        const allowList = this.config?.allowList;
+        // 没有白名单 = 全部拒绝（安全默认值）
+        if (!allowList || allowList.length === 0) {
+            return false;
+        }
+        // '*' = 全部放行
+        if (allowList.includes('*'))
+            return true;
+        // 检查 senderId
+        if (allowList.includes(senderId))
+            return true;
+        // 检查 username（不带 @）
+        if (username && allowList.includes(username))
+            return true;
+        // 群组：检查 chatId
+        if (isGroup && allowList.includes(chatId))
+            return true;
+        return false;
+    }
+    checkMention(text, ctx) {
+        // 方式 1：消息中包含 @botUsername
+        if (this.botUsername && text.includes(`@${this.botUsername}`)) {
+            return true;
+        }
+        // 方式 2：回复机器人的消息
+        const replyTo = ctx.message?.reply_to_message;
+        if (replyTo?.from?.is_bot && replyTo?.from?.username === this.botUsername) {
+            return true;
+        }
+        return false;
+    }
+    removeMention(text) {
+        if (!this.botUsername)
+            return text;
+        return text.replace(new RegExp(`@${this.botUsername}\\b`, 'gi'), '').trim();
+    }
+}
+//# sourceMappingURL=telegram.js.map

package/dist/web/server/channels/adapters/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../../../../src/web/server/channels/adapters/telegram.ts"],"names":[],"mappings":"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"}

package/dist/web/server/channels/adapters/whatsapp.d.ts

@@ -0,0 +1,48 @@
+/**
+ * WhatsApp Cloud API 适配器
+ *
+ * 使用 Meta Graph API 连接 WhatsApp Business Platform。
+ * 与其他适配器（Telegram/飞书/Slack）不同，WhatsApp 需要：
+ * - 公网可访问的 HTTPS Webhook 端点来接收消息
+ * - Meta 开发者账号 + WhatsApp Business 账号
+ *
+ * 收消息：Meta POST → /webhook/whatsapp（由 ChannelManager 挂载到 Express）
+ * 发消息：POST → https://graph.facebook.com/v21.0/{phoneNumberId}/messages
+ *
+ * 限制：
+ * - 不支持编辑已发送的消息（无 editText）
+ * - 图片需要先上传到 Meta 获取 media_id
+ */
+import type { ChannelAdapter, ChannelConfig, ChannelStatus, InboundMessage, SendOptions } from '../types.js';
+export declare class WhatsAppAdapter implements ChannelAdapter {
+    readonly id = "whatsapp";
+    readonly name = "WhatsApp";
+    private status;
+    private config;
+    private onMessage;
+    start(config: ChannelConfig, onMessage: (msg: InboundMessage) => void): Promise<void>;
+    stop(): Promise<void>;
+    sendText(chatId: string, text: string, _options?: SendOptions): Promise<string | void>;
+    sendImage(chatId: string, imageData: Buffer, mimeType: string, caption?: string): Promise<void>;
+    getStatus(): ChannelStatus;
+    /**
+     * 处理 Webhook 验证请求（GET）
+     * Meta 在配置 webhook 时会发一个 GET 请求验证 verify_token
+     */
+    handleWebhookVerify(query: Record<string, string>): {
+        status: number;
+        body: string;
+    };
+    /**
+     * 处理入站 Webhook 消息（POST）
+     * Meta 将消息事件 POST 到这个端点
+     */
+    handleWebhookMessage(body: any): void;
+    private processWhatsAppMessage;
+    /**
+     * 下载 WhatsApp 媒体文件并转发给 AI
+     */
+    private downloadAndForwardImage;
+    private isAllowed;
+}
+//# sourceMappingURL=whatsapp.d.ts.map

package/dist/web/server/channels/adapters/whatsapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../../../../src/web/server/channels/adapters/whatsapp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI7G,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAAgD;IAE3D,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BrF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmCtF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DrG,SAAS,IAAI,aAAa;IAQ1B;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAcpF;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAkCrC,OAAO,CAAC,sBAAsB;IAkF9B;;OAEG;YACW,uBAAuB;IAoDrC,OAAO,CAAC,SAAS;CAoBlB"}