@openclaw-china/qqbot 2026.3.9 → 2026.3.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,5 +1,7 @@
1
1
  import { z } from 'zod';
2
2
 
3
+ declare const QQBotC2CMarkdownDeliveryModeSchema: z.ZodDefault<z.ZodOptional<z.ZodEnum<["passive", "proactive-table-only", "proactive-all"]>>>;
4
+ type QQBotC2CMarkdownDeliveryMode = z.input<typeof QQBotC2CMarkdownDeliveryModeSchema>;
3
5
  declare const QQBotAccountSchema: z.ZodObject<{
4
6
  name: z.ZodOptional<z.ZodString>;
5
7
  enabled: z.ZodOptional<z.ZodBoolean>;
@@ -22,6 +24,7 @@ declare const QQBotAccountSchema: z.ZodObject<{
22
24
  secretKey?: unknown;
23
25
  }>>;
24
26
  markdownSupport: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
27
+ c2cMarkdownDeliveryMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["passive", "proactive-table-only", "proactive-all"]>>>;
25
28
  dmPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "pairing", "allowlist"]>>>;
26
29
  groupPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "allowlist", "disabled"]>>>;
27
30
  requireMention: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -33,6 +36,7 @@ declare const QQBotAccountSchema: z.ZodObject<{
33
36
  longTaskNoticeDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
34
37
  maxFileSizeMB: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
35
38
  mediaTimeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
39
+ autoSendLocalPathMedia: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
36
40
  inboundMedia: z.ZodOptional<z.ZodObject<{
37
41
  dir: z.ZodOptional<z.ZodString>;
38
42
  keepDays: z.ZodOptional<z.ZodNumber>;
@@ -45,6 +49,7 @@ declare const QQBotAccountSchema: z.ZodObject<{
45
49
  }>>;
46
50
  }, "strip", z.ZodTypeAny, {
47
51
  markdownSupport: boolean;
52
+ c2cMarkdownDeliveryMode: "passive" | "proactive-table-only" | "proactive-all";
48
53
  dmPolicy: "open" | "pairing" | "allowlist";
49
54
  groupPolicy: "open" | "allowlist" | "disabled";
50
55
  requireMention: boolean;
@@ -54,6 +59,7 @@ declare const QQBotAccountSchema: z.ZodObject<{
54
59
  longTaskNoticeDelayMs: number;
55
60
  maxFileSizeMB: number;
56
61
  mediaTimeoutMs: number;
62
+ autoSendLocalPathMedia: boolean;
57
63
  name?: string | undefined;
58
64
  enabled?: boolean | undefined;
59
65
  appId?: string | undefined;
@@ -82,6 +88,7 @@ declare const QQBotAccountSchema: z.ZodObject<{
82
88
  secretKey?: unknown;
83
89
  } | undefined;
84
90
  markdownSupport?: boolean | undefined;
91
+ c2cMarkdownDeliveryMode?: "passive" | "proactive-table-only" | "proactive-all" | undefined;
85
92
  dmPolicy?: "open" | "pairing" | "allowlist" | undefined;
86
93
  groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
87
94
  requireMention?: boolean | undefined;
@@ -93,6 +100,7 @@ declare const QQBotAccountSchema: z.ZodObject<{
93
100
  longTaskNoticeDelayMs?: number | undefined;
94
101
  maxFileSizeMB?: number | undefined;
95
102
  mediaTimeoutMs?: number | undefined;
103
+ autoSendLocalPathMedia?: boolean | undefined;
96
104
  inboundMedia?: {
97
105
  dir?: string | undefined;
98
106
  keepDays?: number | undefined;
@@ -120,6 +128,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
120
128
  secretKey?: unknown;
121
129
  }>>;
122
130
  markdownSupport: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
131
+ c2cMarkdownDeliveryMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["passive", "proactive-table-only", "proactive-all"]>>>;
123
132
  dmPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "pairing", "allowlist"]>>>;
124
133
  groupPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "allowlist", "disabled"]>>>;
125
134
  requireMention: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -131,6 +140,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
131
140
  longTaskNoticeDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
132
141
  maxFileSizeMB: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
133
142
  mediaTimeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
143
+ autoSendLocalPathMedia: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
134
144
  inboundMedia: z.ZodOptional<z.ZodObject<{
135
145
  dir: z.ZodOptional<z.ZodString>;
136
146
  keepDays: z.ZodOptional<z.ZodNumber>;
@@ -165,6 +175,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
165
175
  secretKey?: unknown;
166
176
  }>>;
167
177
  markdownSupport: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
178
+ c2cMarkdownDeliveryMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["passive", "proactive-table-only", "proactive-all"]>>>;
168
179
  dmPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "pairing", "allowlist"]>>>;
169
180
  groupPolicy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["open", "allowlist", "disabled"]>>>;
170
181
  requireMention: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -176,6 +187,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
176
187
  longTaskNoticeDelayMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
177
188
  maxFileSizeMB: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
178
189
  mediaTimeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
190
+ autoSendLocalPathMedia: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
179
191
  inboundMedia: z.ZodOptional<z.ZodObject<{
180
192
  dir: z.ZodOptional<z.ZodString>;
181
193
  keepDays: z.ZodOptional<z.ZodNumber>;
@@ -188,6 +200,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
188
200
  }>>;
189
201
  }, "strip", z.ZodTypeAny, {
190
202
  markdownSupport: boolean;
203
+ c2cMarkdownDeliveryMode: "passive" | "proactive-table-only" | "proactive-all";
191
204
  dmPolicy: "open" | "pairing" | "allowlist";
192
205
  groupPolicy: "open" | "allowlist" | "disabled";
193
206
  requireMention: boolean;
@@ -197,6 +210,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
197
210
  longTaskNoticeDelayMs: number;
198
211
  maxFileSizeMB: number;
199
212
  mediaTimeoutMs: number;
213
+ autoSendLocalPathMedia: boolean;
200
214
  name?: string | undefined;
201
215
  enabled?: boolean | undefined;
202
216
  appId?: string | undefined;
@@ -225,6 +239,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
225
239
  secretKey?: unknown;
226
240
  } | undefined;
227
241
  markdownSupport?: boolean | undefined;
242
+ c2cMarkdownDeliveryMode?: "passive" | "proactive-table-only" | "proactive-all" | undefined;
228
243
  dmPolicy?: "open" | "pairing" | "allowlist" | undefined;
229
244
  groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
230
245
  requireMention?: boolean | undefined;
@@ -236,6 +251,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
236
251
  longTaskNoticeDelayMs?: number | undefined;
237
252
  maxFileSizeMB?: number | undefined;
238
253
  mediaTimeoutMs?: number | undefined;
254
+ autoSendLocalPathMedia?: boolean | undefined;
239
255
  inboundMedia?: {
240
256
  dir?: string | undefined;
241
257
  keepDays?: number | undefined;
@@ -243,6 +259,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
243
259
  }>>>;
244
260
  }, "strip", z.ZodTypeAny, {
245
261
  markdownSupport: boolean;
262
+ c2cMarkdownDeliveryMode: "passive" | "proactive-table-only" | "proactive-all";
246
263
  dmPolicy: "open" | "pairing" | "allowlist";
247
264
  groupPolicy: "open" | "allowlist" | "disabled";
248
265
  requireMention: boolean;
@@ -252,6 +269,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
252
269
  longTaskNoticeDelayMs: number;
253
270
  maxFileSizeMB: number;
254
271
  mediaTimeoutMs: number;
272
+ autoSendLocalPathMedia: boolean;
255
273
  name?: string | undefined;
256
274
  enabled?: boolean | undefined;
257
275
  appId?: string | undefined;
@@ -271,6 +289,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
271
289
  defaultAccount?: string | undefined;
272
290
  accounts?: Record<string, {
273
291
  markdownSupport: boolean;
292
+ c2cMarkdownDeliveryMode: "passive" | "proactive-table-only" | "proactive-all";
274
293
  dmPolicy: "open" | "pairing" | "allowlist";
275
294
  groupPolicy: "open" | "allowlist" | "disabled";
276
295
  requireMention: boolean;
@@ -280,6 +299,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
280
299
  longTaskNoticeDelayMs: number;
281
300
  maxFileSizeMB: number;
282
301
  mediaTimeoutMs: number;
302
+ autoSendLocalPathMedia: boolean;
283
303
  name?: string | undefined;
284
304
  enabled?: boolean | undefined;
285
305
  appId?: string | undefined;
@@ -309,6 +329,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
309
329
  secretKey?: unknown;
310
330
  } | undefined;
311
331
  markdownSupport?: boolean | undefined;
332
+ c2cMarkdownDeliveryMode?: "passive" | "proactive-table-only" | "proactive-all" | undefined;
312
333
  dmPolicy?: "open" | "pairing" | "allowlist" | undefined;
313
334
  groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
314
335
  requireMention?: boolean | undefined;
@@ -320,6 +341,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
320
341
  longTaskNoticeDelayMs?: number | undefined;
321
342
  maxFileSizeMB?: number | undefined;
322
343
  mediaTimeoutMs?: number | undefined;
344
+ autoSendLocalPathMedia?: boolean | undefined;
323
345
  inboundMedia?: {
324
346
  dir?: string | undefined;
325
347
  keepDays?: number | undefined;
@@ -337,6 +359,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
337
359
  secretKey?: unknown;
338
360
  } | undefined;
339
361
  markdownSupport?: boolean | undefined;
362
+ c2cMarkdownDeliveryMode?: "passive" | "proactive-table-only" | "proactive-all" | undefined;
340
363
  dmPolicy?: "open" | "pairing" | "allowlist" | undefined;
341
364
  groupPolicy?: "open" | "allowlist" | "disabled" | undefined;
342
365
  requireMention?: boolean | undefined;
@@ -348,6 +371,7 @@ declare const QQBotConfigSchema: z.ZodObject<{
348
371
  longTaskNoticeDelayMs?: number | undefined;
349
372
  maxFileSizeMB?: number | undefined;
350
373
  mediaTimeoutMs?: number | undefined;
374
+ autoSendLocalPathMedia?: boolean | undefined;
351
375
  inboundMedia?: {
352
376
  dir?: string | undefined;
353
377
  keepDays?: number | undefined;
@@ -369,6 +393,7 @@ interface ResolvedQQBotAccount {
369
393
  configured: boolean;
370
394
  appId?: string;
371
395
  markdownSupport?: boolean;
396
+ c2cMarkdownDeliveryMode?: QQBotC2CMarkdownDeliveryMode;
372
397
  }
373
398
  interface QQBotSendResult {
374
399
  channel: "qqbot";
@@ -376,6 +401,29 @@ interface QQBotSendResult {
376
401
  timestamp?: number | string;
377
402
  error?: string;
378
403
  }
404
+ type QQChatType = "direct" | "group" | "channel";
405
+
406
+ interface WizardPrompter {
407
+ note: (message: string, title?: string) => Promise<void>;
408
+ text: (opts: {
409
+ message: string;
410
+ placeholder?: string;
411
+ initialValue?: string;
412
+ validate?: (value: string | undefined) => string | undefined;
413
+ }) => Promise<string | symbol>;
414
+ confirm: (opts: {
415
+ message: string;
416
+ initialValue?: boolean;
417
+ }) => Promise<boolean>;
418
+ select: <T>(opts: {
419
+ message: string;
420
+ options: Array<{
421
+ value: T;
422
+ label: string;
423
+ }>;
424
+ initialValue?: T;
425
+ }) => Promise<T | symbol>;
426
+ }
379
427
 
380
428
  declare const qqbotPlugin: {
381
429
  id: string;
@@ -398,6 +446,7 @@ declare const qqbotPlugin: {
398
446
  reply: boolean;
399
447
  polls: boolean;
400
448
  blockStreaming: boolean;
449
+ activeSend: boolean;
401
450
  };
402
451
  messaging: {
403
452
  normalizeTarget: (raw: string) => string | undefined;
@@ -452,6 +501,10 @@ declare const qqbotPlugin: {
452
501
  markdownSupport: {
453
502
  type: string;
454
503
  };
504
+ c2cMarkdownDeliveryMode: {
505
+ type: string;
506
+ enum: string[];
507
+ };
455
508
  dmPolicy: {
456
509
  type: string;
457
510
  enum: string[];
@@ -496,6 +549,9 @@ declare const qqbotPlugin: {
496
549
  mediaTimeoutMs: {
497
550
  type: string;
498
551
  };
552
+ autoSendLocalPathMedia: {
553
+ type: string;
554
+ };
499
555
  inboundMedia: {
500
556
  type: string;
501
557
  additionalProperties: boolean;
@@ -548,6 +604,10 @@ declare const qqbotPlugin: {
548
604
  markdownSupport: {
549
605
  type: string;
550
606
  };
607
+ c2cMarkdownDeliveryMode: {
608
+ type: string;
609
+ enum: string[];
610
+ };
551
611
  dmPolicy: {
552
612
  type: string;
553
613
  enum: string[];
@@ -592,6 +652,9 @@ declare const qqbotPlugin: {
592
652
  mediaTimeoutMs: {
593
653
  type: string;
594
654
  };
655
+ autoSendLocalPathMedia: {
656
+ type: string;
657
+ };
595
658
  inboundMedia: {
596
659
  type: string;
597
660
  additionalProperties: boolean;
@@ -614,6 +677,28 @@ declare const qqbotPlugin: {
614
677
  reload: {
615
678
  configPrefixes: string[];
616
679
  };
680
+ onboarding: {
681
+ channel: "qqbot";
682
+ getStatus: (params: {
683
+ cfg: PluginConfig;
684
+ }) => Promise<{
685
+ channel: "qqbot";
686
+ configured: boolean;
687
+ statusLines: string[];
688
+ selectionHint: string;
689
+ quickstartScore: number;
690
+ }>;
691
+ configure: (params: {
692
+ cfg: PluginConfig;
693
+ prompter: WizardPrompter;
694
+ shouldPromptAccountIds?: boolean;
695
+ accountOverrides?: Record<string, string>;
696
+ }) => Promise<{
697
+ cfg: PluginConfig;
698
+ accountId: string;
699
+ }>;
700
+ disable: (cfg: PluginConfig) => PluginConfig;
701
+ };
617
702
  config: {
618
703
  listAccountIds: (cfg: PluginConfig) => string[];
619
704
  resolveAccount: (cfg: PluginConfig, accountId?: string) => ResolvedQQBotAccount;
@@ -836,6 +921,48 @@ interface PluginRuntime {
836
921
  declare function setQQBotRuntime(next: PluginRuntime): void;
837
922
  declare function getQQBotRuntime(): PluginRuntime;
838
923
 
924
+ type KnownQQBotTargetKind = "user" | "group" | "channel";
925
+ type KnownQQBotTargetStoreOptions = {
926
+ filePath?: string;
927
+ };
928
+ interface KnownQQBotTarget {
929
+ accountId: string;
930
+ kind: KnownQQBotTargetKind;
931
+ target: string;
932
+ displayName?: string;
933
+ sourceChatType: QQChatType;
934
+ firstSeenAt: number;
935
+ lastSeenAt: number;
936
+ }
937
+ interface ListKnownQQBotTargetsParams extends KnownQQBotTargetStoreOptions {
938
+ accountId?: string;
939
+ kind?: KnownQQBotTargetKind;
940
+ limit?: number;
941
+ }
942
+ interface GetKnownQQBotTargetParams extends KnownQQBotTargetStoreOptions {
943
+ accountId?: string;
944
+ target: string;
945
+ }
946
+ interface RemoveKnownQQBotTargetParams extends KnownQQBotTargetStoreOptions {
947
+ accountId?: string;
948
+ target: string;
949
+ }
950
+ interface ClearKnownQQBotTargetsParams extends KnownQQBotTargetStoreOptions {
951
+ accountId?: string;
952
+ kind?: KnownQQBotTargetKind;
953
+ }
954
+ declare function listKnownQQBotTargets(params?: ListKnownQQBotTargetsParams): KnownQQBotTarget[];
955
+ declare function getKnownQQBotTarget(params: GetKnownQQBotTargetParams): KnownQQBotTarget | undefined;
956
+ declare function removeKnownQQBotTarget(params: RemoveKnownQQBotTargetParams): boolean;
957
+ declare function clearKnownQQBotTargets(params?: ClearKnownQQBotTargetsParams): number;
958
+ declare function sendProactiveQQBotMessage(params: {
959
+ cfg: PluginConfig;
960
+ to: string;
961
+ text?: string;
962
+ mediaUrl?: string;
963
+ accountId?: string;
964
+ }): Promise<QQBotSendResult>;
965
+
839
966
  /**
840
967
  * @openclaw-china/qqbot
841
968
  * QQ Bot 渠道插件入口
@@ -892,6 +1019,10 @@ declare const plugin: {
892
1019
  markdownSupport: {
893
1020
  type: string;
894
1021
  };
1022
+ c2cMarkdownDeliveryMode: {
1023
+ type: string;
1024
+ enum: string[];
1025
+ };
895
1026
  dmPolicy: {
896
1027
  type: string;
897
1028
  enum: string[];
@@ -936,6 +1067,9 @@ declare const plugin: {
936
1067
  mediaTimeoutMs: {
937
1068
  type: string;
938
1069
  };
1070
+ autoSendLocalPathMedia: {
1071
+ type: string;
1072
+ };
939
1073
  inboundMedia: {
940
1074
  type: string;
941
1075
  additionalProperties: boolean;
@@ -988,6 +1122,10 @@ declare const plugin: {
988
1122
  markdownSupport: {
989
1123
  type: string;
990
1124
  };
1125
+ c2cMarkdownDeliveryMode: {
1126
+ type: string;
1127
+ enum: string[];
1128
+ };
991
1129
  dmPolicy: {
992
1130
  type: string;
993
1131
  enum: string[];
@@ -1032,6 +1170,9 @@ declare const plugin: {
1032
1170
  mediaTimeoutMs: {
1033
1171
  type: string;
1034
1172
  };
1173
+ autoSendLocalPathMedia: {
1174
+ type: string;
1175
+ };
1035
1176
  inboundMedia: {
1036
1177
  type: string;
1037
1178
  additionalProperties: boolean;
@@ -1053,4 +1194,4 @@ declare const plugin: {
1053
1194
  register(api: MoltbotPluginApi): void;
1054
1195
  };
1055
1196
 
1056
- export { DEFAULT_ACCOUNT_ID, type MoltbotPluginApi, type QQBotAccountConfig, type QQBotConfig, type QQBotSendResult, type ResolvedQQBotAccount, plugin as default, getQQBotRuntime, qqbotPlugin, setQQBotRuntime };
1197
+ export { DEFAULT_ACCOUNT_ID, type KnownQQBotTarget, type MoltbotPluginApi, type QQBotAccountConfig, type QQBotConfig, type QQBotSendResult, type ResolvedQQBotAccount, clearKnownQQBotTargets, plugin as default, getKnownQQBotTarget, getQQBotRuntime, listKnownQQBotTargets, qqbotPlugin, removeKnownQQBotTarget, sendProactiveQQBotMessage, setQQBotRuntime };