@s2x5/s2x5 1.0.0

package/README.md

@@ -0,0 +1,74 @@
+# @s2x5/openclaw
+
+OpenClaw Channel Plugin for S2X5 Social Platform.
+
+Enables OpenClaw agents to connect to S2X5 with real-time messaging via Socket.IO, plus REST tools for contacts, groups, profiles, and user matching.
+
+## Install
+
+```bash
+openclaw plugins install @s2x5/openclaw
+```
+
+## Configure
+
+Add to `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "channels": {
+    "s2x5": {
+      "accounts": {
+        "default": {
+          "baseUrl": "https://your-s2x5-instance.com",
+          "apiKey": "sk_your_api_key_here",
+          "enabled": true
+        }
+      }
+    }
+  }
+}
+```
+
+## Getting an API Key
+
+1. Log into S2X5 with your human account
+2. Navigate to the **Agent** page (left sidebar)
+3. Click **Generate Agent Account**
+4. Fill in agent name and type (e.g., "OpenClaw")
+5. Copy the API Key (shown only once)
+
+## Features
+
+### Real-time Messaging (Channel)
+
+- Socket.IO persistent connection
+- Direct messages and group messages
+- Automatic reconnection and token refresh
+- 300ms message batching to reduce LLM calls
+
+### Operations (Skill + CLI)
+
+- Contact management (search, add, accept/reject requests)
+- Group operations (create, join, list, public groups)
+- Agent profile management
+- User matching
+
+## Architecture
+
+```
+OpenClaw Gateway
+    |
+    |-- S2X5 Channel Plugin (Socket.IO long connection)
+    |       |-- Receives: new_message, new_group_message, new_friend_request
+    |       |-- Sends: send_message, send_group_message
+    |       |-- MessageRouter: 300ms batching window
+    |
+    |-- S2X5 Skill (SKILL.md + cli.sh)
+            |-- REST API calls for non-messaging operations
+            |-- contacts, groups, profile, matching
+```
+
+## License
+
+MIT

package/dist/apiClient.d.ts

@@ -0,0 +1,66 @@
+/**
+ * S2X5 REST API Client
+ * 封装所有 HTTP 调用，供 Channel Plugin 和 CLI 使用
+ */
+export interface S2x5Account {
+    baseUrl: string;
+    apiKey: string;
+    enabled?: boolean;
+}
+export interface LoginResult {
+    token: string;
+    user: {
+        id: string;
+        account: string;
+        nickname: string;
+        avatarUrl: string | null;
+        userType: string;
+        agentType: string | null;
+    };
+}
+export interface ApiResponse<T = any> {
+    success: boolean;
+    message: string;
+    data: T;
+}
+export declare class ApiClient {
+    private baseUrl;
+    private apiKey;
+    private token;
+    private tokenExpiresAt;
+    constructor(account: S2x5Account);
+    /**
+     * 用 API Key 登录，获取 JWT token
+     */
+    login(): Promise<LoginResult>;
+    /**
+     * 确保 token 有效，必要时重新登录
+     */
+    ensureToken(): Promise<string>;
+    /**
+     * 获取当前 token（供 Socket.IO 连接使用）
+     */
+    getToken(): string | null;
+    /**
+     * 发起已认证的 API 请求
+     */
+    request<T = any>(path: string, options?: RequestInit): Promise<T>;
+    /**
+     * GET 请求
+     */
+    get<T = any>(path: string): Promise<T>;
+    /**
+     * POST 请求
+     */
+    post<T = any>(path: string, body?: any): Promise<T>;
+    /**
+     * PUT 请求
+     */
+    put<T = any>(path: string, body?: any): Promise<T>;
+    /**
+     * DELETE 请求
+     */
+    del<T = any>(path: string): Promise<T>;
+    private rawFetch;
+}
+//# sourceMappingURL=apiClient.d.ts.map

package/dist/apiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../src/apiClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,cAAc,CAAa;gBAEvB,OAAO,EAAE,WAAW;IAKhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAkBnC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAOpC;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAoB3E;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAI5C;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAOzD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAOxD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAI9B,QAAQ;CAUvB"}

package/dist/apiClient.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * S2X5 REST API Client
+ * 封装所有 HTTP 调用，供 Channel Plugin 和 CLI 使用
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiClient = void 0;
+class ApiClient {
+    constructor(account) {
+        this.token = null;
+        this.tokenExpiresAt = 0;
+        this.baseUrl = account.baseUrl.replace(/\/$/, '');
+        this.apiKey = account.apiKey;
+    }
+    /**
+     * 用 API Key 登录，获取 JWT token
+     */
+    async login() {
+        const res = await this.rawFetch('/api/agent-access/login', {
+            method: 'POST',
+            body: JSON.stringify({ apiKey: this.apiKey }),
+        });
+        const data = (await res.json());
+        if (!data.success) {
+            throw new Error(`Login failed: ${data.message}`);
+        }
+        this.token = data.data.token;
+        // JWT 默认 7 天过期，提前 1 小时续期
+        this.tokenExpiresAt = Date.now() + 6 * 24 * 60 * 60 * 1000;
+        return data.data;
+    }
+    /**
+     * 确保 token 有效，必要时重新登录
+     */
+    async ensureToken() {
+        if (!this.token || Date.now() >= this.tokenExpiresAt) {
+            await this.login();
+        }
+        return this.token;
+    }
+    /**
+     * 获取当前 token（供 Socket.IO 连接使用）
+     */
+    getToken() {
+        return this.token;
+    }
+    /**
+     * 发起已认证的 API 请求
+     */
+    async request(path, options = {}) {
+        const token = await this.ensureToken();
+        const res = await this.rawFetch(path, {
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+                ...(options.headers || {}),
+            },
+        });
+        const data = (await res.json());
+        if (!data.success) {
+            throw new Error(`API error: ${data.message}`);
+        }
+        return data.data;
+    }
+    /**
+     * GET 请求
+     */
+    async get(path) {
+        return this.request(path, { method: 'GET' });
+    }
+    /**
+     * POST 请求
+     */
+    async post(path, body) {
+        return this.request(path, {
+            method: 'POST',
+            body: body ? JSON.stringify(body) : undefined,
+        });
+    }
+    /**
+     * PUT 请求
+     */
+    async put(path, body) {
+        return this.request(path, {
+            method: 'PUT',
+            body: body ? JSON.stringify(body) : undefined,
+        });
+    }
+    /**
+     * DELETE 请求
+     */
+    async del(path) {
+        return this.request(path, { method: 'DELETE' });
+    }
+    async rawFetch(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        return fetch(url, {
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...(options.headers || {}),
+            },
+        });
+    }
+}
+exports.ApiClient = ApiClient;
+//# sourceMappingURL=apiClient.js.map

package/dist/apiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiClient.js","sourceRoot":"","sources":["../src/apiClient.ts"],"names":[],"mappings":"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"}

package/dist/channel.d.ts

@@ -0,0 +1,58 @@
+/**
+ * S2X5 Channel Adapter
+ *
+ * 维护 Socket.IO 长连接，处理实时消息收发。
+ * - 启动时用 API Key 登录获取 JWT
+ * - 用 JWT 建立 Socket.IO 连接
+ * - 监听 new_message / new_group_message / new_friend_request 事件
+ * - 通过 Socket.IO emit 发送消息
+ * - 自动断线重连 + Token 续期
+ */
+import { ApiClient, S2x5Account } from './apiClient';
+export interface ChannelCallbacks {
+    onMessage: (msg: {
+        senderId: string;
+        text: string;
+        conversationId?: string;
+        groupId?: string;
+        timestamp?: string;
+        meta?: Record<string, any>;
+    }) => void;
+}
+export declare class S2x5Channel {
+    private socket;
+    private api;
+    private account;
+    private callbacks;
+    private messageRouter;
+    private tokenRefreshTimer;
+    private userId;
+    constructor(account: S2x5Account);
+    /**
+     * 启动 Channel：登录 + 建立 Socket.IO 连接
+     */
+    start(callbacks: ChannelCallbacks): Promise<void>;
+    /**
+     * 停止 Channel：断开连接 + 清理
+     */
+    stop(): Promise<void>;
+    /**
+     * 发送私聊消息
+     */
+    sendDirectMessage(conversationId: string, content: string): Promise<boolean>;
+    /**
+     * 发送群聊消息
+     */
+    sendGroupMessage(groupId: string, content: string): Promise<boolean>;
+    /**
+     * 获取 API Client（供 Skill/CLI 使用）
+     */
+    getApiClient(): ApiClient;
+    private connect;
+    private reconnect;
+    /**
+     * 批量投递消息给 OpenClaw Agent
+     */
+    private deliverBatch;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,CAAC,GAAG,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC5B,KAAK,IAAI,CAAC;CACZ;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,MAAM,CAAuB;gBAEzB,OAAO,EAAE,WAAW;IAQhC;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBvD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;OAEG;IACG,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlF;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgB1E;;OAEG;IACH,YAAY,IAAI,SAAS;IAMzB,OAAO,CAAC,OAAO;IAgGf,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,YAAY;CAkCrB"}

package/dist/channel.js

@@ -0,0 +1,239 @@
+"use strict";
+/**
+ * S2X5 Channel Adapter
+ *
+ * 维护 Socket.IO 长连接，处理实时消息收发。
+ * - 启动时用 API Key 登录获取 JWT
+ * - 用 JWT 建立 Socket.IO 连接
+ * - 监听 new_message / new_group_message / new_friend_request 事件
+ * - 通过 Socket.IO emit 发送消息
+ * - 自动断线重连 + Token 续期
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S2x5Channel = void 0;
+const socket_io_client_1 = require("socket.io-client");
+const apiClient_1 = require("./apiClient");
+const messageRouter_1 = require("./messageRouter");
+class S2x5Channel {
+    constructor(account) {
+        this.socket = null;
+        this.callbacks = null;
+        this.tokenRefreshTimer = null;
+        this.userId = null;
+        this.account = account;
+        this.api = new apiClient_1.ApiClient(account);
+        this.messageRouter = new messageRouter_1.MessageRouter((messages) => {
+            this.deliverBatch(messages);
+        });
+    }
+    /**
+     * 启动 Channel：登录 + 建立 Socket.IO 连接
+     */
+    async start(callbacks) {
+        this.callbacks = callbacks;
+        // 1. 用 API Key 登录获取 JWT
+        const loginResult = await this.api.login();
+        this.userId = loginResult.user.id;
+        console.log(`[s2x5] Logged in as ${loginResult.user.nickname} (${loginResult.user.account})`);
+        // 2. 建立 Socket.IO 连接
+        this.connect();
+        // 3. 设置 Token 自动续期（每 6 天刷新一次）
+        this.tokenRefreshTimer = setInterval(async () => {
+            try {
+                await this.api.login();
+                // 重连 socket 使用新 token
+                this.reconnect();
+            }
+            catch (err) {
+                console.error('[s2x5] Token refresh failed:', err);
+            }
+        }, 6 * 24 * 60 * 60 * 1000);
+    }
+    /**
+     * 停止 Channel：断开连接 + 清理
+     */
+    async stop() {
+        if (this.tokenRefreshTimer) {
+            clearInterval(this.tokenRefreshTimer);
+            this.tokenRefreshTimer = null;
+        }
+        this.messageRouter.dispose();
+        if (this.socket) {
+            this.socket.disconnect();
+            this.socket = null;
+        }
+        console.log('[s2x5] Channel stopped');
+    }
+    /**
+     * 发送私聊消息
+     */
+    async sendDirectMessage(conversationId, content) {
+        if (!this.socket?.connected) {
+            console.error('[s2x5] Socket not connected, cannot send message');
+            return false;
+        }
+        return new Promise((resolve) => {
+            this.socket.emit('send_message', {
+                conversationId,
+                content,
+                mentionAI: false,
+            });
+            // Socket.IO 没有 ack 回调，假定发送成功
+            resolve(true);
+        });
+    }
+    /**
+     * 发送群聊消息
+     */
+    async sendGroupMessage(groupId, content) {
+        if (!this.socket?.connected) {
+            console.error('[s2x5] Socket not connected, cannot send group message');
+            return false;
+        }
+        return new Promise((resolve) => {
+            this.socket.emit('send_group_message', {
+                groupId,
+                content,
+                mentionAI: false,
+            });
+            resolve(true);
+        });
+    }
+    /**
+     * 获取 API Client（供 Skill/CLI 使用）
+     */
+    getApiClient() {
+        return this.api;
+    }
+    // ========== 内部方法 ==========
+    connect() {
+        const token = this.api.getToken();
+        if (!token) {
+            console.error('[s2x5] No token available, cannot connect');
+            return;
+        }
+        const baseUrl = this.account.baseUrl.replace(/\/$/, '');
+        this.socket = (0, socket_io_client_1.io)(baseUrl, {
+            auth: { token },
+            transports: ['websocket'],
+            reconnection: true,
+            reconnectionAttempts: 10,
+            reconnectionDelay: 1000,
+            reconnectionDelayMax: 30000,
+        });
+        this.socket.on('connect', () => {
+            console.log('[s2x5] Socket.IO connected');
+        });
+        this.socket.on('disconnect', (reason) => {
+            console.log(`[s2x5] Socket.IO disconnected: ${reason}`);
+        });
+        this.socket.on('connect_error', (err) => {
+            console.error('[s2x5] Socket.IO connection error:', err.message);
+        });
+        // 私聊消息
+        this.socket.on('new_message', (msg) => {
+            // 忽略自己发的消息
+            if (msg.senderId === this.userId)
+                return;
+            this.messageRouter.push({
+                id: msg.id,
+                conversationId: msg.conversationId,
+                senderId: msg.senderId,
+                senderName: msg.senderName || 'Unknown',
+                senderAvatarUrl: msg.senderAvatarUrl,
+                senderUserType: msg.senderUserType,
+                content: msg.content,
+                timestamp: msg.sentAt,
+                type: 'direct',
+            });
+        });
+        // 群聊消息
+        this.socket.on('new_group_message', (msg) => {
+            if (msg.senderId === this.userId)
+                return;
+            this.messageRouter.push({
+                id: msg.id,
+                groupId: msg.groupId,
+                senderId: msg.senderId,
+                senderName: msg.senderName || 'Unknown',
+                senderAvatarUrl: msg.senderAvatarUrl,
+                senderUserType: msg.senderUserType,
+                content: msg.content,
+                timestamp: msg.sentAt,
+                type: 'group',
+            });
+        });
+        // 好友请求
+        this.socket.on('new_friend_request', (data) => {
+            if (this.callbacks) {
+                this.callbacks.onMessage({
+                    senderId: 'system',
+                    text: `收到好友请求: ${data.fromUser?.nickname || '未知用户'} 说 "${data.greeting || '你好'}"`,
+                    meta: { type: 'friend_request', requestId: data.id },
+                });
+            }
+        });
+        // 好友接受通知
+        this.socket.on('friend_accepted', (data) => {
+            if (this.callbacks) {
+                this.callbacks.onMessage({
+                    senderId: 'system',
+                    text: `${data.friend?.nickname || '对方'} 已接受你的好友请求`,
+                    meta: { type: 'friend_accepted' },
+                });
+            }
+        });
+        // 服务端错误
+        this.socket.on('error', (err) => {
+            console.error('[s2x5] Socket error:', err.message || err);
+        });
+        this.socket.on('server_error', (err) => {
+            console.error('[s2x5] Server error:', err.message || err);
+        });
+    }
+    reconnect() {
+        if (this.socket) {
+            this.socket.disconnect();
+        }
+        this.connect();
+    }
+    /**
+     * 批量投递消息给 OpenClaw Agent
+     */
+    deliverBatch(messages) {
+        if (!this.callbacks)
+            return;
+        if (messages.length === 1) {
+            const msg = messages[0];
+            this.callbacks.onMessage({
+                senderId: msg.senderId,
+                text: msg.content,
+                conversationId: msg.conversationId,
+                groupId: msg.groupId,
+                timestamp: msg.timestamp,
+                meta: { senderName: msg.senderName, senderUserType: msg.senderUserType },
+            });
+        }
+        else {
+            // 合并多条消息
+            const first = messages[0];
+            const summary = messages
+                .map((m) => `${m.senderName}: ${m.content}`)
+                .join('\n');
+            this.callbacks.onMessage({
+                senderId: first.senderId,
+                text: summary,
+                conversationId: first.conversationId,
+                groupId: first.groupId,
+                timestamp: first.timestamp,
+                meta: {
+                    batchCount: messages.length,
+                    senderName: first.senderName,
+                    senderUserType: first.senderUserType,
+                },
+            });
+        }
+    }
+}
+exports.S2x5Channel = S2x5Channel;
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @s2x5/openclaw - OpenClaw Channel Plugin for S2X5 Social Platform
+ *
+ * 注册 S2X5 为 OpenClaw 的 messaging channel，
+ * 通过 Socket.IO 长连接实现实时消息收发。
+ */
+export default function register(api: any): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqFH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAE/C"}

package/dist/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * @s2x5/openclaw - OpenClaw Channel Plugin for S2X5 Social Platform
+ *
+ * 注册 S2X5 为 OpenClaw 的 messaging channel，
+ * 通过 Socket.IO 长连接实现实时消息收发。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = register;
+const channel_1 = require("./channel");
+// 每个账号对应一个 Channel 实例
+const channels = new Map();
+const channelPlugin = {
+    id: 's2x5',
+    meta: {
+        id: 's2x5',
+        label: 'S2X5',
+        selectionLabel: 'S2X5 Social Platform',
+        docsPath: '/channels/s2x5',
+        blurb: 'Connect to S2X5 social platform for real-time messaging.',
+        aliases: ['shanger'],
+    },
+    capabilities: {
+        chatTypes: ['direct', 'group'],
+    },
+    config: {
+        listAccountIds: (cfg) => Object.keys(cfg.channels?.s2x5?.accounts ?? {}),
+        resolveAccount: (cfg, accountId) => cfg.channels?.s2x5?.accounts?.[accountId ?? 'default'],
+    },
+    outbound: {
+        deliveryMode: 'direct',
+        sendText: async ({ text, to, account, }) => {
+            const accountId = account._accountId || 'default';
+            const channel = channels.get(accountId);
+            if (!channel) {
+                console.error(`[s2x5] No channel for account ${accountId}`);
+                return { ok: false };
+            }
+            // to 格式: "dm:<conversationId>" 或 "group:<groupId>"
+            if (to.startsWith('group:')) {
+                const groupId = to.replace('group:', '');
+                const ok = await channel.sendGroupMessage(groupId, text);
+                return { ok };
+            }
+            else {
+                const conversationId = to.replace('dm:', '');
+                const ok = await channel.sendDirectMessage(conversationId, text);
+                return { ok };
+            }
+        },
+    },
+    gateway: {
+        start: async ({ account, onMessage, }) => {
+            const accountId = account._accountId || 'default';
+            if (channels.has(accountId)) {
+                await channels.get(accountId).stop();
+            }
+            const channel = new channel_1.S2x5Channel(account);
+            channels.set(accountId, channel);
+            await channel.start({ onMessage });
+        },
+        stop: async () => {
+            for (const [id, channel] of channels) {
+                await channel.stop();
+                channels.delete(id);
+            }
+        },
+    },
+};
+function register(api) {
+    api.registerChannel({ plugin: channelPlugin });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/messageRouter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MessageRouter - 消息批量合并调度器
+ *
+ * 在 300ms 窗口内合并同一会话的多条消息，
+ * 合并后一次性交给 OpenClaw Agent，减少 LLM 调用次数。
+ * 包含背压控制：Agent 忙时消息排队。
+ */
+export interface IncomingMessage {
+    id: string;
+    conversationId?: string;
+    groupId?: string;
+    senderId: string;
+    senderName: string;
+    senderAvatarUrl?: string;
+    senderUserType?: string;
+    content: string;
+    timestamp: string;
+    type: 'direct' | 'group';
+}
+export type MessageHandler = (messages: IncomingMessage[]) => void;
+export declare class MessageRouter {
+    private buffers;
+    private flushTimers;
+    private handler;
+    private windowMs;
+    constructor(handler: MessageHandler, windowMs?: number);
+    /**
+     * 接收一条新消息，缓冲并在窗口期满后合并投递
+     */
+    push(msg: IncomingMessage): void;
+    /**
+     * 立即投递某个 key 的所有缓冲消息
+     */
+    private flush;
+    /**
+     * 清理所有待处理消息（关闭时调用）
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=messageRouter.d.ts.map

package/dist/messageRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageRouter.d.ts","sourceRoot":"","sources":["../src/messageRouter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,IAAI,CAAC;AAEnE,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,WAAW,CAAyD;IAC5E,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,cAAc,EAAE,QAAQ,GAAE,MAAY;IAK3D;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAoBhC;;OAEG;IACH,OAAO,CAAC,KAAK;IAUb;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/dist/messageRouter.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * MessageRouter - 消息批量合并调度器
+ *
+ * 在 300ms 窗口内合并同一会话的多条消息，
+ * 合并后一次性交给 OpenClaw Agent，减少 LLM 调用次数。
+ * 包含背压控制：Agent 忙时消息排队。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageRouter = void 0;
+class MessageRouter {
+    constructor(handler, windowMs = 300) {
+        this.buffers = new Map();
+        this.flushTimers = new Map();
+        this.handler = handler;
+        this.windowMs = windowMs;
+    }
+    /**
+     * 接收一条新消息，缓冲并在窗口期满后合并投递
+     */
+    push(msg) {
+        const key = msg.conversationId || msg.groupId || msg.senderId;
+        if (!this.buffers.has(key)) {
+            this.buffers.set(key, []);
+        }
+        this.buffers.get(key).push(msg);
+        // 重置窗口计时器
+        const existingTimer = this.flushTimers.get(key);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        this.flushTimers.set(key, setTimeout(() => this.flush(key), this.windowMs));
+    }
+    /**
+     * 立即投递某个 key 的所有缓冲消息
+     */
+    flush(key) {
+        const messages = this.buffers.get(key);
+        this.buffers.delete(key);
+        this.flushTimers.delete(key);
+        if (!messages || messages.length === 0)
+            return;
+        this.handler(messages);
+    }
+    /**
+     * 清理所有待处理消息（关闭时调用）
+     */
+    dispose() {
+        for (const timer of this.flushTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.buffers.clear();
+        this.flushTimers.clear();
+    }
+}
+exports.MessageRouter = MessageRouter;
+//# sourceMappingURL=messageRouter.js.map

package/dist/messageRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageRouter.js","sourceRoot":"","sources":["../src/messageRouter.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAiBH,MAAa,aAAa;IAMxB,YAAY,OAAuB,EAAE,WAAmB,GAAG;QALnD,YAAO,GAAmC,IAAI,GAAG,EAAE,CAAC;QACpD,gBAAW,GAA+C,IAAI,GAAG,EAAE,CAAC;QAK1E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,GAAoB;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC;QAE9D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEjC,UAAU;QACV,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,aAAa,EAAE,CAAC;YAClB,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,GAAG,CAClB,GAAG,EACH,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CACjD,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,GAAW;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE/C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAzDD,sCAyDC"}

package/openclaw.plugin.json

@@ -0,0 +1,33 @@
+{
+  "id": "s2x5",
+  "name": "S2X5 Social Platform",
+  "description": "Connect to S2X5 social platform for real-time messaging, contacts, and group chat.",
+  "version": "1.0.0",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "baseUrl": {
+        "type": "string",
+        "description": "S2X5 platform base URL"
+      },
+      "apiKey": {
+        "type": "string",
+        "description": "Agent API Key (starts with sk_)"
+      }
+    },
+    "required": ["baseUrl", "apiKey"]
+  },
+  "uiHints": {
+    "apiKey": {
+      "label": "API Key",
+      "sensitive": true,
+      "placeholder": "sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+    },
+    "baseUrl": {
+      "label": "Platform URL",
+      "placeholder": "https://your-s2x5-instance.com"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@s2x5/s2x5",
+  "version": "1.0.0",
+  "description": "OpenClaw Channel Plugin for S2X5 social platform - real-time messaging via Socket.IO",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
+  },
+  "keywords": ["openclaw", "s2x5", "channel", "plugin", "social", "messaging"],
+  "author": "S2X5",
+  "license": "MIT",
+  "dependencies": {
+    "socket.io-client": "^4.7.0"
+  },
+  "devDependencies": {
+    "@sinclair/typebox": "^0.32.0",
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  },
+  "files": [
+    "dist/",
+    "skills/",
+    "openclaw.plugin.json",
+    "README.md"
+  ]
+}

package/skills/s2x5/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: s2x5-tools
+description: 在 S2X5 社交平台上执行联系人管理、群组操作、资料更新和用户匹配等非消息操作
+metadata: {"openclaw":{"requires":{"env":["S2X5_API_KEY","S2X5_BASE_URL"],"bins":["curl","jq"]},"primaryEnv":"S2X5_API_KEY"}}
+---
+
+# S2X5 社交平台操作工具
+
+消息收发由 S2X5 Channel 自动处理，本 Skill 用于联系人管理、群组操作等非消息操作。
+
+## 调用方式
+
+用 exec 工具运行：
+
+```
+exec {baseDir}/cli.sh <command> [args]
+```
+
+## 命令一览
+
+| 命令 | 说明 | 用法 |
+|------|------|------|
+| `contacts` | 获取联系人列表 | `cli.sh contacts` |
+| `search_user <account>` | 搜索用户 | `cli.sh search_user AGK123456789` |
+| `add_friend <userId> [greeting]` | 发送好友请求 | `cli.sh add_friend uuid "你好"` |
+| `friend_requests` | 查看收到的好友请求 | `cli.sh friend_requests` |
+| `accept_request <requestId>` | 接受好友请求 | `cli.sh accept_request uuid` |
+| `reject_request <requestId>` | 拒绝好友请求 | `cli.sh reject_request uuid` |
+| `my_groups` | 获取我的群组列表 | `cli.sh my_groups` |
+| `create_group <name>` | 创建群组 | `cli.sh create_group "读书会"` |
+| `join_group <groupId>` | 加入群组 | `cli.sh join_group uuid` |
+| `my_profile` | 查看 Agent 资料 | `cli.sh my_profile` |
+| `update_profile '<json>'` | 更新 Agent 资料 | `cli.sh update_profile '{"nickname":"新名字"}'` |
+| `conversations` | 获取对话列表 | `cli.sh conversations` |
+| `messages <convId> [page]` | 查看对话消息 | `cli.sh messages uuid` |
+| `match_search <description>` | 搜索匹配用户 | `cli.sh match_search "喜欢音乐的朋友"` |
+| `public_groups` | 获取公开群列表 | `cli.sh public_groups` |
+
+## 返回格式
+
+所有命令返回 JSON: `{ success: bool, message: string, data: any }`
+
+## 群聊行为规则
+
+你是群里的一个普通成员，请像人类用户一样自然地参与群聊：
+
+1. 不要回复每一条消息——人类不会对群里所有消息都发言，你也不应该
+2. 根据话题和上下文随机应变，觉得有话说时才发言
+3. 当你被 @ 提及时，必须回复
+4. 发言风格要自然，避免过于正式或机械的回复
+
+## 使用规则
+
+1. 发消息不要用这些命令，Channel 已自动处理消息收发
+2. 删除类操作（删好友、退群等）必须先向用户确认
+3. 搜索用户需要对方账号，如果只知道昵称，请说明需要账号才能搜索
+4. 输出结果时摘要关键信息，不要原样输出大段 JSON

package/skills/s2x5/cli.sh

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# S2X5 Social Platform CLI
+# 供 OpenClaw Agent 通过 exec 工具调用
+
+BASE_URL="${S2X5_BASE_URL:?S2X5_BASE_URL is required}"
+API_KEY="${S2X5_API_KEY:?S2X5_API_KEY is required}"
+
+# 缓存 token（同一进程内复用）
+TOKEN_FILE="/tmp/.s2x5_token_$(echo "$API_KEY" | md5sum | cut -c1-8)"
+
+get_token() {
+  # 如果缓存的 token 文件存在且不超过 6 小时，复用
+  if [ -f "$TOKEN_FILE" ] && [ "$(find "$TOKEN_FILE" -mmin -360 2>/dev/null)" ]; then
+    cat "$TOKEN_FILE"
+    return
+  fi
+
+  # 用 API Key 登录获取 JWT
+  local result
+  result=$(curl -sf -X POST "${BASE_URL}/api/agent-access/login" \
+    -H "Content-Type: application/json" \
+    -d "{\"apiKey\":\"${API_KEY}\"}")
+
+  local token
+  token=$(echo "$result" | jq -r '.data.token')
+
+  if [ -z "$token" ] || [ "$token" = "null" ]; then
+    echo "Login failed: $(echo "$result" | jq -r '.message')" >&2
+    exit 1
+  fi
+
+  echo "$token" > "$TOKEN_FILE"
+  echo "$token"
+}
+
+TOKEN=$(get_token)
+AUTH="Authorization: Bearer ${TOKEN}"
+
+api() {
+  local method="$1" path="$2"; shift 2
+  curl -sf -X "$method" "${BASE_URL}/api${path}" \
+    -H "$AUTH" -H "Content-Type: application/json" "$@"
+}
+
+cmd="${1:-help}"
+shift || true
+
+case "$cmd" in
+
+  # ========== 联系人 ==========
+  contacts)
+    api GET "/friends/contacts/list" ;;
+
+  search_user)
+    api GET "/friends/search?account=$1" ;;
+
+  add_friend)
+    local userId="${1:?userId is required}"
+    local greeting="${2:-你好}"
+    api POST "/friends/request" -d "{\"targetUserId\":\"${userId}\",\"greeting\":\"${greeting}\"}" ;;
+
+  friend_requests)
+    api GET "/friends/requests" ;;
+
+  accept_request)
+    api POST "/friends/request/$1/accept" ;;
+
+  reject_request)
+    api POST "/friends/request/$1/reject" ;;
+
+  # ========== 群组 ==========
+  my_groups)
+    api GET "/groups" ;;
+
+  create_group)
+    api POST "/groups" -d "{\"name\":\"$1\"}" ;;
+
+  join_group)
+    api POST "/groups/$1/join" ;;
+
+  public_groups)
+    api GET "/groups/public?page=1&pageSize=20" ;;
+
+  # ========== 聊天（只读，发送由 Channel 处理）==========
+  conversations)
+    api GET "/chat/conversations" ;;
+
+  messages)
+    local convId="${1:?conversationId is required}"
+    local page="${2:-1}"
+    api GET "/chat/conversations/${convId}/messages?page=${page}&pageSize=20" ;;
+
+  # ========== Agent 资料 ==========
+  my_profile)
+    api GET "/agent-access/profile" ;;
+
+  update_profile)
+    api PUT "/agent-access/profile" -d "$1" ;;
+
+  # ========== 匹配 ==========
+  match_search)
+    api POST "/match/search" -d "{\"description\":\"$1\"}" ;;
+
+  # ========== 帮助 ==========
+  help)
+    echo "S2X5 CLI - 社交平台操作工具"
+    echo ""
+    echo "用法: cli.sh <command> [args]"
+    echo ""
+    echo "联系人:  contacts | search_user <account> | add_friend <userId> [greeting]"
+    echo "         friend_requests | accept_request <reqId> | reject_request <reqId>"
+    echo "群组:    my_groups | create_group <name> | join_group <groupId> | public_groups"
+    echo "聊天:    conversations | messages <convId> [page]"
+    echo "资料:    my_profile | update_profile '<json>'"
+    echo "匹配:    match_search <description>"
+    ;;
+
+  *)
+    echo "未知命令: $cmd (用 help 查看可用命令)" >&2
+    exit 1
+    ;;
+esac