openclaw-plugin-yuanbao 2.9.1 → 2.10.0

package/dist/index.js

@@ -5,6 +5,7 @@ import { initLogger } from './src/logger.js';
 import { registerTools } from './src/tools/index.js';
 import { yuanbaoUpgradeCommand, yuanbaobotUpgradeCommand } from './src/commands/upgrade/index.js';
 import { logUploadCommandDefinition } from './src/commands/log-upload.js';
+import { registerPluginCommand } from './src/commands/slash-commands/index.js';
 import { initEnv } from './src/utils/get-env.js';
 import { initBuiltinStickers } from './src/sticker/init-builtin-stickers.js';
 import pluginManifest from './openclaw.plugin.json' with { type: 'json' };
@@ -29,7 +30,9 @@ const plugin = {
         registerTools(api);
         api.registerCommand(yuanbaoUpgradeCommand);
         api.registerCommand(yuanbaobotUpgradeCommand);
+        registerPluginCommand(yuanbaobotUpgradeCommand.name, yuanbaobotUpgradeCommand.description);
         api.registerCommand(logUploadCommandDefinition);
+        registerPluginCommand(logUploadCommandDefinition.name, logUploadCommandDefinition.description);
         initBuiltinStickers();
     },
 };

package/dist/openclaw.plugin.json

@@ -2,7 +2,7 @@
     "id": "openclaw-plugin-yuanbao",
     "name": "元宝 Bot",
     "description": "Tencent YuanBao intelligent bot channel plugin",
-    "version": "2.9.1",
+    "version": "2.10.0",
     "channels": [
         "yuanbao"
     ],

package/dist/src/accounts.js

@@ -2,6 +2,7 @@ import { DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk/core';
 import { normalizeAccountId } from 'openclaw/plugin-sdk/account-id';
 import { logger } from './logger.js';
 import { getCachedBotId } from './yuanbao-server/http/request.js';
+import { DEFAULT_SLOW_REPLY_TIMEOUT_MS, DEFAULT_SLOW_REPLY_TEXT } from './config-schema.js';
 const DEFAULT_API_DOMAIN = 'bot.yuanbao.tencent.com';
 const DEFAULT_WS_GATEWAY_URL = 'wss://bot-wss.yuanbao.tencent.com/wss/connection';
 function listConfiguredAccountIds(cfg) {
@@ -93,6 +94,8 @@ export function resolveYuanbaoAccount(params) {
     const requireMention = merged.requireMention !== undefined ? merged.requireMention : true;
     const fallbackReply = merged.fallbackReply?.trim();
     const markdownHintEnabled = merged.markdownHintEnabled !== false;
+    const slowReplyTimeoutMs = merged.slowReplyTimeoutMs ?? DEFAULT_SLOW_REPLY_TIMEOUT_MS;
+    const slowReplyText = merged.slowReplyText ?? DEFAULT_SLOW_REPLY_TEXT;
     const configured = Boolean(appKey && appSecret);
     if (!configured && Boolean(yuanbaoConfig)) {
         warnIncompleteConfig(appKey, appSecret);
@@ -118,6 +121,8 @@ export function resolveYuanbaoAccount(params) {
         requireMention,
         fallbackReply,
         markdownHintEnabled,
+        slowReplyTimeoutMs,
+        slowReplyText,
         config: merged,
     };
 }

package/dist/src/commands/slash-commands/index.d.ts

@@ -0,0 +1,27 @@
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+export type CommandItem = {
+    name: string;
+    description: string;
+};
+export declare const SYNC_INFORMATION_TYPE: {
+    readonly UNSPECIFIED: 0;
+    readonly COMMANDS: 1;
+};
+export declare function registerPluginCommand(name: string, description: string): void;
+export declare function getPluginCommands(): ReadonlyArray<CommandItem>;
+export type SyncInformationPayload = {
+    syncType: number;
+    botVersion: string;
+    pluginVersion: string;
+    commandData: {
+        botCommands: Array<{
+            name: string;
+            description: string;
+        }>;
+        pluginCommands: Array<{
+            name: string;
+            description: string;
+        }>;
+    };
+};
+export declare function buildSyncCommandsPayload(config?: OpenClawConfig): Promise<SyncInformationPayload>;

package/dist/src/commands/slash-commands/index.js

@@ -0,0 +1,116 @@
+import { getPluginVersion, getOpenclawVersion } from '../../utils/get-env.js';
+import { createLog } from '../../logger.js';
+let _listChatCommands = null;
+let _listChatCommandsForConfig = null;
+let _commandAuthLoadPromise = null;
+function loadCommandAuth() {
+    if (_commandAuthLoadPromise)
+        return _commandAuthLoadPromise;
+    _commandAuthLoadPromise = import('openclaw/plugin-sdk/command-auth')
+        .then((mod) => {
+        _listChatCommands = mod.listChatCommands;
+        _listChatCommandsForConfig = mod.listChatCommandsForConfig;
+    })
+        .catch(() => {
+        const log = createLog('slash-commands');
+        log.warn('openclaw/plugin-sdk/command-auth 不可用（当前 OpenClaw 版本可能较旧），bot_commands 将返回兜底列表');
+    });
+    return _commandAuthLoadPromise;
+}
+export const SYNC_INFORMATION_TYPE = {
+    UNSPECIFIED: 0,
+    COMMANDS: 1,
+};
+const FALLBACK_BOT_COMMANDS = [
+    { name: '/help', description: 'Show available commands.' },
+    { name: '/status', description: 'Show current status.' },
+    { name: '/stop', description: 'Stop the current run.' },
+    { name: '/new', description: 'Start a new session.' },
+    { name: '/restart', description: 'Restart OpenClaw.' },
+    { name: '/compact', description: 'Compact the session context.' },
+];
+async function fetchBotCommands(config) {
+    const log = createLog('slash-commands');
+    await loadCommandAuth();
+    if (!_listChatCommandsForConfig && !_listChatCommands) {
+        log.info(`command-auth 模块不可用（旧版 OpenClaw），使用兜底命令列表: ${FALLBACK_BOT_COMMANDS.length} 个命令`);
+        return FALLBACK_BOT_COMMANDS;
+    }
+    try {
+        if (config && _listChatCommandsForConfig) {
+            const commands = _listChatCommandsForConfig(config);
+            log.debug(`使用配置感知版本获取命令列表: ${commands.length} 个命令`);
+            if (commands.length > 0) {
+                log.debug('命令原始结构示例:', {
+                    sample: commands.slice(0, 3).map((c) => ({
+                        name: c.name, description: c.description, textAliases: c.textAliases, keys: Object.keys(c),
+                    })),
+                });
+            }
+            return commands;
+        }
+        if (_listChatCommands) {
+            log.debug('OpenClawConfig 不可用, 降级为无参版本');
+            const commands = _listChatCommands();
+            log.debug(`使用无参版本获取命令列表: ${commands.length} 个命令`);
+            return commands;
+        }
+        return null;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.warn(`获取命令列表失败: ${msg}`);
+        return null;
+    }
+}
+function toBotCommandItems(commands) {
+    const log = createLog('slash-commands');
+    const result = [];
+    for (const cmd of commands) {
+        const aliases = cmd.textAliases;
+        let name = '';
+        if (aliases && aliases.length > 0) {
+            [name] = aliases;
+        }
+        else if (cmd.name) {
+            name = cmd.name;
+        }
+        if (!name)
+            continue;
+        if (!name.startsWith('/'))
+            name = `/${name}`;
+        if (name.length <= 1)
+            continue;
+        result.push({
+            name,
+            description: cmd.description ?? '',
+        });
+    }
+    log.debug(`toBotCommandItems 转换结果: ${result.length} 个命令`);
+    return result;
+}
+const pluginCommands = [];
+export function registerPluginCommand(name, description) {
+    const fullName = name.startsWith('/') ? name : `/${name}`;
+    if (!pluginCommands.some(c => c.name === fullName)) {
+        pluginCommands.push({ name: fullName, description });
+    }
+}
+export function getPluginCommands() {
+    return pluginCommands;
+}
+export async function buildSyncCommandsPayload(config) {
+    const botVersion = getOpenclawVersion() || '0.0.0';
+    const pluginVersion = getPluginVersion() || '0.0.0';
+    const rawBotCommands = await fetchBotCommands(config);
+    const botCommands = rawBotCommands ? toBotCommandItems(rawBotCommands) : [];
+    return {
+        syncType: SYNC_INFORMATION_TYPE.COMMANDS,
+        botVersion,
+        pluginVersion,
+        commandData: {
+            botCommands: botCommands.map(c => ({ name: c.name, description: c.description })),
+            pluginCommands: pluginCommands.map(c => ({ name: c.name, description: c.description })),
+        },
+    };
+}

package/dist/src/config-schema.d.ts

@@ -1,2 +1,9 @@
 import type { ChannelConfigSchema } from 'openclaw/plugin-sdk';
+export declare const DEFAULT_SLOW_REPLY_TIMEOUT_MS = 120000;
+export declare const DEFAULT_SLOW_REPLY_TEXT = "\u4EFB\u52A1\u6709\u70B9\u590D\u6742\uFF0C\u6B63\u5728\u52AA\u529B\u5904\u7406\u4E2D\uFF0C\u8BF7\u8010\u5FC3\u7B49\u5F85...";
+export declare const DEFAULT_MODEL_RATE_LIMIT_TEXT = "\u6A21\u578B\u670D\u52A1\u7E41\u5FD9\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5";
+export declare const DEFAULT_MODEL_BILLING_DEFAULT_TEXT = "\u4ECA\u65E5\u8BCD\u5143\u6D88\u8017\u5DF2\u8FBE\u4E0A\u9650\uFF0C\u660E\u65E5\u518D\u6765\u548C\u6211\u5BF9\u8BDD\u5427\uFF5E";
+export declare const DEFAULT_MODEL_BILLING_CUSTOM_TEXT = "\u8BCD\u5143\u4E0D\u8DB3\uFF0C\u8BF7\u68C0\u67E5\u6A21\u578B\u72B6\u6001";
+export declare const DEFAULT_MODEL_ERROR_TEXT = "\u6A21\u578B\u670D\u52A1\u51FA\u9519\uFF0C\u8BF7\u68C0\u67E5\u6A21\u578BAPI";
+export declare const DEFAULT_MODEL_ONE_CLICK_ERROR_TEXT = "\u6A21\u578B\u670D\u52A1\u51FA\u9519\u4E86\uFF0C\u8BF7\u5728\"\u6211\u7684 Bot\"\u4E2D\u5C1D\u8BD5\u91CD\u542F\u6216\u8FD8\u539F Bot \u914D\u7F6E";
 export declare const yuanbaoConfigSchema: ChannelConfigSchema;

package/dist/src/config-schema.js

@@ -1,3 +1,10 @@
+export const DEFAULT_SLOW_REPLY_TIMEOUT_MS = 120_000;
+export const DEFAULT_SLOW_REPLY_TEXT = '任务有点复杂，正在努力处理中，请耐心等待...';
+export const DEFAULT_MODEL_RATE_LIMIT_TEXT = '模型服务繁忙，请稍后重试';
+export const DEFAULT_MODEL_BILLING_DEFAULT_TEXT = '今日词元消耗已达上限，明日再来和我对话吧～';
+export const DEFAULT_MODEL_BILLING_CUSTOM_TEXT = '词元不足，请检查模型状态';
+export const DEFAULT_MODEL_ERROR_TEXT = '模型服务出错，请检查模型API';
+export const DEFAULT_MODEL_ONE_CLICK_ERROR_TEXT = '模型服务出错了，请在"我的 Bot"中尝试重启或还原 Bot 配置';
 export const yuanbaoConfigSchema = {
     schema: {
         $schema: 'http://json-schema.org/draft-07/schema#',
@@ -98,6 +105,19 @@ export const yuanbaoConfigSchema = {
                 description: '开启后在系统提示词中自动注入指令，防止模型用代码块包裹整个 Markdown 回复',
                 default: true,
             },
+            slowReplyTimeoutMs: {
+                type: 'integer',
+                title: '慢回复提醒超时 (ms)',
+                description: '收到消息后，在该时长内未推送首条回复则发送慢回复提示文案；0 表示禁用',
+                minimum: 0,
+                default: DEFAULT_SLOW_REPLY_TIMEOUT_MS,
+            },
+            slowReplyText: {
+                type: 'string',
+                title: '慢回复提示文案',
+                description: '超过慢回复超时后推送给用户的提示文案',
+                default: DEFAULT_SLOW_REPLY_TEXT,
+            },
         },
         additionalProperties: false,
     },

package/dist/src/message-handler/extract.js

@@ -1,6 +1,6 @@
 import { getHandler } from './handlers/index.js';
 export function extractTextFromMsgBody(ctx, msgBody) {
-    const resData = { rawBody: '', isAtBot: false, medias: [], mentions: [] };
+    const resData = { rawBody: '', isAtBot: false, medias: [], mentions: [], linkUrls: [] };
     if (!msgBody || !Array.isArray(msgBody))
         return resData;
     const texts = [];

package/dist/src/message-handler/handlers/{custom.d.ts → custom/index.d.ts}

@@ -1,3 +1,3 @@
-import type { MessageElemHandler, MsgBodyItemType } from './types.js';
+import type { MessageElemHandler, MsgBodyItemType } from '../types.js';
 export declare function buildAtUserMsgBodyItem(userId: string, senderNickname: any): MsgBodyItemType;
 export declare const customHandler: MessageElemHandler;

package/dist/src/message-handler/handlers/custom/index.js

@@ -0,0 +1,63 @@
+import { createLog } from '../../../logger.js';
+import { extractLinkCard, extractLinkCardUrls } from './link-card.js';
+export function buildAtUserMsgBodyItem(userId, senderNickname) {
+    return {
+        msg_type: 'TIMCustomElem',
+        msg_content: {
+            data: JSON.stringify({ elem_type: 1002, text: `@${senderNickname ?? ''}`, user_id: userId }),
+        },
+    };
+}
+const FALLBACK_TEXT = '[当前消息暂不支持查看]';
+export const customHandler = {
+    msgType: 'TIMCustomElem',
+    extract(ctx, elem, resData) {
+        if (elem.msg_content?.data) {
+            try {
+                const customContent = JSON.parse(elem.msg_content?.data);
+                switch (customContent?.elem_type) {
+                    case 1002: {
+                        const { botId } = ctx.account;
+                        const isAtBotSelf = customContent?.user_id === botId;
+                        if (!resData.isAtBot) {
+                            resData.isAtBot = isAtBotSelf;
+                        }
+                        createLog('custom').info('@消息', { text: customContent?.text, userId: customContent?.user_id, isAtBot: resData.isAtBot });
+                        if (customContent?.user_id) {
+                            resData.mentions.push({
+                                userId: customContent.user_id,
+                                text: customContent.text || '',
+                            });
+                        }
+                        if (isAtBotSelf && customContent.text) {
+                            resData.botUsername = customContent.text.replace(/^@/, '');
+                        }
+                        return customContent.text || undefined;
+                    }
+                    case 1010:
+                    case 1007: {
+                        const urls = extractLinkCardUrls(customContent);
+                        if (urls.length > 0)
+                            resData.linkUrls.push(...urls);
+                        return extractLinkCard(customContent);
+                    }
+                    default:
+                        return FALLBACK_TEXT;
+                }
+            }
+            catch { }
+        }
+        return FALLBACK_TEXT;
+    },
+    buildMsgBody(data) {
+        const customData = typeof data.data === 'string'
+            ? data.data
+            : JSON.stringify(data.data);
+        return [
+            {
+                msg_type: 'TIMCustomElem',
+                msg_content: { data: customData },
+            },
+        ];
+    },
+};

package/dist/src/message-handler/handlers/custom/link-card.d.ts

@@ -0,0 +1,2 @@
+export declare function extractLinkCard(customContent: unknown): string | undefined;
+export declare function extractLinkCardUrls(customContent: unknown): string[];

package/dist/src/message-handler/handlers/custom/link-card.js

@@ -0,0 +1,64 @@
+const CONTENT_MAX_LENGTH = 1000;
+function isSharedLinkData(data) {
+    return typeof data === 'object' && data !== null && data.elem_type === 1010;
+}
+function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return `${text.slice(0, maxLength)}...(truncated)`;
+}
+function formatSharedLink(data) {
+    const lines = [];
+    lines.push(`<share_card name="${data.title ?? ''}">`);
+    if (data.link)
+        lines.push(`  <link>${data.link}</link>`);
+    if (data.card_content)
+        lines.push(`  <preview_title>${truncate(data.card_content, CONTENT_MAX_LENGTH)}</preview_title>`);
+    if (data.wechat_des)
+        lines.push(`  <preview_description>${truncate(data.wechat_des, CONTENT_MAX_LENGTH)}</preview_description>`);
+    lines.push('  <instruction>以上仅为分享卡片的摘要预览，请访问 link 获取完整页面内容后再进行分析回复</instruction>');
+    lines.push('</share_card>');
+    return lines.join('\n');
+}
+function isLinkUnderstandingData(data) {
+    return typeof data === 'object' && data !== null && data.elem_type === 1007;
+}
+function parseLinkFromContent(content) {
+    try {
+        const parsed = JSON.parse(content);
+        return typeof parsed?.link === 'string' ? parsed.link : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function formatLinkUnderstanding(data) {
+    const link = data.content ? parseLinkFromContent(data.content) : undefined;
+    if (!link)
+        return undefined;
+    const lines = [];
+    lines.push('<link_understanding>');
+    lines.push(`  <link>${link}</link>`);
+    lines.push('  <instruction>请访问 link 获取完整页面内容后再进行分析回复</instruction>');
+    lines.push('</link_understanding>');
+    return lines.join('\n');
+}
+export function extractLinkCard(customContent) {
+    if (isSharedLinkData(customContent)) {
+        return formatSharedLink(customContent);
+    }
+    if (isLinkUnderstandingData(customContent)) {
+        return formatLinkUnderstanding(customContent);
+    }
+    return undefined;
+}
+export function extractLinkCardUrls(customContent) {
+    if (isSharedLinkData(customContent) && customContent.link) {
+        return [customContent.link];
+    }
+    if (isLinkUnderstandingData(customContent) && customContent.content) {
+        const link = parseLinkFromContent(customContent.content);
+        return link ? [link] : [];
+    }
+    return [];
+}

package/dist/src/message-handler/handlers/index.d.ts

@@ -7,7 +7,7 @@ export declare function prepareOutboundContent(text: string, groupCode?: string,
 export declare function buildOutboundMsgBody(items: OutboundContentItem[]): MsgBodyItemType[];
 export type { MessageElemHandler, MsgBodyItemType, MediaItem, ExtractTextFromMsgBodyResult, OutboundContentItem, } from './types.js';
 export { textHandler } from './text.js';
-export { customHandler, buildAtUserMsgBodyItem } from './custom.js';
+export { customHandler, buildAtUserMsgBodyItem } from './custom/index.js';
 export { imageHandler } from './image.js';
 export { soundHandler } from './sound.js';
 export { fileHandler } from './file.js';

package/dist/src/message-handler/handlers/index.js

@@ -1,5 +1,5 @@
 import { textHandler } from './text.js';
-import { customHandler } from './custom.js';
+import { customHandler } from './custom/index.js';
 import { imageHandler } from './image.js';
 import { soundHandler } from './sound.js';
 import { fileHandler } from './file.js';
@@ -108,7 +108,7 @@ export function buildOutboundMsgBody(items) {
     return msgBody;
 }
 export { textHandler } from './text.js';
-export { customHandler, buildAtUserMsgBodyItem } from './custom.js';
+export { customHandler, buildAtUserMsgBodyItem } from './custom/index.js';
 export { imageHandler } from './image.js';
 export { soundHandler } from './sound.js';
 export { fileHandler } from './file.js';

package/dist/src/message-handler/handlers/types.d.ts

@@ -38,6 +38,7 @@ export type ExtractTextFromMsgBodyResult = {
     medias: MediaItem[];
     mentions: MentionItem[];
     botUsername?: string;
+    linkUrls: string[];
 };
 export type OutboundContentItem = {
     type: 'text';

package/dist/src/message-handler/inbound.js

@@ -102,6 +102,21 @@ function buildGroupHistoryContext(params) {
         : undefined;
     return { combinedBody, inboundHistory };
 }
+function createSlowReplyTimer(params) {
+    const { timeoutMs, text, send, log } = params;
+    if (timeoutMs <= 0)
+        return () => { };
+    let fired = false;
+    const timer = setTimeout(() => {
+        fired = true;
+        log.info(`慢回复超时 (${timeoutMs}ms)，推送提示: "${text}"`);
+        send().catch(err => log.error('慢回复提示发送失败', { error: String(err) }));
+    }, timeoutMs);
+    return () => {
+        if (!fired)
+            clearTimeout(timer);
+    };
+}
 function isSkippableBracketPlaceholder(rawBody, mediaCount) {
     if (mediaCount > 0)
         return false;
@@ -127,7 +142,7 @@ async function handleC2CMessage(params) {
         log.info(`跳过机器人自身消息 <- ${fromAccount}`);
         return;
     }
-    const { rawBody, medias } = extractTextFromMsgBody(ctx, msg.msg_body);
+    const { rawBody, medias, linkUrls } = extractTextFromMsgBody(ctx, msg.msg_body);
     getMember(account.accountId).recordC2cUser(fromAccount, senderNickname || fromAccount);
     log.info(`收到消息 <- ${fromAccount}${senderNickname ? `(${senderNickname})` : ''}, msgKey: ${msg.msg_key}`);
     const quoteInfo = parseQuoteFromCloudCustomData(msg.cloud_custom_data);
@@ -258,6 +273,7 @@ async function handleC2CMessage(params) {
         ...(account.markdownHintEnabled && { GroupSystemPrompt: YUANBAO_MARKDOWN_HINT }),
         ...(mediaPaths.length > 0 && { MediaPaths: mediaPaths, MediaPath: mediaPaths[0] }),
         ...(mediaTypes.length > 0 && { MediaTypes: mediaTypes, MediaType: mediaTypes[0] }),
+        ...(linkUrls.length > 0 && { LinkUnderstanding: [...new Set(linkUrls)] }),
     });
     await core.channel.session.recordInboundSession({
         storePath,
@@ -295,6 +311,12 @@ async function handleC2CMessage(params) {
             ctx,
         }),
     };
+    const cancelSlowReply = createSlowReplyTimer({
+        timeoutMs: account.slowReplyTimeoutMs,
+        text: account.slowReplyText,
+        send: () => sendYuanbaoMessage({ account, toAccount: fromAccount, text: account.slowReplyText, fromAccount: outboundSender, ctx }),
+        log,
+    });
     const outboundSessionKey = `direct:${fromAccount}`;
     const msgId = msg.msg_id ?? String(msg.msg_seq ?? '');
     const queueManager = getOutboundQueue(account.accountId);
@@ -308,24 +330,33 @@ async function handleC2CMessage(params) {
             fromAccount: outboundSender,
             ctx,
             mergeOnFlush: account.disableBlockStreaming,
+            onFirstSent: cancelSlowReply,
         });
         log.debug(`[${outboundSessionKey}] 出站队列 session 已注册，msgId: ${msgId}`);
     }
     const replyRuntime = buildReplyRuntimeConfig(config, account);
-    await executeReply({
-        transport,
-        ctx,
-        account,
-        core,
-        config,
-        ctxPayload,
-        replyRuntime,
-        tableMode,
-        splitFinalText,
-        overflowPolicy: account.overflowPolicy,
-        sessionKey: outboundSessionKey,
-        appendText: getAppendText(rawBody),
-    });
+    try {
+        await executeReply({
+            transport,
+            ctx,
+            account,
+            core,
+            config,
+            ctxPayload,
+            replyRuntime,
+            tableMode,
+            splitFinalText,
+            overflowPolicy: account.overflowPolicy,
+            sessionKey: outboundSessionKey,
+            appendText: getAppendText(rawBody),
+        });
+    }
+    catch (err) {
+        log.error('executeReply 失败', { error: String(err) });
+    }
+    finally {
+        cancelSlowReply();
+    }
     log.info(`消息处理完成 <- ${fromAccount}`);
 }
 async function handleGroupMessage(params) {
@@ -343,7 +374,7 @@ async function handleGroupMessage(params) {
         glog.info('跳过机器人自身消息', { groupCode, fromAccount });
         return;
     }
-    const { rawBody, isAtBot, medias, mentions, botUsername } = extractTextFromMsgBody(ctx, msg.msg_body);
+    const { rawBody, isAtBot, medias, mentions, botUsername, linkUrls } = extractTextFromMsgBody(ctx, msg.msg_body);
     glog.info(`收到群消息 <- group:${groupCode}, from: ${fromAccount}${senderNickname ? `(${senderNickname})` : ''}, msgSeq: ${msg.msg_seq}, isAtBot: ${isAtBot}`);
     const quoteInfo = parseQuoteFromCloudCustomData(msg.cloud_custom_data);
     if (quoteInfo) {
@@ -532,6 +563,7 @@ async function handleGroupMessage(params) {
         ...(account.markdownHintEnabled && { GroupSystemPrompt: YUANBAO_MARKDOWN_HINT }),
         ...(mediaPaths.length > 0 && { MediaPaths: mediaPaths, MediaPath: mediaPaths[0] }),
         ...(mediaTypes.length > 0 && { MediaTypes: mediaTypes, MediaType: mediaTypes[0] }),
+        ...(linkUrls.length > 0 && { LinkUnderstanding: [...new Set(linkUrls)] }),
     });
     await core.channel.session.recordInboundSession({
         storePath,
@@ -578,6 +610,20 @@ async function handleGroupMessage(params) {
     };
     const outboundGroupSessionKey = `group:${groupCode}`;
     const groupMsgId = msg.msg_id ?? String(msg.msg_seq ?? '');
+    const cancelSlowReply = createSlowReplyTimer({
+        timeoutMs: account.slowReplyTimeoutMs,
+        text: account.slowReplyText,
+        send: () => sendYuanbaoGroupMessageBody({
+            account,
+            groupCode,
+            msgBody: buildOutboundMsgBody(prepareOutboundContent(account.slowReplyText, groupCode, getMember(account.accountId))),
+            fromAccount: outboundSender,
+            refMsgId: msg.msg_id || msg.msg_key || undefined,
+            refFromAccount: fromAccount,
+            ctx,
+        }),
+        log: glog,
+    });
     const groupQueueManager = getOutboundQueue(account.accountId);
     if (groupQueueManager) {
         groupQueueManager.registerSession(outboundGroupSessionKey, {
@@ -591,6 +637,7 @@ async function handleGroupMessage(params) {
             refFromAccount: fromAccount,
             ctx,
             mergeOnFlush: account.disableBlockStreaming,
+            onFirstSent: cancelSlowReply,
         });
         glog.debug(`[${outboundGroupSessionKey}] 群出站队列 session 已注册，msgId: ${groupMsgId}`);
     }
@@ -613,9 +660,12 @@ async function handleGroupMessage(params) {
         });
     }
     catch (err) {
+        glog.error('executeReply 失败', { error: String(err) });
         const session = groupQueueManager?.getSession(outboundGroupSessionKey);
         session?.abort();
-        throw err;
+    }
+    finally {
+        cancelSlowReply();
     }
     clearHistoryEntriesIfEnabled({
         historyMap: chatHistories,

package/dist/src/message-handler/outbound.d.ts

@@ -1,6 +1,6 @@
 import type { OpenClawConfig, PluginRuntime } from 'openclaw/plugin-sdk';
 import type { MarkdownTableMode } from 'openclaw/plugin-sdk/config-runtime';
-import type { ResolvedYuanbaoAccount, YuanbaoMsgBodyElement } from '../types.js';
+import { type ResolvedYuanbaoAccount, type YuanbaoMsgBodyElement } from '../types.js';
 import type { YuanbaoWsClient } from '../yuanbao-server/ws/index.js';
 import type { OutboundContentItem } from './handlers/index.js';
 import type { MessageHandlerContext } from './context.js';

package/dist/src/message-handler/outbound.js

@@ -1,3 +1,5 @@
+import { BotCreateType, } from '../types.js';
+import { DEFAULT_MODEL_RATE_LIMIT_TEXT, DEFAULT_MODEL_BILLING_DEFAULT_TEXT, DEFAULT_MODEL_BILLING_CUSTOM_TEXT, DEFAULT_MODEL_ONE_CLICK_ERROR_TEXT, } from '../config-schema.js';
 import { WS_HEARTBEAT } from '../yuanbao-server/ws/index.js';
 import { createLog } from '../logger.js';
 import { prepareOutboundContent, buildOutboundMsgBody } from './handlers/index.js';
@@ -151,6 +153,30 @@ export async function sendMsgBodyDirect(params) {
         ctx: minCtx,
     });
 }
+const RATE_LIMIT_RE = /rate[_ ]?limit|too many requests|\b429\b/i;
+const BILLING_RE = /billing|credits?|insufficient|payment|\b402\b/i;
+function classifyErrorText(text) {
+    if (RATE_LIMIT_RE.test(text))
+        return 'rate_limit';
+    if (BILLING_RE.test(text))
+        return 'billing';
+    return 'other';
+}
+function resolveDeliverErrorText(params) {
+    const { originalText, botCreateType, config } = params;
+    if (botCreateType !== BotCreateType.ONE_CLICK)
+        return originalText;
+    const model = config?.agents?.defaults?.model;
+    const modelId = typeof model === 'string' ? model : model?.primary;
+    const isYuanbaoModel = Boolean(modelId?.startsWith('yuanbao'));
+    const kind = classifyErrorText(originalText);
+    if (kind === 'rate_limit')
+        return DEFAULT_MODEL_RATE_LIMIT_TEXT;
+    if (kind === 'billing') {
+        return isYuanbaoModel ? DEFAULT_MODEL_BILLING_DEFAULT_TEXT : DEFAULT_MODEL_BILLING_CUSTOM_TEXT;
+    }
+    return isYuanbaoModel ? DEFAULT_MODEL_ONE_CLICK_ERROR_TEXT : originalText;
+}
 export async function executeReply(params) {
     const { transport, ctx, account, core, replyRuntime, splitFinalText, overflowPolicy, ctxPayload, sessionKey, appendText, } = params;
     const rlog = createLog('outbound');
@@ -190,7 +216,9 @@ export async function executeReply(params) {
                     rlog.warn(`[deliver][${account.accountId}] 回复已中止，停止处理后续回复块`);
                     return;
                 }
-                rlog.info('[deliver] 收到回复数据', { kind: info.kind, model_output: payload.text });
+                rlog.info('[deliver] 收到回复数据', {
+                    kind: info.kind, isError: payload.isError, model_output: payload.text,
+                });
                 if (payload.isReasoning) {
                     rlog.info('[deliver] Reasoning', { text: payload.text });
                     return;
@@ -205,7 +233,18 @@ export async function executeReply(params) {
                 if (info.kind === 'final') {
                     hasFinalInfo = true;
                 }
-                const text = payload.text ?? '';
+                let text = payload.text ?? '';
+                if (payload.isError && text) {
+                    const replaced = resolveDeliverErrorText({
+                        originalText: text,
+                        botCreateType: account.createType,
+                        config: replyRuntime.config,
+                    });
+                    if (replaced !== text) {
+                        rlog.info('[deliver] 错误文案已替换', { original: text, replaced });
+                    }
+                    text = replaced;
+                }
                 if (session) {
                     if (text.trim()) {
                         await session.push({ type: 'text', text });

package/dist/src/outbound-queue.d.ts

@@ -48,6 +48,7 @@ interface RegisterSessionOptions {
     msgId: string;
     toAccount?: string;
     mergeOnFlush?: boolean;
+    onFirstSent?: () => void;
 }
 export interface LightRegisterSessionOptions {
     chatType: 'c2c' | 'group';

package/dist/src/outbound-queue.js

@@ -54,7 +54,7 @@ function createManager(config) {
                 existing.abort();
             }
             const onComplete = () => sessions.delete(sessionKey);
-            const { chatType, account, target, fromAccount, refMsgId, refFromAccount, ctx, msgId, mergeOnFlush, toAccount, } = options;
+            const { chatType, account, target, fromAccount, refMsgId, refFromAccount, ctx, msgId, mergeOnFlush, toAccount, onFirstSent, } = options;
             const heartbeatTarget = (toAccount ?? (chatType === 'c2c' ? target : '')).trim();
             const heartbeatGroupCode = chatType === 'group' ? target : undefined;
             const sendText = async (text) => {
@@ -149,9 +149,25 @@ function createManager(config) {
                         });
                 }
             };
+            let firstSentFired = false;
+            const fireFirstSent = () => {
+                if (!firstSentFired && onFirstSent) {
+                    firstSentFired = true;
+                    onFirstSent();
+                }
+            };
+            function wrapSend(fn) {
+                return (async (...args) => {
+                    fireFirstSent();
+                    return fn(...args);
+                });
+            }
+            const wrappedSendText = wrapSend(sendText);
+            const wrappedSendSticker = wrapSend(sendSticker);
+            const wrappedSendMedia = wrapSend(sendMedia);
             let session;
             if (mergeOnFlush) {
-                session = createMergeOnFlushSession({ sendText, sendSticker, sendMedia }, msgId, onComplete, log, {
+                session = createMergeOnFlushSession({ sendText: wrappedSendText, sendSticker: wrappedSendSticker, sendMedia: wrappedSendMedia }, msgId, onComplete, log, {
                     ctx,
                     account,
                     toAccount: heartbeatTarget,
@@ -161,7 +177,7 @@ function createManager(config) {
             else {
                 switch (strategy) {
                     case 'immediate':
-                        session = createImmediateSession({ sendText, sendSticker, sendMedia }, msgId, onComplete, log, {
+                        session = createImmediateSession({ sendText: wrappedSendText, sendSticker: wrappedSendSticker, sendMedia: wrappedSendMedia }, msgId, onComplete, log, {
                             ctx,
                             account,
                             toAccount: heartbeatTarget,
@@ -169,7 +185,7 @@ function createManager(config) {
                         });
                         break;
                     case 'merge-text':
-                        session = createMergeTextSession({ sendText, sendSticker, sendMedia }, msgId, sessionKey, onComplete, log, mergeTextOpts, {
+                        session = createMergeTextSession({ sendText: wrappedSendText, sendSticker: wrappedSendSticker, sendMedia: wrappedSendMedia }, msgId, sessionKey, onComplete, log, mergeTextOpts, {
                             ctx,
                             account,
                             toAccount: heartbeatTarget,

package/dist/src/types.d.ts

@@ -27,6 +27,8 @@ export type YuanbaoAccountConfig = {
     requireMention?: boolean;
     fallbackReply?: string;
     markdownHintEnabled?: boolean;
+    slowReplyTimeoutMs?: number;
+    slowReplyText?: string;
 };
 export type YuanbaoConfig = YuanbaoAccountConfig & {
     accounts?: Record<string, YuanbaoAccountConfig>;
@@ -56,6 +58,9 @@ export type ResolvedYuanbaoAccount = {
     requireMention: boolean;
     fallbackReply?: string;
     markdownHintEnabled: boolean;
+    slowReplyTimeoutMs: number;
+    slowReplyText: string;
+    createType?: BotCreateType;
     config: YuanbaoAccountConfig;
 };
 export type ImImageInfoArrayItem = {
@@ -87,6 +92,10 @@ export type ImMsgSeq = {
     msg_seq?: number;
     msg_id?: string;
 };
+export declare enum BotCreateType {
+    ONE_CLICK = 1,
+    LINKED = 2
+}
 export declare enum EnumCLawMsgType {
     CLAW_MSG_UNKNOWN = 0,
     CLAW_MSG_GROUP = 1,
@@ -140,6 +149,7 @@ export type YuanbaoBufferedDeliverPayload = {
     mediaUrls?: string[];
     isCompactionNotice: boolean;
     isReasoning: boolean;
+    isError?: boolean;
 };
 export type YuanbaoSendMsgRequest = {
     sync_other_machine?: number;

package/dist/src/types.js

@@ -1,3 +1,8 @@
+export var BotCreateType;
+(function (BotCreateType) {
+    BotCreateType[BotCreateType["ONE_CLICK"] = 1] = "ONE_CLICK";
+    BotCreateType[BotCreateType["LINKED"] = 2] = "LINKED";
+})(BotCreateType || (BotCreateType = {}));
 export var EnumCLawMsgType;
 (function (EnumCLawMsgType) {
     EnumCLawMsgType[EnumCLawMsgType["CLAW_MSG_UNKNOWN"] = 0] = "CLAW_MSG_UNKNOWN";

package/dist/src/yuanbao-server/http/request.d.ts

@@ -1,10 +1,11 @@
-import type { ResolvedYuanbaoAccount } from '../../types.js';
+import { BotCreateType, type ResolvedYuanbaoAccount } from '../../types.js';
 export type SignTokenData = {
     bot_id: string;
     duration: number;
     product: string;
     source: string;
     token: string;
+    create_type?: BotCreateType;
 };
 export type AuthHeaders = {
     'X-ID': string;

package/dist/src/yuanbao-server/http/request.js

@@ -94,7 +94,7 @@ async function doFetchSignToken(account) {
         }
         const result = (await response.json());
         if (result.code === 0) {
-            mlog.info(`签票成功: bot_id=${result.data.bot_id}`);
+            mlog.info(`签票成功: bot_id=${result.data.bot_id}, create_type=${result.data.create_type}`);
             return result.data;
         }
         if (result.code === RETRYABLE_SIGN_CODE && attempt < SIGN_MAX_RETRIES) {

package/dist/src/yuanbao-server/ws/biz-codec.d.ts

@@ -1,5 +1,5 @@
 import type { YuanbaoInboundMessage, YuanbaoMsgBodyElement } from '../../types.js';
-import type { WsSendC2CMessageData, WsSendGroupMessageData, WsSendMessageResponse, WsSendPrivateHeartbeatData, WsSendGroupHeartbeatData, WsHeartbeatResponse, WsQueryGroupInfoData, WsQueryGroupInfoResponse, WsGetGroupMemberListData, WsGetGroupMemberListResponse } from './types.js';
+import type { WsSendC2CMessageData, WsSendGroupMessageData, WsSendMessageResponse, WsSendPrivateHeartbeatData, WsSendGroupHeartbeatData, WsHeartbeatResponse, WsQueryGroupInfoData, WsQueryGroupInfoResponse, WsGetGroupMemberListData, WsGetGroupMemberListResponse, WsSyncInformationData, WsSyncInformationResponse } from './types.js';
 export declare const BIZ_MSG_TYPES: {
     readonly MsgContent: "trpc.yuanbao.yuanbao_conn.yuanbao_openclaw_proxy.MsgContent";
     readonly MsgBodyElement: "trpc.yuanbao.yuanbao_conn.yuanbao_openclaw_proxy.MsgBodyElement";
@@ -16,6 +16,8 @@ export declare const BIZ_MSG_TYPES: {
     readonly SendPrivateHeartbeatRsp: "trpc.yuanbao.yuanbao_conn.yuanbao_openclaw_proxy.SendPrivateHeartbeatRsp";
     readonly SendGroupHeartbeatReq: "trpc.yuanbao.yuanbao_conn.yuanbao_openclaw_proxy.SendGroupHeartbeatReq";
     readonly SendGroupHeartbeatRsp: "trpc.yuanbao.yuanbao_conn.yuanbao_openclaw_proxy.SendGroupHeartbeatRsp";
+    readonly SyncInformationReq: "trpc.yuanbao.yuanbao_conn.yuanbao_openclaw_proxy.SyncInformationReq";
+    readonly SyncInformationRsp: "trpc.yuanbao.yuanbao_conn.yuanbao_openclaw_proxy.SyncInformationRsp";
 };
 export declare function encodeBizPB(key: string, value: Record<string, unknown>): Uint8Array | null;
 export declare function decodeBizPB(key: string, data: Uint8Array | ArrayBuffer): any;
@@ -35,3 +37,5 @@ export declare function encodeGetGroupMemberListReq(data: WsGetGroupMemberListDa
 export declare function decodeGetGroupMemberListRsp(data: Uint8Array | ArrayBuffer, msgId: string): WsGetGroupMemberListResponse | null;
 export declare function decodeSendPrivateHeartbeatRsp(data: Uint8Array | ArrayBuffer, msgId: string): WsHeartbeatResponse | null;
 export declare function decodeSendGroupHeartbeatRsp(data: Uint8Array | ArrayBuffer, msgId: string): WsHeartbeatResponse | null;
+export declare function encodeSyncInformationReq(data: WsSyncInformationData): Uint8Array | null;
+export declare function decodeSyncInformationRsp(data: Uint8Array | ArrayBuffer, msgId: string): WsSyncInformationResponse | null;

package/dist/src/yuanbao-server/ws/biz-codec.js

@@ -25,6 +25,8 @@ export const BIZ_MSG_TYPES = {
     SendPrivateHeartbeatRsp: `${PKG}.SendPrivateHeartbeatRsp`,
     SendGroupHeartbeatReq: `${PKG}.SendGroupHeartbeatReq`,
     SendGroupHeartbeatRsp: `${PKG}.SendGroupHeartbeatRsp`,
+    SyncInformationReq: `${PKG}.SyncInformationReq`,
+    SyncInformationRsp: `${PKG}.SyncInformationRsp`,
 };
 export function encodeBizPB(key, value) {
     try {
@@ -284,3 +286,21 @@ export function decodeSendGroupHeartbeatRsp(data, msgId) {
         message: decoded.msg || '',
     };
 }
+export function encodeSyncInformationReq(data) {
+    return encodeBizPB(BIZ_MSG_TYPES.SyncInformationReq, {
+        syncType: data.syncType,
+        botVersion: data.botVersion,
+        pluginVersion: data.pluginVersion,
+        ...(data.commandData ? { commandData: data.commandData } : {}),
+    });
+}
+export function decodeSyncInformationRsp(data, msgId) {
+    const decoded = decodeBizPB(BIZ_MSG_TYPES.SyncInformationRsp, data);
+    if (!decoded)
+        return null;
+    return {
+        msgId,
+        code: decoded.code || 0,
+        msg: decoded.msg || '',
+    };
+}

package/dist/src/yuanbao-server/ws/client.d.ts

@@ -1,4 +1,4 @@
-import type { WsClientCallbacks, WsClientConfig, WsClientState, WsConnectionConfig, WsSendMessageResponse, WsSendC2CMessageData, WsSendGroupMessageData, WsSendPrivateHeartbeatData, WsSendGroupHeartbeatData, WsHeartbeatResponse, WsQueryGroupInfoData, WsQueryGroupInfoResponse, WsGetGroupMemberListData, WsGetGroupMemberListResponse } from './types.js';
+import type { WsClientCallbacks, WsClientConfig, WsClientState, WsConnectionConfig, WsSendMessageResponse, WsSendC2CMessageData, WsSendGroupMessageData, WsSendPrivateHeartbeatData, WsSendGroupHeartbeatData, WsHeartbeatResponse, WsQueryGroupInfoData, WsQueryGroupInfoResponse, WsGetGroupMemberListData, WsGetGroupMemberListResponse, WsSyncInformationData, WsSyncInformationResponse } from './types.js';
 export declare const BIZ_CMD: {
     readonly SendC2CMessage: "send_c2c_message";
     readonly SendGroupMessage: "send_group_message";
@@ -6,6 +6,7 @@ export declare const BIZ_CMD: {
     readonly GetGroupMemberList: "get_group_member_list";
     readonly SendPrivateHeartbeat: "send_private_heartbeat";
     readonly SendGroupHeartbeat: "send_group_heartbeat";
+    readonly SyncInformation: "sync_information";
 };
 export declare class YuanbaoWsClient {
     private connectionConfig;
@@ -44,6 +45,7 @@ export declare class YuanbaoWsClient {
     getGroupMemberList(data: WsGetGroupMemberListData): Promise<WsGetGroupMemberListResponse>;
     sendPrivateHeartbeat(data: WsSendPrivateHeartbeatData): Promise<WsHeartbeatResponse>;
     sendGroupHeartbeat(data: WsSendGroupHeartbeatData): Promise<WsHeartbeatResponse>;
+    syncInformation(data: WsSyncInformationData): Promise<WsSyncInformationResponse>;
     private doConnect;
     private onMessage;
     private handleConnMsg;

package/dist/src/yuanbao-server/ws/client.js

@@ -2,7 +2,7 @@ import WebSocket from 'ws';
 import { v4 as uuidv4 } from 'uuid';
 import { getPluginVersion, getOpenclawVersion, getOperationSystem } from '../../utils/get-env.js';
 import { decodeConnMsg, decodePB, buildAuthBindMsg, buildPingMsg, buildPushAck, buildBusinessConnMsg, PB_MSG_TYPES, CMD_TYPE, CMD, } from './conn-codec.js';
-import { encodeSendC2CMessageReq, encodeSendGroupMessageReq, decodeSendMessageRsp, encodeSendPrivateHeartbeatReq, encodeSendGroupHeartbeatReq, decodeSendPrivateHeartbeatRsp, decodeSendGroupHeartbeatRsp, encodeQueryGroupInfoReq, decodeQueryGroupInfoRsp, encodeGetGroupMemberListReq, decodeGetGroupMemberListRsp, } from './biz-codec.js';
+import { encodeSendC2CMessageReq, encodeSendGroupMessageReq, decodeSendMessageRsp, encodeSendPrivateHeartbeatReq, encodeSendGroupHeartbeatReq, decodeSendPrivateHeartbeatRsp, decodeSendGroupHeartbeatRsp, encodeQueryGroupInfoReq, decodeQueryGroupInfoRsp, encodeGetGroupMemberListReq, decodeGetGroupMemberListRsp, encodeSyncInformationReq, decodeSyncInformationRsp, } from './biz-codec.js';
 import { createLog } from '../../logger.js';
 import { msgBodyDesensitization } from '../../utils.js';
 const DEFAULT_RECONNECT_DELAYS = [1_000, 2_000, 5_000, 10_000, 30_000, 60_000];
@@ -36,6 +36,7 @@ export const BIZ_CMD = {
     GetGroupMemberList: 'get_group_member_list',
     SendPrivateHeartbeat: 'send_private_heartbeat',
     SendGroupHeartbeat: 'send_group_heartbeat',
+    SyncInformation: 'sync_information',
 };
 const BIZ_MODULE = 'yuanbao_openclaw_proxy';
 export class YuanbaoWsClient {
@@ -185,6 +186,13 @@ export class YuanbaoWsClient {
             return Promise.reject(new Error('Failed to encode SendGroupHeartbeatReq'));
         return this.sendAndWaitWith(BIZ_CMD.SendGroupHeartbeat, BIZ_MODULE, encoded, decodeSendGroupHeartbeatRsp);
     }
+    syncInformation(data) {
+        this.log.info('[同步] 发送 SyncInformation 请求', { syncType: data.syncType, botVersion: data.botVersion, pluginVersion: data.pluginVersion });
+        const encoded = encodeSyncInformationReq(data);
+        if (!encoded)
+            return Promise.reject(new Error('Failed to encode SyncInformationReq'));
+        return this.sendAndWaitWith(BIZ_CMD.SyncInformation, BIZ_MODULE, encoded, decodeSyncInformationRsp);
+    }
     doConnect() {
         if (this.disposed)
             return;

package/dist/src/yuanbao-server/ws/gateway.js

@@ -5,6 +5,7 @@ import { handleInboundMessage, } from '../../message-handler/index.js';
 import { setActiveWsClient } from './runtime.js';
 import { decodeInboundMessage } from './biz-codec.js';
 import { getSignToken, forceRefreshSignToken } from '../api.js';
+import { buildSyncCommandsPayload } from '../../commands/slash-commands/index.js';
 export async function startYuanbaoWsGateway(params) {
     const { account, config, abortSignal, runtime, statusSink } = params;
     const gwlog = createLog('ws');
@@ -26,6 +27,9 @@ export async function startYuanbaoWsGateway(params) {
                     wsConnectId: data.connectId,
                     lastConnectedAt: Date.now(),
                 });
+                syncCommandsToServer(client, account.accountId, config).catch((err) => {
+                    gwlog.warn(`[${account.accountId}] 同步命令列表失败（不影响正常功能）`, { error: String(err) });
+                });
             },
             onDispatch: (pushEvent) => {
                 gwlog.debug(`[${account.accountId}] WS 推送: cmd=${pushEvent.cmd}, type=${pushEvent.type}`);
@@ -57,6 +61,9 @@ export async function startYuanbaoWsGateway(params) {
                 if (tokenData.bot_id) {
                     account.botId = tokenData.bot_id;
                 }
+                if (tokenData.create_type != null) {
+                    account.createType = tokenData.create_type;
+                }
                 return {
                     bizId: 'ybBot',
                     uid,
@@ -114,7 +121,10 @@ async function resolveWsAuth(account) {
     if (tokenData.bot_id) {
         account.botId = tokenData.bot_id;
     }
-    mlog.info(`[${account.accountId}] 签票完成 uid=${uid} (bot_id=${tokenData.bot_id}, botId=${account.botId})`);
+    if (tokenData.create_type != null) {
+        account.createType = tokenData.create_type;
+    }
+    mlog.info(`[${account.accountId}] 签票完成 uid=${uid} (bot_id=${tokenData.bot_id}, botId=${account.botId}), create_type=${tokenData.create_type}`);
     return {
         bizId: 'ybBot',
         uid,
@@ -259,3 +269,30 @@ function handleWsDispatchEvent(params) {
         dlog.error(`[${account.accountId}][dispatch] WS ${chatType === 'group' ? 'group ' : ''} message handler failed: ${String(err)}`);
     });
 }
+async function syncCommandsToServer(client, accountId, config) {
+    const slog = createLog('ws');
+    const payload = await buildSyncCommandsPayload(config);
+    slog.info(`[${accountId}] 同步命令列表`, {
+        botVersion: payload.botVersion,
+        pluginVersion: payload.pluginVersion,
+        botCommands: payload.commandData.botCommands.length,
+        pluginCommands: payload.commandData.pluginCommands.length,
+    });
+    slog.info(`[${accountId}] SyncInformationReq 请求内容:`, {
+        sync_type: payload.syncType,
+        bot_version: payload.botVersion,
+        plugin_version: payload.pluginVersion,
+        command_data: {
+            bot_commands: payload.commandData.botCommands,
+            plugin_commands: payload.commandData.pluginCommands,
+        },
+    });
+    const rsp = await client.syncInformation(payload);
+    slog.info(`[${accountId}] SyncInformationRsp 响应内容:`, { code: rsp.code, msg: rsp.msg });
+    if (rsp.code !== 0) {
+        slog.warn(`[${accountId}] 同步命令列表返回非零码: code=${rsp.code}, msg=${rsp.msg}`);
+    }
+    else {
+        slog.info(`[${accountId}] 同步命令列表成功`);
+    }
+}

package/dist/src/yuanbao-server/ws/index.d.ts

@@ -1,9 +1,9 @@
 export { encodePB, decodePB, encodeConnMsg, decodeConnMsg, buildAuthBindMsg, buildPingMsg, buildPushAck, buildBusinessConnMsg, createHead, nextSeqNo, PB_MSG_TYPES, CMD_TYPE, CMD, MODULE, } from './conn-codec.js';
 export type { PBHead, PBConnMsg } from './conn-codec.js';
-export { encodeBizPB, decodeBizPB, toProtoMsgBody, fromProtoMsgBody, encodeSendC2CMessageReq, encodeSendGroupMessageReq, encodeSendPrivateHeartbeatReq, encodeSendGroupHeartbeatReq, decodeInboundMessage, decodeSendC2CMessageRsp, decodeSendGroupMessageRsp, decodeSendMessageRsp, decodeSendPrivateHeartbeatRsp, decodeSendGroupHeartbeatRsp, encodeQueryGroupInfoReq, decodeQueryGroupInfoRsp, encodeGetGroupMemberListReq, decodeGetGroupMemberListRsp, BIZ_MSG_TYPES, } from './biz-codec.js';
+export { encodeBizPB, decodeBizPB, toProtoMsgBody, fromProtoMsgBody, encodeSendC2CMessageReq, encodeSendGroupMessageReq, encodeSendPrivateHeartbeatReq, encodeSendGroupHeartbeatReq, decodeInboundMessage, decodeSendC2CMessageRsp, decodeSendGroupMessageRsp, decodeSendMessageRsp, decodeSendPrivateHeartbeatRsp, decodeSendGroupHeartbeatRsp, encodeQueryGroupInfoReq, decodeQueryGroupInfoRsp, encodeGetGroupMemberListReq, decodeGetGroupMemberListRsp, encodeSyncInformationReq, decodeSyncInformationRsp, BIZ_MSG_TYPES, } from './biz-codec.js';
 export { YuanbaoWsClient, BIZ_CMD } from './client.js';
 export { startYuanbaoWsGateway, wsPushToInboundMessage } from './gateway.js';
 export type { StartWsGatewayParams } from './gateway.js';
 export { setActiveWsClient, getActiveWsClient, getAllActiveWsClients } from './runtime.js';
 export { WS_HEARTBEAT } from './types.js';
-export type { WsConnectionConfig, WsClientConfig, WsClientState, WsAuthBindResult, WsClientCallbacks, WsPushEvent, WsSendC2CMessageData, WsSendGroupMessageData, WsSendPrivateHeartbeatData, WsSendGroupHeartbeatData, WsOutboundMessageData, WsSendMessageResponse, WsHeartbeatResponse, WsHeartbeatValue, WsQueryGroupInfoData, WsQueryGroupInfoResponse, WsGroupInfo, WsGetGroupMemberListData, WsGetGroupMemberListResponse, WsGroupMember, } from './types.js';
+export type { WsConnectionConfig, WsClientConfig, WsClientState, WsAuthBindResult, WsClientCallbacks, WsPushEvent, WsSendC2CMessageData, WsSendGroupMessageData, WsSendPrivateHeartbeatData, WsSendGroupHeartbeatData, WsOutboundMessageData, WsSendMessageResponse, WsHeartbeatResponse, WsHeartbeatValue, WsQueryGroupInfoData, WsQueryGroupInfoResponse, WsGroupInfo, WsGetGroupMemberListData, WsGetGroupMemberListResponse, WsGroupMember, WsSyncInformationData, WsSyncInformationResponse, WsSyncCommand, WsSyncCommandsData, } from './types.js';

package/dist/src/yuanbao-server/ws/index.js

@@ -1,5 +1,5 @@
 export { encodePB, decodePB, encodeConnMsg, decodeConnMsg, buildAuthBindMsg, buildPingMsg, buildPushAck, buildBusinessConnMsg, createHead, nextSeqNo, PB_MSG_TYPES, CMD_TYPE, CMD, MODULE, } from './conn-codec.js';
-export { encodeBizPB, decodeBizPB, toProtoMsgBody, fromProtoMsgBody, encodeSendC2CMessageReq, encodeSendGroupMessageReq, encodeSendPrivateHeartbeatReq, encodeSendGroupHeartbeatReq, decodeInboundMessage, decodeSendC2CMessageRsp, decodeSendGroupMessageRsp, decodeSendMessageRsp, decodeSendPrivateHeartbeatRsp, decodeSendGroupHeartbeatRsp, encodeQueryGroupInfoReq, decodeQueryGroupInfoRsp, encodeGetGroupMemberListReq, decodeGetGroupMemberListRsp, BIZ_MSG_TYPES, } from './biz-codec.js';
+export { encodeBizPB, decodeBizPB, toProtoMsgBody, fromProtoMsgBody, encodeSendC2CMessageReq, encodeSendGroupMessageReq, encodeSendPrivateHeartbeatReq, encodeSendGroupHeartbeatReq, decodeInboundMessage, decodeSendC2CMessageRsp, decodeSendGroupMessageRsp, decodeSendMessageRsp, decodeSendPrivateHeartbeatRsp, decodeSendGroupHeartbeatRsp, encodeQueryGroupInfoReq, decodeQueryGroupInfoRsp, encodeGetGroupMemberListReq, decodeGetGroupMemberListRsp, encodeSyncInformationReq, decodeSyncInformationRsp, BIZ_MSG_TYPES, } from './biz-codec.js';
 export { YuanbaoWsClient, BIZ_CMD } from './client.js';
 export { startYuanbaoWsGateway, wsPushToInboundMessage } from './gateway.js';
 export { setActiveWsClient, getActiveWsClient, getAllActiveWsClients } from './runtime.js';

package/dist/src/yuanbao-server/ws/proto/biz.json

@@ -470,6 +470,75 @@
                                                     "id": 2
                                                 }
                                             }
+                                        },
+                                        "SyncInformationType": {
+                                            "values": {
+                                                "SYNC_INFORMATION_TYPE_UNSPECIFIED": 0,
+                                                "SYNC_INFORMATION_TYPE_COMMANDS": 1
+                                            }
+                                        },
+                                        "Command": {
+                                            "fields": {
+                                                "name": {
+                                                    "type": "string",
+                                                    "id": 1
+                                                },
+                                                "description": {
+                                                    "type": "string",
+                                                    "id": 2
+                                                }
+                                            }
+                                        },
+                                        "SyncCommandsData": {
+                                            "fields": {
+                                                "botCommands": {
+                                                    "rule": "repeated",
+                                                    "type": "Command",
+                                                    "id": 1
+                                                },
+                                                "pluginCommands": {
+                                                    "rule": "repeated",
+                                                    "type": "Command",
+                                                    "id": 2
+                                                }
+                                            }
+                                        },
+                                        "SyncInformationReq": {
+                                            "oneofs": {
+                                                "data": {
+                                                    "oneof": ["commandData"]
+                                                }
+                                            },
+                                            "fields": {
+                                                "syncType": {
+                                                    "type": "SyncInformationType",
+                                                    "id": 1
+                                                },
+                                                "botVersion": {
+                                                    "type": "string",
+                                                    "id": 2
+                                                },
+                                                "pluginVersion": {
+                                                    "type": "string",
+                                                    "id": 3
+                                                },
+                                                "commandData": {
+                                                    "type": "SyncCommandsData",
+                                                    "id": 11
+                                                }
+                                            }
+                                        },
+                                        "SyncInformationRsp": {
+                                            "fields": {
+                                                "code": {
+                                                    "type": "int32",
+                                                    "id": 1
+                                                },
+                                                "msg": {
+                                                    "type": "string",
+                                                    "id": 2
+                                                }
+                                            }
                                         }
                                     }
                                 }

package/dist/src/yuanbao-server/ws/types.d.ts

@@ -121,3 +121,22 @@ export type WsHeartbeatResponse = {
     msg?: string;
     message?: string;
 };
+export type WsSyncCommand = {
+    name: string;
+    description: string;
+};
+export type WsSyncCommandsData = {
+    botCommands: WsSyncCommand[];
+    pluginCommands: WsSyncCommand[];
+};
+export type WsSyncInformationData = {
+    syncType: number;
+    botVersion: string;
+    pluginVersion: string;
+    commandData?: WsSyncCommandsData;
+};
+export type WsSyncInformationResponse = {
+    msgId: string;
+    code: number;
+    msg: string;
+};

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-plugin-yuanbao",
   "name": "元宝 Bot",
   "description": "Tencent YuanBao intelligent bot channel plugin",
-  "version": "2.9.1",
+  "version": "2.10.0",
   "channels": [
     "yuanbao"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-plugin-yuanbao",
-  "version": "2.9.1",
+  "version": "2.10.0",
   "type": "module",
   "description": "Tencent YuanBao intelligent bot channel plugin",
   "license": "MIT",

package/dist/src/message-handler/handlers/custom.js

@@ -1,52 +0,0 @@
-import { createLog } from '../../logger.js';
-export function buildAtUserMsgBodyItem(userId, senderNickname) {
-    return {
-        msg_type: 'TIMCustomElem',
-        msg_content: {
-            data: JSON.stringify({ elem_type: 1002, text: `@${senderNickname ?? ''}`, user_id: userId }),
-        },
-    };
-}
-const FALLBACK_TEXT = '[custom]';
-export const customHandler = {
-    msgType: 'TIMCustomElem',
-    extract(ctx, elem, resData) {
-        if (elem.msg_content?.data) {
-            try {
-                const customContent = JSON.parse(elem.msg_content?.data);
-                if (customContent?.elem_type !== 1002) {
-                    return FALLBACK_TEXT;
-                }
-                const { botId } = ctx.account;
-                const isAtBotSelf = customContent?.user_id === botId;
-                if (!resData.isAtBot) {
-                    resData.isAtBot = isAtBotSelf;
-                }
-                createLog('custom').info('@消息', { text: customContent?.text, userId: customContent?.user_id, isAtBot: resData.isAtBot });
-                if (customContent?.user_id) {
-                    resData.mentions.push({
-                        userId: customContent.user_id,
-                        text: customContent.text || '',
-                    });
-                }
-                if (isAtBotSelf && customContent.text) {
-                    resData.botUsername = customContent.text.replace(/^@/, '');
-                }
-                return customContent.text || undefined;
-            }
-            catch { }
-        }
-        return FALLBACK_TEXT;
-    },
-    buildMsgBody(data) {
-        const customData = typeof data.data === 'string'
-            ? data.data
-            : JSON.stringify(data.data);
-        return [
-            {
-                msg_type: 'TIMCustomElem',
-                msg_content: { data: customData },
-            },
-        ];
-    },
-};