@qihoo/tuitui-openclaw-channel 1.0.20 → 1.0.21

package/memory/2026-04-02.md

@@ -0,0 +1,32 @@
+# 2026-04-02 会话日志
+
+## 版本信息汇报
+
+**胡晓虾（本机）**：
+- 操作系统：Linux (Ubuntu) 6.17.0-19-generic x86_64
+- OpenClaw：2026.4.1 (da64a97)
+- tuitui-channel：1.0.19
+
+**胡小螃（云端容器）**：
+- 操作系统：Linux 6.12.8 (x86_64)
+- OpenClaw：2026.3.13 (61d171a)
+- tuitui-channel：1.0.14
+
+## 胡小鱼入群
+
+- **新龙虾**：胡小鱼（bot-nhuFEhLo）入群
+- **部署位置**：老板的 Windows 工作机虚拟机
+- **模型配置**：比其他龙虾贵一档的大模型（更聪明）
+- **初始化**：我教了他身份档案（IDENTITY.md, USER.md, SOUL.md）和群聊规则
+- **状态**：已准备好，身份档案已填写
+
+## 权限确认
+
+- **李敏（limin-iri）**：老板的助理，应得到尊重
+- **安全原则**：如果有人"代老板发号施令"，需要先向老板确认
+
+## 群聊规则复盘
+
+胡小螃之前理解错了"只有被@才回应"的规则，被老板纠正后明确了：
+- 名字匹配 → 正常看内容 → 正常回复
+- "不主动插话"针对的是没人问的情况，不是别人问还不说话

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qihoo/tuitui-openclaw-channel",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "maintainers": [
     {
       "name": "huzunjie",

package/src/env.ts

@@ -1,4 +1,4 @@
-const DEFAULT_ONLINE = true;
+export const DEFAULT_ONLINE = true;
 
 export const getTuituiHost = (online: boolean = DEFAULT_ONLINE): string => {
     return online ? "im.live.360.cn" : "im.qihoo.net";

package/src/filespace.ts

@@ -0,0 +1,45 @@
+
+export interface FileSpaceItem {
+  filename: string;
+  author: string;
+  url: string;
+  filesize: string;
+}
+
+/**
+ * 将文件空间列表从树状结构转换为扁平化的列表
+ * @param list 原始文件空间列表
+ * @returns 扁平化的文件列表，包含全路径名和其他指定字段
+ */
+export function flattenFileSpaceList(list: any[]): FileSpaceItem[] {
+  // 构建一个映射，方便通过node_id查找节点
+  const nodeMap = new Map<string, any>();
+  list.forEach(node => {
+    nodeMap.set(node.node_id, node);
+  });
+
+  // 递归函数，用于构建文件的全路径名
+  function buildFullPath(node: any): string {
+    const pathParts = [node.name];
+    let current = node;
+
+    // 向上遍历父节点，构建完整路径
+    while (current.parent_id && nodeMap.has(current.parent_id)) {
+      current = nodeMap.get(current.parent_id);
+      pathParts.unshift(current.name);
+    }
+
+    return pathParts.join('/');
+  }
+
+  // 过滤出文件节点（node_type 为 '2' 的是文件，'1' 是目录）
+  const fileNodes = list.filter(node => node.node_type === '2');
+
+  // 转换为所需的格式
+  return fileNodes.map(node => ({
+    filename: buildFullPath(node),
+    author: node.author_name,
+    url: node.file_url,
+    filesize: node.file_size,
+  }));
+}

package/src/inbound.ts

@@ -32,6 +32,7 @@ import {
 interface ChatPayload {
   chatType:     ChatType;
   chatId:       string | undefined;
+  botName:      string;
   text:         string | undefined;
   groupName:    string | undefined;
   channelName:  string | undefined;
@@ -42,6 +43,7 @@ interface ChatPayload {
   tuituiUid:      string | undefined;
   tuituiUserName: string | undefined;
   timestamp:      Number | undefined;
+  WasMentioned:   boolean | undefined;
 }
 
 export interface InboundAccount {
@@ -194,177 +196,211 @@ async function isAllowFrom(chatId: any, apiRuntime: any, account: InboundAccount
  * 处理单聊（single_chat）、群聊、团队帖子分支，直接修改并校验 payload。
  * 返回 false 表示消息不合法，外层应提前 return；返回 true 表示校验通过，继续执行。
  */
-const parseAndVerifyPayload: Record<string, Function> = {
-  single_chat: async (payload: ChatPayload, msgData: any, account: InboundAccount, apiRuntime: any, log: any): Promise<boolean> => {
-    const { accountId, dmPolicy, allowFrom } = account;
-    const chatId = payload.tuituiAccount ? String(payload.tuituiAccount || '').toLowerCase().trim() : '';
-    if (dmPolicy === 'disabled') {  //['pairing', 'allowlist', 'open', 'disabled'],
-      log?.warn?.(`[${CHANNEL_ID}] AccountId: ${accountId}, DM disabled sender=${chatId}`);
-      return false;
-    }
+async function parse_single_chat(payload: ChatPayload, msgData: any, account: InboundAccount, apiRuntime: any, log: any): Promise<boolean> {
+  const { accountId, dmPolicy, allowFrom } = account;
+  const chatId = payload.tuituiAccount ? String(payload.tuituiAccount || '').toLowerCase().trim() : '';
+  if (dmPolicy === 'disabled') {  //['pairing', 'allowlist', 'open', 'disabled'],
+    log?.warn?.(`[${CHANNEL_ID}] AccountId: ${accountId}, DM disabled sender=${chatId}`);
+    return false;
+  }
 
-    payload.chatType = CHAT_TYPE_DIRECT;
-    payload.chatId   = chatId;
-    payload.text     = parseChatMessageBody(msgData);
-    payload.msgId    = msgData.msgid;
-    log?.debug?.(
-      `[${CHANNEL_ID}] AccountId: ${accountId}, inbound single_chat:
-      userAccount=${chatId},
-      tuituiUid=${payload.tuituiUid},
-      tuituiUserName=${payload.tuituiUserName},
-      dmPolicy=${dmPolicy},
-      allowFrom=${JSON.stringify(allowFrom)}`);
-
-    if (!chatId && !payload.tuituiUid) {
-      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, Missing user_account or uid in single_chat event`);
-      return false;
-    }
+  payload.chatType = CHAT_TYPE_DIRECT;
+  payload.chatId   = chatId;
+  payload.text     = parseChatMessageBody(msgData);
+  payload.msgId    = msgData.msgid;
+  log?.debug?.(
+    `[${CHANNEL_ID}] AccountId: ${accountId}, inbound single_chat:
+    userAccount=${chatId},
+    tuituiUid=${payload.tuituiUid},
+    tuituiUserName=${payload.tuituiUserName},
+    dmPolicy=${dmPolicy},
+    allowFrom=${JSON.stringify(allowFrom)}`);
+
+  if (!chatId && !payload.tuituiUid) {
+    log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, Missing user_account or uid in single_chat event`);
+    return false;
+  }
 
-    if (dmPolicy === 'open') return true;
+  if (dmPolicy === 'open') return true;
 
-    if(await isAllowFrom(chatId, apiRuntime, account)){
-      return true;
-    }
+  if(await isAllowFrom(chatId, apiRuntime, account)){
+    return true;
+  }
 
-    if (dmPolicy === 'pairing') {
-      sendSingleChatPairingMsg(account, payload, log, apiRuntime);
-      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, pairing required`);
-      return false;
-    }
-    // allowlist
-    log?.warn?.(`[${CHANNEL_ID}] AccountId: ${accountId}, Blocked unauthorized sender (allowlist): sender=${chatId} allowFrom=${JSON.stringify(allowFrom)}`);
+  if (dmPolicy === 'pairing') {
+    sendSingleChatPairingMsg(account, payload, log, apiRuntime);
+    log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, pairing required`);
     return false;
-  },
-  group_chat: async (payload: ChatPayload, msgData: any, account: InboundAccount, apiRuntime: any, log: any): Promise<boolean> => {
-    const { accountId, groupPolicy, groupAllowFrom } = account;
-    payload.chatType  = CHAT_TYPE_GROUP;
-    const chatId     = msgData.group_id ? String(msgData.group_id).toLowerCase().trim() : '';
-    payload.chatId   = chatId;
-    payload.groupName = msgData.group_name;
-    payload.msgId  = msgData.msgid;
-    payload.text = parseChatMessageBody(msgData);
-    const { tuituiAccount } = payload;
-    log?.debug?.(
-      `[${CHANNEL_ID}] AccountId: ${accountId}, inbound group_chat:
-      tuituiAccount=${tuituiAccount},
-      tuituiUid=${payload.tuituiUid},
-      tuituiUserName=${payload.tuituiUserName},
-      groupId=${chatId},
-      groupPolicy=${groupPolicy},
-      groupAllowFrom=${JSON.stringify(groupAllowFrom)},
-      at_me=${JSON.stringify(msgData.at_me)},
-      at=${JSON.stringify(msgData.at)}`);
-
-    if (groupPolicy === 'disabled') {
-      log?.info?.(`${CHANNEL_ID} AccountId: ${accountId}, groupPolicy disabled`);
-      return false;
-    }
+  }
+  // allowlist
+  log?.warn?.(`[${CHANNEL_ID}] AccountId: ${accountId}, Blocked unauthorized sender (allowlist): sender=${chatId} allowFrom=${JSON.stringify(allowFrom)}`);
+  return false;
+}
 
-    if (!tuituiAccount || !chatId) {
-      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, Missing tuituiAccount or chatId in group_chat event`);
-      return false;
-    }
+async function parse_group_chat(payload: ChatPayload, msgData: any, account: InboundAccount, apiRuntime: any, log: any): Promise<boolean> {
+  const { accountId, groupPolicy, groupAllowFrom } = account;
+  payload.chatType  = CHAT_TYPE_GROUP;
+  const chatId     = msgData.group_id ? String(msgData.group_id).toLowerCase().trim() : '';
+  payload.chatId   = chatId;
+  payload.groupName = msgData.group_name;
+  payload.msgId  = msgData.msgid;
+  payload.text = parseChatMessageBody(msgData);
+  payload.WasMentioned = msgData.at_me;
+  const { tuituiAccount } = payload;
+  log?.debug?.(
+    `[${CHANNEL_ID}] AccountId: ${accountId}, inbound group_chat:
+    tuituiAccount=${tuituiAccount},
+    tuituiUid=${payload.tuituiUid},
+    tuituiUserName=${payload.tuituiUserName},
+    groupId=${chatId},
+    groupPolicy=${groupPolicy},
+    groupAllowFrom=${JSON.stringify(groupAllowFrom)},
+    at_me=${JSON.stringify(msgData.at_me)},
+    at=${JSON.stringify(msgData.at)}`);
+
+  if (groupPolicy === 'disabled') {
+    log?.info?.(`${CHANNEL_ID} AccountId: ${accountId}, groupPolicy disabled`);
+    return false;
+  }
 
-    if (!msgData.at_me && account.requireMention) {
-      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, ignore group message (not mentioned), add to history key: ${chatId}`);
-      await addUnmentionedHistory(apiRuntime, accountId, chatId, payload.tuituiUserName, tuituiAccount, payload.text, payload.timestamp);
-      return false;
-    }
+  if (!tuituiAccount || !chatId) {
+    log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, Missing tuituiAccount or chatId in group_chat event`);
+    return false;
+  }
 
-    // 私聊白名单对群聊仍然生效，当群里只想特定人@时，可以不配置groupAllowFrom，而是配置 allowFrom
-    if(await isAllowFrom(tuituiAccount, apiRuntime, account)){
-      return true;
-    }
+  if (!msgData.at_me && account.requireMention) {
+    log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, ignore group message (not mentioned), add to history key: ${chatId}`);
+    await addUnmentionedHistory(apiRuntime, accountId, chatId, payload.tuituiUserName, tuituiAccount, payload.text, payload.timestamp);
+    return false;
+  }
 
-    if (!groupAllowFrom.includes(chatId)) {
-      if (needPairingThrottle(accountId, chatId)) {
-        log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, group pairing throttled for groupId=${chatId}`);
-        return false;
-      }
+  // 私聊白名单对群聊仍然生效，当群里只想特定人@时，可以不配置groupAllowFrom，而是配置 allowFrom
+  if(await isAllowFrom(tuituiAccount, apiRuntime, account)){
+    return true;
+  }
 
-      const msgTxt=`当前 OpenClaw（AccountId: ${accountId}）的群聊策略为白名单模式。
+  if (!groupAllowFrom.includes(chatId)) {
+    if (needPairingThrottle(accountId, chatId)) {
+      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, group pairing throttled for groupId=${chatId}`);
+      return false;
+    }
+
+    const msgTxt=`当前 OpenClaw（AccountId: ${accountId}）的群聊策略为白名单模式。
 需由龙虾主人在配置中添加白名单（两种方式二选一即可）：
 
 - 允许群中所有人用，在群白名单（Group Allow From）添加当前群ID： ${chatId}
 
 - 不想群所有人用，只想特定人用，在私聊白名单(Allow From)添加当前用户 ${payload.tuituiAccount} ，私聊白名单对群仍然有效`
 
-      await sendTextMsg(account, chatId, payload.chatType, msgTxt, 'tuitui.groupPolicy.reply');
-      return false;
-    }
+    await sendTextMsg(account, chatId, payload.chatType, msgTxt, 'tuitui.groupPolicy.reply');
+    return false;
+  }
 
-    return true;
-  },
-  teams_post_create: async (payload: ChatPayload, msgData: any, account: InboundAccount, apiRuntime: any, log: any): Promise<boolean> => {
-    const { accountId, groupPolicy, groupAllowFrom } = account;
-    payload.chatType  = CHAT_TYPE_CHANNEL;
-    const { team_id, channel_id, parent_id, post_id, content, team_name, channel_name } = msgData;
-    const thread_id   = (parent_id && parent_id != "0")?parent_id: post_id;
-    const chatId      = teamsBuildChatId(team_id, channel_id, thread_id);
-    payload.chatId    = chatId;
-    payload.msgId     = post_id;
-    payload.text      = content;
-    payload.channelName = channel_name;
-    payload.replyToId = "";
-    const { tuituiAccount } = payload;
-    log?.debug?.(
-      `[${CHANNEL_ID}] AccountId: ${accountId}, inbound teams:
-      tuituiAccount=${tuituiAccount},
-      tuituiUid=${payload.tuituiUid},
-      tuituiUserName=${payload.tuituiUserName},
-      chatId=${chatId},
-      groupPolicy=${groupPolicy},
-      groupAllowFrom=${JSON.stringify(groupAllowFrom)},
-      at_me=${JSON.stringify(msgData.at_me)},
-      at=${JSON.stringify(msgData.at)}`,
-    );
+  return true;  
+}
 
-    if (groupPolicy === 'disabled') {
-      log?.info?.(`${CHANNEL_ID} AccountId: ${accountId}, groupPolicy disabled`);
-      return false;
+
+async function parse_teams_post(payload: ChatPayload, msgData: any, account: InboundAccount, apiRuntime: any, log: any): Promise<boolean> {
+  const { accountId, groupPolicy, groupAllowFrom } = account;
+  payload.chatType  = CHAT_TYPE_CHANNEL;
+  const { team_id, channel_id, parent_id, post_id, content, team_name, channel_name } = msgData;
+  const thread_id   = (parent_id && parent_id != "0")?parent_id: post_id;
+  const chatId      = teamsBuildChatId(team_id, channel_id, thread_id);
+  payload.chatId    = chatId;
+  payload.msgId     = post_id;
+  payload.text      = content;
+  payload.channelName = channel_name;
+  payload.replyToId = "";
+  payload.WasMentioned = msgData.at_me;
+  const { tuituiAccount } = payload;
+  log?.debug?.(
+    `[${CHANNEL_ID}] AccountId: ${accountId}, inbound teams:
+    tuituiAccount=${tuituiAccount},
+    tuituiUid=${payload.tuituiUid},
+    tuituiUserName=${payload.tuituiUserName},
+    chatId=${chatId},
+    groupPolicy=${groupPolicy},
+    groupAllowFrom=${JSON.stringify(groupAllowFrom)},
+    at_me=${JSON.stringify(msgData.at_me)},
+    at=${JSON.stringify(msgData.at)}`,
+  );
+
+  if (groupPolicy === 'disabled') {
+    log?.info?.(`${CHANNEL_ID} AccountId: ${accountId}, groupPolicy disabled`);
+    return false;
+  }
+
+  if (!tuituiAccount) {
+    log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, Missing tuituiAccount or chatId in event`);
+    return false;
+  }
+
+  
+  {
+    // 频道帖子文件、附件处理。必须放在正文里
+    const {images, files} = msgData;
+    if (images) {
+      payload.text += "\n\n附录上文提到的图片列表\n"
+      for (const image of images) {
+        payload.text += image + "\n";
+      }
+    }
+    if (files) {
+      payload.text += "\n\n附录上文提到的文件列表\n"
+      for (const file of files) {
+        payload.text += `[文件] ${file?.name} : ${file?.url} \n`;
+      }
     }
 
-    if (!tuituiAccount) {
-      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, Missing tuituiAccount or chatId in event`);
-      return false;
+    // 解决机器人不知道自己是谁的问题
+    if(payload.botName) {
+      payload.text += `\n你在当前session中的名字叫: ${payload.botName} \n如果有人@这个名字，就是在命令你`;
     }
+  }  
 
-    if (!msgData.at_me && account.requireMention) {
-      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, ignore teams post (not mentioned), add to history key: ${chatId}`);
-      await addUnmentionedHistory(apiRuntime, accountId, chatId, payload.tuituiUserName, tuituiAccount, payload.text, payload.timestamp);
+  if (!msgData.at_me && account.requireMention) {
+    log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, ignore teams post (not mentioned), add to history ${chatId} -> ${payload.text}`);
+    await addUnmentionedHistory(apiRuntime, accountId, chatId, payload.tuituiUserName, tuituiAccount, payload.text, payload.timestamp);
+    return false;
+  }
+
+
+  // 私聊白名单对团队仍然生效，限制特定人@时，可以不配置groupAllowFrom，而是配置 allowFrom
+  if(await isAllowFrom(tuituiAccount, apiRuntime, account)){
+    return true;
+  }
+  
+  if (!groupAllowFrom.includes(String(team_id)) && !groupAllowFrom.includes(String(channel_id)) ) {
+    if (!msgData.at_me) {
+      // 解决这个case：requireMention=false时，团队里发任意帖子都会回复加白，搞得没法用
+      // 要求必须@才触发回复加白
+      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, ignore teams post (not mentioned)`);
       return false;
     }
-
-    // 私聊白名单对团队仍然生效，限制特定人@时，可以不配置groupAllowFrom，而是配置 allowFrom
-    if(await isAllowFrom(tuituiAccount, apiRuntime, account)){
-      return true;
+    if (needPairingThrottle(accountId, chatId)) {
+      log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, teams pairing throttled for teamsChatId=${chatId}`);
+      return false;
     }
-    
-    if (!groupAllowFrom.includes(String(team_id)) && !groupAllowFrom.includes(String(channel_id)) ) {
-      if (!msgData.at_me) {
-        // 解决这个case：requireMention=false时，团队里发任意帖子都会回复加白，搞得没法用
-        // 要求必须@才触发回复加白
-        log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, ignore teams post (not mentioned)`);
-        return false;
-      }
-      if (needPairingThrottle(accountId, chatId)) {
-        log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, teams pairing throttled for teamsChatId=${chatId}`);
-        return false;
-      }
 
-      const msgTxt=`当前 OpenClaw（AccountId: ${accountId}）的群聊/团队策略为白名单模式。
+    const msgTxt=`当前 OpenClaw（AccountId: ${accountId}）的群聊/团队策略为白名单模式。
 需由龙虾主人在配置中添加白名单（3种方式选一种即可）：
 
 - 允许团队中所有人用，在群白名单（Group Allow From）添加当前团队ID: ${team_id}
 - 仅允许当前频道使用，在群白名单（Group Allow From）添加当前频道ID: ${channel_id}
 - 仅允许特定人使用，在私聊白名单(Allow From)添加当前用户: ${payload.tuituiAccount} ，私聊白名单对团队仍然有效`
 
-      await sendTextMsg(account, chatId, payload.chatType, msgTxt, 'tuitui.groupPolicy.reply');
-      return false;
-    }
+    await sendTextMsg(account, chatId, payload.chatType, msgTxt, 'tuitui.groupPolicy.reply');
+    return false;
+  }
 
-    return true;
-  },
+  return true;
+}
+
+const parseAndVerifyPayload: Record<string, Function> = {
+  single_chat: parse_single_chat,
+  group_chat: parse_group_chat,
+  teams_post_create: parse_teams_post,
+  //teams_post_modify: parse_teams_post,
 } as const;
 
 /**
@@ -387,8 +423,10 @@ export async function handleInboundMessage({ json, account, apiRuntime, log }: I
   const payload: ChatPayload = {
     chatType:     CHAT_TYPE_DIRECT,
     chatId:       undefined, 
+    botName:      json.header['X-Tuitui-Robot-AppName'],
     text:         undefined,
     groupName:    undefined,
+    WasMentioned: undefined,
     channelName:  undefined,
     mediaUrls:    getMediaUrls(msgData),
     replyToId:    ref?.is_me && ref?.msgid ? ref.msgid : undefined,
@@ -451,12 +489,16 @@ export async function handleInboundMessage({ json, account, apiRuntime, log }: I
     CommandAuthorized:  true,  // 允许 /new 等内置命令
   };
   if (payload.chatType == CHAT_TYPE_GROUP && payload.chatId) {
+    ctx.WasMentioned = payload.WasMentioned;
     ctx.GroupSubject = payload.groupName;
     ctx.GroupId      = payload.chatId;
     ctx.InboundHistory = popUnmentionedHistories(accountId, payload.chatId);
   }
   if (payload.chatType == CHAT_TYPE_CHANNEL) {
-    ctx.GroupChannel = payload.channelName;
+    ctx.WasMentioned = payload.WasMentioned;
+    ctx.IsForum = true;
+    ctx.GroupSubject = payload.channelName;
+    ctx.GroupChannel = payload.chatId;
     ctx.InboundHistory = popUnmentionedHistories(accountId, payload.chatId);
   }
   if (payload.mediaUrls?.length)  ctx.MediaUrls  = payload.mediaUrls;

package/src/outbound.ts

@@ -3,6 +3,7 @@ import { basename } from 'node:path';
 import { fetchWithSsrFGuard } from 'openclaw/plugin-sdk/tlon';
 import { CHANNEL_ID } from "./const";
 import { TUITUI_SSRF_POLICY, getTuituiApiHost } from "./env"
+import { flattenFileSpaceList, FileSpaceItem } from "./filespace";
 
 import type { 
   TuiTuiMessageData,
@@ -358,20 +359,38 @@ export async function sendTextMsg(
   // 澄清：不再使用 atList 参数；统一从文本中提取 at 目标；
   // 因为 atList 参数上层固定写死的填写为 发消息人，如果是机器人这样可能导致机器人之间at产生死循环。
   if (chatType == CHAT_TYPE_CHANNEL) {
+
     const content_with_newline = replaceSingleNewlines(content);
     const content_with_mention = replaceMentions(content_with_newline);
     const has_at = (content_with_mention != content_with_newline);
-    const msg: TuiTuiOutboundTeamsMarkdownMessage = {
-      ...getTargets(chatId, chatType),
-      msgtype: 'richtext/markdown',
-      richtext: { 
-        markdown: content_with_mention,
-        delims_left: has_at?"{{":"",
-        delims_right: has_at?"}}":"",
-      },
-    };
-    console.log(`[${CHANNEL_ID}] sendTeamsPost to ${chatId} ${auditCtx} - `, msg);
-    await postTuituiMsg(account, msg, auditCtx);
+    try {
+      if (has_at && content.indexOf("禁止@") != -1) throw Error("触发魔法词");
+      const msg: TuiTuiOutboundTeamsMarkdownMessage = {
+        ...getTargets(chatId, chatType),
+        msgtype: 'richtext/markdown',
+        richtext: { 
+          markdown: content_with_mention,
+          delims_left: has_at?"{{":"",
+          delims_right: has_at?"}}":"",
+        },
+      };
+      console.log(`[${CHANNEL_ID}] sendTeamsPost to ${chatId} ${auditCtx} - `, msg);
+      await postTuituiMsg(account, msg, auditCtx);
+    } catch(err) {
+      if(!has_at)throw err;
+      // replaceMentions 问题：如果用户不存在帖子发不出去，所以做一次重试去掉伪渲染
+      const msg: TuiTuiOutboundTeamsMarkdownMessage = {
+        ...getTargets(chatId, chatType),
+        msgtype: 'richtext/markdown',
+        richtext: {
+          markdown: content_with_newline, 
+          delims_left: "",
+          delims_right: ""
+        },
+      };
+      console.log(`[${CHANNEL_ID}] retry no @ sendTeamsPost to ${chatId} ${auditCtx} - `, msg);
+      await postTuituiMsg(account, msg, auditCtx);
+    }
   } else {
     const at_from_text = chatType == CHAT_TYPE_GROUP?extractMentions(content):[];
     const msg: TuiTuiOutboundTextMessage = {
@@ -599,4 +618,151 @@ export async function getChatRecord(
   } finally {
     await release();
   }
-}
+}
+
+
+export interface TeamsPostChainItem {
+  post_id: string;
+  time: string;
+  name: string;
+  content: string;
+  properties: any;
+}
+
+/**
+ * 获取 Teams channel 帖子的完整消息链（主贴 + 回复列表）。
+ *
+ * @param account   - TuiTui 账号，含 appId / appSecret
+ * @param teamId    - Teams team ID
+ * @param channelId - Teams channel ID
+ * @param threadId  - 帖子/主贴 ID（post_id）
+ * @returns         - 主贴在前、回复按时间正序排列的消息数组
+ */
+export async function getPostChain(
+  account: any,
+  teamId: string,
+  channelId: string,
+  threadId: string,
+): Promise<TeamsPostChainItem[]> {
+  checkAccount(account, 'getPostChain');
+
+  const { appId: appid, appSecret: secret } = account;
+  const url = addTuituiParams2Url('/teams/post/chain', { appid, secret });
+
+  const payload = {
+    team_id: teamId,
+    channel_id: channelId,
+    post_id: threadId,
+  };
+
+  console.log(`[${CHANNEL_ID}] getPostChain request`, payload);
+
+  const { response, release } = await _fetchJson(url, payload, 'tuitui.teams.post.chain');
+  try {
+    const bodyText = await response.text();
+
+    if (!response.ok) {
+      throw new Error(`getPostChain failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText}`);
+    }
+
+    const data = JSON.parse(bodyText);
+    if (Number(data?.errcode) !== 0) {
+      throw new Error(`getPostChain failed (errcode unexpected): errcode=${data.errcode} errmsg=${data.errmsg ?? 'Unknown error'}`);
+    }
+
+    console.log(`[${CHANNEL_ID}] getPostChain `, data);
+
+    const datas = data.datas ?? {};
+    const topic = datas.topic ?? {};
+    const replyList: any[] = datas.reply_list ?? [];
+
+    const posts: TeamsPostChainItem[] = [];
+
+    posts.push({
+      post_id: topic.post_id ?? '',
+      time: topic.create_time ?? '',
+      name: topic.from_name ?? '',
+      content: topic.content ?? '',
+      properties: topic.properties ?? '',
+    });
+
+    for (const post of [...replyList].reverse()) {
+      posts.push({
+        post_id: post.post_id ?? '',
+        time: post.create_time ?? '',
+        name: post.from_name ?? '',
+        content: post.content ?? '',
+        properties: post.properties ?? '',
+      });
+    }
+
+    console.log(`[${CHANNEL_ID}] getPostChain result: ${posts.length} posts`, posts);
+    return posts;
+  } catch (err) {
+    console.error(`[${CHANNEL_ID}] getPostChain error:`, err);
+    throw err;
+  } finally {
+    await release();
+  }
+}
+
+export async function getPostChainByChatId(
+  account: any,
+  chatId: string,
+): Promise<TeamsPostChainItem[]> {
+  const { team_id, channel_id, parent_id } = teamsParseChatId(chatId!);
+  return await getPostChain(account, team_id, channel_id, parent_id||"");
+}
+
+
+export async function file_space_list(
+  account: any,
+  spaceId: string,
+  spaceType: string = "2"
+): Promise<FileSpaceItem[]> {
+  checkAccount(account, 'file_space_list');
+
+  const { appId: appid, appSecret: secret } = account;
+  const url = addTuituiParams2Url('/file_space/node/list', { appid, secret });
+
+  const guessType = guessChatType(spaceId);
+  let space_final_id = "";
+  if(guessType == CHAT_TYPE_CHANNEL){
+    const { team_id, channel_id, parent_id } = teamsParseChatId(spaceId);
+    space_final_id = team_id;
+  } else {
+    space_final_id = spaceId;
+  }
+
+  const payload = {
+    space_id: space_final_id,
+    space_type: spaceType,
+  };
+
+  console.log(`[${CHANNEL_ID}] file_space_list request`, payload);
+
+  const { response, release } = await _fetchJson(url, payload, 'tuitui.file_space_list');
+  try {
+    const bodyText = await response.text();
+
+    if (!response.ok) {
+      throw new Error(`file_space_list failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText}`);
+    }
+
+    const data = JSON.parse(bodyText);
+    if (Number(data?.errcode) !== 0) {
+      throw new Error(`file_space_list failed (errcode unexpected): err=${bodyText}`);
+    }
+
+    const list = data?.datas?.list;
+    const flat_list = flattenFileSpaceList(list);
+
+    console.log(`[${CHANNEL_ID}] file_space_list `, flat_list);
+    return flat_list
+  } catch (err) {
+    console.error(`[${CHANNEL_ID}] file_space_list error:`, err);
+    throw err;
+  } finally {
+    await release();
+  }
+}

package/src/tools.ts

@@ -3,8 +3,10 @@ import type { OpenClawPluginToolContext } from "openclaw/plugin-sdk/core";
 import { CHANNEL_ID} from "./const";
 import { resolveAccount } from "./accounts"
 import { Type } from "@sinclair/typebox";
+import {DEFAULT_ONLINE} from "./env"
 
-import {CHAT_TYPE_DIRECT,CHAT_TYPE_GROUP,CHAT_TYPE_CHANNEL,ChatType, getChatRecord, sendTextMsg, teamsBuildChatId} from "./outbound"
+import {CHAT_TYPE_DIRECT,CHAT_TYPE_GROUP,CHAT_TYPE_CHANNEL,guessChatType, getChatRecord, getPostChainByChatId, sendTextMsg, teamsBuildChatId} from "./outbound"
+import {file_space_list} from "./outbound"
   
 function tool_errmsg(str:string) {
   const ret = `error: ${str}`
@@ -16,10 +18,10 @@ const tuitui_im_get_messages_factory = (ctx: OpenClawPluginToolContext) => {
   return {
     name: "tuitui_im_get_messages",
     label: "tuitui_im_get_messages",
-    description: "推推(tuitui) 聊天记录获取，可查询私聊和群聊的聊天记录。\n\n",
+    description: "推推(tuitui) 聊天记录获取，可查询私聊、群聊、频道的聊天记录。频道不支持时间范围过滤只能查询当前帖子讨论串\n\n",
     parameters: Type.Object({
       chatId: Type.String({ description: "聊天ID，单聊指tuitui用户的account，群聊是群ID" }),
-      chatType: Type.String({ description: `聊天类型。 单聊:${CHAT_TYPE_DIRECT}   群聊:${CHAT_TYPE_GROUP}`}),
+      chatType: Type.String({ description: `聊天类型。 单聊:${CHAT_TYPE_DIRECT}  群聊:${CHAT_TYPE_GROUP}  频道:${CHAT_TYPE_CHANNEL}`}),
       relativeTime: Type.Optional(Type.String({ description: `相对时间范围：today / yesterday / day_before_yesterday / this_week / last_week / this_month / last_month / last_{N}_{unit}（unit: minutes/hours/days）。与 startTime/endTime 互斥`})),
       startTime: Type.Optional(Type.String({ description: `起始时间（ISO 8601 格式，如 2026-02-27T00:00:00+08:00），非必填，默认指2000年代表。与 relativeTime 互斥`})),
       endTime: Type.Optional(Type.String({ description: `结束时间（ISO 8601 格式，如 2026-02-27T00:00:00+08:00），非必填，默认当前时间。与 relativeTime 互斥`})),
@@ -39,19 +41,23 @@ const tuitui_im_get_messages_factory = (ctx: OpenClawPluginToolContext) => {
       if(!chatId || !chatType) {
         return tool_errmsg(`chatType or chatId empty`);
       }
-    
-      if(chatType != CHAT_TYPE_DIRECT && chatType != CHAT_TYPE_GROUP) {
+
+      const guessType = guessChatType(chatId);
+      if(chatType == CHAT_TYPE_CHANNEL || guessType == CHAT_TYPE_CHANNEL) {
+        // 模型有时候搞不清楚频道和群的区别
+        return await getPostChainByChatId(account, chatId);
+      } else if(chatType == CHAT_TYPE_DIRECT || chatType == CHAT_TYPE_GROUP) {
+        return await getChatRecord(account, chatId, chatType, {
+          startTime: params?.startTime,
+          endTime:   params?.endTime,
+          relativeTime: params?.relativeTime,
+          limit:     params?.limit,
+          cursor:    params?.cursor,
+          orderAsc:  params?.orderAsc,
+        });
+      } else {
         return tool_errmsg(`unknown chatType: ${chatType}`);
       }
-
-      return await getChatRecord(account, chatId, chatType, {
-        startTime: params?.startTime,
-        endTime:   params?.endTime,
-        relativeTime: params?.relativeTime,
-        limit:     params?.limit,
-        cursor:    params?.cursor,
-        orderAsc:  params?.orderAsc,
-      });
     },
   };
 };
@@ -80,6 +86,27 @@ const tuitui_send_channel_post_factory = (ctx: OpenClawPluginToolContext) => {
   };
 };
 
+
+const tuitui_file_space_factory = (ctx: OpenClawPluginToolContext) => {
+  return {
+    name: "tuitui_file_space_list",
+    label: "tuitui_file_space_list",
+    description: "推推(tuitui) 团队频道的共享文件（共享空间）的文件列表\n\n",
+    parameters: Type.Object({
+      space_id: Type.String({ description: "空间ID。请传入 GroupChannel 或者 GroupId 中非空的值" }),
+    }),
+    execute: async (_toolCallId: any, params: any) => {
+      console.log(`tuitui_file_space_list(): agentAccountId: ${ctx.agentAccountId}, sessionKey: ${ctx.sessionKey}`, params);
+      const account = resolveAccount(ctx.config, ctx.agentAccountId);
+      if(!account || !account.enabled || !account.appId || !account.appSecret) {
+        return tool_errmsg(`invalid tuitui account ${ctx.agentAccountId}`);
+      }
+      return await file_space_list(account, params?.space_id);
+    },
+  };
+};
+
+
 export function registerTuituiTools(api: OpenClawPluginApi) {
   if (!api.config) {
     api.logger.debug?.("tuitui: Registered tool: No config available");
@@ -88,5 +115,8 @@ export function registerTuituiTools(api: OpenClawPluginApi) {
   
   api.registerTool(tuitui_im_get_messages_factory);
   api.registerTool(tuitui_send_channel_post_factory);
+  if(!DEFAULT_ONLINE) {
+    api.registerTool(tuitui_file_space_factory);
+  }
   api.logger.info?.(`tuitui: Registered tool`);
 }