openclaw-rocketchat 0.1.0

package/dist/service/channel.js

@@ -0,0 +1,157 @@
+// ============================================================
+// 频道后台服务主逻辑
+// Gateway 启动时自动运行：连接 RC、管理机器人、桥接消息
+// ============================================================
+import { RocketChatRestClient } from "../rc-api/rest-client.js";
+import { BotManager } from "./bot-manager.js";
+import { MessageHandler } from "./message-handler.js";
+import { loadAdminCredentials, loadBotCredentials, } from "../config/credentials.js";
+export class ChannelService {
+    config;
+    bindings;
+    botManager = null;
+    messageHandler = null;
+    adminClient = null;
+    logger;
+    running = false;
+    constructor(options) {
+        this.config = options.config;
+        this.bindings = options.bindings || [];
+        this.logger = options.logger || {
+            info: (msg) => console.log(`[RC ChannelService] ${msg}`),
+            error: (msg) => console.error(`[RC ChannelService] ${msg}`),
+        };
+    }
+    // ----------------------------------------------------------
+    // 生命周期
+    // ----------------------------------------------------------
+    /** 启动服务 */
+    async start() {
+        if (this.running)
+            return;
+        if (!this.config.enabled) {
+            this.logger.info("Rocket.Chat 插件未启用，跳过启动");
+            return;
+        }
+        if (!this.config.serverUrl) {
+            this.logger.error("未配置 serverUrl，无法启动");
+            return;
+        }
+        this.logger.info(`正在连接 Rocket.Chat: ${this.config.serverUrl}`);
+        // 1. 验证管理员连接
+        const adminCreds = await loadAdminCredentials();
+        if (!adminCreds) {
+            this.logger.error("未找到管理员凭据，请先运行 setup");
+            return;
+        }
+        this.adminClient = new RocketChatRestClient(this.config.serverUrl);
+        this.adminClient.setAuth(adminCreds.userId, adminCreds.authToken);
+        try {
+            await this.adminClient.serverInfo();
+            this.logger.info("Rocket.Chat 服务器连接成功");
+        }
+        catch (err) {
+            this.logger.error(`无法连接 Rocket.Chat: ${err.message}`);
+            return;
+        }
+        // 2. 初始化 BotManager
+        this.botManager = new BotManager(this.config.serverUrl, this.logger);
+        // 3. 初始化 MessageHandler
+        this.messageHandler = new MessageHandler({
+            botManager: this.botManager,
+            config: this.config,
+            logger: this.logger,
+        });
+        // 4. 设置消息回调
+        this.botManager.onMessage((msg, roomId, botUsername, agentId) => {
+            this.messageHandler.handleInbound(msg, roomId, botUsername, agentId);
+        });
+        // 5. 连接所有机器人
+        await this.connectBots();
+        // 6. 确保所有群组存在并订阅
+        await this.ensureGroups();
+        this.running = true;
+        this.logger.info("Rocket.Chat 频道服务已启动");
+    }
+    /** 停止服务 */
+    stop() {
+        if (!this.running)
+            return;
+        this.botManager?.disconnectAll();
+        this.running = false;
+        this.logger.info("Rocket.Chat 频道服务已停止");
+    }
+    /** 获取 MessageHandler（用于出站消息） */
+    getMessageHandler() {
+        return this.messageHandler;
+    }
+    /** 获取 BotManager */
+    getBotManager() {
+        return this.botManager;
+    }
+    // ----------------------------------------------------------
+    // 内部：连接机器人
+    // ----------------------------------------------------------
+    async connectBots() {
+        const accounts = this.config.accounts || {};
+        const botCreds = await loadBotCredentials();
+        for (const [accountId, account] of Object.entries(accounts)) {
+            const creds = botCreds[account.botUsername];
+            if (!creds) {
+                this.logger.error(`机器人 ${account.botUsername} 无凭据，跳过`);
+                continue;
+            }
+            try {
+                // 从 bindings 中查找该 account 绑定的 agentId
+                const binding = this.bindings.find((b) => b.match?.channel === "rocketchat" && b.match?.accountId === accountId);
+                const agentId = binding?.agentId || accountId;
+                await this.botManager.addBot(account.botUsername, creds.password, creds.userId, agentId, account.botDisplayName);
+                // 订阅该机器人所有相关的 DM
+                await this.subscribeBotDMs(account.botUsername);
+            }
+            catch (err) {
+                this.logger.error(`机器人 ${account.botUsername} 启动失败: ${err.message}`);
+            }
+        }
+    }
+    /** 订阅机器人的所有 DM */
+    async subscribeBotDMs(botUsername) {
+        const restClient = this.botManager.getRestClient(botUsername);
+        if (!restClient)
+            return;
+        try {
+            const dms = await restClient.listDirectMessages();
+            for (const dm of dms) {
+                await this.botManager.subscribeRoom(botUsername, dm._id);
+            }
+        }
+        catch (err) {
+            this.logger.error(`${botUsername}: 获取 DM 列表失败: ${err.message}`);
+        }
+    }
+    // ----------------------------------------------------------
+    // 内部：确保群组存在
+    // ----------------------------------------------------------
+    async ensureGroups() {
+        const groups = this.config.groups || {};
+        for (const [groupName, groupConfig] of Object.entries(groups)) {
+            try {
+                // 检查群组是否存在
+                const groupInfo = await this.adminClient.getGroupInfo(undefined, groupName);
+                if (groupInfo) {
+                    // 群组存在，为其中的每个机器人订阅消息
+                    for (const botUsername of groupConfig.bots || []) {
+                        await this.botManager.subscribeRoom(botUsername, groupInfo._id);
+                    }
+                }
+                else {
+                    this.logger.error(`群组「${groupName}」不存在！请运行: openclaw rocketchat add-group`);
+                }
+            }
+            catch (err) {
+                this.logger.error(`检查群组「${groupName}」失败: ${err.message}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/service/channel.js.map

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

package/dist/service/message-handler.d.ts

@@ -0,0 +1,45 @@
+import type { RcMessage, RocketchatChannelConfig } from "../rc-api/types.js";
+import type { BotManager } from "./bot-manager.js";
+interface MessageHandlerOptions {
+    botManager: BotManager;
+    config: Partial<RocketchatChannelConfig>;
+    logger?: {
+        info: (msg: string) => void;
+        error: (msg: string) => void;
+    };
+}
+export declare class MessageHandler {
+    private botManager;
+    private config;
+    private logger;
+    /** 正在处理中的消息 ID 集合（防止并发重复处理） */
+    private processingMessages;
+    constructor(options: MessageHandlerOptions);
+    /**
+     * 处理入站消息
+     * 由 BotManager 的 onMessage 回调调用
+     */
+    handleInbound(msg: RcMessage, roomId: string, botUsername: string, agentId: string): Promise<void>;
+    /**
+     * 发送 Agent 回复到 Rocket.Chat
+     * 由频道插件的 outbound.sendText 调用
+     */
+    handleOutbound(text: string, botUsername: string, roomId: string): Promise<void>;
+    /**
+     * 判断机器人是否应该响应该消息
+     * - DM 消息：始终响应
+     * - 群组消息：根据 requireMention 规则判断
+     */
+    private shouldRespond;
+    /**
+     * 通过 openclaw CLI 将消息发送给 Agent
+     */
+    private sendToOpenClaw;
+    /**
+     * 将长文本分块
+     * 尽量按段落或代码块边界分割
+     */
+    private splitText;
+}
+export {};
+//# sourceMappingURL=message-handler.d.ts.map

package/dist/service/message-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handler.d.ts","sourceRoot":"","sources":["../../src/service/message-handler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAOnD,UAAU,qBAAqB;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACxE;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,MAAM,CAAgE;IAC9E,+BAA+B;IAC/B,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,OAAO,EAAE,qBAAqB;IAa1C;;;OAGG;IACG,aAAa,CACjB,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IA2EhB;;;OAGG;IACG,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;YACW,cAAc;IA4C5B;;;OAGG;IACH,OAAO,CAAC,SAAS;CAyClB"}

package/dist/service/message-handler.js

@@ -0,0 +1,207 @@
+// ============================================================
+// 消息桥接：RC 消息 <-> OpenClaw Agent
+// 入站：接收 RC 消息 → 路由到 Agent
+// 出站：Agent 回复 → 格式化 → 发回 RC
+// ============================================================
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** 长文本分块大小（Rocket.Chat 单条消息建议不超过 4000 字符） */
+const MAX_MESSAGE_LENGTH = 4000;
+export class MessageHandler {
+    botManager;
+    config;
+    logger;
+    /** 正在处理中的消息 ID 集合（防止并发重复处理） */
+    processingMessages = new Set();
+    constructor(options) {
+        this.botManager = options.botManager;
+        this.config = options.config;
+        this.logger = options.logger || {
+            info: (msg) => console.log(`[RC MessageHandler] ${msg}`),
+            error: (msg) => console.error(`[RC MessageHandler] ${msg}`),
+        };
+    }
+    // ----------------------------------------------------------
+    // 入站：RC 消息 → OpenClaw Agent
+    // ----------------------------------------------------------
+    /**
+     * 处理入站消息
+     * 由 BotManager 的 onMessage 回调调用
+     */
+    async handleInbound(msg, roomId, botUsername, agentId) {
+        // 消息去重：防止同一条消息被多个 bot 或重连后重复处理
+        const msgKey = `${roomId}:${msg._id}`;
+        if (this.processingMessages.has(msgKey))
+            return;
+        this.processingMessages.add(msgKey);
+        // 处理完成后清理（30 秒超时兜底）
+        const cleanup = () => this.processingMessages.delete(msgKey);
+        setTimeout(cleanup, 30000);
+        // 检查 @提及 规则（群组消息）
+        if (!this.shouldRespond(msg, botUsername, roomId)) {
+            cleanup();
+            return;
+        }
+        // 提取消息文本
+        let text = msg.msg || "";
+        // 处理附件（图片、文件、语音）
+        if (msg.attachments?.length) {
+            for (const att of msg.attachments) {
+                if (att.image_url) {
+                    text += `\n[图片: ${att.image_url}]`;
+                }
+                else if (att.audio_url) {
+                    text += `\n[语音: ${att.audio_url}]`;
+                }
+                else if (att.title_link) {
+                    text += `\n[文件: ${att.title_link}]`;
+                }
+            }
+        }
+        if (!text.trim()) {
+            return;
+        }
+        // 通过 openclaw message send CLI 发送给 Agent
+        this.logger.info(`入站: ${msg.u.username} -> ${botUsername} (Agent: ${agentId}): ${text.slice(0, 100)}...`);
+        try {
+            await this.sendToOpenClaw(text, botUsername, msg.u.username, roomId);
+        }
+        catch (err) {
+            const errMsg = err.message || "";
+            this.logger.error(`发送到 OpenClaw 失败: ${errMsg}`);
+            // 如果 Agent 不存在或绑定丢失，回复用户一条友好提示
+            if (errMsg.includes("agent") ||
+                errMsg.includes("not found") ||
+                errMsg.includes("binding") ||
+                errMsg.includes("No matching")) {
+                try {
+                    await this.handleOutbound("⚠️ 抱歉，我绑定的 AI Agent 当前不可用。请联系管理员检查 Agent 配置。", botUsername, roomId);
+                }
+                catch {
+                    // 回复也失败，只能记日志
+                }
+            }
+        }
+    }
+    // ----------------------------------------------------------
+    // 出站：OpenClaw Agent → RC
+    // ----------------------------------------------------------
+    /**
+     * 发送 Agent 回复到 Rocket.Chat
+     * 由频道插件的 outbound.sendText 调用
+     */
+    async handleOutbound(text, botUsername, roomId) {
+        this.logger.info(`出站: ${botUsername} -> ${roomId}: ${text.slice(0, 100)}...`);
+        // 长文本分块发送
+        const chunks = this.splitText(text, MAX_MESSAGE_LENGTH);
+        for (const chunk of chunks) {
+            try {
+                await this.botManager.sendMessage(botUsername, roomId, chunk);
+            }
+            catch (err) {
+                this.logger.error(`发送消息失败: ${err.message}`);
+            }
+        }
+    }
+    // ----------------------------------------------------------
+    // 内部：消息路由
+    // ----------------------------------------------------------
+    /**
+     * 判断机器人是否应该响应该消息
+     * - DM 消息：始终响应
+     * - 群组消息：根据 requireMention 规则判断
+     */
+    shouldRespond(msg, botUsername, roomId) {
+        // 检查是否在群组中且需要 @提及
+        const groups = this.config.groups || {};
+        for (const [, groupConfig] of Object.entries(groups)) {
+            if (groupConfig.bots?.includes(botUsername) && groupConfig.requireMention) {
+                // 需要 @提及 才响应
+                const isMentioned = msg.mentions?.some((m) => m.username === botUsername);
+                if (!isMentioned) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * 通过 openclaw CLI 将消息发送给 Agent
+     */
+    async sendToOpenClaw(text, accountId, senderId, roomId) {
+        // 基本校验：确保标识符不为空、不包含控制字符
+        if (!accountId || !senderId || !roomId) {
+            this.logger.error("sendToOpenClaw: 缺少必要的标识符参数");
+            return;
+        }
+        try {
+            // execFileAsync 不走 shell，参数不会被 shell 解析，注入风险极低
+            await execFileAsync("openclaw", [
+                "message",
+                "send",
+                "--channel",
+                "rocketchat",
+                "--account",
+                accountId,
+                "--target",
+                roomId,
+                "--sender",
+                senderId,
+                "-m",
+                text,
+            ], { timeout: 30000 });
+        }
+        catch (err) {
+            // 如果 openclaw CLI 不可用，记录错误但不抛出
+            this.logger.error(`openclaw message send 失败: ${err.message}`);
+        }
+    }
+    // ----------------------------------------------------------
+    // 工具
+    // ----------------------------------------------------------
+    /**
+     * 将长文本分块
+     * 尽量按段落或代码块边界分割
+     */
+    splitText(text, maxLength) {
+        if (text.length <= maxLength) {
+            return [text];
+        }
+        const chunks = [];
+        let remaining = text;
+        while (remaining.length > 0) {
+            if (remaining.length <= maxLength) {
+                chunks.push(remaining);
+                break;
+            }
+            // 优先在代码块边界分割
+            let splitIndex = remaining.lastIndexOf("\n```\n", maxLength);
+            if (splitIndex > maxLength * 0.5) {
+                splitIndex += 5; // 包含 \n```\n
+            }
+            else {
+                // 在段落边界分割
+                splitIndex = remaining.lastIndexOf("\n\n", maxLength);
+                if (splitIndex > maxLength * 0.5) {
+                    splitIndex += 2;
+                }
+                else {
+                    // 在换行处分割
+                    splitIndex = remaining.lastIndexOf("\n", maxLength);
+                    if (splitIndex > maxLength * 0.5) {
+                        splitIndex += 1;
+                    }
+                    else {
+                        // 强制分割
+                        splitIndex = maxLength;
+                    }
+                }
+            }
+            chunks.push(remaining.slice(0, splitIndex));
+            remaining = remaining.slice(splitIndex);
+        }
+        return chunks;
+    }
+}
+//# sourceMappingURL=message-handler.js.map

package/dist/service/message-handler.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,45 @@
+{
+  "id": "rocketchat",
+  "name": "Rocket.Chat",
+  "description": "Rocket.Chat channel plugin for OpenClaw — connect via mobile app, ideal for China mainland users",
+  "version": "0.1.0",
+  "channels": ["rocketchat"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": { "type": "boolean", "default": false },
+      "serverUrl": {
+        "type": "string",
+        "description": "Rocket.Chat server URL, e.g. http://192.168.1.100:3000"
+      },
+      "port": { "type": "number", "default": 3000 },
+      "dmPolicy": {
+        "type": "string",
+        "enum": ["pairing", "allowlist", "open"],
+        "default": "pairing"
+      },
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "botUsername": { "type": "string" },
+            "botDisplayName": { "type": "string" }
+          },
+          "required": ["botUsername"]
+        }
+      },
+      "groups": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "requireMention": { "type": "boolean", "default": false },
+            "bots": { "type": "array", "items": { "type": "string" } }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "openclaw-rocketchat",
+  "version": "0.1.0",
+  "description": "Rocket.Chat channel plugin for OpenClaw — connect via mobile app, ideal for China mainland users",
+  "type": "module",
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "openclaw": {
+    "extensions": [
+      "./src/index.ts"
+    ],
+    "channel": {
+      "id": "rocketchat",
+      "label": "Rocket.Chat",
+      "selectionLabel": "Rocket.Chat (self-hosted)",
+      "docsPath": "/channels/rocketchat",
+      "blurb": "Self-hosted team chat via Rocket.Chat, ideal for China mainland users.",
+      "order": 70,
+      "aliases": [
+        "rc",
+        "rocket"
+      ]
+    }
+  },
+  "files": [
+    "dist/",
+    "openclaw.plugin.json"
+  ],
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "rocketchat",
+    "rocket.chat",
+    "china",
+    "im",
+    "chat"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "json5": "^2.2.3",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}