@qihoo/tuitui-openclaw-channel 1.0.21 → 1.0.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qihoo/tuitui-openclaw-channel",
-  "version": "1.0.21",
+  "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/inbound.ts

@@ -451,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) {
+      // 出错不影响后续逻辑
+    }
   }
 
   // 路由判断

package/src/outbound.ts

@@ -1,9 +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,
@@ -33,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',
@@ -60,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;
@@ -133,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`);
@@ -168,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}`);
     }
@@ -218,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(
@@ -260,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{
@@ -374,7 +265,6 @@ export async function sendTextMsg(
           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;
@@ -388,7 +278,6 @@ export async function sendTextMsg(
           delims_right: ""
         },
       };
-      console.log(`[${CHANNEL_ID}] retry no @ sendTeamsPost to ${chatId} ${auditCtx} - `, msg);
       await postTuituiMsg(account, msg, auditCtx);
     }
   } else {
@@ -399,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);
   }
 }
@@ -415,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);
@@ -427,7 +315,6 @@ export async function sendPageMsg(
     togroups,
     page: { ...(page || {})}
   };
-  console.log(`[${CHANNEL_ID}] sendPageMsg ${auditCtx} - `, msg);
   await postTuituiMsg(account, msg, auditCtx);
 }
 
@@ -440,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';
@@ -462,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 =
@@ -472,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);
   }
@@ -545,8 +429,6 @@ export async function getChatRecord(
     return undefined;
   }
 
-  checkAccount(account, 'getChatRecord');
-
   let baseurl = "";
   if (chatType == CHAT_TYPE_DIRECT) {
     baseurl = "/message/single/sync";
@@ -572,52 +454,28 @@ 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 url = addTuituiParams2Url(baseurl, { appid, secret });
-
-  console.log(`[${CHANNEL_ID}] getChatRecord request `, body);
-
-  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}`);
-    }
-
-    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'}`);
-    }
-
-    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 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', ' '),
+      };
+    }),
+  };
 
-    console.log(`[${CHANNEL_ID}] getChatRecord result(cleaned)`, JSON.stringify(clean, null, 2));
+  console.log(`[${CHANNEL_ID}] getChatRecord result(cleaned)`, JSON.stringify(clean, null, 2));
 
-    return clean;
-  } catch (err) {
-    console.error(`[${CHANNEL_ID}] getChatRecord error:`, err);
-    return undefined;
-  } finally {
-    await release();
-  }
+  return clean;
 }
 
 
@@ -644,66 +502,40 @@ export async function getPostChain(
   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,
   };
+  const data = await tuituiRobotApi(account, '/teams/post/chain', payload);
 
-  console.log(`[${CHANNEL_ID}] getPostChain request`, payload);
+  const datas = data.datas ?? {};
+  const topic = datas.topic ?? {};
+  const replyList: any[] = datas.reply_list ?? [];
 
-  const { response, release } = await _fetchJson(url, payload, 'tuitui.teams.post.chain');
-  try {
-    const bodyText = await response.text();
+  const posts: TeamsPostChainItem[] = [];
 
-    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: topic.post_id ?? '',
-      time: topic.create_time ?? '',
-      name: topic.from_name ?? '',
-      content: topic.content ?? '',
-      properties: topic.properties ?? '',
+      post_id: post.post_id ?? '',
+      time: post.create_time ?? '',
+      name: post.from_name ?? '',
+      content: post.content ?? '',
+      properties: post.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();
   }
+
+  console.log(`[${CHANNEL_ID}] getPostChain result: ${posts.length} posts`, posts);
+  return posts;
 }
 
 export async function getPostChainByChatId(
@@ -714,17 +546,11 @@ export async function getPostChainByChatId(
   return await getPostChain(account, team_id, channel_id, parent_id||"");
 }
 
-
 export async function file_space_list(
   account: any,
-  spaceId: string,
+  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){
@@ -739,30 +565,41 @@ export async function file_space_list(
     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();
+  const data = await tuituiRobotApi(account, '/file_space/node/list', payload);
 
-    if (!response.ok) {
-      throw new Error(`file_space_list failed (response.ok unexpected): ${response.status} ${response.statusText}; body=${bodyText}`);
-    }
+  const list = data?.datas?.list;
+  const flat_list = flattenFileSpaceList(list);
 
-    const data = JSON.parse(bodyText);
-    if (Number(data?.errcode) !== 0) {
-      throw new Error(`file_space_list failed (errcode unexpected): err=${bodyText}`);
-    }
+  console.log(`[${CHANNEL_ID}] file_space_list `, flat_list);
+  return flat_list
+}
 
-    const list = data?.datas?.list;
-    const flat_list = flattenFileSpaceList(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 "";
+}
 
-    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();
+// 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

@@ -3,9 +3,8 @@ 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,guessChatType, getChatRecord, getPostChainByChatId, 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) {
@@ -87,6 +86,27 @@ 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",
@@ -115,8 +135,7 @@ 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.registerTool(tuitui_get_announcement_factory);
+  api.registerTool(tuitui_file_space_factory);
   api.logger.info?.(`tuitui: Registered tool`);
 }