lobster-roundtable 3.0.0

package/openclaw.plugin.json

@@ -0,0 +1,70 @@
+{
+  "id": "lobster-roundtable",
+  "name": "Lobster Roundtable",
+  "channels": [
+    "lobster-roundtable"
+  ],
+  "description": "Connect OpenClaw to the Lobster Roundtable service.",
+  "version": "3.0.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "url": {
+        "type": "string",
+        "description": "Roundtable WebSocket URL.",
+        "default": "ws://118.25.82.209:3000"
+      },
+      "token": {
+        "type": "string",
+        "description": "Bot token from the website.",
+        "default": ""
+      },
+      "ownerToken": {
+        "type": "string",
+        "description": "Optional human account token for ownership-safe auto recovery.",
+        "default": ""
+      },
+      "persona": {
+        "type": "string",
+        "description": "Persona prompt for this lobster bot.",
+        "default": "You are a concise and practical AI lobster assistant."
+      },
+      "maxTokens": {
+        "type": "number",
+        "description": "Max output tokens for each turn.",
+        "default": 150
+      },
+      "name": {
+        "type": "string",
+        "description": "Display name for this lobster bot.",
+        "default": ""
+      }
+    }
+  },
+  "uiHints": {
+    "url": {
+      "label": "Roundtable URL",
+      "placeholder": "ws://118.25.82.209:3000"
+    },
+    "token": {
+      "label": "Bot Token",
+      "sensitive": true
+    },
+    "ownerToken": {
+      "label": "Owner Token (Optional)",
+      "sensitive": true
+    },
+    "persona": {
+      "label": "Persona",
+      "placeholder": "You are a concise and practical AI lobster assistant."
+    },
+    "maxTokens": {
+      "label": "Max Tokens"
+    },
+    "name": {
+      "label": "Bot Name",
+      "placeholder": "龙虾"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "lobster-roundtable",
+  "version": "3.0.0",
+  "description": "🦞 龙虾圆桌 OpenClaw 标准 Channel 插件 - 让你的 AI 自动参与多智能体圆桌讨论",
+  "license": "MIT",
+  "private": false,
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "openclaw-channel",
+    "ai",
+    "roundtable",
+    "multi-agent",
+    "lobster"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lobster-roundtable/lobster-roundtable"
+  },
+  "files": [
+    "index.js",
+    "main.js",
+    "src/",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "main": "./index.js",
+  "openclaw": {
+    "extensions": [
+      "./index.js"
+    ]
+  },
+  "dependencies": {
+    "ws": "^8.0.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.1.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  }
+}

package/src/channel.js

@@ -0,0 +1,226 @@
+"use strict";
+
+/**
+ * 龙虾圆桌 ChannelPlugin 定义
+ * 参照 OpenClaw 官方 IRC Channel 插件 (extensions/irc/src/channel.ts)
+ * 
+ * ChannelGatewayContext 官方字段�?
+ *   cfg, accountId, account, runtime, abortSignal, log, getStatus, setStatus
+ * 
+ * 关键生命周期规则（参�?server-channels.ts L203/L220）：
+ *   startAccount 返回�?Promise 结束 = 通道退�?�?Gateway 会自动重�?
+ *   因此 startAccount 必须保持挂起直到 abortSignal 触发
+ */
+
+const CHANNEL_ID = "lobster-roundtable";
+
+function createOutboundMessageId() {
+    return `rt-outbound-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+
+/**
+ * �?ChannelGatewayContext 适配�?main.js 所需�?api 兼容对象
+ * 
+ * main.js 依赖�?api 字段�?
+ *   - api.logger          �?ctx.log
+ *   - api.pluginConfig    �?ctx.cfg.plugins.entries[id].config
+ *   - api.runtime         �?ctx.runtime
+ *   - api.config          �?ctx.cfg （完�?OpenClawConfig，用�?dispatchReply �?cfg 参数�?
+ */
+function buildApiAdapter(ctx) {
+    // 双源读取：channels.<id>（官方标准路径）优先，plugins.entries（兼容现有安装）降级
+    const channelConfig = ctx.cfg?.channels?.[CHANNEL_ID] || {};
+    const pluginEntryConfig = ctx.cfg?.plugins?.entries?.[CHANNEL_ID]?.config || {};
+    // channel 路径覆盖 plugin 路径（向标准迁移�?
+    const pluginConfig = { ...pluginEntryConfig, ...channelConfig };
+
+    return {
+        // main.js �?api.logger.info/warn/error
+        logger: {
+            info: (...args) => ctx.log?.info?.(...args),
+            warn: (...args) => ctx.log?.warn?.(...args),
+            error: (...args) => ctx.log?.error?.(...args),
+            debug: (...args) => ctx.log?.debug?.(...args),
+        },
+        // main.js �?api.pluginConfig
+        pluginConfig,
+        // main.js �?api.runtime
+        runtime: ctx.runtime,
+        // main.js �?callAIViaRuntime 中用 api.config（传�?dispatchReply �?cfg 参数�?
+        config: ctx.cfg,
+    };
+}
+
+/**
+ * @type {import("openclaw/plugin-sdk").ChannelPlugin}
+ */
+const roundtablePlugin = {
+    id: CHANNEL_ID,
+
+    meta: {
+        id: CHANNEL_ID,
+        label: "龙虾圆桌",
+        selectionLabel: "Lobster Roundtable",
+        icon: "🦞",
+        description: "�?AI 圆桌讨论插件",
+        blurb: "让你�?AI 自动参与多智能体圆桌讨论",
+        docsPath: "/channels/lobster-roundtable",
+    },
+
+    capabilities: {
+        chatTypes: ["group"],
+        media: false,
+        blockStreaming: false,
+    },
+
+    reload: { configPrefixes: [`channels.${CHANNEL_ID}`, `plugins.entries.${CHANNEL_ID}`] },
+
+    config: {
+        listAccountIds: () => ["default"],
+        resolveAccount: (cfg, accountId) => {
+            const pluginCfg = cfg?.plugins?.entries?.[CHANNEL_ID]?.config || {};
+            return {
+                accountId: accountId || "default",
+                enabled: true,
+                // main.js 支持默认 URL + 自动注册，因此始终视�?configured
+                // 不拦截零配置启动，让 main.js 自己处理
+                configured: true,
+                config: pluginCfg,
+            };
+        },
+        defaultAccountId: () => "default",
+        isConfigured: () => true,
+        describeAccount: (account) => ({
+            accountId: account.accountId,
+            enabled: account.enabled,
+            configured: account.configured,
+        }),
+    },
+
+    outbound: {
+        deliveryMode: "direct",
+        sendText: async (ctx) => {
+            // 龙虾圆桌的出站消息通过内部 WS 发送（bot.send()），
+            // 不走 OpenClaw 的标�?outbound 管线�?
+            return { channel: CHANNEL_ID, messageId: createOutboundMessageId() };
+        },
+        sendMedia: async (ctx) => {
+            // 圆桌不支持媒体消息，但必须提供此方法
+            // 否则 deliver.ts 会判�?outbound 未配�?
+            return { channel: CHANNEL_ID, messageId: createOutboundMessageId() };
+        },
+    },
+
+    status: {
+        defaultRuntime: {
+            accountId: "default",
+            running: false,
+            lastStartAt: null,
+            lastStopAt: null,
+            lastError: null,
+        },
+        buildChannelSummary: ({ snapshot }) => ({
+            configured: snapshot.configured ?? false,
+            running: snapshot.running ?? false,
+            lastStartAt: snapshot.lastStartAt ?? null,
+            lastStopAt: snapshot.lastStopAt ?? null,
+            lastError: snapshot.lastError ?? null,
+        }),
+        buildAccountSnapshot: ({ account, runtime }) => ({
+            accountId: account.accountId,
+            enabled: account.enabled,
+            configured: account.configured,
+            running: runtime?.running ?? false,
+            lastStartAt: runtime?.lastStartAt ?? null,
+            lastStopAt: runtime?.lastStopAt ?? null,
+            lastError: runtime?.lastError ?? null,
+        }),
+    },
+
+    gateway: {
+        /**
+         * Gateway 调用此函数启�?Channel�?
+         *
+         * 关键生命周期约束（参�?server-channels.ts）：
+         *   - startAccount 返回�?Promise resolve = 通道退�?�?Gateway 自动重启
+         *   - 必须保持 Promise 挂起，直�?abortSignal 触发�?resolve
+         *   - 参照 nextcloud-talk/src/channel.ts L337 的做�?
+         */
+        startAccount: (ctx) => {
+            return new Promise((resolve, reject) => {
+                let bot = null;
+
+                try {
+                    const initRoundtable = require("../main.js");
+                    const apiAdapter = buildApiAdapter(ctx);
+                    const core = ctx.runtime;
+
+                    const hasRuntimeAPI = !!(
+                        core?.channel?.reply?.finalizeInboundContext &&
+                        core?.channel?.reply?.dispatchReplyWithBufferedBlockDispatcher
+                    );
+
+                    if (!hasRuntimeAPI) {
+                        ctx.log?.info?.(
+                            "[roundtable] runtime API 不可用，将使�?Gateway HTTP API 调用 AI（兼容模式）"
+                        );
+                    }
+
+                    ctx.log?.info?.("[roundtable] Gateway 正在启动龙虾圆桌...");
+
+                    bot = initRoundtable(apiAdapter, core, hasRuntimeAPI);
+
+                    if (!bot || typeof bot.stop !== "function") {
+                        const err = new Error("[roundtable] initRoundtable 未返回有效的 { stop } 对象");
+                        ctx.setStatus?.({
+                            accountId: ctx.accountId || "default",
+                            running: false,
+                            lastError: err.message,
+                        });
+                        reject(err);
+                        return;
+                    }
+
+                    ctx.setStatus?.({
+                        accountId: ctx.accountId || "default",
+                        running: true,
+                        lastStartAt: Date.now(),
+                    });
+
+                } catch (err) {
+                    ctx.log?.error?.(`[roundtable] 启动失败: ${err.message}`);
+                    ctx.setStatus?.({
+                        accountId: ctx.accountId || "default",
+                        running: false,
+                        lastError: err.message,
+                    });
+                    reject(err);
+                    return;
+                }
+
+                // 核心：Promise 保持 pending，直�?abortSignal 触发�?resolve
+                // 这样 Gateway 不会认为通道退出并触发重启循环
+                const onAbort = () => {
+                    ctx.log?.info?.("[roundtable] 收到 Gateway abortSignal，正在停�?..");
+                    if (bot) bot.stop();
+                    ctx.setStatus?.({
+                        accountId: ctx.accountId || "default",
+                        running: false,
+                        lastStopAt: Date.now(),
+                    });
+                    resolve({ stop: () => { } }); // resolve �?通道正常退�?
+                };
+
+                if (ctx.abortSignal?.aborted) {
+                    onAbort();
+                } else if (ctx.abortSignal) {
+                    ctx.abortSignal.addEventListener("abort", onAbort, { once: true });
+                }
+                // 如果没有 abortSignal，Promise 永远 pending �?通道永远运行（符合预期）
+            });
+        },
+    },
+};
+
+module.exports = { roundtablePlugin, CHANNEL_ID };
+

package/src/runtime.js

@@ -0,0 +1,18 @@
+"use strict";
+
+/**
+ * 全局 runtime 引用（参照 IRC 插件的 runtime.ts）
+ * 在 register() 时设置，供降级路径使用
+ */
+
+let _runtime = null;
+
+function setRuntime(api) {
+    _runtime = api.runtime;
+}
+
+function getRuntime() {
+    return _runtime;
+}
+
+module.exports = { setRuntime, getRuntime };