@jerryliang122/openclaw-qqbot 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,1222 @@
+import * as openclaw_plugin_sdk_core from 'openclaw/plugin-sdk/core';
+import { PluginRuntime, OpenClawConfig, GroupPolicy as GroupPolicy$1, OpenClawPluginApi } from 'openclaw/plugin-sdk';
+import * as openclaw_plugin_sdk_channel_core from 'openclaw/plugin-sdk/channel-core';
+import { QQBot, ReplyTarget, MessageResponse, MediaFileType, StreamSession, MiddlewareContext, QQBotInboundMessage, RefIndexStore, RefEntry, Middleware } from '@tencent-connect/qqbot-nodejs';
+
+/** 普通文本消息 */
+declare const MSG_TYPE_TEXT = 0;
+/** 引用（回复）消息 */
+declare const MSG_TYPE_QUOTE = 103;
+/**
+ * QQ Bot 配置类型
+ */
+interface QQBotConfig {
+    appId: string;
+    clientSecret?: string;
+    clientSecretFile?: string;
+}
+/**
+ * 解析后的 QQ Bot 账户
+ */
+interface ResolvedQQBotAccount {
+    accountId: string;
+    name?: string;
+    enabled: boolean;
+    appId: string;
+    clientSecret: string;
+    secretSource: "config" | "file" | "env" | "none";
+    /** 系统提示词 */
+    systemPrompt?: string;
+    /** 是否支持 markdown 消息（默认 true） */
+    markdownSupport: boolean;
+    /** 是否自动同步 openclaw essential 原生指令到 QQ Bot 指令面板（默认 true） */
+    commandPanelNative: boolean;
+    /** User-Agent 尾部追加内容 */
+    userAgentSuffix: string;
+    config: QQBotAccountConfig;
+}
+/** 群消息策略：open=全响应 | allowlist=白名单 | disabled=不响应 */
+type GroupPolicy = "open" | "allowlist" | "disabled";
+/** 工具策略：full=全部 | restricted=限制敏感工具 | none=禁止 */
+type ToolPolicy = "full" | "restricted" | "none";
+/** 群消息合并配置 */
+interface GroupCoalesceConfig {
+    /**
+     * 是否启用消息合并（默认 true）：
+     * - true：框架 collect 合并批处理
+     * - false：followup 排队不合并
+     * 排队/合并完全由 OpenClaw 框架的 followup 队列承担。
+     */
+    enabled?: boolean;
+}
+/** 指令面板配置 */
+interface CommandsConfig {
+    /**
+     * 是否把 openclaw essential 原生指令自动注册到 QQ Bot 指令面板（默认 true）。
+     * 面板项点击后指令文本填入输入框，以普通文本进入框架，走文本斜杠指令路由执行。
+     */
+    native?: boolean;
+}
+/** 单个群的配置 */
+interface GroupConfig {
+    /** 是否需要 @机器人才响应（默认 true） */
+    requireMention?: boolean;
+    /**
+     * 是否忽略 @了其他用户但没有 @机器人的消息（默认 false）。
+     * 开启后，消息中 @了其他人但未 @bot 时直接丢弃（不记录历史、不触发 AI）。
+     */
+    ignoreOtherMentions?: boolean;
+    /** 群聊中 AI 可使用的工具范围（默认 restricted） */
+    toolPolicy?: ToolPolicy;
+    /** 群名称 */
+    name?: string;
+    /** 群消息行为 PE（未配置时使用内置默认值） */
+    prompt?: string;
+    /** 群历史消息缓存条数（0 禁用，默认 20） */
+    historyLimit?: number;
+    /**
+     * 群历史清理时机（默认 clear）：
+     * - clear：每次回复后整清（旧语义，"自上次回复以来的窗口"）
+     * - rolling：回复后裁剪到最后一条 bot 出站之后（bot 发言也计入历史，
+     *   对齐 telegram selectAfterLastSelf 的滚动窗口语义）
+     */
+    historyMode?: 'clear' | 'rolling';
+    /**
+     * 未被 @ 的群消息入站策略（默认 user_request，仅全量模式群有实际意义）：
+     * - user_request：维持现状——mentionGate 拦截未 @ 消息（只进历史，不上报）
+     * - room_event：门控放行全部消息，未被 @/称呼/引用的作为 room_event 被动
+     *   房间事件进框架（AI 只读上下文，不自动回复，想发言走主动 message 工具；
+     *   框架自动压制 typing/流式/steer）。成本提示：每条消息一次推理 pass。
+     */
+    unmentionedInbound?: 'user_request' | 'room_event';
+    /** 群消息合并配置（覆盖账号级配置） */
+    coalesce?: GroupCoalesceConfig;
+}
+/** 限流单层配置（滑动窗口） */
+interface RateLimitTierConfig {
+    /** 窗口内最大消息数 */
+    max: number;
+    /** 窗口时长（毫秒） */
+    windowMs: number;
+}
+/** 三层限流配置（sender / group / global） */
+interface RateLimitConfig {
+    /** 是否启用（默认 true；保守默认阈值，正常使用不会触发） */
+    enabled?: boolean;
+    /** 单发送者限流（默认 20 条/分钟） */
+    perSender?: RateLimitTierConfig;
+    /** 单群限流（默认 60 条/分钟，c2c 按 sender 归组） */
+    perGroup?: RateLimitTierConfig;
+    /** 全局限流（默认 300 条/分钟） */
+    global?: RateLimitTierConfig;
+}
+/** 消息接收传输方式 */
+type TransportMode = "websocket" | "webhook";
+/** Webhook 传输配置 */
+interface WebhookTransportConfig {
+    /** 监听路径（默认 /qqbot/webhook） */
+    path?: string;
+}
+/**
+ * QQ Bot 账户配置
+ */
+interface QQBotAccountConfig {
+    enabled?: boolean;
+    name?: string;
+    appId?: string;
+    clientSecret?: string;
+    clientSecretFile?: string;
+    dmPolicy?: "open" | "pairing" | "allowlist" | "disabled";
+    allowFrom?: string[];
+    /** 消息接收传输方式：websocket（默认）| webhook */
+    transport?: TransportMode;
+    /** webhook 传输配置（transport="webhook" 时生效） */
+    webhook?: WebhookTransportConfig;
+    /** 群消息策略（默认 allowlist） */
+    groupPolicy?: GroupPolicy;
+    /** 群白名单（groupPolicy 为 allowlist 时生效） */
+    groupAllowFrom?: string[];
+    /** 群配置映射（按 groupOpenid 索引，"*" 为默认） */
+    groups?: Record<string, GroupConfig>;
+    /** 三层限流（sender/group/global，默认启用保守阈值） */
+    rateLimit?: RateLimitConfig;
+    /** 系统提示词，会添加在用户消息前面 */
+    systemPrompt?: string;
+    /** 是否支持 markdown 消息（默认 true，设为 false 可禁用） */
+    markdownSupport?: boolean;
+    /**
+     * 音频格式策略配置
+     * 统一管理入站（STT）和出站（上传）的音频格式转换行为
+     */
+    audioFormatPolicy?: AudioFormatPolicy;
+    /**
+     * 是否启用公网 URL 直传 QQ 平台（默认 true）
+     * 启用时：公网 URL 先直传给 QQ 开放平台的富媒体 API，平台自行拉取；失败后自动 fallback 到插件下载再 Base64 上传
+     * 禁用时：公网 URL 始终由插件先下载到本地，再以 Base64 上传（适用于 QQ 平台无法访问目标 URL 的场景）
+     */
+    urlDirectUpload?: boolean;
+    /**
+     * /bot-upgrade 指令返回的升级指引网址
+     * 默认: 本仓库 CHANGELOG（含各版本升级说明）
+     */
+    upgradeUrl?: string;
+    /**
+     * 群消息是否默认需要 @机器人才响应（默认 true）
+     * 优先级低于 groups.{groupId}.requireMention 和 groups."*".requireMention
+     * 设为 false 时，所有群默认无需 @ 即触发回复（仍可被群级配置覆盖）
+     */
+    defaultRequireMention?: boolean;
+    /**
+     * 群消息合并配置（账号级）
+     * 启用后，群聊中快速发送的多条消息会被合并处理，而不是取消之前的任务
+     * 与私聊的"插嘴"行为相反，群聊中所有消息都应该被处理
+     */
+    groupCoalesce?: GroupCoalesceConfig;
+    /**
+     * 出站消息合并回复（debounce）配置
+     * 当短时间内收到多次 deliver 时，将文本合并为一条消息发送，避免消息轰炸
+     */
+    deliverDebounce?: DeliverDebounceConfig;
+    /**
+     * "正在输入"指示器配置（仅 C2C 私聊生效）
+     */
+    typing?: TypingIndicatorConfig;
+    /**
+     * 指令面板配置（openclaw 原生指令 → QQ Bot 指令面板自动注册）
+     */
+    commands?: CommandsConfig;
+    /**
+     * 是否启用流式消息（默认 false）
+     * 启用后，AI 的回复会以流式形式逐步显示在 QQ 聊天中，
+     * 用户可以看到文字逐字出现的打字机效果。
+     *
+     * 兼容布尔值和对象格式，对齐框架 schema：
+     *   - true / false         旧版布尔格式（自动转换为对象）
+     *   - { mode: "partial" }  开启（对齐 StreamingMode.partial）
+     *   - { mode: "off" }      关闭
+     *
+     * 注意：仅 C2C（私聊）支持流式消息 API。
+     *
+     * sendMode 控制文本下发通道（仅 mode="partial" 时生效）：
+     *   - "stream"  QQ 流式打印机（默认）：同一条消息内容不断变长，打字机效果
+     *   - "static"  流结束时用一条普通 sendText 发送完整文本：无打字机，
+     *               partial 接收逻辑（状态机/串行/去重）保持不变，仅替换下发通道。
+     *               适合不想要打字机效果、只想收到一条完整回复的场景。
+     */
+    streaming?: {
+        mode: 'partial' | 'off';
+        sendMode?: 'stream' | 'static';
+    };
+    /**
+     * STT (语音转文字) 配置
+     * 配置后，收到语音消息时会自动调用 STT 服务转录为文字
+     */
+    stt?: STTChannelConfig;
+    /**
+     * User-Agent 尾部追加内容（用于私有化部署标识等场景）
+     * 追加在 `QQBotPlugin/{version} (Node/{nodeVersion}; {os}; OpenClaw/{version})` 之后
+     */
+    userAgentSuffix?: string;
+}
+/**
+ * 出站消息合并回复配置
+ */
+interface DeliverDebounceConfig {
+    /**
+     * 是否启用合并回复（默认 true）
+     */
+    enabled?: boolean;
+    /**
+     * 合并窗口时长（毫秒），在此时间内的连续 deliver 会被合并
+     * 默认 1500ms
+     */
+    windowMs?: number;
+    /**
+     * 最大等待时长（毫秒），从第一条 deliver 开始计算，超过此时间强制发送
+     * 防止持续有新 deliver 导致一直不发送
+     * 默认 8000ms
+     */
+    maxWaitMs?: number;
+    /**
+     * 合并文本之间的分隔符
+     * 默认 "\n\n---\n\n"
+     */
+    separator?: string;
+}
+/**
+ * "正在输入"指示器配置
+ *
+ * QQ 客户端行为：退出聊天界面再进入后，指示器会消失，只有收到新的
+ * input_notify 推送才会重新显示，因此处理期间需要周期性续期。
+ *
+ * 配额说明：typing 通知与回复消息共享同一 msg_id 的被动回复配额
+ * （QQ 开放平台同一条消息被动回复上限约 5 条）。被动配额耗尽后，
+ * typing 与回复消息一样自动降级为主动发送（不带 msg_id），续期不中断。
+ *
+ * 中间消息：机器人发出消息（如思维链中间输出）后，QQ 客户端会终止
+ * 指示器显示。若框架任务仍在进行，插件会在消息发出 5 秒后补发一次
+ * 续期；若是最终回复（任务完成），则不再补发。
+ */
+interface TypingIndicatorConfig {
+    /**
+     * 是否启用指示器（默认 true）
+     */
+    enabled?: boolean;
+    /**
+     * 续期间隔（毫秒），默认 20000
+     * 受 QPS 限制，低于 20000 会被钳制到 20000
+     */
+    intervalMs?: number;
+}
+/**
+ * 音频格式策略：控制哪些格式可跳过转换
+ */
+interface AudioFormatPolicy {
+    /**
+     * STT 模型直接支持的音频格式（入站：跳过 SILK→WAV 转换）
+     * 如果 STT 服务支持直接处理某些格式（如 silk/amr），可将其加入此列表
+     * 例如: [".silk", ".amr", ".wav", ".mp3", ".ogg"]
+     * 默认为空（所有语音都先转换为 WAV 再送 STT）
+     */
+    sttDirectFormats?: string[];
+    /**
+     * QQ 平台支持直传的音频格式（出站：跳过→SILK 转换）
+     * 默认为 [".wav", ".mp3", ".silk"]（QQ Bot API 原生支持的三种格式）
+     * 仅当需要覆盖默认值时才配置此项
+     */
+    uploadDirectFormats?: string[];
+    /**
+     * 是否启用语音转码（默认 true）
+     * 设为 false 可在环境无 ffmpeg 时跳过转码，直接以文件形式发送
+     * 当禁用时，非原生格式的音频会 fallback 到 sendDocument（文件发送）
+     */
+    transcodeEnabled?: boolean;
+}
+/**
+ * STT (语音转文字) 配置
+ */
+interface STTChannelConfig {
+    /** 是否启用 STT（默认 true，配置了 baseUrl+apiKey 即自动启用） */
+    enabled?: boolean;
+    /** STT 服务提供商 ID（对应 models.providers 中的 key，默认 "openai"） */
+    provider?: string;
+    /** STT API 地址（如 https://api.openai.com/v1） */
+    baseUrl?: string;
+    /** STT API 密钥 */
+    apiKey?: string;
+    /** STT 模型名称（默认 "whisper-1"） */
+    model?: string;
+}
+/**
+ * 富媒体附件
+ */
+interface MessageAttachment {
+    content_type: string;
+    filename?: string;
+    height?: number;
+    width?: number;
+    size?: number;
+    url: string;
+    voice_wav_url?: string;
+    asr_refer_text?: string;
+}
+/**
+ * C2C 消息事件
+ */
+interface C2CMessageEvent {
+    author: {
+        id: string;
+        union_openid: string;
+        user_openid: string;
+    };
+    content: string;
+    id: string;
+    timestamp: string;
+    message_scene?: {
+        source: string;
+        /** ext 数组，可能包含 ref_msg_idx=REFIDX_xxx（引用的消息）和 msg_idx=REFIDX_xxx（自身索引） */
+        ext?: string[];
+    };
+    attachments?: MessageAttachment[];
+    /** 消息类型，参见 MSG_TYPE_* */
+    message_type?: number;
+    /** 消息元素列表，引用消息时 [0] 为被引用的原始消息 */
+    msg_elements?: MsgElement[];
+}
+/**
+ * 频道 AT 消息事件
+ */
+interface GuildMessageEvent {
+    id: string;
+    channel_id: string;
+    guild_id: string;
+    content: string;
+    timestamp: string;
+    author: {
+        id: string;
+        username?: string;
+        bot?: boolean;
+    };
+    member?: {
+        nick?: string;
+        joined_at?: string;
+    };
+    attachments?: MessageAttachment[];
+}
+/** 消息元素结点，引用消息时 msg_elements[0] 为被引用的原始消息 */
+interface MsgElement {
+    /** 消息索引标识 */
+    msg_idx?: string;
+    /** 消息类型，参见 MSG_TYPE_* 常量 */
+    message_type?: number;
+    /** 文本内容 */
+    content?: string;
+    /** 附件列表 */
+    attachments?: MessageAttachment[];
+    /** 嵌套消息元素（引用消息场景下可能存在） */
+    msg_elements?: MsgElement[];
+}
+/**
+ * 群聊 AT 消息事件
+ */
+interface GroupMessageEvent {
+    author: {
+        id: string;
+        member_openid: string;
+        username?: string;
+        bot?: boolean;
+    };
+    content: string;
+    id: string;
+    timestamp: string;
+    group_id: string;
+    group_openid: string;
+    message_scene?: {
+        source: string;
+        ext?: string[];
+    };
+    attachments?: MessageAttachment[];
+    /** @提及列表 */
+    mentions?: Array<{
+        scope?: "all" | "single";
+        id?: string;
+        user_openid?: string;
+        member_openid?: string;
+        nickname?: string;
+        bot?: boolean;
+        /** 是否 @机器人自身 */
+        is_you?: boolean;
+    }>;
+    /** 消息类型，参见 MSG_TYPE_* */
+    message_type?: number;
+    /** 消息元素列表，引用消息时 [0] 为被引用的原始消息 */
+    msg_elements?: MsgElement[];
+}
+/**
+ * 按钮交互事件（INTERACTION_CREATE）
+ */
+interface InteractionEvent {
+    /** 事件 ID，用于回应交互（PUT /interactions/{id}） */
+    id: string;
+    /** 事件类型：11=消息按钮 12=单聊快捷菜单 */
+    type: number;
+    /** 场景：c2c / group / guild */
+    scene?: string;
+    /** 场景类型：0=频道 1=群聊 2=单聊 */
+    chat_type?: number;
+    /** 触发时间 RFC3339 */
+    timestamp?: string;
+    /** 频道 openid（仅频道场景） */
+    guild_id?: string;
+    /** 子频道 openid（仅频道场景） */
+    channel_id?: string;
+    /** 单聊用户 openid（仅 c2c 场景） */
+    user_openid?: string;
+    /** 群 openid（仅群聊场景） */
+    group_openid?: string;
+    /** 群内触发用户 openid（仅群聊场景） */
+    group_member_openid?: string;
+    version: number;
+    data: {
+        type: number;
+        resolved: {
+            /** 按钮 action.data 值 */
+            button_data?: string;
+            /** 按钮 id */
+            button_id?: string;
+            /** 操作用户 userid（仅频道场景） */
+            user_id?: string;
+            /** 自定义菜单 id（仅菜单场景） */
+            feature_id?: string;
+            /** 操作的消息 id（仅频道场景） */
+            message_id?: string;
+            /** 配置更新：群消息模式 "mention"=@机器人时激活 "always"=总是激活 */
+            require_mention?: string;
+            /** 配置更新：群消息策略 */
+            group_policy?: GroupPolicy;
+            /** 配置更新：@文本的名称提及BOT名，多个使用,分隔 */
+            mention_patterns?: string;
+        };
+    };
+}
+/**
+ * 按钮 Action 类型
+ * 0=跳转链接  1=回调型(INTERACTION_CREATE)  2=指令型(直接发文本)  3=mqqapi
+ */
+type KeyboardActionType = 0 | 1 | 2 | 3;
+/** 按钮权限 */
+interface KeyboardPermission {
+    /** 0=全体  1=管理员  2=按钮指定  3=身份组 */
+    type: 0 | 1 | 2 | 3;
+    specify_role_ids?: string[];
+    specify_user_ids?: string[];
+}
+/** 二次确认弹窗 */
+interface KeyboardModal {
+    content: string;
+    confirm_text?: string;
+    cancel_text?: string;
+}
+/** 按钮 Action */
+interface KeyboardAction {
+    type: KeyboardActionType;
+    data?: string;
+    /** true = 点击后直接发出（Enter）*/
+    enter?: boolean;
+    /** 仅指令型（type=2）：是否把指令发到输入框（reply=true）还是静默发出 */
+    reply?: boolean;
+    permission?: KeyboardPermission;
+    click_limit?: number;
+    unsupport_tips?: string;
+    modal?: KeyboardModal;
+}
+/** 按钮渲染数据 */
+interface KeyboardRenderData {
+    label: string;
+    visited_label?: string;
+    /** 0=灰色线框  1=蓝色线框  2=推荐回复专用  3=红色字体  4=蓝色背景 */
+    style?: 0 | 1 | 2 | 3 | 4;
+}
+/** 单个按钮 */
+interface KeyboardButton {
+    id: string;
+    render_data?: KeyboardRenderData;
+    action?: KeyboardAction;
+    group_id?: string;
+}
+/** 一行按钮 */
+interface KeyboardRow {
+    buttons: KeyboardButton[];
+}
+/** CustomKeyboard（自定义按钮内容） */
+interface CustomKeyboard {
+    rows: KeyboardRow[];
+}
+/** MessageKeyboard（keyboard / prompt_keyboard.keyboard 共用） */
+interface MessageKeyboard {
+    /** 模板 ID（与 content 二选一） */
+    id?: string;
+    /** 自定义内容 */
+    content?: CustomKeyboard;
+}
+/**
+ * Inline Keyboard（消息内嵌按钮，需平台审核）
+ * 发送字段：keyboard
+ * JSON: { "keyboard": { "id": "...", "content": { "rows": [...] } } }
+ */
+type InlineKeyboard = MessageKeyboard;
+/**
+ * WebSocket 事件负载
+ */
+interface WSPayload {
+    op: number;
+    d?: unknown;
+    s?: number;
+    t?: string;
+}
+/** 流式消息输入模式 */
+declare const StreamInputMode: {
+    /** 每次发送的 content_raw 替换整条消息内容 */
+    readonly REPLACE: "replace";
+};
+type StreamInputMode = (typeof StreamInputMode)[keyof typeof StreamInputMode];
+/** 流式消息输入状态 */
+declare const StreamInputState: {
+    /** 正文生成中 */
+    readonly GENERATING: 1;
+    /** 正文生成结束（终结状态） */
+    readonly DONE: 10;
+};
+type StreamInputState = (typeof StreamInputState)[keyof typeof StreamInputState];
+/** 流式消息内容类型 */
+declare const StreamContentType: {
+    readonly MARKDOWN: "markdown";
+};
+type StreamContentType = (typeof StreamContentType)[keyof typeof StreamContentType];
+/**
+ * 流式消息请求体
+ * 对应 StreamReq proto
+ */
+interface StreamMessageRequest {
+    /** 输入模式 */
+    input_mode: StreamInputMode;
+    /** 输入状态 */
+    input_state: StreamInputState;
+    /** 内容类型 */
+    content_type: StreamContentType;
+    /** markdown 内容 */
+    content_raw: string;
+    /** 事件 ID */
+    event_id: string;
+    /** 原始消息 ID */
+    msg_id: string;
+    /** 流式消息 ID，首次发送后返回，后续分片需携带 */
+    stream_msg_id?: string;
+    /** 递增序号 */
+    msg_seq: number;
+    /** 同一条流式会话内的发送索引，从 0 开始，每次发送前递增；新流式会话重新从 0 开始 */
+    index: number;
+}
+
+/**
+ * QQBot Channel Plugin
+ */
+declare const qqbotPlugin: openclaw_plugin_sdk_channel_core.ChannelPlugin<ResolvedQQBotAccount, unknown, unknown>;
+
+/**
+ * QQBot 插件运行时管理。
+ *
+ * 日志统一由 `utils/plugin-logger.ts` 提供，此处只管理 runtime 实例。
+ */
+
+declare function setQQBotRuntime(next: PluginRuntime): void;
+declare function getQQBotRuntime(): PluginRuntime;
+
+declare function buildUserAgent(suffix?: string): string;
+/**
+ * 获取指定账户的 QQBot SDK 实例。
+ *
+ * @throws 如果该账户的 gateway 尚未启动
+ *
+ * @example
+ * ```ts
+ * const bot = getBotForAccount(accountId);
+ * await bot.send({ target, content: 'hello' });
+ * const guilds = await bot.api.get('/users/@me/guilds');
+ * const token = await bot.api.getToken();
+ * ```
+ */
+declare function getBotForAccount(accountId: string): QQBot;
+/**
+ * 尝试获取指定账户的 QQBot SDK 实例（不抛异常）。
+ * 返回 null 表示 gateway 尚未启动。
+ */
+declare function tryGetBotForAccount(accountId: string): QQBot | null;
+
+/**
+ * PluginLogger — 统一日志接口
+ *
+ * 默认后端为 OpenClaw 框架 logger（`runtime.logging.getChildLogger`），
+ * 运行时不可用时临时降级 console，就绪后自动切换缓存。
+ */
+interface PluginLogger {
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    child(tag: string): PluginLogger;
+}
+
+/**
+ * QQBotGateway — 封装单个 Bot 实例的完整生命周期
+ */
+
+interface GatewayCallbacks {
+    onReady?: () => void;
+    onError?: (error: Error) => void;
+}
+interface SendOptions {
+    msgId?: string;
+    text?: string;
+}
+declare class QQBotGateway {
+    readonly bot: QQBot;
+    private readonly account;
+    private readonly runtime;
+    readonly log: PluginLogger;
+    private readonly textTimeout;
+    private readonly mediaTimeout;
+    constructor(account: ResolvedQQBotAccount, runtime: PluginRuntime, log?: PluginLogger);
+    start(callbacks?: GatewayCallbacks, signal?: AbortSignal): Promise<void>;
+    stop(): Promise<void>;
+    sendText(target: ReplyTarget, text: string, opts?: SendOptions): Promise<MessageResponse>;
+    sendMedia(target: ReplyTarget, source: string, opts?: SendOptions & {
+        fileType?: MediaFileType;
+    }): Promise<MessageResponse>;
+    sendVoice(target: ReplyTarget, source: {
+        url?: string;
+        base64?: string;
+        localPath?: string;
+    }, opts?: SendOptions): Promise<MessageResponse>;
+    sendVideo(target: ReplyTarget, source: string, opts?: SendOptions): Promise<MessageResponse>;
+    sendFile(target: ReplyTarget, source: string, opts?: SendOptions & {
+        fileName?: string;
+    }): Promise<MessageResponse>;
+    openStream(target: ReplyTarget, msgId: string): StreamSession;
+    sendTyping(target: ReplyTarget): Promise<void>;
+    /**
+     * 消息发送成功后通知活跃的 typing 会话补发续期。
+     * QQ 客户端收到机器人消息（含思维链等中间输出）会终止"正在输入"
+     * 显示；若框架任务仍在进行，typing 中间件会在 5s 后补发恢复显示。
+     */
+    private notifyTypingRefresh;
+    private wrapBotSendForRefIndex;
+    /**
+     * 配额感知的 msg_id 挂接（被动优先）。
+     *
+     * - 显式 msgId（opts.msgId）：上游 adapter 已做配额记账（quotaReserved），
+     *   直接透传，不重复消费。
+     * - 无显式 msgId：尝试挂 msgid-cache 最新条目；挂接前经 quota-manager
+     *   原子预检+扣减——配额耗尽则不挂（降级主动，避免平台 40034128 硬失败），
+     *   API 抛错时由调用方 rollback 释放已扣减的额度。
+     */
+    private attachMsgIdWithQuota;
+}
+
+type MediaKind = 'image' | 'voice' | 'video' | 'file';
+interface SendResult {
+    messageId?: string;
+    error?: string;
+    errorCode?: string;
+    qqBizCode?: number;
+}
+declare function sendText(params: {
+    to: string;
+    text: string;
+    accountId?: string;
+    replyToId?: string;
+    account: ResolvedQQBotAccount;
+    quotaReserved?: boolean;
+}): Promise<SendResult>;
+declare function sendMedia(params: {
+    to: string;
+    text?: string;
+    mediaUrl: string;
+    mediaKind?: MediaKind;
+    accountId?: string;
+    replyToId?: string;
+    account: ResolvedQQBotAccount;
+    quotaReserved?: boolean;
+}): Promise<SendResult>;
+
+/**
+ * 出站目标地址解析
+ *
+ * 将 OpenClaw 规范的目标地址字符串（如 qqbot:c2c:xxx / qqbot:group:xxx）
+ * 转换为 SDK 的 ReplyTarget 结构。
+ *
+ * 也导出共享的正则常量供 channel.ts messaging 段复用。
+ */
+
+/**
+ * 解析目标地址字符串为 SDK ReplyTarget
+ *
+ * 注意：此函数总是返回 ReplyTarget，即使输入无效（targetId 可能为空字符串）
+ * 如果需要严格验证，请使用 tryParseTarget
+ */
+declare function parseTarget(to: string): ReplyTarget;
+
+/**
+ * 消息转发 — 入站消息 → OpenClaw AI
+ *
+ * 核心职责：
+ * 1. 从 SDK MiddlewareContext 构建 OpenClaw 标准信封
+ * 2. 通过 runtime-adapter 将消息交给 AI 处理
+ *
+ * 架构说明：
+ * - 所有 runtime.channel.* 访问均通过 runtime-adapter 隔离
+ * - log: 前缀由 PluginLogger + 框架自动注入，消息体不重复 accountId
+ */
+
+/**
+ * 将经过中间件处理的入站消息转发给 OpenClaw AI
+ */
+declare function dispatchToOpenClaw(ctx: MiddlewareContext, msg: QQBotInboundMessage, account: ResolvedQQBotAccount, runtime: PluginRuntime, log?: PluginLogger): Promise<void>;
+
+/**
+ * 持久化 RefIndex 存储
+ *
+ * SDK 提供的 MemoryRefIndexStore 在进程重启后即丢失，
+ * 而 QQ 引用消息（REFIDX_xxx）入站事件只携带 key，必须本地缓存才能回查。
+ *
+ * 设计：
+ *   - 内存 LRU（与 SDK 同款）保证 O(1) 读取
+ *   - JSONL 追加写持久化，进程重启时按时间顺序回放重建 LRU
+ *   - 写入触发 compact 阈值时重写文件（去重 + 截断到 maxEntries）
+ *   - 文件路径: ~/.openclaw/qqbot/data/ref-index.jsonl
+ *
+ * 实现 SDK 的 RefIndexStore 接口，可直接通过 `quoteRef({ store })` 注入。
+ */
+
+interface PersistedRefIndexStoreOptions {
+    /** 内存与磁盘的最大条目数。默认 2000。 */
+    maxEntries?: number;
+    /** 自定义存储文件路径。默认 ~/.openclaw/qqbot/data/ref-index.jsonl */
+    filePath?: string;
+}
+/**
+ * 持久化版本的 RefIndexStore
+ *
+ * - get：仅查内存（启动时从磁盘回放重建）
+ * - set：内存 + JSONL 追加写；磁盘行数过多时触发 compact
+ */
+declare class PersistedRefIndexStore implements RefIndexStore {
+    private readonly memory;
+    private readonly maxEntries;
+    private readonly filePath;
+    /** 当前磁盘累计写入的行数（用于 compact 阈值判断） */
+    private diskLineCount;
+    /** 是否已成功初始化（磁盘回放完成） */
+    private initialized;
+    /** 串行化写入，防止并发 append 撕裂行 */
+    private writeChain;
+    constructor(options?: PersistedRefIndexStoreOptions);
+    /**
+     * 初始化：按时间顺序回放 JSONL 重建内存 LRU
+     */
+    private init;
+    get(key: string): RefEntry | undefined;
+    set(key: string, entry: RefEntry): void;
+    private touchMemory;
+    private appendToDisk;
+    /**
+     * 异步 compact：将内存 LRU 状态完整重写到磁盘，丢弃历史冗余。
+     */
+    private compact;
+    /**
+     * 同步 compact（仅 init 阶段使用，避免回放后立刻保留巨大磁盘文件）
+     */
+    private compactSync;
+    /** 当前内存中的条目数 */
+    get size(): number;
+    /** 是否已完成初始化（磁盘回放） */
+    get isInitialized(): boolean;
+    /** 诊断快照 */
+    stats(): {
+        memoryEntries: number;
+        diskLines: number;
+        maxEntries: number;
+        filePath: string;
+    };
+    /**
+     * 强制将当前内存状态持久化到磁盘（进程退出前调用）
+     */
+    flush(): void;
+}
+/**
+ * 获取按 accountId 隔离的持久化 RefIndexStore 单例。
+ *
+ * 每个账户独立存储文件，避免多账户混用同一个 refIdx 命名空间。
+ */
+declare function getPersistedRefIndexStore(accountId: string): PersistedRefIndexStore;
+/**
+ * 进程退出前 flush 所有 store
+ */
+declare function flushAllRefIndexStores(): void;
+
+/**
+ * QQ Bot 流式消息控制器
+ *
+ * 核心约束：QQ 流式 API 替换模式下，已下发文本的**前缀不可变更**。
+ *
+ * 状态机：
+ *   IDLE → (first chunk) → STREAMING → (complete) → DONE
+ *                                      → (prefix changed) → DONE
+ *                                      → (new reply) → IDLE → …
+ *
+ * onPartialReply(text) 输入：模型全量文本，持续增长。
+ * finalize()           标记：框架通知回复结束，用 lastAccepted 收尾。
+ */
+
+type StreamingPhase = 'idle' | 'streaming' | 'done' | 'failed';
+type StreamingSendMode = 'stream' | 'static';
+interface StreamingControllerDeps {
+    gateway: QQBotGateway;
+    target: ReplyTarget;
+    accountId: string;
+    replyToId: string;
+    log?: PluginLogger;
+    /**
+     * 文本下发通道：
+     *   - 'stream'（默认）QQ 流式打印机：openStream/update/complete
+     *   - 'static'           流结束时用一条普通 sendText 发完整文本
+     * partial 接收逻辑（状态机/串行/去重）在两种模式下完全一致。
+     */
+    sendMode?: StreamingSendMode;
+    /**
+     * static 模式专用：在 finalize 收尾时把累积的完整文本一次性发出。
+     * stream 模式下不使用。未提供时 static 模式将降级为 shouldFallbackToStatic。
+     */
+    sendStatic?: (fullText: string) => Promise<void>;
+}
+declare class StreamingController {
+    private readonly deps;
+    private phase;
+    private session;
+    /** QQ 已接受的最新文本 — 单源真理 */
+    private lastAcceptedFull;
+    /** 已成功发送的分片数（降级：=0 则走静态消息兜底） */
+    private sentChunkCount;
+    /** 同步标志：收到第一个 onPartialReply 即置 true（不等 async 完成） */
+    private _hasStarted;
+    /** 串行队列 */
+    private chain;
+    constructor(deps: StreamingControllerDeps);
+    /** 是否走静态（普通 sendText）下发通道 */
+    private get isStaticMode();
+    /**
+     * 是否处于 static 下发模式（公开访问器，供 dispatch 协同判断）。
+     * static 模式下 dispatch 不应在 tool/final 事件提前 finalize，
+     * 由 controller 靠 new_reply 检测自主分段，避免终态与发送延迟。
+     */
+    get isStaticSendMode(): boolean;
+    get currentPhase(): StreamingPhase;
+    /** 是否已成功发送至少一个流式分片 */
+    get hasSentChunks(): boolean;
+    /** 同步标志：流式已启动（不等异步完成），用于 final 去重 */
+    get hasStarted(): boolean;
+    get isTerminal(): boolean;
+    get shouldFallbackToStatic(): boolean;
+    onPartialReply(text: string): Promise<void>;
+    finalize(): Promise<void>;
+    /**
+     * static 模式：把当前累积段立即发出并重置缓冲，**不进入终态**。
+     * 供框架 onAssistantMessageStart 回调调用（工具调用后新一段推理开始时触发）。
+     * 对齐 telegram rotateLaneForNewMessage：固化旧段 + 开始新段。
+     * 无累积内容时跳过（第一段开始时 lastAcceptedFull 为空）。
+     */
+    flushSegment(): Promise<void>;
+    abort(reason?: string): Promise<void>;
+    private handleChunk;
+    private handleFinalize;
+    private sendUpdate;
+    private completeSession;
+    private transition;
+}
+
+declare function shouldUseStreaming(account: ResolvedQQBotAccount, targetScope: 'c2c' | 'group' | 'channel'): boolean;
+
+/**
+ * 解析 mentionPatterns（agent → global → 空数组）
+ *
+ * 优先级：
+ *   1. agents.list[agentId].groupChat.mentionPatterns
+ *   2. messages.groupChat.mentionPatterns
+ *   3. []
+ */
+declare function resolveMentionPatterns(cfg: OpenClawConfig, agentId?: string): string[];
+declare const DEFAULT_ACCOUNT_ID = "default";
+/** 解析群消息策略 */
+declare function resolveGroupPolicy(cfg: OpenClawConfig, accountId?: string): GroupPolicy$1;
+/** 解析群白名单（统一转大写） */
+declare function resolveGroupAllowFrom(cfg: OpenClawConfig, accountId?: string): string[];
+/** 检查指定群是否被允许（使用标准策略引擎） */
+declare function isGroupAllowed(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): boolean;
+type ResolvedGroupConfig = Omit<Required<GroupConfig>, "prompt" | "coalesce" | "historyMode" | "unmentionedInbound"> & {
+    prompt: string;
+    coalesce: Required<GroupCoalesceConfig>;
+    historyMode: 'clear' | 'rolling';
+    unmentionedInbound: 'user_request' | 'room_event';
+};
+declare function resolveGroupConfigFromAccount(account: ResolvedQQBotAccount, groupOpenid: string): ResolvedGroupConfig;
+declare function resolveGroupConfig(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): ResolvedGroupConfig;
+/** 解析群历史消息缓存条数 */
+declare function resolveHistoryLimit(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): number;
+/** 解析群行为 PE（具体群 > "*" > 默认值） */
+declare function resolveGroupPrompt(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): string;
+/** 解析群是否需要 @机器人才响应 */
+declare function resolveRequireMention(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): boolean;
+/** 解析群是否忽略 @了其他人（非 bot）的消息 */
+declare function resolveIgnoreOtherMentions(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): boolean;
+/** 解析群工具策略 */
+declare function resolveToolPolicy(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): ToolPolicy;
+/** 解析群名称（优先配置，fallback 为 openid 前 8 位） */
+declare function resolveGroupName(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): string;
+/**
+ * 解析 User-Agent 追加后缀（仅通道级：channels.qqbot.userAgentSuffix）
+ */
+declare function resolveUserAgentSuffix(cfg: OpenClawConfig): string;
+/** 文档变量名优先，同时兼容旧的下划线变量名。 */
+declare function resolveQQBotEnvAppId(): string;
+declare function resolveQQBotEnvClientSecret(): string;
+/**
+ * 列出所有 QQBot 账户 ID
+ */
+declare function listQQBotAccountIds(cfg: OpenClawConfig): string[];
+/**
+ * 获取默认账户 ID
+ */
+declare function resolveDefaultQQBotAccountId(cfg: OpenClawConfig): string;
+/**
+ * 解析 QQBot 账户配置
+ */
+declare function resolveQQBotAccount(cfg: OpenClawConfig, accountId?: string | null): ResolvedQQBotAccount;
+/**
+ * 应用账户配置
+ */
+declare function applyQQBotAccountConfig(cfg: OpenClawConfig, accountId: string, input: {
+    appId?: string;
+    clientSecret?: string;
+    clientSecretFile?: string;
+    name?: string;
+}): OpenClawConfig;
+/** 解析群消息合并配置 */
+declare function resolveGroupCoalesceConfig(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): Required<GroupCoalesceConfig>;
+/** 解析群消息合并是否启用 */
+declare function resolveGroupCoalesceEnabled(cfg: OpenClawConfig, groupOpenid: string, accountId?: string): boolean;
+
+/**
+ * QQBot Outbound 适配器
+ *
+ * 封装 sendText/sendMedia 流式等出站操作，提供配额感知的发送能力。
+ *
+ * 两层结构：
+ * - createQQBotOutboundAdapter —— 内部配额包装（sendTextWithQuota / sendMediaWithQuota），
+ *   供中间件/流式路径使用；
+ * - createQQBotChannelOutbound —— 框架 ChannelOutboundAdapter 契约入口
+ *   （sendText / sendMedia / chunker / sanitizeText 等）。
+ *   openclaw 的 channel-selection 通过 outbound.sendText（或 message.send.text /
+ *   deliveryMode === "gateway"）判定通道可用，缺失会导致
+ *   "Channel is unavailable: qqbot"。
+ */
+
+/** 框架 sendText / sendMedia 上下文（openclaw ChannelOutboundContext 子集） */
+interface ChannelOutboundSendContext {
+    to: string;
+    text?: string;
+    mediaUrl?: string;
+    accountId?: string | null;
+    replyToId?: string | null;
+    cfg: OpenClawConfig;
+}
+interface ChannelOutboundDeliveryResult {
+    channel: 'qqbot';
+    messageId: string;
+}
+declare const qqbotChannelOutbound: {
+    deliveryMode: "direct";
+    sendText: (ctx: ChannelOutboundSendContext) => Promise<ChannelOutboundDeliveryResult>;
+    sendMedia: (ctx: ChannelOutboundSendContext) => Promise<ChannelOutboundDeliveryResult>;
+    sanitizeText: ({ text }: {
+        text: string;
+    }) => string;
+    chunker: (text: string, limit: number) => string[];
+    chunkerMode: "markdown";
+    textChunkLimit: number;
+    shouldSuppressLocalPayloadPrompt: ({ payload }: {
+        payload: unknown;
+    }) => boolean;
+    sendTextWithQuota: (params: {
+        to: string;
+        text: string;
+        accountId?: string;
+        replyToId?: string;
+        account: ResolvedQQBotAccount;
+        log?: PluginLogger;
+    }) => Promise<{
+        messageId?: string;
+        error?: string;
+    }>;
+    sendMediaWithQuota: (params: {
+        to: string;
+        source: string;
+        text?: string;
+        accountId?: string;
+        replyToId?: string;
+        account: ResolvedQQBotAccount;
+        agentId?: string;
+        log?: PluginLogger;
+    }) => Promise<{
+        messageId?: string;
+        error?: string;
+    }>;
+    canSendTyping: (params: {
+        to: string;
+        accountId: string;
+        replyToId: string;
+        log?: PluginLogger;
+    }) => Promise<boolean>;
+    shouldTreatDeliveredTextAsVisible: (params: {
+        kind: string;
+        text?: string;
+    }) => boolean;
+    preferFinalAssistantVisibleText: boolean;
+};
+
+/**
+ * 被动回复限额管理
+ *
+ * QQ Bot 被动回复有限额（同一条消息最多回复 N 次，超时后不能再被动回复）。
+ * 当限额耗尽或消息过期时，标记应降级为主动消息（proactive）。
+ */
+interface ReplyLimiterConfig {
+    /** 每条消息最大被动回复次数（默认 4） */
+    limit?: number;
+    /** 消息 ID 过期时间 ms（默认 1 小时） */
+    ttlMs?: number;
+    /** 最大跟踪消息数（LRU 驱逐，默认 10000） */
+    maxTrackedMessages?: number;
+}
+interface ReplyLimitResult {
+    allowed: boolean;
+    remaining: number;
+    shouldFallbackToProactive: boolean;
+    fallbackReason?: 'expired' | 'limit_exceeded';
+}
+/**
+ * 被动回复限额管理器
+ *
+ * @example
+ * ```ts
+ * const limiter = new ReplyLimiter({ limit: 4, ttlMs: 3600_000 });
+ * const result = limiter.checkLimit(messageId);
+ * if (!result.allowed) {
+ *   // 降级为主动消息
+ * } else {
+ *   limiter.record(messageId);
+ *   // 正常被动回复
+ * }
+ * ```
+ */
+declare class ReplyLimiter {
+    private readonly limit;
+    private readonly ttlMs;
+    private readonly maxTracked;
+    private readonly messages;
+    constructor(config?: ReplyLimiterConfig);
+    /**
+     * 检查是否允许对指定消息继续被动回复
+     */
+    checkLimit(messageId: string): ReplyLimitResult;
+    /**
+     * 记录一次被动回复
+     */
+    record(messageId: string): void;
+    /**
+     * 尝试占用一个被动回复配额（检查 + 记录原子完成）。
+     * 用于 typing 等非回复用途：占用失败时调用方应降级为主动发送（不带 msg_id）。
+     */
+    tryAcquire(messageId: string): boolean;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        trackedMessages: number;
+        totalReplies: number;
+    };
+    /**
+     * 清除所有跟踪数据
+     */
+    clear(): void;
+}
+
+/**
+ * 配额管理参数
+ */
+interface QuotaCheckParams {
+    accountId: string;
+    msgId?: string;
+    scope: 'c2c' | 'group';
+}
+
+/**
+ * QQBot 被动回复配额管理
+ *
+ * C2C: 4 次/msg_id, 60 分钟
+ * Group: 5 次/msg_id, 5 分钟
+ *
+ * 重要说明：
+ * - QQ Bot 平台的 msg_id 有时效性限制（C2C: 60分钟，Group: 5分钟）
+ * - 过期后的 msg_id 不能再用于被动回复（API 会返回错误 40034128）
+ * - 这是平台限制，不是"配额恢复"
+ * - 因此 checkPassiveReplyQuota 在 msg_id 过期时返回 false，而非重置配额
+ *
+ * 使用方式：
+ * 1. 推荐：使用 checkAndConsumePassiveReplyQuota 进行原子操作（失败用 rollback 回滚）
+ * 2. 纯探测（不消耗配额）：checkPassiveReplyQuota
+ */
+
+/**
+ * 检查被动回复配额（纯探测，不消耗配额）。
+ * 需要同时消耗配额时使用 checkAndConsumePassiveReplyQuota。
+ */
+declare function checkPassiveReplyQuota(params: QuotaCheckParams): boolean;
+declare function inferQQBotScope(to: string): 'c2c' | 'group';
+declare function clearQuotaCache(): void;
+declare function getQuotaStats(accountId: string, scope: 'c2c' | 'group'): {
+    activeSessions: number;
+    totalUsage: number;
+};
+
+/**
+ * C2C "正在输入"指示器中间件（替代 SDK 的 typingIndicator）。
+ *
+ * 与 SDK 版的三点差异：
+ * 1. 续期间隔默认 20s 且强制不低于 20s（QPS 约束，事件触发的续期
+ *    同样受此间距保护）
+ * 2. 配额感知：typing 通知携带入站 msg_id 时属于被动回复、消耗该
+ *    msg_id 的被动配额，与真正的回复消息共享额度（经同一 limiter
+ *    记账）。被动配额耗尽后与回复消息一样自动降级为主动发送
+ *    （不带 msg_id），续期不会中断
+ * 3. 出站消息后续期：QQ 客户端收到机器人消息（如思维链中间输出）
+ *    会自动终止"正在输入"显示。若框架任务仍在进行，本中间件在
+ *    每条消息发出 POST_MESSAGE_REFRESH_DELAY_MS 后补发一次续期；
+ *    若该消息是最终回复（处理链完成），会话已结束，自然不再续期
+ *
+ * QQ 客户端行为：退出聊天界面再进入后指示器会消失，只有收到新的
+ * input_notify 推送才会重新显示 —— 这是需要周期性续期的原因。
+ */
+
+/** QPS 约束：续期间隔不得低于 20s */
+declare const MIN_TYPING_INTERVAL_MS = 20000;
+/** 出站消息后延迟多久补发续期 */
+declare const POST_MESSAGE_REFRESH_DELAY_MS = 5000;
+declare function resolveTypingIntervalMs(input: number | undefined): number;
+interface TypingIndicatorMiddlewareOptions {
+    accountId: string;
+    /** 续期间隔 ms，默认 20_000，低于 20_000 会被钳制到 20_000 */
+    intervalMs?: number;
+}
+declare function c2cTypingIndicator(opts: TypingIndicatorMiddlewareOptions): Middleware;
+
+/**
+ * 出站消息 → typing 续期信号
+ *
+ * QQ 客户端收到机器人消息后会自动终止"正在输入"显示。若框架任务
+ * 仍在进行（如思维链等中间消息），typing 中间件需要在消息发出后
+ * 延迟数秒补发一次续期，恢复指示器显示。
+ *
+ * 本模块提供进程内信号：出站层（QQBotGateway）在消息发送成功后
+ * notify，活跃的 typing 会话按 accountId + scope + targetId 订阅。
+ * 任务已完成的会话已取消订阅，notify 自然不产生任何效果。
+ */
+type Listener = () => void;
+/**
+ * 订阅指定会话的出站消息信号。
+ * @returns 取消订阅函数
+ */
+declare function subscribeOutboundMessage(accountId: string, scope: string, targetId: string, listener: Listener): () => void;
+/**
+ * 消息发送成功后由出站层调用：通知该会话活跃的 typing 会话补发续期。
+ */
+declare function notifyOutboundMessageSent(accountId: string, scope: string, targetId: string): void;
+
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: openclaw_plugin_sdk_core.OpenClawPluginConfigSchema;
+    register(api: OpenClawPluginApi): void;
+};
+
+export { type AudioFormatPolicy, type C2CMessageEvent, type CommandsConfig, type CustomKeyboard, DEFAULT_ACCOUNT_ID, type DeliverDebounceConfig, type GroupCoalesceConfig, type GroupConfig, type GroupMessageEvent, type GroupPolicy, type GuildMessageEvent, type InlineKeyboard, type InteractionEvent, type KeyboardAction, type KeyboardActionType, type KeyboardButton, type KeyboardModal, type KeyboardPermission, type KeyboardRenderData, type KeyboardRow, MIN_TYPING_INTERVAL_MS, MSG_TYPE_QUOTE, MSG_TYPE_TEXT, type MessageAttachment, type MessageKeyboard, type MsgElement, POST_MESSAGE_REFRESH_DELAY_MS, PersistedRefIndexStore, type QQBotAccountConfig, type QQBotConfig, QQBotGateway, type RateLimitConfig, type RateLimitTierConfig, ReplyLimiter, type ResolvedGroupConfig, type ResolvedQQBotAccount, type STTChannelConfig, StreamContentType, StreamInputMode, StreamInputState, type StreamMessageRequest, StreamingController, type ToolPolicy, type TransportMode, type TypingIndicatorConfig, type WSPayload, type WebhookTransportConfig, applyQQBotAccountConfig, buildUserAgent, c2cTypingIndicator, checkPassiveReplyQuota, clearQuotaCache, plugin as default, dispatchToOpenClaw, flushAllRefIndexStores, getBotForAccount, getPersistedRefIndexStore, getQQBotRuntime, getQuotaStats, inferQQBotScope, isGroupAllowed, listQQBotAccountIds, notifyOutboundMessageSent, parseTarget, qqbotChannelOutbound, qqbotPlugin, resolveDefaultQQBotAccountId, resolveGroupAllowFrom, resolveGroupCoalesceConfig, resolveGroupCoalesceEnabled, resolveGroupConfig, resolveGroupConfigFromAccount, resolveGroupName, resolveGroupPolicy, resolveGroupPrompt, resolveHistoryLimit, resolveIgnoreOtherMentions, resolveMentionPatterns, resolveQQBotAccount, resolveQQBotEnvAppId, resolveQQBotEnvClientSecret, resolveRequireMention, resolveToolPolicy, resolveTypingIntervalMs, resolveUserAgentSuffix, sendMedia, sendText, setQQBotRuntime, shouldUseStreaming, subscribeOutboundMessage, tryGetBotForAccount };