@kirigaya/openclaw-onebot 1.0.0

package/dist/connection.js

@@ -0,0 +1,426 @@
+/**
+ * OneBot WebSocket 连接与 API 调用
+ *
+ * 图片消息：网络 URL 会先下载到本地再发送（兼容 Lagrange.Core retcode 1200），
+ * 并定期清理临时文件。
+ */
+import WebSocket from "ws";
+import { createServer } from "http";
+import https from "https";
+import http from "http";
+import { writeFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+const IMAGE_TEMP_DIR = join(tmpdir(), "openclaw-onebot");
+const DOWNLOAD_TIMEOUT_MS = 30000;
+/** 使用 Node 内置 http(s) 下载 URL，避免 fetch 在某些环境下的兼容性问题 */
+function downloadUrl(url) {
+    return new Promise((resolve, reject) => {
+        const lib = url.startsWith("https") ? https : http;
+        const req = lib.get(url, (res) => {
+            const redirect = res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location;
+            if (redirect) {
+                downloadUrl(redirect.startsWith("http") ? redirect : new URL(redirect, url).href).then(resolve).catch(reject);
+                return;
+            }
+            if (res.statusCode && res.statusCode >= 400) {
+                reject(new Error(`HTTP ${res.statusCode} ${res.statusMessage}`));
+                return;
+            }
+            const chunks = [];
+            res.on("data", (chunk) => chunks.push(chunk));
+            res.on("end", () => resolve(Buffer.concat(chunks)));
+            res.on("error", reject);
+        });
+        req.on("error", reject);
+        req.setTimeout(DOWNLOAD_TIMEOUT_MS, () => {
+            req.destroy();
+            reject(new Error("Download timeout"));
+        });
+    });
+}
+const IMAGE_TEMP_MAX_AGE_MS = 60 * 60 * 1000; // 1 小时
+const IMAGE_TEMP_CLEANUP_INTERVAL_MS = 60 * 60 * 1000; // 每小时清理一次
+let imageTempCleanupTimer = null;
+/** 清理过期的临时图片文件 */
+function cleanupImageTemp() {
+    try {
+        if (!readdirSync)
+            return;
+        const files = readdirSync(IMAGE_TEMP_DIR);
+        const now = Date.now();
+        for (const f of files) {
+            const p = join(IMAGE_TEMP_DIR, f);
+            try {
+                const st = statSync(p);
+                if (st.isFile() && now - st.mtimeMs > IMAGE_TEMP_MAX_AGE_MS) {
+                    unlinkSync(p);
+                }
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    catch {
+        /* dir not exist or readdir failed */
+    }
+}
+/** 将 mediaUrl 解析为可发送的 file 路径。网络 URL 下载到本地，base64 解码到本地，定期清理过期文件 */
+async function resolveImageToLocalPath(image) {
+    const trimmed = image?.trim();
+    if (!trimmed)
+        throw new Error("Empty image");
+    if (/^https?:\/\//i.test(trimmed)) {
+        cleanupImageTemp();
+        const buf = await downloadUrl(trimmed);
+        const ext = (trimmed.match(/\.(png|jpg|jpeg|gif|webp|bmp)(?:\?|$)/i)?.[1] ?? "png").toLowerCase();
+        mkdirSync(IMAGE_TEMP_DIR, { recursive: true });
+        const tmpPath = join(IMAGE_TEMP_DIR, `img-${Date.now()}-${Math.random().toString(36).slice(2)}.${ext}`);
+        writeFileSync(tmpPath, buf);
+        return tmpPath.replace(/\\/g, "/");
+    }
+    if (trimmed.startsWith("base64://")) {
+        cleanupImageTemp();
+        const b64 = trimmed.slice(9);
+        const buf = Buffer.from(b64, "base64");
+        mkdirSync(IMAGE_TEMP_DIR, { recursive: true });
+        const tmpPath = join(IMAGE_TEMP_DIR, `img-${Date.now()}-${Math.random().toString(36).slice(2)}.png`);
+        writeFileSync(tmpPath, buf);
+        return tmpPath.replace(/\\/g, "/");
+    }
+    if (trimmed.startsWith("file://")) {
+        return trimmed.slice(7).replace(/\\/g, "/");
+    }
+    return trimmed.replace(/\\/g, "/");
+}
+/** 启动临时图片定期清理（每小时执行一次） */
+export function startImageTempCleanup() {
+    stopImageTempCleanup();
+    imageTempCleanupTimer = setInterval(cleanupImageTemp, IMAGE_TEMP_CLEANUP_INTERVAL_MS);
+}
+/** 停止临时图片定期清理 */
+export function stopImageTempCleanup() {
+    if (imageTempCleanupTimer) {
+        clearInterval(imageTempCleanupTimer);
+        imageTempCleanupTimer = null;
+    }
+}
+let ws = null;
+let wsServer = null;
+let httpServer = null;
+const pendingEcho = new Map();
+let echoCounter = 0;
+let connectionReadyResolve = null;
+const connectionReadyPromise = new Promise((r) => { connectionReadyResolve = r; });
+function nextEcho() {
+    return `onebot-${Date.now()}-${++echoCounter}`;
+}
+export function handleEchoResponse(payload) {
+    if (payload?.echo && pendingEcho.has(payload.echo)) {
+        const h = pendingEcho.get(payload.echo);
+        h?.resolve(payload);
+        return true;
+    }
+    return false;
+}
+function getLogger() {
+    return globalThis.__onebotApi?.logger ?? {};
+}
+function sendOneBotAction(wsocket, action, params, log = getLogger()) {
+    const echo = nextEcho();
+    const payload = { action, params, echo };
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            pendingEcho.delete(echo);
+            log.warn?.(`[onebot] sendOneBotAction ${action} timeout`);
+            reject(new Error(`OneBot action ${action} timeout`));
+        }, 15000);
+        pendingEcho.set(echo, {
+            resolve: (v) => {
+                clearTimeout(timeout);
+                pendingEcho.delete(echo);
+                if (v?.retcode !== 0)
+                    log.warn?.(`[onebot] sendOneBotAction ${action} retcode=${v?.retcode} msg=${v?.msg ?? ""}`);
+                resolve(v);
+            },
+        });
+        wsocket.send(JSON.stringify(payload), (err) => {
+            if (err) {
+                pendingEcho.delete(echo);
+                clearTimeout(timeout);
+                reject(err);
+            }
+        });
+    });
+}
+export function getWs() {
+    return ws;
+}
+/** 为 WebSocket 设置 echo 响应处理（按需连接时需调用，以便 sendOneBotAction 能收到响应） */
+function setupEchoHandler(socket) {
+    socket.on("message", (data) => {
+        try {
+            const payload = JSON.parse(data.toString());
+            handleEchoResponse(payload);
+        }
+        catch {
+            /* ignore */
+        }
+    });
+}
+/** 等待 WebSocket 连接就绪（service 启动后异步建立连接，发送前需先等待） */
+export async function waitForConnection(timeoutMs = 30000) {
+    if (ws && ws.readyState === WebSocket.OPEN)
+        return ws;
+    const log = getLogger();
+    log.info?.("[onebot] waitForConnection: waiting for WebSocket...");
+    return Promise.race([
+        connectionReadyPromise.then(() => {
+            if (ws && ws.readyState === WebSocket.OPEN)
+                return ws;
+            throw new Error("OneBot WebSocket not connected");
+        }),
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`OneBot WebSocket not connected after ${timeoutMs}ms. Ensure "openclaw gateway run" is running and OneBot (Lagrange.Core) is connected.`)), timeoutMs)),
+    ]);
+}
+/**
+ * 确保有可用的 WebSocket 连接。当 service 未启动时，
+ * forward-websocket 模式直接建立连接（message send 可独立运行）；
+ * backward-websocket 模式需等待 gateway 的 service 建立连接。
+ */
+export async function ensureConnection(getConfig, timeoutMs = 30000) {
+    if (ws && ws.readyState === WebSocket.OPEN)
+        return ws;
+    const config = getConfig();
+    if (!config)
+        throw new Error("OneBot not configured");
+    const log = getLogger();
+    if (config.type === "forward-websocket") {
+        log.info?.("[onebot] 连接 OneBot (forward-websocket)...");
+        const socket = await connectForward(config);
+        setupEchoHandler(socket);
+        setWs(socket);
+        return socket;
+    }
+    return waitForConnection(timeoutMs);
+}
+export async function sendPrivateMsg(userId, text, getConfig) {
+    const socket = getConfig
+        ? await ensureConnection(getConfig)
+        : await waitForConnection();
+    const res = await sendOneBotAction(socket, "send_private_msg", { user_id: userId, message: text });
+    if (res?.retcode !== 0) {
+        throw new Error(res?.msg ?? `OneBot send_private_msg failed (retcode=${res?.retcode})`);
+    }
+    return res?.data?.message_id;
+}
+export async function sendGroupMsg(groupId, text, getConfig) {
+    const socket = getConfig
+        ? await ensureConnection(getConfig)
+        : await waitForConnection();
+    const res = await sendOneBotAction(socket, "send_group_msg", { group_id: groupId, message: text });
+    if (res?.retcode !== 0) {
+        throw new Error(res?.msg ?? `OneBot send_group_msg failed (retcode=${res?.retcode})`);
+    }
+    return res?.data?.message_id;
+}
+export async function sendGroupImage(groupId, image, log = getLogger(), getConfig) {
+    log.info?.(`[onebot] sendGroupImage entry: groupId=${groupId} image=${image?.slice?.(0, 80) ?? ""}`);
+    const socket = getConfig ? await ensureConnection(getConfig) : await waitForConnection();
+    log.info?.(`222[onebot] sendGroupImage entry: groupId=${groupId} image=${image?.slice?.(0, 80) ?? ""}`);
+    try {
+        const filePath = image.startsWith("[") ? null : await resolveImageToLocalPath(image);
+        const seg = image.startsWith("[")
+            ? JSON.parse(image)
+            : [{ type: "image", data: { file: filePath } }];
+        log.info?.(`333[onebot] sendGroupImage entry: groupId=${groupId} image=${image?.slice?.(0, 80) ?? ""}`);
+        const res = await sendOneBotAction(socket, "send_group_msg", { group_id: groupId, message: seg }, log);
+        if (res?.retcode !== 0) {
+            throw new Error(res?.msg ?? `OneBot send_group_msg (image) failed (retcode=${res?.retcode})`);
+        }
+        log.info?.(`[onebot] sendGroupImage done: retcode=${res?.retcode ?? "?"}`);
+        return res?.data?.message_id;
+    }
+    catch (error) {
+        log.warn?.(`[onebot] sendGroupImage error: ${error}`);
+    }
+}
+export async function sendPrivateImage(userId, image, log = getLogger(), getConfig) {
+    log.info?.(`[onebot] sendPrivateImage entry: userId=${userId} image=${image?.slice?.(0, 80) ?? ""}`);
+    const socket = getConfig ? await ensureConnection(getConfig) : await waitForConnection();
+    const filePath = image.startsWith("[") ? null : await resolveImageToLocalPath(image);
+    const seg = image.startsWith("[")
+        ? JSON.parse(image)
+        : [{ type: "image", data: { file: filePath } }];
+    const res = await sendOneBotAction(socket, "send_private_msg", { user_id: userId, message: seg }, log);
+    if (res?.retcode !== 0) {
+        throw new Error(res?.msg ?? `OneBot send_private_msg (image) failed (retcode=${res?.retcode})`);
+    }
+    log.info?.(`[onebot] sendPrivateImage done: retcode=${res?.retcode ?? "?"}`);
+    return res?.data?.message_id;
+}
+export async function uploadGroupFile(groupId, file, name) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        throw new Error("OneBot WebSocket not connected");
+    await sendOneBotAction(ws, "upload_group_file", { group_id: groupId, file, name });
+}
+export async function uploadPrivateFile(userId, file, name) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        throw new Error("OneBot WebSocket not connected");
+    await sendOneBotAction(ws, "upload_private_file", { user_id: userId, file, name });
+}
+/** 撤回消息 */
+export async function deleteMsg(messageId) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        throw new Error("OneBot WebSocket not connected");
+    await sendOneBotAction(ws, "delete_msg", { message_id: messageId });
+}
+/**
+ * 对消息进行表情回应（Lagrange/QQ NT 扩展 API）
+ * @param message_id 需要回应的消息 ID（用户发送的消息）
+ * @param emoji_id 表情 ID，1 通常为点赞
+ * @param is_set true 添加，false 取消
+ */
+export async function setMsgEmojiLike(message_id, emoji_id, is_set = true) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        throw new Error("OneBot WebSocket not connected");
+    await sendOneBotAction(ws, "set_msg_emoji_like", { message_id, emoji_id, is_set });
+}
+/** 获取陌生人信息（含 nickname） */
+export async function getStrangerInfo(userId) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        return null;
+    try {
+        const res = await sendOneBotAction(ws, "get_stranger_info", { user_id: userId, no_cache: false });
+        if (res?.retcode === 0 && res?.data)
+            return { nickname: String(res.data.nickname ?? "") };
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 获取群成员信息（含 nickname、card） */
+export async function getGroupMemberInfo(groupId, userId) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        return null;
+    try {
+        const res = await sendOneBotAction(ws, "get_group_member_info", { group_id: groupId, user_id: userId, no_cache: false });
+        if (res?.retcode === 0 && res?.data) {
+            return { nickname: String(res.data.nickname ?? ""), card: String(res.data.card ?? "") };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** 获取群信息（含 group_name） */
+export async function getGroupInfo(groupId) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        return null;
+    try {
+        const res = await sendOneBotAction(ws, "get_group_info", { group_id: groupId, no_cache: false });
+        if (res?.retcode === 0 && res?.data)
+            return { group_name: String(res.data.group_name ?? "") };
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** QQ 头像 URL，s=640 为常用尺寸 */
+export function getAvatarUrl(userId, size = 640) {
+    return `https://q1.qlogo.cn/g?b=qq&nk=${userId}&s=${size}`;
+}
+/** 获取单条消息（需 OneBot 实现支持） */
+export async function getMsg(messageId) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        return null;
+    try {
+        const res = await sendOneBotAction(ws, "get_msg", { message_id: messageId });
+        if (res?.retcode === 0 && res?.data)
+            return res.data;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 获取群聊历史消息（Lagrange.Core 扩展 API，go-cqhttp 等可能不支持）
+ * @param groupId 群号
+ * @param opts message_seq 起始序号；message_id 起始消息 ID；count 数量
+ */
+export async function getGroupMsgHistory(groupId, opts = { count: 20 }) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        return [];
+    try {
+        const res = await sendOneBotAction(ws, "get_group_msg_history", {
+            group_id: groupId,
+            message_seq: opts.message_seq,
+            message_id: opts.message_id,
+            count: opts.count ?? 20,
+        });
+        if (res?.retcode === 0 && res?.data?.messages)
+            return res.data.messages;
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+export async function connectForward(config) {
+    const path = config.path ?? "/onebot/v11/ws";
+    const pathNorm = path.startsWith("/") ? path : `/${path}`;
+    const addr = `ws://${config.host}:${config.port}${pathNorm}`;
+    const headers = {};
+    if (config.accessToken) {
+        headers["Authorization"] = `Bearer ${config.accessToken}`;
+    }
+    const w = new WebSocket(addr, { headers });
+    await new Promise((resolve, reject) => {
+        w.on("open", () => resolve());
+        w.on("error", reject);
+    });
+    return w;
+}
+export async function createServerAndWait(config) {
+    const { WebSocketServer } = await import("ws");
+    const server = createServer();
+    httpServer = server;
+    const wss = new WebSocketServer({
+        server,
+        path: config.path ?? "/onebot/v11/ws",
+    });
+    const host = config.host || "0.0.0.0";
+    server.listen(config.port, host);
+    wsServer = wss;
+    return new Promise((resolve) => {
+        wss.on("connection", (socket) => {
+            resolve(socket);
+        });
+    });
+}
+export function setWs(socket) {
+    ws = socket;
+    if (socket && socket.readyState === WebSocket.OPEN && connectionReadyResolve) {
+        connectionReadyResolve();
+        connectionReadyResolve = null;
+    }
+}
+export function stopConnection() {
+    if (ws) {
+        ws.close();
+        ws = null;
+    }
+    if (wsServer) {
+        wsServer.close();
+        wsServer = null;
+    }
+    if (httpServer) {
+        httpServer.close();
+        httpServer = null;
+    }
+}

package/dist/debug-log.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 调试日志：写入文件，便于追踪 sendMedia / sendText 调用链
+ * 开发模式下生效（NODE_ENV !== 'production'）
+ * 日志路径：process.cwd()/openclaw-onebot-debug.log
+ */
+export declare function isDevLogEnabled(): boolean;
+export declare function debugLog(layer: string, msg: string, data?: Record<string, unknown>): void;

package/dist/debug-log.js

@@ -0,0 +1,24 @@
+/**
+ * 调试日志：写入文件，便于追踪 sendMedia / sendText 调用链
+ * 开发模式下生效（NODE_ENV !== 'production'）
+ * 日志路径：process.cwd()/openclaw-onebot-debug.log
+ */
+import fs from "node:fs";
+import path from "node:path";
+function getLogPath() {
+    return path.join(process.cwd(), "openclaw-onebot-debug.log");
+}
+export function isDevLogEnabled() {
+    if (process.env.OPENCLAW_ONEBOT_DEBUG === "1")
+        return true;
+    return process.env.NODE_ENV !== "production";
+}
+export function debugLog(layer, msg, data) {
+    if (!isDevLogEnabled())
+        return;
+    try {
+        const line = `${new Date().toISOString()} [${layer}] ${msg}${data ? " " + JSON.stringify(data) : ""}\n`;
+        fs.appendFileSync(getLogPath(), line);
+    }
+    catch (_) { }
+}

package/dist/gateway-proxy.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 当 openclaw message send 在独立进程运行（无 WebSocket）时，
+ * 通过 Gateway HTTP API /tools/invoke 代理发送
+ */
+export declare function invokeGatewayTool(cfg: Record<string, unknown>, tool: string, args: Record<string, unknown>): Promise<{
+    ok: boolean;
+    error?: string;
+}>;

package/dist/gateway-proxy.js

@@ -0,0 +1,36 @@
+/**
+ * 当 openclaw message send 在独立进程运行（无 WebSocket）时，
+ * 通过 Gateway HTTP API /tools/invoke 代理发送
+ */
+export async function invokeGatewayTool(cfg, tool, args) {
+    const gw = cfg?.gateway;
+    const port = gw?.port ?? 18789;
+    const bind = gw?.bind ?? "loopback";
+    const host = bind === "loopback" ? "127.0.0.1" : "0.0.0.0";
+    const auth = gw?.auth;
+    const token = auth?.token;
+    const url = `http://${host}:${port}/tools/invoke`;
+    const headers = { "Content-Type": "application/json" };
+    if (token)
+        headers["Authorization"] = `Bearer ${token}`;
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ tool, action: "json", args }),
+        });
+        if (!res.ok) {
+            return { ok: false, error: `Gateway API ${res.status}: ${await res.text().catch(() => "")}` };
+        }
+        const data = (await res.json().catch(() => ({})));
+        if (data?.error)
+            return { ok: false, error: data.error };
+        return { ok: true };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: e instanceof Error ? e.message : String(e),
+        };
+    }
+}

package/dist/handlers/group-increase.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 新成员入群欢迎
+ *
+ * 支持：
+ * 1. 简单文本模板（message），占位符：{name}、{userId}、{groupName}、{groupId}、{avatarUrl}
+ * 2. 自定义 handler 脚本，可生成图片并返回，接收完整上下文
+ */
+import type { OneBotMessage } from "../types.js";
+export interface GroupIncreaseContext {
+    groupId: number;
+    groupName: string;
+    userId: number;
+    userName: string;
+    avatarUrl: string;
+}
+export interface GroupIncreaseResult {
+    text?: string;
+    imagePath?: string;
+    imageUrl?: string;
+}
+export declare function handleGroupIncrease(api: any, msg: OneBotMessage): Promise<void>;

package/dist/handlers/group-increase.js

@@ -0,0 +1,95 @@
+/**
+ * 新成员入群欢迎
+ *
+ * 支持：
+ * 1. 简单文本模板（message），占位符：{name}、{userId}、{groupName}、{groupId}、{avatarUrl}
+ * 2. 自定义 handler 脚本，可生成图片并返回，接收完整上下文
+ */
+import { sendGroupMsg, sendGroupImage, getStrangerInfo, getGroupMemberInfo, getGroupInfo, getAvatarUrl, } from "../connection.js";
+import { loadScript } from "../load-script.js";
+import { resolve } from "path";
+async function resolveContext(groupId, userId) {
+    const [groupInfo, memberInfo] = await Promise.all([
+        getGroupInfo(groupId),
+        getGroupMemberInfo(groupId, userId),
+    ]);
+    const groupName = groupInfo?.group_name ?? String(groupId);
+    let userName;
+    if (memberInfo) {
+        userName = (memberInfo.card || memberInfo.nickname || "").trim() || memberInfo.nickname || String(userId);
+    }
+    else {
+        const stranger = await getStrangerInfo(userId);
+        userName = stranger?.nickname?.trim() || String(userId);
+    }
+    return {
+        groupId,
+        groupName,
+        userId,
+        userName,
+        avatarUrl: getAvatarUrl(userId),
+    };
+}
+function applyTemplate(template, ctx) {
+    return template
+        .replace(/\{name\}/g, ctx.userName)
+        .replace(/\{userId\}/g, String(ctx.userId))
+        .replace(/\{groupName\}/g, ctx.groupName)
+        .replace(/\{groupId\}/g, String(ctx.groupId))
+        .replace(/\{avatarUrl\}/g, ctx.avatarUrl);
+}
+export async function handleGroupIncrease(api, msg) {
+    const cfg = api.config;
+    const gi = cfg?.channels?.onebot?.groupIncrease;
+    if (!gi?.enabled)
+        return;
+    const groupId = msg.group_id;
+    const userId = msg.user_id;
+    let ctx;
+    try {
+        ctx = await resolveContext(groupId, userId);
+    }
+    catch (e) {
+        api.logger?.error?.(`[onebot] groupIncrease resolveContext failed: ${e?.message}`);
+        return;
+    }
+    let result = {};
+    const handlerPath = gi?.handler;
+    if (handlerPath?.trim()) {
+        try {
+            const mod = await loadScript(handlerPath);
+            const fn = mod?.default ?? mod?.generate ?? mod;
+            if (typeof fn === "function") {
+                result = (await fn(ctx)) ?? {};
+            }
+        }
+        catch (e) {
+            api.logger?.error?.(`[onebot] groupIncrease handler failed: ${e?.message}`);
+        }
+    }
+    const message = gi?.message;
+    if (message?.trim() && !result.text) {
+        result.text = applyTemplate(message, ctx);
+    }
+    const text = (result.text ?? "").trim();
+    const imagePath = result.imagePath?.trim();
+    const imageUrl = result.imageUrl?.trim();
+    if (!text && !imagePath && !imageUrl)
+        return;
+    try {
+        if (text)
+            await sendGroupMsg(groupId, text);
+        if (imagePath) {
+            const abs = imagePath.startsWith("file://") || imagePath.startsWith("http://") || imagePath.startsWith("https://")
+                ? imagePath
+                : resolve(process.cwd(), imagePath);
+            await sendGroupImage(groupId, abs);
+        }
+        if (imageUrl && !imagePath)
+            await sendGroupImage(groupId, imageUrl);
+        api.logger?.info?.(`[onebot] sent group welcome to ${groupId} for user ${userId} (${ctx.userName})`);
+    }
+    catch (e) {
+        api.logger?.error?.(`[onebot] group welcome failed: ${e?.message}`);
+    }
+}

package/dist/handlers/process-inbound.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 入站消息处理
+ */
+import type { OneBotMessage } from "../types.js";
+export declare const sessionHistories: Map<string, {
+    sender: string;
+    body: string;
+    timestamp: number;
+    messageId: string;
+}[]>;
+export declare function processInboundMessage(api: any, msg: OneBotMessage): Promise<void>;