timbot 2026.3.12-beta.2 → 2026.3.19-beta.1

package/README.md

@@ -21,6 +21,11 @@ Local testing, streaming mode selection, and webhook replay examples are documen
 
 ## Changelog
 
+### 2026.3.12
+
+- docs: 补充流式模式依赖上游 partial 输出的说明与可观测性日志
+- chore: 添加调试配置命令与本地 webhook 测试脚本
+
 ### 2026.3.10
 
 - feat: 流式消息支持，新增 `streamingMode` 配置（`off` / `text_modify` / `custom_modify` / `tim_stream`）

package/README.zh-CN.md

@@ -103,6 +103,297 @@ openclaw config set channels.timbot.overflowPolicy split
 openclaw config set channels.timbot.typingText "思考中，请稍候..."
 ```
 
+## 多 Agent 配置教程
+
+timbot 支持在同一个腾讯 IM 应用下配置多个机器人账号，每个机器人绑定不同的 OpenClaw Agent，实现"不同会话 = 不同 AI 助手"的体验。
+
+### 前置条件
+
+- timbot >= 2026.3.12
+- 单账号基础配置已完成（`sdkAppId` + `secretKey`）
+- **在腾讯云 IM 控制台创建好多个机器人账号（`@RBT#001`、`@RBT#002` 等）**
+
+> 每个 sdkAppId 最多支持 20 个 `@RBT#` 机器人账号。
+
+### 原理概览
+
+```
+用户发消息给 @RBT#002
+      ↓
+腾讯 IM Webhook（To_Account = "@RBT#002"）
+      ↓
+timbot 按 To_Account 匹配到 accountId = "translator"
+      ↓
+OpenClaw bindings 将 accountId 路由到 agentId = "translator"
+      ↓
+translator agent 的 workspace 处理消息并回复
+```
+
+### 第一步：创建 Agent workspace
+
+为每个 Agent 创建独立的 workspace：
+
+```bash
+openclaw agents add translator
+openclaw agents add coder
+```
+
+每个 Agent 拥有独立的 `SOUL.md`（人设）、`AGENTS.md`（行为指令）、session 存储和 auth 配置。
+
+### 第二步：配置 timbot 多账号
+
+#### 方式 A：CLI 命令（推荐）
+
+```bash
+# 设置默认账号
+openclaw config set channels.timbot.defaultAccount default
+
+# 为每个账号设置 botAccount
+openclaw config set channels.timbot.accounts.default.botAccount "@RBT#001"
+openclaw config set channels.timbot.accounts.translator.botAccount "@RBT#002"
+openclaw config set channels.timbot.accounts.coder.botAccount "@RBT#003"
+
+# 可按账号覆盖顶层配置（可选）
+openclaw config set channels.timbot.accounts.coder.streamingMode tim_stream
+```
+
+也可以用 `--batch-json` 一次性批量设置：
+
+```bash
+openclaw config set --batch-json '[
+  { "path": "channels.timbot.defaultAccount", "value": "default" },
+  { "path": "channels.timbot.accounts.default.botAccount", "value": "@RBT#001" },
+  { "path": "channels.timbot.accounts.translator.botAccount", "value": "@RBT#002" },
+  { "path": "channels.timbot.accounts.coder.botAccount", "value": "@RBT#003" }
+]'
+```
+
+#### 方式 B：手动编辑配置文件
+
+编辑 `~/.openclaw/openclaw.json`：
+
+```json5
+{
+  channels: {
+    timbot: {
+      // 共享凭证
+      sdkAppId: "1600012345",
+      secretKey: "your-secret-key",
+      token: "webhook-token",
+      webhookPath: "/timbot",
+
+      // 顶层作为所有账号的默认值
+      streamingMode: "off",
+      dm: { policy: "open", allowFrom: ["*"] },
+
+      // 默认账号
+      defaultAccount: "default",
+
+      // 多账号配置
+      accounts: {
+        default: {
+          botAccount: "@RBT#001",   // AI 助手
+        },
+        translator: {
+          botAccount: "@RBT#002",   // 翻译官
+        },
+        coder: {
+          botAccount: "@RBT#003",   // 代码助手
+          streamingMode: "tim_stream",  // 可按账号覆盖
+        },
+      },
+    },
+  },
+}
+```
+
+账号级字段会覆盖顶层同名字段，未指定的继承顶层默认值。`sdkAppId`、`secretKey` 等共享凭证只需在顶层写一次。
+
+### 第三步：添加 bindings
+
+bindings 将 timbot 的 `accountId` 映射到 OpenClaw 的 `agentId`。
+
+#### 方式 A：CLI 命令（推荐）
+
+```bash
+# 将 timbot 的各账号绑定到对应 agent
+openclaw agents bind --agent main --bind timbot:default
+openclaw agents bind --agent translator --bind timbot:translator
+openclaw agents bind --agent coder --bind timbot:coder
+
+# 验证绑定关系
+openclaw agents bindings
+```
+
+#### 方式 B：手动编辑配置文件
+
+在 `~/.openclaw/openclaw.json` 中添加：
+
+```json5
+{
+  agents: {
+    list: [
+      { id: "main", default: true, workspace: "~/.openclaw/workspace" },
+      { id: "translator", workspace: "~/.openclaw/workspace-translator" },
+      { id: "coder", workspace: "~/.openclaw/workspace-coder" },
+    ],
+  },
+
+  bindings: [
+    { agentId: "main",       match: { channel: "timbot", accountId: "default" } },
+    { agentId: "translator", match: { channel: "timbot", accountId: "translator" } },
+    { agentId: "coder",      match: { channel: "timbot", accountId: "coder" } },
+  ],
+
+  channels: {
+    timbot: {
+      // ... 上一步的配置
+    },
+  },
+}
+```
+
+### 第四步：设置 Agent 人设
+
+每个 Agent 的 workspace 下编辑 `SOUL.md` 定义人格：
+
+```bash
+# ~/.openclaw/workspace-translator/SOUL.md
+echo "你是一位专业翻译官，擅长中英互译。请用简洁准确的风格翻译用户提供的内容。" \
+  > ~/.openclaw/workspace-translator/SOUL.md
+
+# ~/.openclaw/workspace-coder/SOUL.md
+echo "你是一位资深程序员，擅长代码审查、调试和编写。回复时附带代码示例。" \
+  > ~/.openclaw/workspace-coder/SOUL.md
+```
+
+### 第五步：重启并验证
+
+```bash
+# 重启 Gateway
+openclaw gateway restart
+
+# 检查 agents 和 bindings
+openclaw agents list --bindings
+
+# 检查通道状态
+openclaw channels status --probe
+```
+
+### 按用户路由（可选）
+
+如果只有一个机器人账号，但想把不同用户的消息路由到不同 Agent，可以用 peer 匹配：
+
+```json5
+{
+  bindings: [
+    // 指定用户 → translator agent
+    {
+      agentId: "translator",
+      match: { channel: "timbot", peer: { kind: "direct", id: "user_alice" } },
+    },
+    // 指定群 → coder agent
+    {
+      agentId: "coder",
+      match: { channel: "timbot", peer: { kind: "group", id: "@TGS#group001" } },
+    },
+    // 其余走默认
+    { agentId: "main", match: { channel: "timbot" } },
+  ],
+}
+```
+
+peer 匹配优先级高于 accountId 匹配。更多路由规则见 [OpenClaw Multi-Agent 文档](https://docs.openclaw.ai/concepts/multi-agent)。
+
+### 完整配置示例
+
+```json5
+{
+  agents: {
+    list: [
+      {
+        id: "main",
+        default: true,
+        name: "AI 助手",
+        workspace: "~/.openclaw/workspace",
+      },
+      {
+        id: "translator",
+        name: "翻译官",
+        workspace: "~/.openclaw/workspace-translator",
+      },
+      {
+        id: "coder",
+        name: "代码助手",
+        workspace: "~/.openclaw/workspace-coder",
+        model: "anthropic/claude-sonnet-4-5",
+      },
+    ],
+  },
+
+  bindings: [
+    { agentId: "main",       match: { channel: "timbot", accountId: "default" } },
+    { agentId: "translator", match: { channel: "timbot", accountId: "translator" } },
+    { agentId: "coder",      match: { channel: "timbot", accountId: "coder" } },
+  ],
+
+  channels: {
+    timbot: {
+      sdkAppId: "1600012345",
+      secretKey: "your-secret-key",
+      token: "webhook-token",
+      webhookPath: "/timbot",
+      streamingMode: "tim_stream",
+      fallbackPolicy: "final_text",
+      dm: { policy: "open", allowFrom: ["*"] },
+      defaultAccount: "default",
+      accounts: {
+        default: {
+          botAccount: "@RBT#001",
+        },
+        translator: {
+          botAccount: "@RBT#002",
+        },
+        coder: {
+          botAccount: "@RBT#003",
+        },
+      },
+    },
+  },
+}
+```
+
+### 调试
+
+```bash
+# 前台运行，观察路由日志
+openclaw gateway run --verbose --force
+
+# 模拟向 @RBT#002 发消息
+TS=$(date +%s) && RAND=$RANDOM
+curl -sS 'http://127.0.0.1:18789/timbot' \
+  -H 'content-type: application/json' \
+  --data-binary "{
+    \"CallbackCommand\":\"Bot.OnC2CMessage\",
+    \"From_Account\":\"test_user\",
+    \"To_Account\":\"@RBT#002\",
+    \"MsgTime\":$TS,
+    \"MsgRandom\":$RAND,
+    \"MsgKey\":\"test_${TS}_${RAND}\",
+    \"MsgBody\":[{\"MsgType\":\"TIMTextElem\",\"MsgContent\":{\"Text\":\"翻译：hello world\"}}]
+  }"
+```
+
+日志中应出现 `agentId=translator`，说明路由生效。
+
+### 注意事项
+
+- 每个 sdkAppId 最多 20 个 `@RBT#` 机器人账号
+- `@RBT#` 机器人发送 C2C 消息不校验好友关系，但用户端会话列表需要机器人先主动发一条消息或通过 `friend_add` API 强制添加
+- 体验版每日限 1000 条消息（所有机器人共享），生产环境需升级
+- 当前 onboarding 向导不支持多账号交互配置，需手动编辑配置文件
+- Agent 的 auth profile 是隔离的，如需共享 provider 凭证，将 `auth-profiles.json` 复制到对应 Agent 的 `agentDir`
+
 ## 常用命令速查
 
 ### Gateway 前台运行 + 日志

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

@@ -0,0 +1,2 @@
+export declare function normalizeOptionalText(value: unknown): string | undefined;
+//# sourceMappingURL=config-text.d.ts.map

package/dist/src/config-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-text.d.ts","sourceRoot":"","sources":["../../src/config-text.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAWxE"}

package/dist/src/config-text.js

@@ -0,0 +1,11 @@
+export function normalizeOptionalText(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        return trimmed || undefined;
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return String(value);
+    }
+    return undefined;
+}
+//# sourceMappingURL=config-text.js.map

package/dist/src/config-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-text.js","sourceRoot":"","sources":["../../src/config-text.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,OAAO,IAAI,SAAS,CAAC;IAC9B,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/inbound-routing.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedTimbotAccount, TimbotInboundMessage, TimbotMsgBodyElement } from "./types.js";
+export type TimbotWebhookRoutingTarget = {
+    account: Pick<ResolvedTimbotAccount, "configured" | "sdkAppId" | "botAccount" | "token">;
+};
+export declare function extractTextFromMsgBody(msgBody?: TimbotMsgBodyElement[]): string;
+export declare function extractMentionedBotAccounts(rawBody: string): string[];
+export declare function matchTimbotWebhookTargetsBySdkAppId<T extends TimbotWebhookRoutingTarget>(targets: T[], sdkAppId: string): T[];
+export declare function selectTimbotWebhookTarget<T extends TimbotWebhookRoutingTarget>(params: {
+    targets: T[];
+    msg: TimbotInboundMessage;
+}): T | undefined;
+//# sourceMappingURL=inbound-routing.d.ts.map

package/dist/src/inbound-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-routing.d.ts","sourceRoot":"","sources":["../../src/inbound-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;CAC1F,CAAC;AA4BF,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,oBAAoB,EAAE,GAAG,MAAM,CA2B/E;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAerE;AAED,wBAAgB,mCAAmC,CAAC,CAAC,SAAS,0BAA0B,EACtF,OAAO,EAAE,CAAC,EAAE,EACZ,QAAQ,EAAE,MAAM,GACf,CAAC,EAAE,CAIL;AAED,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,0BAA0B,EAAE,MAAM,EAAE;IACtF,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,GAAG,EAAE,oBAAoB,CAAC;CAC3B,GAAG,CAAC,GAAG,SAAS,CAoChB"}

package/dist/src/inbound-routing.js

@@ -0,0 +1,112 @@
+function normalizeBotAccount(raw) {
+    const trimmed = raw?.trim();
+    if (!trimmed)
+        return undefined;
+    return trimmed.replace(/^＠/u, "@").toLowerCase();
+}
+function extractMentionedBotAccountsFromField(msg) {
+    const mentions = Array.isArray(msg.AtRobots_Account) ? msg.AtRobots_Account : [];
+    const normalizedMentions = [];
+    const seen = new Set();
+    for (const mention of mentions) {
+        const normalized = normalizeBotAccount(mention);
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        normalizedMentions.push(mention.replace(/^＠/u, "@"));
+    }
+    return normalizedMentions;
+}
+function isGroupMessage(msg) {
+    return msg.CallbackCommand === "Bot.OnGroupMessage" || Boolean(msg.GroupId?.trim());
+}
+// 从 MsgBody 提取文本内容
+export function extractTextFromMsgBody(msgBody) {
+    if (!msgBody || !Array.isArray(msgBody))
+        return "";
+    const texts = [];
+    for (const elem of msgBody) {
+        if (elem.MsgType === "TIMTextElem" && elem.MsgContent?.Text) {
+            texts.push(elem.MsgContent.Text);
+        }
+        else if (elem.MsgType === "TIMCustomElem") {
+            texts.push("[custom]");
+        }
+        else if (elem.MsgType === "TIMImageElem") {
+            texts.push("[image]");
+        }
+        else if (elem.MsgType === "TIMSoundElem") {
+            texts.push("[voice]");
+        }
+        else if (elem.MsgType === "TIMFileElem") {
+            texts.push("[file]");
+        }
+        else if (elem.MsgType === "TIMVideoFileElem") {
+            texts.push("[video]");
+        }
+        else if (elem.MsgType === "TIMFaceElem") {
+            texts.push("[face]");
+        }
+        else if (elem.MsgType === "TIMLocationElem") {
+            texts.push("[location]");
+        }
+        else if (elem.MsgType === "TIMStreamElem") {
+            texts.push("[stream]");
+        }
+    }
+    return texts.join("\n");
+}
+export function extractMentionedBotAccounts(rawBody) {
+    if (!rawBody.trim())
+        return [];
+    const matches = rawBody.match(/[@＠]RBT#[A-Za-z0-9._-]+/giu) ?? [];
+    const mentions = [];
+    const seen = new Set();
+    for (const match of matches) {
+        const normalized = normalizeBotAccount(match);
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        mentions.push(match.replace(/^＠/u, "@"));
+    }
+    return mentions;
+}
+export function matchTimbotWebhookTargetsBySdkAppId(targets, sdkAppId) {
+    const trimmed = sdkAppId.trim();
+    if (!trimmed)
+        return [...targets];
+    return targets.filter((candidate) => candidate.account.sdkAppId === trimmed);
+}
+export function selectTimbotWebhookTarget(params) {
+    const configuredTargets = params.targets.filter((candidate) => candidate.account.configured);
+    if (configuredTargets.length === 0)
+        return undefined;
+    const toAccount = normalizeBotAccount(params.msg.To_Account);
+    if (toAccount) {
+        const directMatch = configuredTargets.find((candidate) => normalizeBotAccount(candidate.account.botAccount) === toAccount);
+        if (directMatch)
+            return directMatch;
+    }
+    if (configuredTargets.length === 1) {
+        return configuredTargets[0];
+    }
+    if (!isGroupMessage(params.msg)) {
+        return undefined;
+    }
+    const mentionedAccounts = [
+        ...extractMentionedBotAccountsFromField(params.msg),
+        ...extractMentionedBotAccounts(extractTextFromMsgBody(params.msg.MsgBody)),
+    ];
+    const seenMentions = new Set();
+    for (const mentionedAccount of mentionedAccounts) {
+        const normalizedMention = normalizeBotAccount(mentionedAccount);
+        if (!normalizedMention || seenMentions.has(normalizedMention))
+            continue;
+        seenMentions.add(normalizedMention);
+        const matched = configuredTargets.find((candidate) => normalizeBotAccount(candidate.account.botAccount) === normalizedMention);
+        if (matched)
+            return matched;
+    }
+    return undefined;
+}
+//# sourceMappingURL=inbound-routing.js.map

package/dist/src/inbound-routing.js.map

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

package/dist/src/monitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/monitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EACV,qBAAqB,EAKtB,MAAM,YAAY,CAAC;AAiBpB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnF,CAAC;AAqcF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAG/D;AAkFD,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAGhF;AAg0CD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAWnF;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,OAAO,CAAC,CAuHlB"}
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../src/monitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EACV,qBAAqB,EAKtB,MAAM,YAAY,CAAC;AAsBpB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnF,CAAC;AAodF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAG/D;AAkFD,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAGhF;AAmyCD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAWnF;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,OAAO,CAAC,CAsIlB"}

package/dist/src/monitor.js

@@ -2,8 +2,8 @@ import { createHash, timingSafeEqual } from "node:crypto";
 import { getTimbotRuntime } from "./runtime.js";
 import { genTestUserSig } from "./debug/GenerateTestUserSig-es.js";
 import { LOG_PREFIX, logSimple } from "./logger.js";
+import { extractMentionedBotAccounts, extractTextFromMsgBody, matchTimbotWebhookTargetsBySdkAppId, selectTimbotWebhookTarget, } from "./inbound-routing.js";
 import { allowsFinalTextRecovery, buildBotErrorPayload, buildBotStreamPayload, buildCustomMsgBody, buildStreamingMsgBody, buildTimStreamChunk, buildTimStreamMsgBody, buildTextMsgBody, } from "./streaming-policy.js";
-import { splitTextByPreferredBreaks } from "./text-splitter.js";
 const webhookTargets = new Map();
 // ============ 日志工具（带 target） ============
 /** 带 target 的日志（有 runtime 回调） */
@@ -149,6 +149,19 @@ function mergeStreamingText(previousText, nextText) {
 function estimateMsgBodyBytes(msgBody) {
     return Buffer.byteLength(JSON.stringify(msgBody), "utf8");
 }
+function splitTextByFixedLength(text, limit) {
+    if (!text) {
+        return [];
+    }
+    if (limit <= 0 || text.length <= limit) {
+        return [text];
+    }
+    const chunks = [];
+    for (let index = 0; index < text.length; index += limit) {
+        chunks.push(text.slice(index, index + limit));
+    }
+    return chunks;
+}
 function isMsgTooLongError(error) {
     return /msg too long/i.test(error ?? "");
 }
@@ -1229,42 +1242,6 @@ async function executeStreamingReply(params) {
         target.statusSink?.({ lastOutboundAt: Date.now() });
     }
 }
-// 从 MsgBody 提取文本内容
-function extractTextFromMsgBody(msgBody) {
-    if (!msgBody || !Array.isArray(msgBody))
-        return "";
-    const texts = [];
-    for (const elem of msgBody) {
-        if (elem.MsgType === "TIMTextElem" && elem.MsgContent?.Text) {
-            texts.push(elem.MsgContent.Text);
-        }
-        else if (elem.MsgType === "TIMCustomElem") {
-            texts.push("[custom]");
-        }
-        else if (elem.MsgType === "TIMImageElem") {
-            texts.push("[image]");
-        }
-        else if (elem.MsgType === "TIMSoundElem") {
-            texts.push("[voice]");
-        }
-        else if (elem.MsgType === "TIMFileElem") {
-            texts.push("[file]");
-        }
-        else if (elem.MsgType === "TIMVideoFileElem") {
-            texts.push("[video]");
-        }
-        else if (elem.MsgType === "TIMFaceElem") {
-            texts.push("[face]");
-        }
-        else if (elem.MsgType === "TIMLocationElem") {
-            texts.push("[location]");
-        }
-        else if (elem.MsgType === "TIMStreamElem") {
-            texts.push("[stream]");
-        }
-    }
-    return texts.join("\n");
-}
 // 处理消息并回复
 async function processAndReply(params) {
     const { target, msg } = params;
@@ -1347,7 +1324,7 @@ async function processAndReply(params) {
     const finalTextChunkLimit = core.channel.text.resolveTextChunkLimit(config, "timbot", account.accountId, {
         fallbackLimit: TIMBOT_FINAL_TEXT_CHUNK_LIMIT,
     });
-    const splitFinalText = (text) => splitTextByPreferredBreaks(text, finalTextChunkLimit);
+    const splitFinalText = (text) => splitTextByFixedLength(text, finalTextChunkLimit);
     logVerbose(target, `开始生成回复 -> ${fromAccount}`);
     logVerbose(target, `转发给 OpenClaw: RawBody=${rawBody.slice(0, 100)}, SessionKey=${ctxPayload.SessionKey}, From=${ctxPayload.From}`);
     // C2C 传输适配器
@@ -1486,6 +1463,7 @@ async function processGroupAndReply(params) {
         MessageSid: msg.MsgKey ?? String(msg.MsgSeq ?? ""),
         OriginatingChannel: "timbot",
         OriginatingTo: `timbot:group:${groupId}`,
+        WasMentioned: true,
     });
     await core.channel.session.recordInboundSession({
         storePath,
@@ -1503,7 +1481,7 @@ async function processGroupAndReply(params) {
     const finalTextChunkLimit = core.channel.text.resolveTextChunkLimit(config, "timbot", account.accountId, {
         fallbackLimit: TIMBOT_FINAL_TEXT_CHUNK_LIMIT,
     });
-    const splitFinalText = (text) => splitTextByPreferredBreaks(text, finalTextChunkLimit);
+    const splitFinalText = (text) => splitTextByFixedLength(text, finalTextChunkLimit);
     logVerbose(target, `开始生成群回复 -> group:${groupId}`);
     // Group 传输适配器
     const transport = {
@@ -1590,7 +1568,6 @@ export async function handleTimbotWebhookRequest(req, res) {
     const targets = webhookTargets.get(path);
     if (!targets || targets.length === 0)
         return false;
-    const firstTarget = targets[0];
     // 只处理 POST 请求
     if (req.method !== "POST") {
         logSimple("warn", `收到非 POST 请求: ${req.method} ${path}`);
@@ -1613,27 +1590,16 @@ export async function handleTimbotWebhookRequest(req, res) {
         return true;
     }
     const msg = bodyResult.value;
-    // 根据 SdkAppid 或 To_Account 匹配目标账号
-    const target = targets.find((candidate) => {
-        if (!candidate.account.configured)
-            return false;
-        // 如果 URL 带了 SdkAppid，校验是否匹配
-        if (sdkAppId && candidate.account.sdkAppId !== sdkAppId)
-            return false;
-        // 如果配置了 botAccount，校验 To_Account 是否匹配
-        if (candidate.account.botAccount && msg.To_Account) {
-            return candidate.account.botAccount === msg.To_Account;
-        }
-        return true;
-    }) ?? firstTarget;
-    if (!target.account.configured) {
-        logSimple("warn", `账号 ${target.account.accountId} 未配置，跳过处理`);
-        // 即使未配置也返回成功，避免腾讯 IM 重试
-        jsonOk(res, { ActionStatus: "OK", ErrorCode: 0, ErrorInfo: "" });
-        return true;
+    logSimple("info", `webhook 消息详情: callback=${msg.CallbackCommand || "-"}, To_Account=${msg.To_Account || "-"}, AtRobots_Account=${JSON.stringify(msg.AtRobots_Account ?? [])}, From_Account=${msg.From_Account || "-"}, GroupId=${msg.GroupId || "-"}`);
+    const sdkMatchedTargets = matchTimbotWebhookTargetsBySdkAppId(targets, sdkAppId);
+    let target = selectTimbotWebhookTarget({ targets: sdkMatchedTargets, msg });
+    if (!target && sdkMatchedTargets.length === 1) {
+        target = sdkMatchedTargets[0];
     }
     // 签名验证
-    if (target.account.token) {
+    const signatureTargets = (target ? [target] : sdkMatchedTargets)
+        .filter((candidate) => candidate.account.configured && candidate.account.token);
+    if (signatureTargets.length > 0) {
         // 1. 超时校验：RequestTime 与当前时间相差超过 60 秒则拒绝
         const requestTimestamp = parseInt(requestTime, 10);
         const nowTimestamp = Math.floor(Date.now() / 1000);
@@ -1645,18 +1611,41 @@ export async function handleTimbotWebhookRequest(req, res) {
             return true;
         }
         // 2. 签名校验：sha256(token + requestTime)
-        const expectedSign = createHash("sha256")
-            .update(target.account.token + requestTime)
-            .digest("hex");
-        if (sign.length !== expectedSign.length
-            || !timingSafeEqual(Buffer.from(sign), Buffer.from(expectedSign))) {
+        const verifiedTargets = signatureTargets.filter((candidate) => {
+            const expectedSign = createHash("sha256")
+                .update(candidate.account.token + requestTime)
+                .digest("hex");
+            return (sign.length === expectedSign.length
+                && timingSafeEqual(Buffer.from(sign), Buffer.from(expectedSign)));
+        });
+        if (verifiedTargets.length === 0) {
+            const expectedSign = createHash("sha256")
+                .update(signatureTargets[0].account.token + requestTime)
+                .digest("hex");
             logSimple("error", `签名验证失败: 收到=${sign.slice(0, 16)}..., 预期=${expectedSign.slice(0, 16)}...`);
             res.statusCode = 403;
             res.end("Signature verification failed");
             return true;
         }
+        if (!target && verifiedTargets.length === 1) {
+            target = verifiedTargets[0];
+        }
+    }
+    if (!target) {
+        const callbackCommand = msg.CallbackCommand ?? "";
+        const mentions = extractMentionedBotAccounts(extractTextFromMsgBody(msg.MsgBody));
+        logSimple("warn", `未能唯一匹配 webhook 账号，跳过处理: callback=${callbackCommand || "-"}, sdkAppId=${sdkAppId || "-"}, to=${msg.To_Account?.trim() || "-"}, group=${msg.GroupId?.trim() || "-"}, mentions=${mentions.join(",") || "-"}`);
+        jsonOk(res, { ActionStatus: "OK", ErrorCode: 0, ErrorInfo: "" });
+        return true;
+    }
+    if (!target.account.configured) {
+        logSimple("warn", `账号 ${target.account.accountId} 未配置，跳过处理`);
+        // 即使未配置也返回成功，避免腾讯 IM 重试
+        jsonOk(res, { ActionStatus: "OK", ErrorCode: 0, ErrorInfo: "" });
+        return true;
     }
     target.statusSink?.({ lastInboundAt: Date.now() });
+    logSimple("info", `匹配到账号: ${target.account.accountId}, botAccount=${target.account.botAccount || "-"}`);
     const callbackCommand = msg.CallbackCommand ?? "";
     // 立即返回成功响应给腾讯 IM
     jsonOk(res, { ActionStatus: "OK", ErrorCode: 0, ErrorInfo: "" });