@qihoo/tuitui-openclaw-channel 1.0.20 → 1.0.22

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.22",
   "maintainers": [
     {
       "name": "huzunjie",

package/src/channel.ts

@@ -8,7 +8,6 @@ import { setAccountEnabledInConfigSection, deleteAccountFromConfigSection } from
 import { CHANNEL_ID, CHANNEL_NAME } from "./const";
 import { handleInboundMessage } from './inbound';
 import {
-  checkAccount,
   sendTextMsg,
   sendPageMsg,
   sendMediaMsg,
@@ -189,7 +188,6 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
 
       sendText: async ({ cfg, to, text, accountId, replyToId, threadId }: any) => {
         const account = resolveAccount(cfg, accountId);
-        checkAccount(account);
         
         const chatId = String(to || '').trim();
         const chatType = guessChatType(chatId);
@@ -202,8 +200,6 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
 
       sendCustom: async ({ cfg, to, payload, accountId, account, chatType, groupId }: any) => {
         account = account || resolveAccount(cfg, accountId);
-        checkAccount(account, 'send custom message');
-
         // If it's a page message, we need to construct it
         if (payload?.msgtype !== 'page') {
           throw new Error(`[${CHANNEL_ID}] unsupported custom message type: ${payload?.msgtype}`);
@@ -217,7 +213,6 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
 
       sendMedia: async ({ cfg, to, mediaUrl, accountId, account }: any) => {
         account = account || resolveAccount(cfg, accountId);
-        checkAccount(account, 'send media');
 
         const chatId = String(to || '').trim();
         // Determine if this is a group message based on 'to' being all digits (group) or not (direct)

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,
@@ -413,7 +451,11 @@ export async function handleInboundMessage({ json, account, apiRuntime, log }: I
 
   if (account.emojiReaction) {
     // 因为回复较慢，先回复一个表情
-    await tuituiEmojiReaction(account, payload.chatId, payload.chatType, payload.msgId, '收到');
+    try{
+      await tuituiEmojiReaction(account, payload.chatId, payload.chatType, payload.msgId, '收到');
+    } catch (err) {
+      // 出错不影响后续逻辑
+    }
   }
 
   // 路由判断
@@ -451,12 +493,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

@@ -1,8 +1,8 @@
 import { readFileSync, existsSync, statSync } from 'node:fs';
 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 { tuituiRobotApi, downloadUrl } from "./robot_api"
 
 import type { 
   TuiTuiMessageData,
@@ -32,12 +32,6 @@ export function guessChatType(chatId: string): ChatType {
   return CHAT_TYPE_DIRECT;
 }
 
-export function addTuituiParams2Url(urlStr: string, params: any) {
-  const url = new URL(getTuituiApiHost() + urlStr);
-  for (let k in params) url.searchParams.set(k, params[k]);
-  return url.toString();
-}
-
 const mimeTypes: Record<string, string> = {
   jpg: 'image/jpeg',
   jpeg: 'image/jpeg',
@@ -59,61 +53,10 @@ export function getMimeType(filename: string): string {
   return mimeTypes[ext] || 'application/octet-stream';
 }
 
-function _fetch(opts: any): Promise<any> {
-  return fetchWithSsrFGuard({
-    //url: fileSrc,
-    policy: TUITUI_SSRF_POLICY,
-    //auditCtx: "tuitui.media.download",
-    ...opts,
-  })
-}
-function _fetchJson(url: string, json: any, auditCtx: string): Promise<any> {
-  return _fetch({
-    url,
-    init: {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(json),
-    },
-    auditCtx,
-  });
-}
 export async function postTuituiMsg(account: any, json: any, auditCtx: string): Promise<any> {
-  const { appId: appid, appSecret: secret } = account;
-  const { response, release } = await _fetchJson(
-    addTuituiParams2Url('/message/custom/send', { appid, secret }),
-    json,
-    auditCtx,
-  );
-  try {
-    const bodyText = await response.text();
-    const parsed =  JSON.parse(bodyText);
-
-    console.debug(`[${CHANNEL_ID}] ${auditCtx} postTuituiMsg response status=${response.status} ok=${response.ok} body=${bodyText || '<empty>'}`);
-
-    if (!response.ok) {
-      throw new Error(`postTuituiMsg Failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText || '<empty>'}`);
-    }
-
-    if (Number(parsed?.errcode) !== 0) {
-      throw new Error(`postTuituiMsg Failed (errcode unexpected): errcode=${parsed.errcode} errmsg=${parsed.errmsg ?? 'Unknown error'}`);
-    }
-  } catch(err) {
-    console.error(`[${CHANNEL_ID}] ${auditCtx} postTuituiMsg error:`, err, `\njson: ${JSON.stringify(json)}`);
-    // 必须抛出错误，否则上层无法知道失败了（channel机器人问答、agent调用tool的场景）
-    throw err;
-  } finally {
-    await release();
-  }
+  await tuituiRobotApi(account, '/message/custom/send', json);
 }
 
-export function checkAccount(account: any, ctxTips: string = 'send text') {
-  if (!account || !account.appId || !account.appSecret) {
-    throw new Error(`[${CHANNEL_ID}] appId and appSecret are required for ${ctxTips}`);
-  }
-}
-
-
 interface tuituiUploadResult {
   fid: string;
   filename: string;
@@ -132,15 +75,15 @@ interface tuituiUploadResult {
  * @returns The media_id from TuiTui
  */
 export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'image' | 'file'): Promise<tuituiUploadResult> {
-  checkAccount(account, 'uploadFileToTuiTui');
-
-  const { appId: appid, appSecret: secret } = account;
   let fileBuffer: ArrayBuffer;
   let contentType: string;
   let filename: string;
 
+
   // Check if it's a Base64 data URL
   if (/^data\:/.test(fileSrc)) {
+    console.log("uploadFileToTuiTui: Base64 data");
+
     const matches = fileSrc.match(/^data:([^;,]*)(;base64)?,(.*)$/);
     if (!matches) {
       throw new Error(`[${CHANNEL_ID}] Invalid data URL format`);
@@ -167,33 +110,15 @@ export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'i
   }
   // HTTP/HTTPS URL
   else if (/^https?\:/.test(fileSrc)) {
-    const { response, release } = await _fetch({ url: fileSrc, auditCtx: 'tuitui.media.download' });
-    try {
-      if (!response.ok) {
-        throw new Error(`[${CHANNEL_ID}] Failed to download media from ${fileSrc}: ${response.status}`);
-      }
-
-      fileBuffer = await response.arrayBuffer();
-      contentType = response.headers.get('content-type') || 'application/octet-stream';
-
-      filename = 'media';
-      const urlPath = new URL(fileSrc).pathname;
-      const pathParts = urlPath.split('/');
-      const lastPart = pathParts[pathParts.length - 1];
-      if (lastPart) filename = lastPart;
-      const contentDisposition = response.headers.get('content-disposition');
-      if (contentDisposition) {
-        const match = contentDisposition.match(/filename\*?=(?:UTF-8''|")?([^";\r\n]+)"?/i);
-        if (match) {
-          filename = decodeURIComponent(match[1]);
-        }
-      }
-    } finally {
-      await release();
-    }
+    console.log("uploadFileToTuiTui: url", fileSrc);
+    const { buffer, filename: downloadedFilename, contentType: downloadedContentType } = await downloadUrl(fileSrc);
+    fileBuffer = buffer;
+    filename = downloadedFilename;
+    contentType = downloadedContentType;
   }
   // Check if it's a local file path
   else {
+    console.log("uploadFileToTuiTui: local", fileSrc);
     if (!existsSync(fileSrc)) {
       throw new Error(`[${CHANNEL_ID}] Local file not found: ${fileSrc}`);
     }
@@ -217,27 +142,8 @@ export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'i
   const body = new FormData();
   body.append('media', new Blob([fileBuffer], { type: contentType }), filename);
 
-  const { response, release } = await _fetch({
-    url: addTuituiParams2Url('/media/upload', { appid, secret, type }),
-    init: { method: "POST", body },
-    auditCtx: "tuitui.media.upload",
-  });
-  try {
-    if (!response.ok) {
-      throw new Error(`[${CHANNEL_ID}] Failed to upload file to TuiTui: HTTP ${response.status}`);
-    }
-
-    const result: TuiTuiMediaUploadResponse = await response.json();
-    if (result.errcode !== 0 || !result.media_id) {
-      throw new Error(`[${CHANNEL_ID}] file upload failed: ${result.errmsg || "Unknown error"}`);
-    }
-
-    return {fid: result.media_id, filename};
-  } catch(err) {
-    throw err;
-  } finally {
-    await release();
-  }
+  const result: TuiTuiMediaUploadResponse = await tuituiRobotApi(account, '/media/upload', body);
+  return {fid: result.media_id||"", filename};
 }
 
 export async function tuituiEmojiReaction(
@@ -259,21 +165,7 @@ export async function tuituiEmojiReaction(
     payload.toteams = [{ ...teamsParseChatId(target), parent_id: '', post_id: msgid }] as TuiTuiTeamsTarget[];
   }
 
-  const { appId: appid, appSecret: secret } = account;
-  const toTarget = (payload.togroups || payload.tousers || payload.toteams)[0];
-  const _logTxt =`[${CHANNEL_ID}] emoji_reaction "${emoji}"`;
-  console.log(`${_logTxt} request`, toTarget);
-  const sendUrl = addTuituiParams2Url('/message/custom/modify', { appid, secret });
-  const { response, release } = await _fetchJson(sendUrl, payload, 'tuitui.emoji_reaction');
-
-  try {
-    const body = JSON.parse(await response.text().catch(() => "{}"));
-    console.log(`${_logTxt} response errcode=${body.errcode} errmsg=${body.errmsg}`, toTarget);
-  } catch (err) {
-    console.error(`${_logTxt} Caught exception:`, err)
-  } finally {
-    await release();
-  }
+  await tuituiRobotApi(account, '/message/custom/modify', payload);
 }
 
 export function teamsBuildChatId(team_id: string, channel_id:string, thread_id:string) : string{
@@ -358,20 +250,36 @@ 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?"}}":"",
+        },
+      };
+      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: ""
+        },
+      };
+      await postTuituiMsg(account, msg, auditCtx);
+    }
   } else {
     const at_from_text = chatType == CHAT_TYPE_GROUP?extractMentions(content):[];
     const msg: TuiTuiOutboundTextMessage = {
@@ -380,7 +288,6 @@ export async function sendTextMsg(
       at: at_from_text,
       text: { content },
     };
-    console.log(`[${CHANNEL_ID}] sendTextMsg to ${chatId} ${auditCtx} - `, msg);
     await postTuituiMsg(account, msg, auditCtx);
   }
 }
@@ -396,7 +303,7 @@ export async function sendPageMsg(
 ): Promise<void> {
   if (!chatId) return console.error(`[${CHANNEL_ID}] sendPageMsg Error ${auditCtx}: Missing "target"`);
   if(chatType == CHAT_TYPE_CHANNEL) {
-    console.log(`[${CHANNEL_ID}] sendPageMsg to teams notNOT supported ${auditCtx} - `, page);
+    console.log(`[${CHANNEL_ID}] sendPageMsg to teams NOT supported ${auditCtx} - `, page);
     return
   }
   const targets = getTargets(chatId, chatType);
@@ -408,7 +315,6 @@ export async function sendPageMsg(
     togroups,
     page: { ...(page || {})}
   };
-  console.log(`[${CHANNEL_ID}] sendPageMsg ${auditCtx} - `, msg);
   await postTuituiMsg(account, msg, auditCtx);
 }
 
@@ -421,7 +327,6 @@ export async function sendMediaMsg(
   atList?: string[],
 ): Promise<void> {
   if (!chatId) return console.error(`[${CHANNEL_ID}] sendMediaMsg Error ${auditCtx}: Missing "target"`);
-  console.log(`[${CHANNEL_ID}] sendMediaMsg ${chatType} ${chatId} ${auditCtx} uploading`);
   // Check if mediaUrl looks like an image
   const isImage = /^data:image\//i.test(mediaUrl) || /\.(jpg|jpeg|png|gif)(?:$|[?#])/i.test(mediaUrl);
   const mediaType = isImage ? 'image' : 'file';
@@ -443,7 +348,6 @@ export async function sendMediaMsg(
       at: atList || [],
       richtext: { markdown: content, delims_left: "{{", delims_right: "}}"},
     }
-    console.log(`[${CHANNEL_ID}] sendMediaMsg ${chatType} ${chatId} ${auditCtx} - `, msg);
     await postTuituiMsg(account, msg, auditCtx);
   } else {
     const msg: TuiTuiOutboundImageMessage | TuiTuiOutboundAttachmentMessage =
@@ -453,7 +357,6 @@ export async function sendMediaMsg(
 
     const realAtList = chatType == CHAT_TYPE_GROUP? atList : [];
     msg.at = realAtList;
-    console.log(`[${CHANNEL_ID}] sendMediaMsg ${chatType} ${chatId} ${auditCtx} - `, msg);
 
     await postTuituiMsg(account, msg, auditCtx);
   }
@@ -526,8 +429,6 @@ export async function getChatRecord(
     return undefined;
   }
 
-  checkAccount(account, 'getChatRecord');
-
   let baseurl = "";
   if (chatType == CHAT_TYPE_DIRECT) {
     baseurl = "/message/single/sync";
@@ -553,50 +454,152 @@ export async function getChatRecord(
   if (options.limit) body.limit = options.limit;
   if (typeof options.orderAsc === 'boolean') body.order_asc = options.orderAsc;
 
-  const { appId: appid, appSecret: secret } = account;
+  const parsed: TuiTuiChatRecordResponse = await tuituiRobotApi(account, baseurl, body);
+
+  const clean: TuiTuiChatRecordResponseClean = {
+    errcode:  parsed.errcode,
+    errmsg:   parsed.errmsg,
+    cursor:   parsed.cursor,
+    has_more: parsed.has_more,
+    current_time: parsed.time,
+    msgs: (parsed.msgs ?? []).map(({ user_account, user_name, timestamp, data }) => {
+      const { at, msgid, group_id, group_name, ...restData } = data;  // 排除一些字段，减少大模型上下文大小
+      return {
+        ...restData,  // 使用排除 at 后的数据
+        user_account,
+        user_name,
+        msg_time: new Date(Number(timestamp) * 1000).toLocaleString('sv-SE', { hour12: false }).replace('T', ' '),
+      };
+    }),
+  };
 
-  const url = addTuituiParams2Url(baseurl, { appid, secret });
+  console.log(`[${CHANNEL_ID}] getChatRecord result(cleaned)`, JSON.stringify(clean, null, 2));
 
-  console.log(`[${CHANNEL_ID}] getChatRecord request `, body);
+  return clean;
+}
 
-  const { response, release } = await _fetchJson(url, body, 'tuitui.chat.record');
-  try {
-    const bodyText = await response.text();
-    //console.log(`[${CHANNEL_ID}] getChatRecord response ${bodyText}`);
 
-    if (!response.ok) {
-      throw new Error(`getChatRecord failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText}`);
-    }
+export interface TeamsPostChainItem {
+  post_id: string;
+  time: string;
+  name: string;
+  content: string;
+  properties: any;
+}
 
-    const parsed: TuiTuiChatRecordResponse = JSON.parse(bodyText);
-    if (Number(parsed?.errcode) !== 0) {
-      throw new Error(`getChatRecord failed (errcode unexpected): errcode=${parsed.errcode} errmsg=${parsed.errmsg ?? 'Unknown error'}`);
-    }
+/**
+ * 获取 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[]> {
 
-    const clean: TuiTuiChatRecordResponseClean = {
-      errcode:  parsed.errcode,
-      errmsg:   parsed.errmsg,
-      cursor:   parsed.cursor,
-      has_more: parsed.has_more,
-      current_time: parsed.time,
-      msgs: (parsed.msgs ?? []).map(({ user_account, user_name, timestamp, data }) => {
-        const { at, msgid, group_id, group_name, ...restData } = data;  // 排除一些字段，减少大模型上下文大小
-        return {
-          ...restData,  // 使用排除 at 后的数据
-          user_account,
-          user_name,
-          msg_time: new Date(Number(timestamp) * 1000).toLocaleString('sv-SE', { hour12: false }).replace('T', ' '),
-        };
-      }),
-    };
+  const payload = {
+    team_id: teamId,
+    channel_id: channelId,
+    post_id: threadId,
+  };
+  const data = await tuituiRobotApi(account, '/teams/post/chain', payload);
 
-    console.log(`[${CHANNEL_ID}] getChatRecord result(cleaned)`, JSON.stringify(clean, null, 2));
+  const datas = data.datas ?? {};
+  const topic = datas.topic ?? {};
+  const replyList: any[] = datas.reply_list ?? [];
 
-    return clean;
-  } catch (err) {
-    console.error(`[${CHANNEL_ID}] getChatRecord error:`, err);
-    return undefined;
-  } finally {
-    await release();
+  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;
+}
+
+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[]> {
+  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,
+  };
+
+  const data = await tuituiRobotApi(account, '/file_space/node/list', payload);
+
+  const list = data?.datas?.list;
+  const flat_list = flattenFileSpaceList(list);
+
+  console.log(`[${CHANNEL_ID}] file_space_list `, flat_list);
+  return flat_list
+}
+
+function parseSessionKey(str: string): string {
+  // 检查是否包含必须的格式 "tuitui:channel:"
+  if (!str.includes('tuitui:channel:')) {
+      return "";
+  }
+  
+  const parts = str.split(':');
+  const channelIndex = parts.findIndex(part => part === 'channel');
+  
+  if (channelIndex !== -1 && parts[channelIndex + 1]) {
+      return parts[channelIndex + 1];
+  }
+  
+  return "";
+}
+
+// TODO: 支持群公告
+export async function get_announcement(account: any, sessionKey: string = ""): Promise<any> {
+  const channel_id = parseSessionKey(sessionKey);
+  if(!channel_id) {
+    return {"announcement": ""};
+  }
+  
+  const payload = {channel_id: channel_id};
+  const body = await tuituiRobotApi(account, '/teams/channel/info', payload);
+  //console.log("info", data);
+  const announcement = body?.datas?.info?.announcement;
+  return {"announcement": announcement};
+}

package/src/robot_api.ts

@@ -0,0 +1,123 @@
+import { fetchWithSsrFGuard } from 'openclaw/plugin-sdk/tlon';
+import { CHANNEL_ID } from "./const";
+import { TUITUI_SSRF_POLICY, getTuituiApiHost } from "./env"
+
+function addTuituiParams2Url(urlStr: string, params: any) {
+  const url = new URL(getTuituiApiHost() + urlStr);
+  for (let k in params) url.searchParams.set(k, params[k]);
+  return url.toString();
+}
+
+export function checkAccount(account: any, ctxTips: string = 'send text') {
+  if (!account || !account.appId || !account.appSecret) {
+    throw new Error(`[${CHANNEL_ID}] appId and appSecret are required for ${ctxTips}`);
+  }
+}
+
+export async function tuituiRobotApi(account: any, api: string, payload: any) {
+  checkAccount(account);
+
+  console.log(`[${CHANNEL_ID}] ${api} request`, payload);
+
+  const { appId: appid, appSecret: secret } = account;
+  const url = addTuituiParams2Url(api, { appid, secret });
+
+
+  let fetch_fun = _fetchJson;
+  if (payload instanceof FormData) {
+    fetch_fun = _fetchForm;
+  }
+
+  const { response, release } = await fetch_fun(url, payload);
+  try {
+    const bodyText = await response.text();
+
+    if (!response.ok) {
+      throw new Error(`${api} failed : ${response.status} ${response.statusText}; body=${bodyText}`);
+    }
+
+    const data = JSON.parse(bodyText);
+    if (Number(data?.errcode) !== 0) {
+      throw new Error(`${api} failed : ${bodyText}`);
+    }
+    return data;
+  } catch (err) {
+    // 必须抛出错误，否则上层无法知道失败了
+    console.error(`[${CHANNEL_ID}] ${api} error:`, err);
+    throw err;
+  } finally {
+    await release();
+  }
+}
+
+function _fetch(opts: any): Promise<any> {
+  return fetchWithSsrFGuard({
+    policy: TUITUI_SSRF_POLICY,
+    ...opts,
+  })
+}
+function _fetchJson(url: string, json: any, auditCtx: string = "tuitui.api.call"): Promise<any> {
+  return _fetch({
+    url,
+    init: {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(json),
+    },
+    auditCtx
+  });
+}
+
+function _fetchForm(url: string, form: any, auditCtx: string = "tuitui.api.call"): Promise<any> {
+  return _fetch({
+    url,
+    init: {
+      method: 'POST',
+      body: form,
+    },
+    auditCtx
+  });
+}
+
+/**
+ * Download content from a URL and extract filename and content type
+ * @param url - The URL to download from
+ * @returns Object with buffer, filename and content type
+ */
+export async function downloadUrl(url: string): Promise<{ buffer: ArrayBuffer; filename: string; contentType: string }> {
+  const { response, release } = await _fetch({
+    url,
+    init: { method: 'GET' },
+    auditCtx: "tuitui.download"
+  });
+
+  try {
+    if (!response.ok) {
+      throw new Error(`[${CHANNEL_ID}] Failed to download from ${url}: ${response.status}`);
+    }
+
+    const buffer = await response.arrayBuffer();
+    const contentType = response.headers.get('content-type') || 'application/octet-stream';
+
+    // Extract filename from URL or Content-Disposition header
+    let filename = 'media';
+    try {
+      const urlPath = new URL(url).pathname;
+      const pathParts = urlPath.split('/');
+      const lastPart = pathParts[pathParts.length - 1];
+      if (lastPart) filename = lastPart;
+    } catch (e) {
+      // Ignore URL parsing errors
+    }
+
+    const contentDisposition = response.headers.get('content-disposition');
+    if (contentDisposition) {
+      const match = contentDisposition.match(/filename\*?=(?:UTF-8''|")?([^";\r\n]+)"?/i);
+      if (match) filename = decodeURIComponent(match[1]);
+    }
+
+    return { buffer, filename, contentType };
+  } finally {
+    await release();
+  }
+}

package/src/tools.ts

@@ -4,7 +4,8 @@ import { CHANNEL_ID} from "./const";
 import { resolveAccount } from "./accounts"
 import { Type } from "@sinclair/typebox";
 
-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, get_announcement} from "./outbound"
+import {file_space_list} from "./outbound"
   
 function tool_errmsg(str:string) {
   const ret = `error: ${str}`
@@ -16,10 +17,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 +40,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 +85,48 @@ const tuitui_send_channel_post_factory = (ctx: OpenClawPluginToolContext) => {
   };
 };
 
+
+const tuitui_get_announcement_factory = (ctx: OpenClawPluginToolContext) => {
+  return {
+    name: "tuitui_get_announcement",
+    label: "tuitui_get_announcement",
+    description: "获取推推(tuitui) 当前会话的公告信息\n\n",
+    parameters: Type.Object({
+    }),
+    execute: async (_toolCallId: any, params: any) => {
+      console.log(`tuitui_get_announcement(): 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 get_announcement(account, ctx.sessionKey);
+    },
+  };
+};
+
+
+
+
+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 +135,7 @@ export function registerTuituiTools(api: OpenClawPluginApi) {
   
   api.registerTool(tuitui_im_get_messages_factory);
   api.registerTool(tuitui_send_channel_post_factory);
+  api.registerTool(tuitui_get_announcement_factory);
+  api.registerTool(tuitui_file_space_factory);
   api.logger.info?.(`tuitui: Registered tool`);
 }