@qqvu/openclaw-channel 1.0.0

package/dist/api-client.d.ts

@@ -0,0 +1,77 @@
+import type { PufferfishAccount, SendMessageRequest, SendMessageResponse } from './types.js';
+/**
+ * Pufferfish API 客户端
+ * 负责与 Pufferfish 服务器的 HTTP API 通信
+ */
+export declare class PufferfishAPIClient {
+    private baseURL;
+    private token;
+    private privateKey?;
+    private botUserId;
+    constructor(account: PufferfishAccount);
+    /**
+     * 请求全局 Token（用于 Discovery API）
+     * @param workerId OpenClaw 实例唯一标识
+     * @param apiKey Operator API Key
+     * @returns 返回 token 和过期时间
+     */
+    requestGlobalToken(workerId: string, apiKey: string): Promise<{
+        token: string;
+        expiresAt: number;
+    }>;
+    /**
+     * 刷新全局 Token
+     * @param workerId OpenClaw 实例唯一标识
+     * @param accessToken 旧的 token
+     * @returns 返回新 token 和过期时间
+     */
+    refreshGlobalToken(workerId: string, accessToken: string): Promise<{
+        token: string;
+        expiresAt: number;
+    }>;
+    /**
+     * 自动发现当前用户可用的机器人账号配置
+     * @param globalToken 全局 Token（从 requestGlobalToken 获取）
+     * @param options 可选参数
+     */
+    discoverAccounts(globalToken: string, options?: {
+        workerId?: string;
+        leaseSeconds?: number;
+    }): Promise<PufferfishAccount[]>;
+    /**
+     * 发送消息到 Pufferfish
+     */
+    sendMessage(params: SendMessageRequest): Promise<SendMessageResponse>;
+    /**
+     * 发送流式消息到 Pufferfish（支持打字效果）
+     * @param params 流式消息参数
+     */
+    sendStreamMessage(params: {
+        chatId: string;
+        content: string;
+        isStream: boolean;
+        streamEnd: boolean;
+    }): Promise<SendMessageResponse>;
+    /**
+     * 上传文件到 Pufferfish OSS
+     */
+    uploadFile(fileData: Buffer, fileName: string): Promise<string>;
+    /**
+     * 下载文件
+     */
+    downloadFile(url: string): Promise<Buffer>;
+    /**
+     * 请求签名（ECDSA）
+     */
+    private signRequest;
+    private accountBotId;
+    /**
+     * 将 OpenClaw 的出站消息封装为 Pufferfish 客户端可解析的 MessageContent(base64(json))。
+     *
+     * Pufferfish 客户端在 encryptVersion=0 时仍会对 content 做 base64Decode + jsonDecode，
+     * 所以这里必须发送 base64(JSON.stringify(MessageContent)).
+     */
+    private encodeMessageContent;
+    private toStringMap;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7F;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,iBAAiB;IAWtC;;;;;OAKG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBhD;;;;;OAKG;IACG,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBhD;;;;OAIG;IACG,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA4C/B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmC3E;;;OAGG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;KACpB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmChC;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BrE;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAShD;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,YAAY;IAIpB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA6B5B,OAAO,CAAC,WAAW;CAQpB"}

package/dist/api-client.js

@@ -0,0 +1,265 @@
+import crypto from 'crypto';
+/**
+ * Pufferfish API 客户端
+ * 负责与 Pufferfish 服务器的 HTTP API 通信
+ */
+export class PufferfishAPIClient {
+    baseURL; // API 基础URL
+    token; // JWT 认证令牌
+    privateKey; // ECDSA 私钥（用于签名）
+    botUserId; // 机器人用户ID
+    constructor(account) {
+        // 兼容用户把 apiUrl 配成 https://host/v1 或 https://host/v1/
+        // 统一把 baseURL 规范化为不带尾部斜杠、且不带末尾 /v1
+        let url = String(account.apiUrl ?? '').trim().replace(/\/+$/, '');
+        if (url.endsWith('/v1'))
+            url = url.slice(0, -3);
+        this.baseURL = url;
+        this.token = account.token;
+        this.privateKey = account.privateKey;
+        this.botUserId = account.botUserId ?? 0;
+    }
+    /**
+     * 请求全局 Token（用于 Discovery API）
+     * @param workerId OpenClaw 实例唯一标识
+     * @param apiKey Operator API Key
+     * @returns 返回 token 和过期时间
+     */
+    async requestGlobalToken(workerId, apiKey) {
+        const response = await fetch(`${this.baseURL}/v1/ai-bot/auth/request-token`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ workerId, apiKey }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`请求全局 Token 失败: ${response.status} ${text}`);
+        }
+        const data = await response.json();
+        return {
+            token: data.accessToken,
+            expiresAt: data.expiresAt,
+        };
+    }
+    /**
+     * 刷新全局 Token
+     * @param workerId OpenClaw 实例唯一标识
+     * @param accessToken 旧的 token
+     * @returns 返回新 token 和过期时间
+     */
+    async refreshGlobalToken(workerId, accessToken) {
+        const response = await fetch(`${this.baseURL}/v1/ai-bot/auth/refresh-token`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ workerId, accessToken }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`刷新全局 Token 失败: ${response.status} ${text}`);
+        }
+        const data = await response.json();
+        return {
+            token: data.accessToken,
+            expiresAt: data.expiresAt,
+        };
+    }
+    /**
+     * 自动发现当前用户可用的机器人账号配置
+     * @param globalToken 全局 Token（从 requestGlobalToken 获取）
+     * @param options 可选参数
+     */
+    async discoverAccounts(globalToken, options) {
+        const params = new URLSearchParams();
+        if (options?.workerId)
+            params.set('worker_id', options.workerId);
+        if (options?.leaseSeconds && options.leaseSeconds > 0) {
+            params.set('lease_seconds', String(options.leaseSeconds));
+        }
+        const query = params.toString();
+        const url = `${this.baseURL}/v1/ai-bot/discovery${query ? `?${query}` : ''}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'X-Global-Token': globalToken, // 使用全局 Token
+            },
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Failed to discover accounts: ${response.status} ${response.statusText}${text ? ` - ${text}` : ''}`);
+        }
+        const data = await response.json();
+        return (data.items ?? [])
+            .filter((item) => item.enabled && item.apiUrl && item.wsUrl && item.botUserId && item.token)
+            .map((item) => ({
+            accountId: item.accountId ?? String(item.botUserId),
+            enabled: true,
+            apiUrl: item.apiUrl,
+            wsUrl: item.wsUrl,
+            botUserId: Number(item.botUserId),
+            token: item.token,
+        }));
+    }
+    /**
+     * 发送消息到 Pufferfish
+     */
+    async sendMessage(params) {
+        const encodedContent = this.encodeMessageContent(params.type, params.content, params.metadata);
+        console.log(`[Pufferfish API] BotSendMessage content encoded type=${params.type} ` +
+            `rawLen=${(params.content ?? '').length} ` +
+            `encodedLen=${encodedContent.length} ` +
+            `encodedPrefix=${encodedContent.slice(0, 12)}`);
+        const body = JSON.stringify({
+            botId: this.accountBotId(),
+            chatId: params.chatId,
+            messageType: params.type,
+            content: encodedContent,
+            metadata: this.toStringMap(params.metadata),
+        });
+        const headers = { 'Content-Type': 'application/json' };
+        // 如果配置了私钥，添加签名
+        if (this.privateKey) {
+            headers['X-Signature'] = this.signRequest(body);
+        }
+        const response = await fetch(`${this.baseURL}/v1.AIBot/BotSendMessage`, {
+            method: 'POST',
+            headers,
+            body,
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to send message: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * 发送流式消息到 Pufferfish（支持打字效果）
+     * @param params 流式消息参数
+     */
+    async sendStreamMessage(params) {
+        const encodedContent = this.encodeMessageContent('text', params.content, {
+            isStream: params.isStream,
+            streamEnd: params.streamEnd,
+        });
+        const body = JSON.stringify({
+            botId: this.accountBotId(),
+            chatId: params.chatId,
+            messageType: 'text',
+            content: encodedContent,
+            metadata: {
+                isStream: params.isStream,
+                streamEnd: params.streamEnd,
+            },
+        });
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.privateKey) {
+            headers['X-Signature'] = this.signRequest(body);
+        }
+        const response = await fetch(`${this.baseURL}/v1.AIBot/BotSendMessage`, {
+            method: 'POST',
+            headers,
+            body,
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to send stream message: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * 上传文件到 Pufferfish OSS
+     */
+    async uploadFile(fileData, fileName) {
+        // 1. 获取预签名 URL
+        const presignedResp = await fetch(`${this.baseURL}/v1/file/presigned`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ fileName }),
+        });
+        if (!presignedResp.ok) {
+            throw new Error('Failed to get presigned URL');
+        }
+        const { uploadUrl, publicUrl } = await presignedResp.json();
+        // 2. 上传文件
+        const uploadResp = await fetch(uploadUrl, {
+            method: 'PUT',
+            body: new Uint8Array(fileData),
+        });
+        if (!uploadResp.ok) {
+            throw new Error('Failed to upload file');
+        }
+        return publicUrl;
+    }
+    /**
+     * 下载文件
+     */
+    async downloadFile(url) {
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to download file: ${response.status}`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
+    /**
+     * 请求签名（ECDSA）
+     */
+    signRequest(body) {
+        if (!this.privateKey) {
+            return '';
+        }
+        const sign = crypto.createSign('SHA256');
+        sign.update(body);
+        return sign.sign(this.privateKey, 'base64');
+    }
+    accountBotId() {
+        return this.botUserId;
+    }
+    /**
+     * 将 OpenClaw 的出站消息封装为 Pufferfish 客户端可解析的 MessageContent(base64(json))。
+     *
+     * Pufferfish 客户端在 encryptVersion=0 时仍会对 content 做 base64Decode + jsonDecode，
+     * 所以这里必须发送 base64(JSON.stringify(MessageContent)).
+     */
+    encodeMessageContent(type, content, metadata) {
+        const kind = type;
+        const msg = { kind };
+        if (type === 'text') {
+            msg.text = content;
+        }
+        else if (type === 'image') {
+            msg.mediaList = [{ url: content }];
+            if (metadata?.caption) {
+                msg.mediaList[0].caption = String(metadata.caption);
+            }
+        }
+        else if (type === 'file') {
+            msg.file = {
+                url: content,
+                name: String(metadata?.fileName ?? 'file'),
+            };
+            if (metadata?.caption) {
+                msg.file.caption = String(metadata.caption);
+            }
+        }
+        else {
+            msg.text = content;
+        }
+        const json = JSON.stringify(msg);
+        return Buffer.from(json, 'utf8').toString('base64');
+    }
+    toStringMap(input) {
+        const out = {};
+        if (!input)
+            return out;
+        for (const [k, v] of Object.entries(input)) {
+            out[k] = typeof v === 'string' ? v : JSON.stringify(v);
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/channel.d.ts

@@ -0,0 +1,80 @@
+import type { PufferfishAccount } from './types.js';
+export declare function setRuntimeAccount(account: PufferfishAccount): void;
+export declare function removeRuntimeAccount(accountId: string): void;
+/**
+ * Pufferfish Channel 定义
+ * 实现 OpenClaw Channel 接口，连接到 Pufferfish IM 平台
+ */
+export declare const pufferfishChannel: {
+    id: string;
+    meta: {
+        id: string;
+        label: string;
+        selectionLabel: string;
+        docsPath: string;
+        blurb: string;
+        aliases: string[];
+    };
+    capabilities: {
+        chatTypes: readonly ["direct", "group"];
+        media: readonly ["text", "image", "file"];
+        mentions: boolean;
+        threads: boolean;
+    };
+    config: {
+        listAccountIds: (cfg: any) => string[];
+        resolveAccount: (cfg: any, accountId?: string) => PufferfishAccount;
+    };
+    /**
+     * OpenClaw 工具「发消息」解析 to：纯数字或 user: 等形式需映射为服务端 chatId；
+     * 否则会走「通讯录」目录匹配，本通道未实现 directory 时会报 Unknown target。
+     */
+    messaging: {
+        normalizeTarget: (raw: string) => string;
+        inferTargetChatType: ({ to }: {
+            to: string;
+        }) => "direct" | "group" | undefined;
+        targetResolver: {
+            hint: string;
+            looksLikeId: (trimmed: string) => boolean;
+            resolveTarget: (params: {
+                input: string;
+                normalized: string;
+                preferredKind?: string;
+            }) => Promise<{
+                to: string;
+                kind: string;
+                display: string;
+                source: "normalized";
+            }>;
+        };
+    };
+    outbound: {
+        deliveryMode: "direct";
+        /**
+         * OpenClaw 传入 ctx：`to`（投递目标）、`accountId`、`cfg`；与自定义 chatId / account 兼容。
+         */
+        sendText: (ctx: any) => Promise<{
+            ok: boolean;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            error: any;
+        }>;
+        sendImage: (ctx: any) => Promise<{
+            ok: boolean;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            error: any;
+        }>;
+        sendFile: (ctx: any) => Promise<{
+            ok: boolean;
+            error?: undefined;
+        } | {
+            ok: boolean;
+            error: any;
+        }>;
+    };
+};
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAElE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE5D;AAkDD;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;8BAwBJ,GAAG;8BAIH,GAAG,cAAc,MAAM,KAAG,iBAAiB;;IAInE;;;OAGG;;+BAEsB,MAAM;sCACC;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE;;;mCAanB,MAAM;oCAOC;gBAC5B,KAAK,EAAE,MAAM,CAAC;gBACd,UAAU,EAAE,MAAM,CAAC;gBACnB,aAAa,CAAC,EAAE,MAAM,CAAC;aACxB;;;;;;;;;;QAwBH;;WAEG;wBACmB,GAAG;;;;;;;yBAwCF,GAAG;;;;;;;wBAwBJ,GAAG;;;;;;;;CA2B5B,CAAC"}

package/dist/channel.js

@@ -0,0 +1,226 @@
+import { PufferfishAPIClient } from './api-client.js';
+const runtimeAccounts = new Map();
+export function setRuntimeAccount(account) {
+    runtimeAccounts.set(account.accountId, account);
+}
+export function removeRuntimeAccount(accountId) {
+    runtimeAccounts.delete(accountId);
+}
+/**
+ * 与 Pufferfish 服务端 parseChatId 一致：私聊 user_{id}、群聊 group_{id}
+ */
+function normalizePufferfishChatId(raw) {
+    const t = raw.trim();
+    if (!t)
+        return t;
+    const userColon = /^user:(\d+)$/i.exec(t);
+    if (userColon)
+        return `user_${userColon[1]}`;
+    if (/^user_\d+$/i.test(t))
+        return t;
+    const groupColon = /^group:(\d+)$/i.exec(t);
+    if (groupColon)
+        return `group_${groupColon[1]}`;
+    if (/^group_\d+$/i.test(t))
+        return t;
+    const channelNum = t.match(/^channel:(\d+)$/i);
+    if (channelNum)
+        return `group_${channelNum[1]}`;
+    if (/^\d+$/.test(t))
+        return `user_${t}`;
+    return t;
+}
+function resolvePufferfishAccountFromConfig(cfg, accountId) {
+    const runtime = runtimeAccounts.get(accountId ?? 'default');
+    if (runtime) {
+        return runtime;
+    }
+    const account = cfg.channels?.pufferfish?.accounts?.[accountId ?? 'default'];
+    return {
+        accountId: accountId ?? 'default',
+        enabled: account?.enabled ?? true,
+        apiUrl: account?.apiUrl ?? 'http://localhost:8080',
+        wsUrl: account?.wsUrl ?? 'ws://localhost:8080/v1/ai-bot/ws',
+        botUserId: account?.botUserId ?? 0,
+        token: account?.token ?? '',
+        privateKey: account?.privateKey,
+    };
+}
+function resolveOutboundCtx(ctx) {
+    const rawTarget = String(ctx.chatId ?? ctx.to ?? '').trim();
+    const chatId = normalizePufferfishChatId(rawTarget);
+    const account = ctx.account ?? resolvePufferfishAccountFromConfig(ctx.cfg, ctx.accountId);
+    return { chatId, account };
+}
+/**
+ * Pufferfish Channel 定义
+ * 实现 OpenClaw Channel 接口，连接到 Pufferfish IM 平台
+ */
+export const pufferfishChannel = {
+    id: 'pufferfish',
+    // 元数据：Channel 的基本信息
+    meta: {
+        id: 'pufferfish',
+        label: 'Pufferfish IM',
+        selectionLabel: 'Pufferfish (即时通讯平台)',
+        docsPath: '/channels/pufferfish',
+        blurb: 'Connect to Pufferfish instant messaging platform with AI capabilities',
+        aliases: ['pf', 'pufferfish-im'],
+    },
+    // 能力声明：支持的功能
+    capabilities: {
+        chatTypes: ['direct', 'group'], // 支持私聊和群聊
+        media: ['text', 'image', 'file'], // 支持文本、图片、文件
+        mentions: true, // 支持 @提及
+        threads: false, // 不支持消息线程
+    },
+    // 配置解析：从 OpenClaw 配置文件读取账号信息
+    config: {
+        // 列出所有配置的账号ID
+        listAccountIds: (cfg) => Object.keys(cfg.channels?.pufferfish?.accounts ?? {}),
+        // 解析指定账号的配置
+        resolveAccount: (cfg, accountId) => resolvePufferfishAccountFromConfig(cfg, accountId),
+    },
+    /**
+     * OpenClaw 工具「发消息」解析 to：纯数字或 user: 等形式需映射为服务端 chatId；
+     * 否则会走「通讯录」目录匹配，本通道未实现 directory 时会报 Unknown target。
+     */
+    messaging: {
+        normalizeTarget: (raw) => normalizePufferfishChatId(raw),
+        inferTargetChatType: ({ to }) => {
+            const t = String(to ?? '').trim();
+            if (/^group_\d+$/i.test(t))
+                return 'group';
+            if (/^group:\d+$/i.test(t))
+                return 'group';
+            if (/^channel:\d+$/i.test(t))
+                return 'group';
+            if (/^user_\d+$/i.test(t))
+                return 'direct';
+            if (/^user:\d+$/i.test(t))
+                return 'direct';
+            if (/^\d+$/.test(t))
+                return 'direct';
+            return undefined;
+        },
+        targetResolver: {
+            hint: '私聊：`user_<用户数字ID>`、`user:<ID>` 或直接写用户数字 ID；群：`group_<群ID>` 或 `group:<ID>`。',
+            looksLikeId: (trimmed) => {
+                if (/^(user|group)_\d+$/i.test(trimmed))
+                    return true;
+                if (/^(user|group):\d+$/i.test(trimmed))
+                    return true;
+                if (/^channel:\d+$/i.test(trimmed))
+                    return true;
+                if (/^\d+$/.test(trimmed))
+                    return true;
+                return false;
+            },
+            resolveTarget: async (params) => {
+                const raw = (params.normalized?.trim() ? params.normalized : params.input).trim();
+                let chatId = normalizePufferfishChatId(raw);
+                if (params.preferredKind === 'group' && /^\d+$/.test(raw)) {
+                    chatId = `group_${raw}`;
+                }
+                else if (params.preferredKind === 'user' && /^\d+$/.test(raw)) {
+                    chatId = `user_${raw}`;
+                }
+                const kind = /^group_/i.test(chatId) ? 'group' : 'user';
+                const display = chatId.replace(/^(user|group)_/i, '');
+                return {
+                    to: chatId,
+                    kind,
+                    display,
+                    source: 'normalized',
+                };
+            },
+        },
+    },
+    // 出站消息处理：AI 发送消息给用户
+    outbound: {
+        deliveryMode: 'direct', // 直接发送模式
+        /**
+         * OpenClaw 传入 ctx：`to`（投递目标）、`accountId`、`cfg`；与自定义 chatId / account 兼容。
+         */
+        sendText: async (ctx) => {
+            const { text, streaming } = ctx;
+            const { chatId, account } = resolveOutboundCtx(ctx);
+            const client = new PufferfishAPIClient(account);
+            try {
+                if (streaming) {
+                    const chunkSize = 10;
+                    const chunks = [];
+                    for (let i = 0; i < text.length; i += chunkSize) {
+                        chunks.push(text.substring(0, i + chunkSize));
+                    }
+                    for (let i = 0; i < chunks.length; i++) {
+                        const isLast = i === chunks.length - 1;
+                        await client.sendStreamMessage({
+                            chatId,
+                            content: chunks[i],
+                            isStream: true,
+                            streamEnd: isLast,
+                        });
+                        if (!isLast) {
+                            await new Promise(resolve => setTimeout(resolve, 50));
+                        }
+                    }
+                }
+                else {
+                    await client.sendMessage({
+                        chatId,
+                        type: 'text',
+                        content: text,
+                    });
+                }
+                return { ok: true };
+            }
+            catch (error) {
+                console.error('[Pufferfish Channel] Failed to send text:', error);
+                return { ok: false, error: error.message };
+            }
+        },
+        sendImage: async (ctx) => {
+            const imageUrl = ctx.imageUrl ?? ctx.mediaUrl;
+            const { chatId, account } = resolveOutboundCtx(ctx);
+            const client = new PufferfishAPIClient(account);
+            try {
+                const imageData = await client.downloadFile(imageUrl);
+                const ossUrl = await client.uploadFile(imageData, 'image.jpg');
+                await client.sendMessage({
+                    chatId,
+                    type: 'image',
+                    content: ossUrl,
+                });
+                return { ok: true };
+            }
+            catch (error) {
+                console.error('[Pufferfish Channel] Failed to send image:', error);
+                return { ok: false, error: error.message };
+            }
+        },
+        sendFile: async (ctx) => {
+            const { fileUrl, fileName, mediaUrl } = ctx;
+            const url = fileUrl ?? mediaUrl;
+            const { chatId, account } = resolveOutboundCtx(ctx);
+            const client = new PufferfishAPIClient(account);
+            try {
+                const fileData = await client.downloadFile(url);
+                const name = fileName ?? 'file.bin';
+                const ossUrl = await client.uploadFile(fileData, name);
+                await client.sendMessage({
+                    chatId,
+                    type: 'file',
+                    content: ossUrl,
+                    metadata: { fileName: name },
+                });
+                return { ok: true };
+            }
+            catch (error) {
+                console.error('[Pufferfish Channel] Failed to send file:', error);
+                return { ok: false, error: error.message };
+            }
+        },
+    },
+};
+//# sourceMappingURL=channel.js.map