@insta-dev01/intclaw 1.0.11 → 1.1.1

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.
Files changed (49) hide show
  1. package/LICENSE +1 -1
  2. package/README.en.md +424 -0
  3. package/README.md +365 -164
  4. package/index.ts +28 -0
  5. package/openclaw.plugin.json +10 -39
  6. package/package.json +69 -40
  7. package/src/channel.ts +557 -0
  8. package/src/config/accounts.ts +230 -0
  9. package/src/config/schema.ts +144 -0
  10. package/src/core/connection.ts +733 -0
  11. package/src/core/message-handler.ts +1268 -0
  12. package/src/core/provider.ts +106 -0
  13. package/src/core/state.ts +54 -0
  14. package/src/directory.ts +95 -0
  15. package/src/gateway-methods.ts +237 -0
  16. package/src/onboarding.ts +387 -0
  17. package/src/policy.ts +19 -0
  18. package/src/probe.ts +213 -0
  19. package/src/reply-dispatcher.ts +674 -0
  20. package/src/runtime.ts +7 -0
  21. package/src/sdk/helpers.ts +317 -0
  22. package/src/sdk/types.ts +515 -0
  23. package/src/secret-input.ts +19 -0
  24. package/src/services/media/audio.ts +54 -0
  25. package/src/services/media/chunk-upload.ts +293 -0
  26. package/src/services/media/common.ts +154 -0
  27. package/src/services/media/file.ts +70 -0
  28. package/src/services/media/image.ts +67 -0
  29. package/src/services/media/index.ts +10 -0
  30. package/src/services/media/video.ts +162 -0
  31. package/src/services/media.ts +1134 -0
  32. package/src/services/messaging/index.ts +16 -0
  33. package/src/services/messaging/send.ts +137 -0
  34. package/src/services/messaging.ts +800 -0
  35. package/src/targets.ts +45 -0
  36. package/src/types/index.ts +52 -0
  37. package/src/utils/agent.ts +63 -0
  38. package/src/utils/async.ts +51 -0
  39. package/src/utils/constants.ts +9 -0
  40. package/src/utils/http-client.ts +84 -0
  41. package/src/utils/index.ts +8 -0
  42. package/src/utils/logger.ts +78 -0
  43. package/src/utils/session.ts +118 -0
  44. package/src/utils/token.ts +94 -0
  45. package/src/utils/utils-legacy.ts +506 -0
  46. package/.env.example +0 -11
  47. package/skills/intclaw_matrix/SKILL.md +0 -20
  48. package/src/channel/intclaw_channel.js +0 -155
  49. package/src/index.js +0 -23
@@ -0,0 +1,674 @@
1
+ import type {
2
+ ClawdbotConfig,
3
+ RuntimeEnv,
4
+ ReplyPayload,
5
+ } from "openclaw/plugin-sdk";
6
+ import {
7
+ createReplyPrefixOptions,
8
+ createTypingCallbacks,
9
+ logTypingFailure,
10
+ } from "openclaw/plugin-sdk";
11
+ import { resolveIntclawAccount } from "./config/accounts.ts";
12
+ import { getIntclawRuntime } from "./runtime.ts";
13
+ import type { IntclawConfig } from "./types/index.ts";
14
+ import {
15
+ createAICardForTarget,
16
+ streamAICard,
17
+ finishAICard,
18
+ sendMessage,
19
+ type AICardTarget,
20
+ type AICardInstance,
21
+ } from "./services/messaging/index.ts";
22
+ import {
23
+ processLocalImages,
24
+ processVideoMarkers,
25
+ processAudioMarkers,
26
+ processFileMarkers,
27
+ } from "./services/media/index.ts";
28
+ import { getAccessToken, getOapiAccessToken } from "./utils/index.ts";
29
+
30
+ // ============ 新会话命令归一化 ============
31
+
32
+ /** 新会话触发命令 */
33
+ const NEW_SESSION_COMMANDS = ['/new', '/reset', '/clear', '新会话', '重新开始', '清空对话'];
34
+
35
+ /**
36
+ * 将新会话命令归一化为标准的 /new 命令
37
+ * 支持多种别名:/new、/reset、/clear、新会话、重新开始、清空对话
38
+ */
39
+ export function normalizeSlashCommand(text: string): string {
40
+ const trimmed = text.trim();
41
+ const lower = trimmed.toLowerCase();
42
+ if (NEW_SESSION_COMMANDS.some(cmd => lower === cmd.toLowerCase())) {
43
+ return '/new';
44
+ }
45
+ return text;
46
+ }
47
+
48
+ export type CreateIntclawReplyDispatcherParams = {
49
+ cfg: ClawdbotConfig;
50
+ agentId: string;
51
+ runtime: RuntimeEnv;
52
+ conversationId: string;
53
+ senderId: string;
54
+ isDirect: boolean;
55
+ accountId?: string;
56
+ messageCreateTimeMs?: number;
57
+ sessionWebhook: string;
58
+ asyncMode?: boolean;
59
+ };
60
+
61
+ export function createIntclawReplyDispatcher(params: CreateIntclawReplyDispatcherParams) {
62
+ const core = getIntclawRuntime();
63
+ const {
64
+ cfg,
65
+ agentId,
66
+ conversationId,
67
+ senderId,
68
+ isDirect,
69
+ accountId,
70
+ sessionWebhook,
71
+ asyncMode = false,
72
+ } = params;
73
+
74
+ const account = resolveIntclawAccount({ cfg, accountId });
75
+ const { onModelSelected, ...prefixOptions } = createReplyPrefixOptions({
76
+ cfg,
77
+ agentId,
78
+ channel: "intclaw-connector",
79
+ accountId,
80
+ });
81
+
82
+ // ✅ 读取 debug 配置
83
+ const debugMode = account.config?.debug || false;
84
+ const log = {
85
+ info: (msg: string) => {
86
+ if (debugMode) {
87
+ params.runtime.info?.(msg);
88
+ }
89
+ },
90
+ error: (msg: string) => {
91
+ if (debugMode) {
92
+ params.runtime.error?.(msg);
93
+ }
94
+ },
95
+ warn: (msg: string) => {
96
+ if (debugMode) {
97
+ params.runtime.warn?.(msg);
98
+ }
99
+ },
100
+ debug: (msg: string) => {
101
+ if (debugMode) {
102
+ params.runtime.debug?.(msg);
103
+ }
104
+ },
105
+ };
106
+
107
+ // AI Card 状态管理
108
+ let currentCardTarget: AICardTarget | null = null;
109
+ let accumulatedText = "";
110
+ const deliveredFinalTexts = new Set<string>();
111
+
112
+ // 异步模式:累积完整响应
113
+ let asyncModeFullResponse = "";
114
+
115
+ // ✅ 节流控制:避免频繁调用IntClaw API 导致 QPS 限流
116
+ let lastUpdateTime = 0;
117
+ const updateInterval = 1000; // 最小更新间隔 1000ms(IntClaw QPS 限制:40 次/秒,安全起见设为 1 秒)
118
+
119
+ // ✅ 错误兜底:防止重复发送错误消息
120
+ const deliveredErrorTypes = new Set<string>();
121
+ let lastErrorTime = 0;
122
+ const ERROR_COOLDOWN = 60000; // 错误消息冷却时间 1 分钟
123
+
124
+ // ============ 错误兜底函数 ============
125
+
126
+ /**
127
+ * 发送兜底错误消息,确保用户始终能收到反馈
128
+ */
129
+ const sendFallbackErrorMessage = async (
130
+ errorType: 'mediaProcess' | 'sendMessage' | 'unknown',
131
+ originalError?: string,
132
+ forceSend: boolean = false
133
+ ) => {
134
+ const now = Date.now();
135
+ const errorKey = `${errorType}:${conversationId}:${senderId}`;
136
+
137
+ // 防止重复发送相同类型的错误消息
138
+ if (!forceSend && deliveredErrorTypes.has(errorKey)) {
139
+ log.debug(`[IntClaw][Fallback] 跳过重复错误消息:${errorType}`);
140
+ return;
141
+ }
142
+
143
+ // 冷却时间控制
144
+ if (!forceSend && now - lastErrorTime < ERROR_COOLDOWN) {
145
+ log.debug(`[IntClaw][Fallback] 冷却时间内,跳过错误消息`);
146
+ return;
147
+ }
148
+
149
+ const errorMessages = {
150
+ mediaProcess: '⚠️ 媒体文件处理失败,已发送文字回复',
151
+ sendMessage: '⚠️ 消息发送失败,请稍后重试',
152
+ unknown: '⚠️ 抱歉,处理您的请求时出错,请稍后重试',
153
+ };
154
+
155
+ const errorMessage = errorMessages[errorType];
156
+ log.warn(`[IntClaw][Fallback] ${errorMessage}, error: ${originalError}`);
157
+
158
+ try {
159
+ await sendMessage(
160
+ account.config as IntclawConfig,
161
+ sessionWebhook,
162
+ errorMessage,
163
+ {
164
+ useMarkdown: false,
165
+ log: params.runtime.log,
166
+ }
167
+ );
168
+ deliveredErrorTypes.add(errorKey);
169
+ lastErrorTime = now;
170
+ log.info(`[IntClaw][Fallback] ✅ 错误消息发送成功`);
171
+ } catch (fallbackErr: any) {
172
+ log.error(`[IntClaw][Fallback] ❌ 错误消息发送失败:${fallbackErr.message}`);
173
+ }
174
+ };
175
+
176
+ // 打字指示器回调(IntClaw暂不支持,预留接口)
177
+ const typingCallbacks = createTypingCallbacks({
178
+ start: async () => {
179
+ // IntClaw暂不支持打字指示器
180
+ },
181
+ stop: async () => {
182
+ // IntClaw暂不支持打字指示器
183
+ },
184
+ onStartError: (err) =>
185
+ logTypingFailure({
186
+ log: (message) => params.runtime.log?.(message),
187
+ channel: "intclaw-connector",
188
+ action: "start",
189
+ error: err,
190
+ }),
191
+ onStopError: (err) =>
192
+ logTypingFailure({
193
+ log: (message) => params.runtime.log?.(message),
194
+ channel: "intclaw-connector",
195
+ action: "stop",
196
+ error: err,
197
+ }),
198
+ });
199
+
200
+ const textChunkLimit = core.channel.text.resolveTextChunkLimit(
201
+ cfg,
202
+ "intclaw-connector",
203
+ accountId,
204
+ { fallbackLimit: 4000 }
205
+ );
206
+ const chunkMode = core.channel.text.resolveChunkMode(cfg, "intclaw-connector");
207
+
208
+ // 流式 AI Card 支持
209
+ const streamingEnabled = account.config?.streaming !== false;
210
+ let isCreatingCard = false; // ✅ 添加创建中标志,防止并发创建
211
+
212
+ const startStreaming = async () => {
213
+ // 异步模式下禁用流式 AI Card
214
+ if (asyncMode) {
215
+ log.info(`[IntClaw][startStreaming] 异步模式,跳过 AI Card 创建`);
216
+ return;
217
+ }
218
+ if (!streamingEnabled) {
219
+ log.info(`[IntClaw][startStreaming] 流式功能被禁用,跳过 AI Card 创建`);
220
+ return;
221
+ }
222
+ if (currentCardTarget) {
223
+ log.info(`[IntClaw][startStreaming] AI Card 已存在,跳过创建`);
224
+ return;
225
+ }
226
+ if (isCreatingCard) {
227
+ log.info(`[IntClaw][startStreaming] AI Card 正在创建中,跳过`);
228
+ return;
229
+ }
230
+
231
+ isCreatingCard = true;
232
+ log.info(`[IntClaw][startStreaming] 开始创建 AI Card...`);
233
+
234
+ try {
235
+ const target: AICardTarget = isDirect
236
+ ? { type: 'user', userId: senderId }
237
+ : { type: 'group', openConversationId: conversationId };
238
+
239
+ log.info(`[IntClaw][startStreaming] 目标:${JSON.stringify(target)}`);
240
+
241
+ const card = await createAICardForTarget(
242
+ account.config as IntclawConfig,
243
+ target,
244
+ {
245
+ info: params.runtime.info,
246
+ error: params.runtime.error,
247
+ warn: params.runtime.warn,
248
+ debug: params.runtime.debug,
249
+ }
250
+ );
251
+ currentCardTarget = card;
252
+ accumulatedText = "";
253
+
254
+ if (card) {
255
+ log.info(`[IntClaw][startStreaming] ✅ AI Card 创建成功`);
256
+ } else {
257
+ log.warn(`[IntClaw][startStreaming] AI Card 创建返回 null,静默降级到普通消息模式`);
258
+ }
259
+ } catch (error: any) {
260
+ log.error(`[IntClaw][startStreaming] ❌ AI Card 创建失败:${error?.message || String(error)},静默降级到普通消息模式`);
261
+ currentCardTarget = null;
262
+ } finally {
263
+ isCreatingCard = false;
264
+ }
265
+ };
266
+
267
+ const closeStreaming = async () => {
268
+ if (!currentCardTarget) {
269
+ log.info(`[IntClaw][closeStreaming] 无 AI Card,跳过关闭`);
270
+ return;
271
+ }
272
+
273
+ log.info(`[IntClaw][closeStreaming] 开始关闭 AI Card...`);
274
+
275
+ try {
276
+ // 处理媒体标记
277
+ let finalText = accumulatedText;
278
+
279
+ // ✅ 如果累积的文本为空,使用默认提示文案
280
+ if (!finalText.trim()) {
281
+ finalText = '✅ 任务执行完成(无文本输出)';
282
+ log.info(`[IntClaw][closeStreaming] 累积文本为空,使用默认提示文案`);
283
+ }
284
+
285
+ // 获取 oapiToken 用于媒体处理
286
+ const oapiToken = await getOapiAccessToken(account.config as IntclawConfig);
287
+
288
+ // ✅ 构建正确的 target(单聊用 senderId,群聊用 conversationId)
289
+ const target: AICardTarget = isDirect
290
+ ? { type: 'user', userId: senderId }
291
+ : { type: 'group', openConversationId: conversationId };
292
+
293
+ log.info(`[IntClaw][closeStreaming] 开始处理媒体文件,target=${JSON.stringify(target)}`);
294
+
295
+ if (oapiToken) {
296
+ // 处理本地图片
297
+ finalText = await processLocalImages(finalText, oapiToken, log);
298
+
299
+ // ✅ 先处理 Markdown 标记格式的媒体文件
300
+ finalText = await processVideoMarkers(
301
+ finalText,
302
+ '',
303
+ account.config as IntclawConfig,
304
+ oapiToken,
305
+ log,
306
+ true, // ✅ 使用主动 API 模式
307
+ target
308
+ );
309
+ finalText = await processAudioMarkers(
310
+ finalText,
311
+ '',
312
+ account.config as IntclawConfig,
313
+ oapiToken,
314
+ log,
315
+ true, // ✅ 使用主动 API 模式
316
+ target
317
+ );
318
+ finalText = await processFileMarkers(
319
+ finalText,
320
+ '',
321
+ account.config as IntclawConfig,
322
+ oapiToken,
323
+ log,
324
+ true, // ✅ 使用主动 API 模式
325
+ target
326
+ );
327
+
328
+ // ✅ 处理裸露的本地文件路径(绕过 OpenClaw SDK 的 bug)
329
+ log.info(`[IntClaw][closeStreaming] 准备调用 processRawMediaPaths`);
330
+ const { processRawMediaPaths } = await import('./services/media.js');
331
+ finalText = await processRawMediaPaths(
332
+ finalText,
333
+ account.config as IntclawConfig,
334
+ oapiToken,
335
+ log,
336
+ target
337
+ );
338
+ log.info(`[IntClaw][closeStreaming] processRawMediaPaths 处理完成`);
339
+ } else {
340
+ log.warn(`[IntClaw][closeStreaming] oapiToken 为空,跳过媒体处理`);
341
+ }
342
+
343
+ log.info(`[IntClaw][closeStreaming] 准备调用 finishAICard,文本长度=${finalText.length}`);
344
+ await finishAICard(
345
+ currentCardTarget as AICardInstance,
346
+ finalText,
347
+ {
348
+ info: params.runtime.info,
349
+ error: params.runtime.error,
350
+ warn: params.runtime.warn,
351
+ debug: params.runtime.debug,
352
+ }
353
+ );
354
+ log.info(`[IntClaw][closeStreaming] ✅ AI Card 关闭成功`);
355
+ } catch (error: any) {
356
+ log.error(`[IntClaw][closeStreaming] ❌ AI Card 关闭失败:${error?.message || String(error)}`);
357
+ // ✅ 媒体处理或关闭失败时,降级发送普通消息
358
+ await sendFallbackErrorMessage('mediaProcess', error?.message || String(error));
359
+
360
+ // 尝试用普通消息发送累积的文本
361
+ if (accumulatedText.trim()) {
362
+ try {
363
+ log.info(`[IntClaw][closeStreaming] 降级发送普通消息`);
364
+ await sendMessage(
365
+ account.config as IntclawConfig,
366
+ sessionWebhook,
367
+ accumulatedText,
368
+ {
369
+ useMarkdown: true,
370
+ log: params.runtime.log,
371
+ }
372
+ );
373
+ log.info(`[IntClaw][closeStreaming] ✅ 降级发送成功`);
374
+ } catch (sendErr: any) {
375
+ log.error(`[IntClaw][closeStreaming] ❌ 降级发送失败:${sendErr.message}`);
376
+ }
377
+ }
378
+ } finally {
379
+ currentCardTarget = null;
380
+ accumulatedText = "";
381
+ }
382
+ };
383
+
384
+ const { dispatcher, replyOptions, markDispatchIdle } =
385
+ core.channel.reply.createReplyDispatcherWithTyping({
386
+ ...prefixOptions,
387
+ humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, agentId),
388
+ onReplyStart: async () => {
389
+ deliveredFinalTexts.clear();
390
+ log.info(`[IntClaw][onReplyStart] 开始回复,流式 enabled=${streamingEnabled}`);
391
+ if (streamingEnabled) {
392
+ await startStreaming();
393
+ }
394
+ typingCallbacks.onActive?.();
395
+ },
396
+ deliver: async (payload, info) => {
397
+ let text = payload.text ?? "";
398
+
399
+ log.info(`[IntClaw][deliver] 被调用:kind=${info?.kind}, textLength=${text.length}, hasText=${Boolean(text.trim())}`);
400
+
401
+ // ✅ 在 final 响应时,先处理裸露的文件路径
402
+ if (info?.kind === "final" && text.trim()) {
403
+ const target: AICardTarget = isDirect
404
+ ? { type: 'user', userId: senderId }
405
+ : { type: 'group', openConversationId: conversationId };
406
+
407
+ try {
408
+ const oapiToken = await getOapiAccessToken(account.config as IntclawConfig);
409
+ if (oapiToken) {
410
+ log.info(`[IntClaw][deliver] 检测到 final 响应,准备处理裸露文件路径`);
411
+ const { processRawMediaPaths } = await import('./services/media.js');
412
+ text = await processRawMediaPaths(
413
+ text,
414
+ account.config as IntclawConfig,
415
+ oapiToken,
416
+ log,
417
+ target
418
+ );
419
+ log.info(`[IntClaw][deliver] 裸露文件路径处理完成`);
420
+ }
421
+ } catch (err: any) {
422
+ log.error(`[IntClaw][deliver] 处理裸露文件路径失败:${err.message}`);
423
+ }
424
+ }
425
+
426
+ const hasText = Boolean(text.trim());
427
+ const skipTextForDuplicateFinal =
428
+ info?.kind === "final" && hasText && deliveredFinalTexts.has(text);
429
+
430
+ // ✅ 如果是 final 响应且没有文本,使用默认提示文案
431
+ if (info?.kind === "final" && !hasText) {
432
+ text = '✅ 任务执行完成(无文本输出)';
433
+ log.info(`[IntClaw][deliver] final 响应无文本,使用默认提示文案`);
434
+ }
435
+
436
+ const shouldDeliverText = Boolean(text.trim()) && !skipTextForDuplicateFinal;
437
+
438
+ if (!shouldDeliverText) {
439
+ log.info(`[IntClaw][deliver] 跳过发送:hasText=${hasText}, skipTextForDuplicateFinal=${skipTextForDuplicateFinal}`);
440
+ return;
441
+ }
442
+
443
+ // 异步模式:只累积响应,不发送
444
+ if (asyncMode) {
445
+ log.info(`[IntClaw][deliver] 异步模式,累积响应`);
446
+ asyncModeFullResponse = text;
447
+ return;
448
+ }
449
+
450
+ // 流式模式:使用 AI Card
451
+ if (info?.kind === "block" && streamingEnabled) {
452
+ if (!currentCardTarget) {
453
+ log.info(`[IntClaw][deliver] block 响应,AI Card 不存在,尝试创建...`);
454
+ await startStreaming();
455
+ }
456
+ if (currentCardTarget) {
457
+ accumulatedText += text;
458
+ log.info(`[IntClaw][deliver] 流式更新 AI Card,累积文本长度=${accumulatedText.length}`);
459
+ try {
460
+ await streamAICard(
461
+ currentCardTarget as AICardInstance,
462
+ accumulatedText,
463
+ false,
464
+ params.runtime.log
465
+ );
466
+ } catch (streamErr: any) {
467
+ log.error(`[IntClaw][deliver] ❌ streamAICard 失败:${streamErr.message}`);
468
+ // ✅ 流式更新失败,发送兜底消息并降级
469
+ await sendFallbackErrorMessage('sendMessage', streamErr.message);
470
+ }
471
+ } else {
472
+ log.warn(`[IntClaw][deliver] ⚠️ AI Card 创建失败,降级到非流式发送`);
473
+ // 降级逻辑:如果 AI Card 创建失败,直接发送普通消息
474
+ try {
475
+ for (const chunk of core.channel.text.chunkTextWithMode(
476
+ text,
477
+ textChunkLimit,
478
+ chunkMode
479
+ )) {
480
+ await sendMessage(
481
+ account.config as IntclawConfig,
482
+ sessionWebhook,
483
+ chunk,
484
+ {
485
+ useMarkdown: true,
486
+ log: params.runtime.log,
487
+ }
488
+ );
489
+ }
490
+ log.info(`[IntClaw][deliver] ✅ 降级发送成功`);
491
+ } catch (error: any) {
492
+ log.error(`[IntClaw][deliver] ❌ 降级发送失败:${error.message}`);
493
+ await sendFallbackErrorMessage('sendMessage', error.message);
494
+ }
495
+ }
496
+ return;
497
+ }
498
+
499
+ // 流式模式的 final 处理
500
+ if (info?.kind === "final" && streamingEnabled) {
501
+ log.info(`[IntClaw][deliver] final 响应,流式模式`);
502
+ // 如果还没有创建 AI Card,先创建
503
+ if (!currentCardTarget && !isCreatingCard) {
504
+ log.info(`[IntClaw][deliver] AI Card 不存在,尝试创建...`);
505
+ await startStreaming();
506
+ }
507
+
508
+ // 等待创建完成
509
+ if (isCreatingCard) {
510
+ const maxWait = 5000;
511
+ const startTime = Date.now();
512
+ log.info(`[IntClaw][deliver] 等待 AI Card 创建完成,最多等待 ${maxWait}ms`);
513
+ while (isCreatingCard && Date.now() - startTime < maxWait) {
514
+ await new Promise(resolve => setTimeout(resolve, 50));
515
+ }
516
+ }
517
+
518
+ if (currentCardTarget) {
519
+ accumulatedText = text;
520
+ log.info(`[IntClaw][deliver] 调用 closeStreaming 完成 AI Card`);
521
+ await closeStreaming();
522
+ deliveredFinalTexts.add(text);
523
+ return;
524
+ } else {
525
+ log.warn(`[IntClaw][deliver] ⚠️ AI Card 创建失败,降级到非流式发送`);
526
+ }
527
+ }
528
+
529
+ // 流式模式但没有 card target:降级到非流式发送
530
+ // 或者非流式模式:使用普通消息发送
531
+ if (info?.kind === "final") {
532
+ log.info(`[IntClaw][deliver] 降级到非流式发送,文本长度=${text.length}`);
533
+ try {
534
+ for (const chunk of core.channel.text.chunkTextWithMode(
535
+ text,
536
+ textChunkLimit,
537
+ chunkMode
538
+ )) {
539
+ await sendMessage(
540
+ account.config as IntclawConfig,
541
+ sessionWebhook,
542
+ chunk,
543
+ {
544
+ useMarkdown: true,
545
+ log: params.runtime.log,
546
+ }
547
+ );
548
+ }
549
+ log.info(`[IntClaw][deliver] ✅ 非流式发送成功`);
550
+ deliveredFinalTexts.add(text);
551
+ } catch (error: any) {
552
+ log.error(`[IntClaw][deliver] ❌ 非流式发送失败:${error.message}`);
553
+ params.runtime.error?.(
554
+ `intclaw[${account.accountId}]: non-streaming delivery failed: ${String(error)}`
555
+ );
556
+ // ✅ 发送兜底错误消息
557
+ await sendFallbackErrorMessage('sendMessage', error.message);
558
+ }
559
+ return;
560
+ }
561
+ },
562
+ onError: async (error, info) => {
563
+ log.error(`[IntClaw][onError] ${info.kind} reply failed: ${String(error)}`);
564
+ params.runtime.error?.(
565
+ `intclaw[${account.accountId}] ${info.kind} reply failed: ${String(error)}`
566
+ );
567
+ await closeStreaming();
568
+ typingCallbacks.onIdle?.();
569
+ },
570
+ onIdle: async () => {
571
+ log.info(`[IntClaw][onIdle] 回复空闲,关闭流式`);
572
+ await closeStreaming();
573
+ typingCallbacks.onIdle?.();
574
+ },
575
+ onCleanup: () => {
576
+ log.info(`[IntClaw][onCleanup] 清理回调`);
577
+ typingCallbacks.onCleanup?.();
578
+ },
579
+ });
580
+
581
+ // 构建完整的 replyOptions:replyOptions 只包含 onReplyStart、onTypingController、onTypingCleanup
582
+ // deliver、onError、onIdle、onCleanup 等回调已经在 createReplyDispatcherWithTyping 的参数中定义
583
+ return {
584
+ dispatcher,
585
+ replyOptions: {
586
+ ...replyOptions, // ✅ 包含 onReplyStart、onTypingController、onTypingCleanup
587
+ onModelSelected,
588
+ ...(streamingEnabled && {
589
+ onPartialReply: async (payload: ReplyPayload) => {
590
+ log.info(`[IntClaw][onPartialReply] 被调用,payload.text=${payload.text ? payload.text.length : 'null'}`);
591
+ if (!payload.text) {
592
+ log.debug(`[IntClaw][onPartialReply] 空文本,跳过`);
593
+ return;
594
+ }
595
+
596
+ log.debug(`[IntClaw][onPartialReply] 收到部分响应,文本长度=${payload.text.length}`);
597
+
598
+ // 异步模式下禁用流式更新
599
+ if (asyncMode) {
600
+ log.debug(`[IntClaw][onPartialReply] 异步模式,累积响应`);
601
+ asyncModeFullResponse = payload.text;
602
+ return;
603
+ }
604
+
605
+ // 如果还没有 AI Card,先启动流式
606
+ if (!currentCardTarget && !isCreatingCard) {
607
+ log.debug(`[IntClaw][onPartialReply] AI Card 不存在,尝试创建...`);
608
+ await startStreaming();
609
+ }
610
+
611
+ // 如果正在创建中,等待创建完成
612
+ if (isCreatingCard) {
613
+ const maxWait = 5000;
614
+ const startTime = Date.now();
615
+ log.debug(`[IntClaw][onPartialReply] 等待 AI Card 创建完成,最多等待 ${maxWait}ms`);
616
+ while (isCreatingCard && Date.now() - startTime < maxWait) {
617
+ await new Promise(resolve => setTimeout(resolve, 50));
618
+ }
619
+ }
620
+
621
+ if (currentCardTarget) {
622
+ accumulatedText = payload.text;
623
+
624
+ const now = Date.now();
625
+ if (now - lastUpdateTime >= updateInterval) {
626
+ const { FILE_MARKER_PATTERN, VIDEO_MARKER_PATTERN, AUDIO_MARKER_PATTERN } = await import('./services/media/common.ts');
627
+ const displayContent = accumulatedText
628
+ .replace(FILE_MARKER_PATTERN, '')
629
+ .replace(VIDEO_MARKER_PATTERN, '')
630
+ .replace(AUDIO_MARKER_PATTERN, '')
631
+ .trim();
632
+
633
+ log.debug(`[IntClaw][onPartialReply] 更新 AI Card,显示文本长度=${displayContent.length}`);
634
+
635
+ try {
636
+ await streamAICard(
637
+ currentCardTarget as AICardInstance,
638
+ displayContent,
639
+ false,
640
+ {
641
+ info: params.runtime.info,
642
+ error: params.runtime.error,
643
+ warn: params.runtime.warn,
644
+ debug: params.runtime.debug,
645
+ }
646
+ );
647
+ lastUpdateTime = now;
648
+ log.debug(`[IntClaw][onPartialReply] ✅ AI Card 更新成功`);
649
+ } catch (err: any) {
650
+ // 安全检查:确保 code 存在且为字符串
651
+ const errorCode = err.response?.data?.code;
652
+ if (err.response?.status === 403 && typeof errorCode === 'string' && errorCode.includes('QpsLimit')) {
653
+ // QPS 限流,跳过本次更新
654
+ log.warn(`[IntClaw][AICard] QPS 限流,跳过本次更新`);
655
+ } else {
656
+ log.error(`[IntClaw][onPartialReply] ❌ AI Card 更新失败:${err.message}`);
657
+ // ✅ 发送兜底错误消息,但不抛出异常,避免中断后续处理
658
+ await sendFallbackErrorMessage('sendMessage', err.message);
659
+ }
660
+ }
661
+ } else {
662
+ log.debug(`[IntClaw][onPartialReply] 节流控制,跳过本次更新(距离上次更新 ${now - lastUpdateTime}ms)`);
663
+ }
664
+ } else {
665
+ log.warn(`[IntClaw][onPartialReply] ⚠️ AI Card 不存在,跳过更新`);
666
+ }
667
+ },
668
+ }),
669
+ disableBlockStreaming: true, // ✅ 强制使用 onPartialReply 而不是 block
670
+ },
671
+ markDispatchIdle,
672
+ getAsyncModeResponse: () => asyncModeFullResponse,
673
+ };
674
+ }
package/src/runtime.ts ADDED
@@ -0,0 +1,7 @@
1
+ import { createPluginRuntimeStore } from "openclaw/plugin-sdk/compat";
2
+ import type { PluginRuntime } from "openclaw/plugin-sdk";
3
+
4
+ const { setRuntime: setIntclawRuntime, getRuntime: getIntclawRuntime } =
5
+ createPluginRuntimeStore<PluginRuntime>("IntClaw runtime not initialized");
6
+
7
+ export { getIntclawRuntime, setIntclawRuntime };