dlinkclaw-openclaw 1.0.0

package/dist/src/client/dl-http.js

@@ -0,0 +1,223 @@
+import fs from 'fs';
+import path from 'path';
+import axios from 'axios';
+import { generateSignature, getDeviceId } from './crypto.js';
+import { FILE_LIMITS, IMAGE_EXTS } from './const.js';
+import mime from 'mime-types';
+import FormData from 'form-data';
+function getFileLimit(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return IMAGE_EXTS.has(ext) ? FILE_LIMITS.image.maxSize : FILE_LIMITS.attachment.maxSize;
+}
+export class DLHttp {
+    opts;
+    deviceId;
+    client;
+    logger;
+    constructor(opts, logger, timeout = 30000) {
+        this.opts = { ...opts };
+        this.logger = logger;
+        this.deviceId = getDeviceId();
+        this.client = axios.create({
+            baseURL: opts.baseUrl,
+            timeout: timeout,
+            headers: {
+                "Res-Type": "json",
+                "Device-Id": this.deviceId,
+                "Api-Key": opts.apiKey,
+                "User-Type": "2",
+                "User-From": "8",
+            }
+        });
+        this.client.interceptors.request.use((config) => {
+            // ========== 【请求发送前 打印日志】 ==========
+            const params = config.params || config.data;
+            this.logger.debug ?? ("======================================");
+            this.logger.debug ?? (`🚀 发送请求: ${config.method?.toUpperCase()}, ${config.baseURL}${config.url}`);
+            this.logger.debug ?? (`请求参数：", ${JSON.stringify(params)}`);
+            this.logger.debug ?? (`"🧾 请求头：\r\n${config.headers}`);
+            this.logger.debug ?? ("======================================\n");
+            return config;
+        }, (error) => {
+            this.logger.debug ?? (`❌ 请求发送失败：${error}`);
+            return Promise.reject(error);
+        });
+    }
+    randomString(len) {
+        const l = len || 32;
+        const $chars = "ABCDEFGHJKMNPQRSTWXYZabcdefhijkmnprstwxyz2345678";
+        const maxPos = $chars.length;
+        let pwd = "";
+        for (let i = 0; i < l; i++) {
+            pwd += $chars.charAt(Math.floor(Math.random() * maxPos));
+        }
+        return pwd;
+    }
+    ;
+    genSign(data) {
+        const timestamp = Date.now().toString();
+        const echostr = this.randomString(20);
+        const params = {
+            version: "1",
+            echostr: echostr,
+            deviceId: this.deviceId,
+            timestamp: timestamp,
+            timezone: Intl.DateTimeFormat().resolvedOptions().timeZone
+        };
+        if (data) {
+            for (const key in data) {
+                const value = data[key] || '';
+                if (value.length > 0) {
+                    params[key] = value.trim();
+                }
+            }
+        }
+        const signature = generateSignature(params, this.opts.secret);
+        return { params, signature };
+    }
+    response(res) {
+        if (res.status != 200) {
+            throw new Error(`Request Get Error:${String(res.statusText)}`);
+        }
+        const result = res.data;
+        if (result.success) {
+            return result.data;
+        }
+        throw new Error(String(result.msg));
+    }
+    async get(url, data) {
+        const { params, signature } = this.genSign(data);
+        const res = await this.client.get(url, {
+            "headers": {
+                "Sign": signature,
+                "Content-Type": "application/x-www-form-urlencoded"
+            },
+            "params": params,
+            "responseType": 'json'
+        });
+        return this.response(res);
+    }
+    async post(url, data) {
+        const { params, signature } = this.genSign(data);
+        const res = await this.client.post(url, params, {
+            "headers": {
+                "Sign": signature,
+                "Content-Type": "application/x-www-form-urlencoded"
+            },
+            "responseType": "json"
+        });
+        return this.response(res);
+    }
+    async upload(url, files, data) {
+        if (!files.length) {
+            throw new Error('No files to upload.');
+        }
+        let fileCount = 0; // 👈 用计数器代替 getLengthSync
+        const { params, signature } = this.genSign(data);
+        const form = new FormData();
+        for (const filePath of files) {
+            try {
+                // 1. 校验文件是否存在
+                if (!fs.existsSync(filePath)) {
+                    this.logger.warn(`The file does not exist.: ${filePath}`);
+                    continue;
+                }
+                // 2. 校验文件大小
+                const stat = await fs.promises.stat(filePath);
+                const maxSize = getFileLimit(filePath);
+                if (stat.size > maxSize) {
+                    const mb = maxSize / 1024 / 1024;
+                    this.logger.warn(`The file is too large and has been skipped.: ${filePath} (超过 ${mb}MB)`);
+                    continue;
+                }
+                // 3. 流式添加到 form
+                const fileName = path.basename(filePath);
+                const contentType = mime.lookup(filePath) || 'application/octet-stream';
+                form.append('files', fs.createReadStream(filePath), {
+                    filename: fileName,
+                    contentType,
+                });
+                fileCount++;
+                this.logger.info(`Files have been added.: ${fileName} (${(stat.size / 1024 / 1024).toFixed(2)}MB)`);
+            }
+            catch (e) {
+                this.logger.error(`Failed to read the file: ${filePath}, error=${e}`);
+            }
+        }
+        // 所有文件都失败的情况
+        // if (!form.getLengthSync()) {
+        //     throw new Error('所有文件均无效，无法上传');
+        // }
+        if (fileCount === 0) {
+            throw new Error('All files are invalid and cannot be uploaded.');
+        }
+        // 添加业务参数
+        for (const [key, value] of Object.entries(params ?? {})) {
+            form.append(key, value);
+        }
+        // 发送请求
+        const res = await this.client.post(url, form, {
+            headers: {
+                ...form.getHeaders(),
+                "Sign": signature // form-data 自动生成 boundary
+            },
+            responseType: 'json',
+            maxContentLength: Infinity, // axios 不限制响应大小
+            maxBodyLength: Infinity, // axios 不限制请求大小
+            timeout: 5 * 60 * 1000, // 5 分钟超时（大文件慢网）
+        });
+        return this.response(res);
+    }
+    async downloadFileRaw(url, { timeout = 10000, botType }) {
+        this.logger.info(`Downloading file...${url}`);
+        const config = {
+            timeout,
+            headers: {
+                'Content-Type': "application/json",
+            },
+        };
+        if (botType === 'dLink') {
+            const { params, signature } = this.genSign();
+            config.params = params;
+            config.headers = {
+                ...config.headers,
+                'Content-Type': 'application/x-www-form-urlencoded',
+                'Sign': signature,
+                'Api-Key': this.opts.apiKey,
+            };
+        }
+        const http = axios.create(config);
+        try {
+            const response = await http.get(url, {
+                responseType: 'arraybuffer'
+            });
+            // 从 Content-Disposition 头中解析文件名
+            const contentDisposition = response.headers['content-disposition'];
+            let filename;
+            if (contentDisposition) {
+                // 优先匹配 filename*=UTF-8''xxx 格式（RFC 5987）
+                const utf8Match = contentDisposition.match(/filename\*=UTF-8''([^;\s]+)/i);
+                if (utf8Match) {
+                    filename = decodeURIComponent(utf8Match[1]);
+                }
+                else {
+                    // 匹配 filename="xxx" 或 filename=xxx 格式
+                    const match = contentDisposition.match(/filename="?([^";\s]+)"?/i);
+                    if (match) {
+                        filename = decodeURIComponent(match[1]);
+                    }
+                }
+            }
+            if (botType === 'dLink' && (!filename || filename.length === 0)) {
+                const httpUrl = new URL(decodeURIComponent(url));
+                const uri = decodeURIComponent(httpUrl.pathname);
+                filename = uri.substring(uri.lastIndexOf('/') + 1);
+            }
+            this.logger.info(`File[${filename ?? ''}] downloaded successfully`);
+            return { buffer: Buffer.from(response.data), filename };
+        }
+        catch (error) {
+            throw new Error(`File download failed.! error:${String(error)}`);
+        }
+    }
+}

package/dist/src/client/media-handler.d.ts

@@ -0,0 +1,21 @@
+import { OpenClawConfig, PluginLogger, PluginRuntime } from "openclaw/plugin-sdk/core";
+import { DLClient } from "./dl-client.js";
+import { BotType, DLResolvedAccount } from "./types.js";
+import { InboundMediaFacts } from "openclaw/plugin-sdk/channel-inbound";
+/**
+ * 下载并保存所有文件到本地，每个文件的下载带超时保护
+ */
+export declare function downloadAndSaveFiles(params: {
+    client: DLClient;
+    fileUrls: string[];
+    fileAesKeys?: Map<string, string>;
+    account: DLResolvedAccount;
+    clawConfig: OpenClawConfig;
+    core: PluginRuntime;
+    channelId: string;
+    streamId: string;
+    botType: BotType;
+    logger: PluginLogger;
+    /** 2026-08-05 语音消息：为 true 时强制按音频处理（webm → .weba，contentType=audio/webm） */
+    forceAudio?: boolean;
+}): Promise<Array<InboundMediaFacts>>;

package/dist/src/client/media-handler.js

@@ -0,0 +1,196 @@
+// ============================================================================
+// 图片格式检测辅助函数（基于 file-type 包）
+// ============================================================================
+import { fileTypeFromBuffer } from "file-type";
+import { DEFAULT_MEDIA_MAX_MB, FILE_DOWNLOAD_TIMEOUT_MS } from "./const.js";
+import { withTimeout } from "./timeout.js";
+import { dlinkDecryptFile, ewxDecryptFile, md5 } from "./crypto.js";
+import mime from 'mime-types';
+/**
+ * 检测 Buffer 的内容类型
+ */
+async function detectFileContentType(data, filename) {
+    if (!data || data.length === 0) {
+        return 'application/octet-stream';
+    }
+    // 1.根据文件名精准判断文本类型（最准）
+    if (filename) {
+        // 2026-08-05 修复：原来 mime.lookup 结果被丢弃（未 return），导致 .weba 语音被 file-type 误判为 video/webm
+        // 现在文件名扩展名能识别时优先返回（.weba → audio/webm）
+        const mimeByExt = mime.lookup(filename);
+        if (mimeByExt) {
+            return mimeByExt;
+        }
+    }
+    // 2.通过Buffer识别文件类型
+    const fileTypeResult = await fileTypeFromBuffer(data);
+    if (fileTypeResult?.mime) {
+        return fileTypeResult.mime;
+    }
+    // 3. 二进制未识别 → 判断是否为【纯文本文件】(txt/md/json等)
+    try {
+        const text = data.toString('utf8');
+        if (typeof text === 'string') {
+            // 简单判断是否包含不可打印字符（排除乱码二进制）
+            const isBinary = /[\x00-\x08\x0B\x0C\x0E-\x1F]/.test(text);
+            if (!isBinary) {
+                return 'text/plain';
+            }
+        }
+    }
+    catch { }
+    return 'application/octet-stream';
+}
+function detectDocument(contentType) {
+    if (contentType.includes('json') ||
+        contentType.includes('msword ') ||
+        contentType.includes('pdf') ||
+        contentType.includes('sql') ||
+        (contentType.includes('/vnd.') && !contentType.includes("vnd.rar")) ||
+        contentType.startsWith("text/") ||
+        contentType.endsWith('/epub+zip') ||
+        contentType.endsWith('/x-mobipocket-ebook')) {
+        return 'document';
+    }
+    return undefined;
+}
+function detectZipPackage(contentType) {
+    if (contentType.endsWith('/zip') ||
+        contentType.endsWith('/vnd.rar') ||
+        contentType.endsWith('/x-rar-compressed') ||
+        contentType.endsWith('/x-7z-compressed') ||
+        contentType.endsWith("/gzip") ||
+        contentType.endsWith('/x-tar') ||
+        contentType.endsWith('/x-bzip2') ||
+        contentType.endsWith('/x-xz') ||
+        contentType.endsWith('/x-compress')) {
+        return 'document';
+    }
+    return undefined;
+}
+function detectScript(contentType) {
+    if (contentType.endsWith('/javascript') ||
+        contentType.endsWith('/typescript')) {
+        return 'document';
+    }
+    return undefined;
+}
+/**
+ * 下载并保存所有文件到本地，每个文件的下载带超时保护
+ */
+export async function downloadAndSaveFiles(params) {
+    const { client, fileUrls, fileAesKeys, account, clawConfig, core, channelId, streamId, botType, logger, forceAudio } = params;
+    const { config } = account;
+    const mediaList = [];
+    for (const fileUrl of fileUrls) {
+        try {
+            let buffer;
+            let contentType;
+            let originalFilename;
+            let kind;
+            const mediaMaxMb = config.mediaMaxMb || clawConfig.agents?.defaults?.mediaMaxMb || DEFAULT_MEDIA_MAX_MB;
+            const maxBytes = mediaMaxMb * 1024 * 1024;
+            const key = fileAesKeys?.get(md5(fileUrl));
+            try {
+                logger.info(`account[${account.accountId}] Downloading file from: ${fileUrl}, aseKey: ${key}`);
+                const res = await withTimeout(downloadFile(client, {
+                    url: fileUrl,
+                    aesKey: key,
+                    channelId,
+                    logger,
+                    botType
+                }), FILE_DOWNLOAD_TIMEOUT_MS, `${channelId} account[${account.accountId}] Manual file download timed out: ${fileUrl}`);
+                buffer = res.buffer;
+                contentType = await detectFileContentType(buffer, res.filename);
+                originalFilename = res.filename;
+            }
+            catch (err) {
+                logger.error(`${channelId} account[${account.accountId}] Failed to Manual download file: ${String(err)}`);
+                logger.info(`${channelId} account[${account.accountId}] use runtime api download..`);
+                const fetched = await withTimeout(core.channel.media.fetchRemoteMedia({ url: fileUrl }), FILE_DOWNLOAD_TIMEOUT_MS, `${channelId} account[${account.accountId}] use runtime api download timed out: ${fileUrl}`);
+                buffer = fetched.buffer;
+                contentType = fetched.contentType ?? "application/octet-stream";
+                originalFilename = fetched.fileName;
+            }
+            if (contentType.startsWith('image/')) {
+                kind = 'image';
+            }
+            else if (contentType.startsWith('audio/')) {
+                kind = 'audio';
+            }
+            else if (contentType.startsWith('video/')) {
+                kind = 'video';
+            }
+            else {
+                kind = detectDocument(contentType);
+                if (!kind) {
+                    kind = detectZipPackage(contentType);
+                }
+                if (!kind) {
+                    kind = detectScript(contentType);
+                }
+                if (!kind) {
+                    kind = 'unknown';
+                }
+            }
+            if (!kind) {
+                logger.warn(`禁止接收该类型[${contentType}]文件`);
+                client.publishToServer({ streamId, content: `[tag_error_not_allow_file_type]:${contentType}-${originalFilename}!`, kind: 'block', finish: true });
+                continue;
+            }
+            const saved = await core.channel.media.saveMediaBuffer(buffer, contentType, "inbound", maxBytes, originalFilename, 'The received file is saved in. [user directory]/.openclaw/media/inbound');
+            // 2026-08-05 语音消息：forceAudio 时强制按音频处理
+            // 背景1：webm 容器即使只有 Opus 音频轨，file-type 也识别为 video/webm，
+            //       openclaw 运行时 detectMime 优先用嗅探结果，导致 source_modality=video。
+            // 背景2：SenseAudio STT 不认 .weba 扩展名（返回 500），但认 .webm。
+            // 处理：保持 .webm 文件名（SenseAudio 能转写），仅把 contentType 强制为 audio/webm
+            //       （OpenClaw 的 source_modality 看 contentType，不看扩展名）。
+            //       不重命名文件，避免 .weba 导致 SenseAudio 500。
+            let savedPath = saved.path;
+            let savedContentType = saved.contentType;
+            if (forceAudio) {
+                savedContentType = 'audio/webm';
+                logger.info(`${channelId} account[${account.accountId}] voice file contentType forced to audio/webm: ${savedPath}`);
+            }
+            mediaList.push({ path: savedPath, contentType: savedContentType, messageId: streamId });
+            //logger.info(`${channelId} account[${account.accountId}] file saved to ${saved.path}, contentType=${saved.contentType}`);
+        }
+        catch (e) {
+            logger.error(`${channelId} account[${account.accountId}] Failed to download file: ${String(e)}`);
+        }
+    }
+    logger.info(`${channelId} account[${account.accountId}], mediaList = ${JSON.stringify(mediaList)}`);
+    return mediaList;
+}
+const downloadFile = async (client, params) => {
+    const { url, aesKey, channelId, logger, botType } = params;
+    logger.debug ?? (`${channelId} downloadFile: url=${url}, hasAesKey=${!!aesKey}`);
+    logger.info('Downloading and decrypting file...');
+    try {
+        // 下载加密的文件数据
+        const { buffer, filename } = await client.downloadFileRaw(url, botType);
+        // 如果没有提供 aesKey，直接返回原始数据
+        if (!aesKey || aesKey.length === 0) {
+            logger.warn(`${channelId} No aesKey provided, returning raw file data`);
+            return { buffer: buffer, filename };
+        }
+        // 使用独立的解密模块进行 AES-256-CBC 解密
+        let decryptedBuffer;
+        switch (botType) {
+            case "ewx":
+                decryptedBuffer = ewxDecryptFile(buffer, aesKey);
+                break;
+            case "qq":
+            case "dd":
+            case "feishu":
+            case "dLink":
+                decryptedBuffer = dlinkDecryptFile(buffer, aesKey);
+                break;
+        }
+        logger.info(`${channelId} File downloaded and decrypted successfully`);
+        return { buffer: decryptedBuffer, filename };
+    }
+    catch (error) {
+        throw new Error(`解密失败!,${error}`);
+    }
+};

package/dist/src/client/message.d.ts

@@ -0,0 +1,96 @@
+import { OpenClawConfig, PluginLogger, PluginRuntime } from "openclaw/plugin-sdk/core";
+import { BotType, DLKind, DLMessagePayload, DLResolvedAccount, FromPerson, ToAgent } from "./types.js";
+import { DLClient } from "./dl-client.js";
+import { HistoryEntry } from "openclaw/plugin-sdk/reply-history";
+import { InboundMediaFacts } from "openclaw/plugin-sdk/channel-inbound";
+export interface ParsedMessageContent {
+    textParts: string[];
+    imageUrls: string[];
+    imageAesKeys: Map<string, string>;
+    voiceUrls: string[];
+    voiceAesKeys: Map<string, string>;
+    videoUrls: string[];
+    videoAesKeys: Map<string, string>;
+    fileUrls: string[];
+    fileAesKeys: Map<string, string>;
+    quoteContent: string | undefined;
+}
+export interface Accumulators {
+    key: string;
+    expireTime: number;
+    accumulatedPayload: string;
+    originalFields: Omit<DLMessagePayload, 'payload' | 'finish' | 'streamId'>;
+}
+export type AccumulatorsStatus = Omit<Accumulators, 'expireTime' | 'relayTime' | 'originalFields'>;
+/**
+ * 主动回复参数
+ */
+export type AutoReplyOpts = {
+    toAgent: ToAgent;
+    fromUser: FromPerson;
+    botType: BotType;
+    chatId: string;
+    isGroup: boolean;
+    relayId: string;
+    notifyUrl?: string;
+    contactId?: string;
+};
+/**
+ * mqtt接收到消息后预处理
+ * @param msg
+ * @param logger
+ */
+export declare const messagePreviewHandler: (msg: DLMessagePayload, accountId: string, logger: PluginLogger) => AccumulatorsStatus;
+/**
+ * 消息出站时构建回复消息
+ * @param param0
+ * @returns
+ */
+export declare const buildDLReplyMessage: ({ streamId, content, finish, kind, runId }: {
+    streamId: string;
+    content: string;
+    finish: boolean;
+    kind: DLKind;
+    runId?: string;
+}) => DLMessagePayload | undefined;
+/**
+ * 解析消息内容（支持单条消息、图文混排和引用消息）
+ * @returns 提取的文本数组、图片URL数组和引用消息内容
+ */
+export declare function parseMessageContent(payload: string): ParsedMessageContent | undefined;
+export declare function buildMessageContext(params: {
+    core: PluginRuntime;
+    channelId: string;
+    account: DLResolvedAccount;
+    clawConfig: OpenClawConfig;
+    msg: DLMessagePayload;
+    imageList: Array<InboundMediaFacts>;
+    voiceList: Array<InboundMediaFacts>;
+    videoList: Array<InboundMediaFacts>;
+    fileList: Array<InboundMediaFacts>;
+    textBody?: string;
+    quoteContent?: string;
+    commandAuthorized?: boolean;
+    chatHistories: Map<string, HistoryEntry[]>;
+    historyLimit: number;
+    logger: PluginLogger;
+    client: DLClient;
+    streamId: string;
+    relayId: string;
+}): Promise<any>;
+/**
+ * 路由消息到核心处理流程并处理回复
+ */
+export declare function routeAndDispatchMessage(ctx: {
+    ctxPayload: ReturnType<typeof buildMessageContext>;
+    core: PluginRuntime;
+    cfg: OpenClawConfig;
+    client: DLClient;
+    channelId: string;
+    accountId: string;
+    streamId: string;
+    accStatus: AccumulatorsStatus;
+    commandAuthorized?: boolean;
+    chatOpts?: AutoReplyOpts;
+    logger: PluginLogger;
+}): Promise<void>;