@qihoo/tuitui-openclaw-channel 1.0.19 → 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.19",
+  "version": "1.0.21",
   "maintainers": [
     {
       "name": "huzunjie",

package/src/accounts.ts

@@ -19,10 +19,10 @@ export const getDefaultAccountConfig = (acct?: any) => ({
 });
 
 export const resolveAccount = (cfg: any, accountId?: string | null) => {
-  accountId = accountId || DEFAULT_ACCOUNT_ID;
+  const accId = accountId || DEFAULT_ACCOUNT_ID;
   let currAccount = cfg?.channels?.[CHANNEL_ID] || {};
-  if (accountId && accountId !== DEFAULT_ACCOUNT_ID) {
-    currAccount = currAccount.accounts?.[accountId];
+  if (accId !== DEFAULT_ACCOUNT_ID) {
+    currAccount = currAccount.accounts?.[accId];
   }
-  return { accountId, ...getDefaultAccountConfig(currAccount) };
+  return { accountId: accId, ...getDefaultAccountConfig(currAccount) };
 };

package/src/channel.ts

@@ -6,6 +6,7 @@
 import { DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk/account-id';
 import { setAccountEnabledInConfigSection, deleteAccountFromConfigSection } from 'openclaw/plugin-sdk/core';
 import { CHANNEL_ID, CHANNEL_NAME } from "./const";
+import { handleInboundMessage } from './inbound';
 import {
   checkAccount,
   sendTextMsg,
@@ -256,6 +257,14 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
           apiRuntime,
           onConnected: () => _setStatus({ running: true, connected: true }),
           onDisconnected: () => _setStatus({ running: false, connected: false }),
+          onInbounMessage: (json: any) => {
+            _setStatus({ running: true, connected: true, lastInboundAt: Date.now() });
+            if (apiRuntime) {
+              handleInboundMessage({ json, account, apiRuntime, log });
+            } else {
+              log?.error?.(`[${CHANNEL_ID}] AccountId: ${accountId}, WebSocket.onInbounMessage TuiTuiRuntime error`);
+            }
+          },
         });
 
         // 保持账户运行状态，直至触发“abortSignal”信号为止。

package/src/env.ts

@@ -0,0 +1,15 @@
+export const DEFAULT_ONLINE = true;
+
+export const getTuituiHost = (online: boolean = DEFAULT_ONLINE): string => {
+    return online ? "im.live.360.cn" : "im.qihoo.net";
+};
+
+export const getTuituiWebsocketHost = (online: boolean = DEFAULT_ONLINE): string => {
+    return `wss://${getTuituiHost(online)}:8282/robot`;
+};
+
+export const getTuituiApiHost = (online: boolean = DEFAULT_ONLINE): string => {
+    return `https://${getTuituiHost(online)}:8282/robot`;
+};
+
+export const TUITUI_SSRF_POLICY = { allowedHostnames: ['im.live.360.cn', 'im.qihoo.net'] } as const;

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

@@ -2,6 +2,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 type { 
   TuiTuiMessageData,
@@ -17,8 +19,6 @@ import type {
   TuiTuiTeamsTarget
 } from './types';
 
-/* 一些常量配置 */
-export const TUITUI_SSRF_POLICY = { allowedHostnames: ['im.live.360.cn'] } as const;
 
 // ChatType定义与SessionKey定义一致，不可随意修改
 // https://docs.openclaw.ai/channels/channel-routing#session-key-shapes-examples
@@ -33,8 +33,8 @@ export function guessChatType(chatId: string): ChatType {
   return CHAT_TYPE_DIRECT;
 }
 
-export function addParams2Url(urlStr: string, params: any) {
-  const url = new URL(urlStr);
+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();
 }
@@ -82,7 +82,7 @@ function _fetchJson(url: string, json: any, auditCtx: string): Promise<any> {
 export async function postTuituiMsg(account: any, json: any, auditCtx: string): Promise<any> {
   const { appId: appid, appSecret: secret } = account;
   const { response, release } = await _fetchJson(
-    addParams2Url('https://im.live.360.cn:8282/robot/message/custom/send', { appid, secret }),
+    addTuituiParams2Url('/message/custom/send', { appid, secret }),
     json,
     auditCtx,
   );
@@ -132,7 +132,7 @@ interface tuituiUploadResult {
  * @param type - Media type: 'image' or "file" (auto-detected if not specified)
  * @returns The media_id from TuiTui
  */
-export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'image' | 'file'): Promise<tuituiUploadResult | undefined> {
+export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'image' | 'file'): Promise<tuituiUploadResult> {
   checkAccount(account, 'uploadFileToTuiTui');
 
   const { appId: appid, appSecret: secret } = account;
@@ -219,23 +219,23 @@ export async function uploadFileToTuiTui(fileSrc: string, account: any, type: 'i
   body.append('media', new Blob([fileBuffer], { type: contentType }), filename);
 
   const { response, release } = await _fetch({
-    url: addParams2Url('https://im.live.360.cn:8282/robot/media/upload', { appid, secret, type }),
+    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 media to TuiTui: ${response.status}`);
+      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}] media upload failed: ${result.errmsg || "Unknown error"}`);
+      throw new Error(`[${CHANNEL_ID}] file upload failed: ${result.errmsg || "Unknown error"}`);
     }
 
     return {fid: result.media_id, filename};
   } catch(err) {
-    console.error(`[${CHANNEL_ID}] uploadFileToTuiTui error:`, err, `filename: ${filename}, fileSrc: ${fileSrc}`);
+    throw err;
   } finally {
     await release();
   }
@@ -264,7 +264,7 @@ export async function tuituiEmojiReaction(
   const toTarget = (payload.togroups || payload.tousers || payload.toteams)[0];
   const _logTxt =`[${CHANNEL_ID}] emoji_reaction "${emoji}"`;
   console.log(`${_logTxt} request`, toTarget);
-  const sendUrl = addParams2Url('https://im.live.360.cn:8282/robot/message/custom/modify', { appid, secret });
+  const sendUrl = addTuituiParams2Url('/message/custom/modify', { appid, secret });
   const { response, release } = await _fetchJson(sendUrl, payload, 'tuitui.emoji_reaction');
 
   try {
@@ -359,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 = {
@@ -428,11 +446,6 @@ export async function sendMediaMsg(
   const mediaType = isImage ? 'image' : 'file';
 
   const uploadResult = await uploadFileToTuiTui(mediaUrl, account, mediaType);
-  if (!uploadResult || !uploadResult?.fid) {
-    console.error(`[${CHANNEL_ID}] uploadFileToTuiTui failed ${auditCtx}, {mediaUrl: ${mediaUrl}, mediaType: ${mediaType}}`);
-    return;
-  }
-
   const {fid, filename} = uploadResult;
 
   const targets = getTargets(chatId, chatType);
@@ -536,9 +549,9 @@ export async function getChatRecord(
 
   let baseurl = "";
   if (chatType == CHAT_TYPE_DIRECT) {
-    baseurl = "https://im.live.360.cn:8282/robot/message/single/sync";
+    baseurl = "/message/single/sync";
   } else if (chatType == CHAT_TYPE_GROUP){
-    baseurl = "https://im.live.360.cn:8282/robot/message/group/sync";
+    baseurl = "/message/group/sync";
   } else {
     console.log(`[${CHANNEL_ID}] getChatRecord: chatType "${chatType}" is not supported`);
     return undefined;
@@ -561,7 +574,7 @@ export async function getChatRecord(
 
   const { appId: appid, appSecret: secret } = account;
 
-  const url = addParams2Url(baseurl, { appid, secret });
+  const url = addTuituiParams2Url(baseurl, { appid, secret });
 
   console.log(`[${CHANNEL_ID}] getChatRecord request `, body);
 
@@ -605,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`);
 }

package/src/websocket.ts

@@ -1,11 +1,11 @@
 import WebSocket from 'ws';
 import { CHANNEL_ID } from "./const";
-import { handleInboundMessage } from './inbound';
+import { getTuituiWebsocketHost } from "./env"
 
 const wsReadyStates = ['CONNECTING', 'OPEN', 'CLOSING', 'CLOSED'] as const;
 let wsNum = 0;
 
-export default function createWebSocket({ account, log, abortSignal, onConnected, onDisconnected, apiRuntime }: any): () => void {
+export default function createWebSocket({ account, log, abortSignal, onConnected, onDisconnected, onInbounMessage }: any): () => void {
   const { accountId, appId, appSecret } = account;
   let ws: any = null;
   const _closeWS = () => ws && ws.readyState !== WebSocket.CLOSED && ws.close();
@@ -20,7 +20,7 @@ export default function createWebSocket({ account, log, abortSignal, onConnected
   const _clearTimeoutTimer = () => _timeoutId && clearTimeout(_timeoutId);
 
   const wsEvtIds = new Set<string>();
-  const wsUrl = `wss://im.live.360.cn:8282/robot/callback/ws?auth=${appId}.${appSecret}`;
+  const wsUrl = getTuituiWebsocketHost() + `/callback/ws?auth=${appId}.${appSecret}`;
   const _startWS = () => {
     _closeWS(); // 启动新链接前先关闭旧链接，防止产生空指针链接
 
@@ -81,11 +81,7 @@ export default function createWebSocket({ account, log, abortSignal, onConnected
       if (!json?.header || !wsEvent || !json?.body?.data) {
         return log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, WebSocket[${wsId}] invalid message`);
       }
-      if (!apiRuntime) {
-        return log?.error?.(`[${CHANNEL_ID}] AccountId: ${accountId}, WebSocket[${wsId}] TuiTuiRuntime error`);
-      }
-
-      handleInboundMessage({ json, account, apiRuntime, log });
+      onInbounMessage(json);
     });
     
     const onErrOrClose = (errStr: string) => {