@qihoo/tuitui-openclaw-channel 1.0.12 → 1.0.14

package/index.ts

@@ -1,17 +1,19 @@
 import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
-import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk';
+import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk/core';
 import { createTuiTuiChannelPlugin } from './src/channel';
+import { registerTuituiTools } from './src/tools';
 import { CHANNEL_ID, CHANNEL_NAME } from './src/const';
 import { id } from './openclaw.plugin.json';
 
 const plugin = {
   id, // plugin id not is CHANNEL_ID
   name: CHANNEL_NAME,
-  description: `${CHANNEL_NAME} chat integration for OpenClaw via webhook`,
+  description: `${CHANNEL_NAME} chat integration for OpenClaw via WebSocket`,
   configSchema: emptyPluginConfigSchema(),
   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.12",
+  "version": "1.0.14",
   "maintainers": [
     {
       "name": "huzunjie",
@@ -17,7 +17,11 @@
   ],
   "description": "TuiTui channel plugin for OpenClaw",
   "type": "module",
+  "peerDependencies": {
+    "openclaw": ">=2026.3.13"
+  },
   "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,24 @@
+import { parseAllowFroms, isEnabled } from './utils';
+import { baseFildsDefault } from './confs';
+import { CHANNEL_ID } from './const';
+import { DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk/account-id';
+
+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,
+    emojiReaction: isEnabled(acct?.emojiReaction ?? baseFildsDefault.emojiReaction),
+  };
+};

package/src/channel.ts

@@ -5,13 +5,9 @@
  * Supports single chat (text, image, voice, file) and group chat with @mentions.
  */
 import WebSocket from 'ws';
-import {
-  DEFAULT_ACCOUNT_ID,
-  setAccountEnabledInConfigSection,
-  deleteAccountFromConfigSection,
-} from 'openclaw/plugin-sdk';
+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 {
   checkAccount,
   sendTextMsg,
@@ -19,31 +15,13 @@ import {
   sendMediaMsg,
   guessChatType,
 } from "./outbound";
-
 import { handleInboundMessage } from './inbound';
-
 import { capabilities, configSchema, baseFildsDefault } from './confs';
+import { resolveAccount } from "./accounts"
+import { isEnabled } from './utils';
 
-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;
 
@@ -288,7 +266,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`);

package/src/confs.ts

@@ -42,7 +42,10 @@ const baseFields = {
     default: 'channel',
     enum: ['channel', 'thread']
   },
-
+  emojiReaction: {
+    type: 'boolean',
+    default: true,
+  },
 };
 const baseFieldsKeys = Object.keys(baseFields);
 export const baseFildsDefault = {} as Record<string, any>;
@@ -86,7 +89,7 @@ const fieldsUiHints = {
       advanced: true,
     },
     groupAllowFrom: {
-      help: '群组/团队白名单-群ID和团队ID（仅在 groupPolicy=allowlist 生效）',
+      help: '群组/团队白名单-包含群ID、团队ID或频道ID（仅在 groupPolicy=allowlist 生效）',
       order: 14,
       advanced: true,
     },
@@ -95,9 +98,14 @@ const fieldsUiHints = {
       order: 15,
       advanced: true,
     },
+    emojiReaction: {
+      help: '在收到消息后，大模型给出反应结果前，先对原消息发送一个”收到“的表情回复。',
+      order: 16,
+      advanced: true,
+    },
 };
 
-/* 多账户管理 - 暂不开放，先保留代码逻辑
+/* 多账户管理 */
 const accountsFieldsUiHints = {} as Record<string, any>;
 function isValidObjKey(key: string | number | symbol , object: object): key is keyof typeof object {
   return key in object;
@@ -105,7 +113,6 @@ function isValidObjKey(key: string | number | symbol , object: object): key is k
 for (const k in fieldsUiHints) {
   if (isValidObjKey(k, fieldsUiHints)) accountsFieldsUiHints[`accounts.*.${k}` as string] = fieldsUiHints[k];
 }
-*/
 
 export const configSchema = {
   schema: {
@@ -113,7 +120,7 @@ export const configSchema = {
     additionalProperties: false,
     properties: {
       ...fields,
-      /* 基础配置信息中，准备 accounts 配置支持多账户管理，以备后续允许用户配置多个推推机器人账号
+      /* 基础配置信息中，准备 accounts 配置支持多账户管理 */
       accounts: {
         type: 'object',
         additionalProperties: {
@@ -121,17 +128,17 @@ export const configSchema = {
           additionalProperties: false,
           properties: { ...fields },
         },
-      }, */
+      },
     },
   },
   uiHints: {
     ...fieldsUiHints,
-    /* 基础配置信息中，准备 accounts 配置支持多账户管理，以备后续允许用户配置多个推推机器人账号
+    /* 基础配置信息中，准备 accounts 配置支持多账户管理 */
     accounts: {
       help: 'Accounts（多账户配置）',
       order: 30,
       advanced: true
     },
-    ...accountsFieldsUiHints, */
+    ...accountsFieldsUiHints,
   },
 };