@qihoo/tuitui-openclaw-channel 1.0.11 → 1.0.13

package/index.ts

@@ -1,6 +1,7 @@
 import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
 import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk';
 import { createTuiTuiChannelPlugin } from './src/channel';
+import { registerTuituiTools } from './src/tools';
 import { CHANNEL_ID, CHANNEL_NAME } from './src/const';
 import { id } from './openclaw.plugin.json';
 
@@ -12,6 +13,7 @@ const plugin = {
   register(api: OpenClawPluginApi) {
     console.log(`[${CHANNEL_ID}] Plugin.register Before.`);
     api.registerChannel({ plugin: createTuiTuiChannelPlugin(api.runtime) });
+    registerTuituiTools(api);
     console.log(`[${CHANNEL_ID}] Plugin.register After.`);
   },
 };

package/openclaw.plugin.json

@@ -1,6 +1,7 @@
 {
   "id": "tuitui-openclaw-channel",
   "channels": ["tuitui"],
+  "skills": ["./skills"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qihoo/tuitui-openclaw-channel",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "maintainers": [
     {
       "name": "huzunjie",
@@ -18,6 +18,7 @@
   "description": "TuiTui channel plugin for OpenClaw",
   "type": "module",
   "dependencies": {
+    "@sinclair/typebox": "^0.34.48",
     "ws": "^8.13.0"
   },
   "openclaw": {

package/skills/tuitui-im-read/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: tuitui-im-read
+description: |
+  推推(tuitui) IM 消息读取工具使用指南
+
+  **当以下情况时使用此 Skill**:
+  (1) 需要获取群聊或单聊的历史消息
+  (2) 用户提到"聊天记录"、"消息"、"群里说了什么"
+  (3) 需要按时间范围过滤消息、分页获取更多消息
+---
+
+# 推推 IM 消息读取
+
+## 执行前必读
+
+- 该 Skill 中的所有消息读取工具均以机器人身份调用，只能读取机器人有权限的会话。
+
+---
+
+## 工具：tuitui_im_get_messages
+
+### 参数说明
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `chatId` | string | ✅ | 聊天 ID。单聊填对方的 tuitui account，群聊填群 ID |
+| `chatType` | string | ✅ | 聊天类型：单聊填 `direct`，群聊填 `group` |
+| `relativeTime` | string | ❌ | 相对时间范围：today / yesterday / day_before_yesterday / this_week / last_week / this_month / last_month / last_{N}_{unit}（unit: minutes/hours/days）。与 `startTime`/`endTime` 互斥 |
+| `startTime` | string | ❌ | 起始时间，ISO 8601 格式，如 `2026-02-27T00:00:00+08:00`。不填默认从最早开始。与 `relativeTime` 互斥 |
+| `endTime` | string | ❌ | 结束时间，ISO 8601 格式，如 `2026-02-27T23:59:59+08:00`。不填默认到当前时间。与 `relativeTime` 互斥 |
+| `limit` | number | ❌ | 每页条数，范围 1~100，默认 100 |
+| `cursor` | string | ❌ | 分页游标，首次调用填 `"0"`，翻页时传上次返回的 `cursor` |
+| `orderAsc` | boolean | ❌ | 排序方向，`true` 正序（从旧到新），`false` 逆序（从新到旧，默认） |
+
+### 返回结构
+
+```json
+{
+  "errcode": 0,
+  "errmsg": "ok",
+  "cursor": "xxx",
+  "has_more": true,
+  "current_time": "2026-03-21 10:00:00",
+  "msgs": [
+    {
+      "user_account": "zhangsan",
+      "user_name": "张三",
+      "msg_time": "2026-01-03 15:42:44",
+      "msg_type": "text",
+      "text": "消息内容",
+      "images": [],
+      "group_id": "group_abc",
+      "group_name": "某群",
+      "at_me": false,
+      "ref": null
+    }
+  ]
+}
+```
+
+字段说明：
+
+| 字段 | 说明 |
+|------|------|
+| `current_time` | 当前服务器时间，格式 `YYYY-MM-DD HH:MM:SS`，辅助理解消息的相对时间 |
+| `has_more` | `true` 时说明还有更多数据，可用返回的 `cursor` 继续翻页 |
+| `msgs` | 消息列表，空数组表示该时间段内没有消息 |
+| `msgs[].user_account` | 发送者账号 |
+| `msgs[].user_name` | 发送者显示名称 |
+| `msgs[].msg_time` | 消息时间，格式 `YYYY-MM-DD HH:MM:SS` |
+| `msgs[].msg_type` | 消息类型：`text` / `image` / `mixed` / `voice` / `file` |
+| `msgs[].text` | 文本内容（`msg_type` 为 `text` / `mixed` 时有值） |
+| `msgs[].images` | 图片 URL 列表（`msg_type` 为 `image` / `mixed` 时有值） |
+| `msgs[].file` | 文件信息 `{ name, url, file_id }`（`msg_type` 为 `file` 时有值） |
+| `msgs[].at_me` | 是否 @ 了机器人（群聊） |
+| `msgs[].ref` | 引用/回复的原消息，无引用时为 `null` |
+
+---
+
+## 核心约束
+
+### 1. 时间范围：确保消息覆盖完整
+
+- 用户说"今天"、"最近"等相对时间时，自主推算对应的 `startTime` / `endTime`（ISO 8601，+08:00 时区）
+- 不确定范围时适当放宽，宁可多拉再过滤
+
+### 2. 分页：根据需要翻页获取更多结果
+
+- 返回结果中 `has_more=true` 时，将 `cursor` 传入下次调用继续获取下一页
+- 根据用户需求判断是否需要翻页：需要完整结果时继续翻页，浏览概览时第一页通常够用
+
+### 3. 排序方向
+
+- 默认 `orderAsc=false`（逆序），拉取最新消息
+- 需要按时间顺序阅读时，传 `orderAsc=true`
+
+---
+
+## 使用场景示例
+
+### 场景 1：获取群聊最新消息
+
+```json
+{
+  "chatId": "4511334567",
+  "chatType": "group"
+}
+```
+
+### 场景 2：获取某时间段内的单聊消息
+
+```json
+{
+  "chatId": "zhangsan",
+  "chatType": "direct",
+  "startTime": "2026-03-01T00:00:00+08:00",
+  "endTime": "2026-03-01T23:59:59+08:00",
+  "orderAsc": true
+}
+```
+
+### 场景 3：分页获取更多消息
+
+第一次调用返回 `has_more: true` 和 `cursor: "xxx"`，继续获取：
+
+```json
+{
+  "chatId": "4511334567",
+  "chatType": "group",
+  "cursor": "xxx"
+}
+```
+
+---
+
+## 常见错误与排查
+
+| 错误现象 | 根本原因 | 解决方案 |
+|---------|---------|---------|
+| 消息结果为空 | 时间范围不对或 chatId 有误 | 检查 `chatId`、`chatType`，适当放宽时间范围 |
+| 消息不完整 | 没有检查 `has_more` 并翻页 | `has_more=true` 时用返回的 `cursor` 继续翻页 |
+| 报错 invalid tuitui account | 账号未配置或未启用 | 确认 tuitui 账号已正确配置 |
+| 消息顺序不对 | `orderAsc` 方向有误 | 按需传 `orderAsc: true/false` |

package/src/accounts.ts

@@ -0,0 +1,25 @@
+import { parseAllowFroms } from './utils';
+import { capabilities, configSchema, baseFildsDefault } from './confs';
+import {  CHANNEL_ID,} from "./const";
+import {  DEFAULT_ACCOUNT_ID,} from 'openclaw/plugin-sdk';
+
+const isEnabled = (val: any) => val === undefined || !!val;
+
+export const resolveAccount = (cfg: any, accountId?: string | null) => {
+  const channelConfig = cfg?.channels?.[CHANNEL_ID] || {};
+  const targetId = accountId || DEFAULT_ACCOUNT_ID;
+  const acct = targetId === DEFAULT_ACCOUNT_ID ? channelConfig : channelConfig.accounts?.[targetId];
+  return {
+    accountId: targetId,
+    enabled: isEnabled(acct?.enabled),
+    appId: acct?.appId || '',
+    appSecret: acct?.appSecret || '',
+    dmPolicy: acct?.dmPolicy || baseFildsDefault.dmPolicy,
+    allowFrom: parseAllowFroms(acct?.allowFrom || baseFildsDefault.allowFrom),
+    // 群组策略与白名单、群组级覆盖
+    groupPolicy: acct?.groupPolic || baseFildsDefault.groupPolicy,
+    groupAllowFrom: parseAllowFroms(acct?.groupAllowFrom || baseFildsDefault.groupAllowFrom),
+    requireMention: isEnabled(acct?.requireMention ?? baseFildsDefault.requireMention),
+    channelContext: acct?.channelContext || baseFildsDefault.channelContext,
+  };
+};

package/src/channel.ts

@@ -11,7 +11,6 @@ import {
   deleteAccountFromConfigSection,
 } from 'openclaw/plugin-sdk';
 import { CHANNEL_ID, CHANNEL_NAME } from "./const";
-
 import {
   checkAccount,
   sendTextMsg,
@@ -19,31 +18,14 @@ import {
   sendMediaMsg,
   guessChatType,
 } from "./outbound";
-
 import { handleInboundMessage } from './inbound';
-
 import { capabilities, configSchema, baseFildsDefault } from './confs';
+import { resolveAccount } from "./accounts"
+
 
 const isEnabled = (val: any) => val === undefined || !!val;
 const isConfigured = (account: any)=> !!(account?.appId && account?.appSecret);
-const resolveAccount = (cfg: any, accountId?: string | null) => {
-  const channelConfig = cfg?.channels?.[CHANNEL_ID] || {};
-  const targetId = accountId || DEFAULT_ACCOUNT_ID;
-  const acct = targetId === DEFAULT_ACCOUNT_ID ? channelConfig : channelConfig.accounts?.[targetId];
-  return {
-    accountId: targetId,
-    enabled: isEnabled(acct?.enabled),
-    appId: acct?.appId as string | undefined,
-    appSecret: acct?.appSecret as string | undefined,
-    dmPolicy: acct?.dmPolicy || baseFildsDefault.dmPolicy,
-    allowFrom: acct?.allowFrom || baseFildsDefault.allowFrom,
-    // 群组策略与白名单、群组级覆盖
-    groupPolicy: (acct?.groupPolicy as string | undefined) || baseFildsDefault.groupPolicy,
-    groupAllowFrom: acct?.groupAllowFrom || baseFildsDefault.groupAllowFrom,
-    requireMention: isEnabled(acct?.requireMention),
-    channelContext: acct?.channelContext || baseFildsDefault.channelContext,
-  };
-};
+
 const wsReadyStates = ['CONNECTING', 'OPEN', 'CLOSING', 'CLOSED'] as const;
 let wsNumber = 0;
 
@@ -153,7 +135,7 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
           allowFrom: policy === 'open' ? ['*'] : (account.allowFrom ?? []),
           policyPath: `${allowFromPath}dmPolicy`,
           allowFromPath,
-          approveHint: `openclaw 配对校验信息，CHANNEL_ID: ${CHANNEL_ID}, AccountId: ${accountId}, code: <code>`,
+          approveHint: `当前 ${CHANNEL_ID} openclaw（AccountId: ${accountId}）需要配对校验, code: <code>`,
           normalizeEntry: (raw: string) => raw.toLowerCase().trim(),
         };
       },
@@ -174,16 +156,18 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
     },
 
     outbound: {
-      deliveryMode: 'gateway' as const,
-      textChunkLimit: 2000,
+      deliveryMode: 'direct' as const,
+      textChunkLimit: 10000,  // API上限制为50k
 
-      sendText: async ({ cfg, to, text, accountId, account }: any) => {
-        account = account || resolveAccount(cfg, accountId);
-        checkAccount(account, 'send text');
+      sendText: async ({ cfg, to, text, accountId, replyToId, threadId }: any) => {
+        const account = resolveAccount(cfg, accountId);
+        checkAccount(account);
         
         const chatId = String(to || '').trim();
-        // Determine if this is a group message based on 'to' being all digits (group) or not (direct)
-        await sendTextMsg(account, chatId, guessChatType(chatId), text);
+        const chatType = guessChatType(chatId);
+        console.log(`[${CHANNEL_ID}] AccountId ${accountId} outbound.sendText() ${chatType} to ${chatId} ${text}`);
+
+        await sendTextMsg(account, chatId, chatType, text);
 
         return { channel: CHANNEL_ID, messageId: `tuitui-text-${Date.now()}`, chatId };
       },
@@ -240,6 +224,7 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
         wsNumber++;
         const wsId = `${wsNumber}-${Date.now()}`;
         const wsEvtIds = new Set<string>();
+        let wsRetryTimerId = 0;
 
         const wsUrl = `wss://im.live.360.cn:8282/robot/callback/ws?auth=${account.appId}.${account.appSecret}`;
         const defSendMsg = (msg: any) => {
@@ -285,7 +270,7 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
             const wsEvent = json?.body?.event;
             if (wsEvent === 'keepalive') return;
 
-            log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, WebSocket[${wsId}] Received message: ${wsData}`);
+            log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, WebSocket[${wsId}], Received event ${wsEvent}, body ${JSON.stringify(json?.body, null, 2)}`);
 
             if (!json?.header || !wsEvent || !json?.body?.data) {
               return log?.info?.(`[${CHANNEL_ID}] AccountId: ${accountId}, WebSocket[${wsId}] invalid message`);
@@ -304,7 +289,8 @@ export function createTuiTuiChannelPlugin(apiRuntime: any) {
             _sendMsg = defSendMsg;
             if (!abortSignal?.aborted) {
               log?.warn?.(`[${CHANNEL_ID}] WebSocket[${wsId}] Restart`);
-              setTimeout(startWebSocket, 10e3); // 10秒后尝试重启
+              if (wsRetryTimerId) clearTimeout(wsRetryTimerId);
+              wsRetryTimerId = setTimeout(startWebSocket, 10e3); // 10秒后尝试重启
             }
           };
           ws.on('close', () => {