@rlynicrisis/link 0.0.9 → 0.1.1

package/README.md

@@ -103,6 +103,91 @@ curl --location --request POST 'https://www.bingolink.biz/sso/oauth2/token' \
 
 > **提示**: 请将 `username` 和 `password` 替换为您的实际账号信息。响应结果将包含 `access_token` 和 `refresh_token`。
 
+## 多账号支持 (Multi-Account Support)
+
+插件支持在同一个 OpenClaw 实例中同时连接多个 Link 账号，每个账号独立维护连接和消息路由。
+
+### 配置格式
+
+在 `channels.link` 下添加 `accounts` 字段，以账号 ID 为键，每个账号独立配置：
+
+```yaml
+channels:
+  link:
+    accounts:
+      default:
+        host: "embtcp.bingolink.biz:20081"
+        accessToken: "token_for_default_account"
+        refreshToken: "refresh_token_for_default"
+        ssoUrl: "https://www.bingolink.biz/sso"
+      work:
+        host: "embtcp.bingolink.biz:20081"
+        accessToken: "token_for_work_account"
+        refreshToken: "refresh_token_for_work"
+        ssoUrl: "https://www.bingolink.biz/sso"
+```
+
+### 绑定配置
+
+使用 `bindings` 将不同账号路由到不同的 Agent：
+
+```yaml
+bindings:
+  - agentId: "main"
+    match:
+      channel: "link"
+      accountId: "default"
+  - agentId: "work-agent"
+    match:
+      channel: "link"
+      accountId: "work"
+```
+
+### JSON 格式示例
+
+```json
+{
+  "channels": {
+    "link": {
+      "accounts": {
+        "default": {
+          "host": "embtcp.bingolink.biz:20081",
+          "accessToken": "xxx",
+          "refreshToken": "xxx",
+          "ssoUrl": "https://www.bingolink.biz/sso"
+        },
+        "work": {
+          "host": "embtcp.bingolink.biz:20081",
+          "accessToken": "yyy",
+          "refreshToken": "yyy",
+          "ssoUrl": "https://www.bingolink.biz/sso"
+        }
+      }
+    }
+  },
+  "bindings": [
+    { "agentId": "main", "match": { "channel": "link", "accountId": "default" } },
+    { "agentId": "work-agent", "match": { "channel": "link", "accountId": "work" } }
+  ]
+}
+```
+
+### 向后兼容 (Backward Compatibility)
+
+**无需修改现有配置**。如果没有 `accounts` 字段，插件会将根级别的 `host`、`accessToken` 等字段视为 `accountId = "default"` 的账号，行为与之前完全一致：
+
+```yaml
+# 旧配置格式，继续有效
+channels:
+  link:
+    host: "embtcp.bingolink.biz:20081"
+    accessToken: "your_token"
+    refreshToken: "your_refresh_token"
+    ssoUrl: "https://www.bingolink.biz/sso"
+```
+
+> **注意**: `accounts` 字段与根级别的 `host`/`accessToken` 互斥。当 `accounts` 存在时，根级别字段会被忽略。
+
 ## 开发调试
 
 ### 单元测试

package/openclaw.plugin.json

@@ -8,11 +8,31 @@
     "type": "object",
     "additionalProperties": false,
     "properties": {
-      "host": { "type": "string", "description": "Link Server Host (e.g. embtcpbeta.bingolink.biz:20081)" },
-      "ssoUrl": { "type": "string", "description": "SSO URL for refreshing token (e.g. https://sso.example.com)" },
+      "host": { "type": "string", "description": "Link Server Host", "default": "embtcp.bingolink.biz:20081" },
+      "ssoUrl": { "type": "string", "description": "SSO URL for refreshing token", "default": "https://www.bingolink.biz:443/sso" },
       "accessToken": { "type": "string", "description": "User Access Token" },
       "refreshToken": { "type": "string", "description": "User Refresh Token (Optional)" },
-      "heartbeatIntervalMs": { "type": "number", "default": 30000 }
+      "groupId": { "type": "string", "description": "Group ID to monitor (enables group bot mode)" },
+      "botToken": { "type": "string", "description": "Group bot webhook token" },
+      "notificationApiUrl": { "type": "string", "description": "Webhook base URL", "default": "https://notificationapi.bingolink.biz:443/notificationapi" },
+      "accounts": {
+        "type": "object",
+        "description": "Multi-account configuration. Keys are accountIds.",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["accessToken"],
+          "properties": {
+            "host": { "type": "string", "description": "Link Server Host", "default": "embtcp.bingolink.biz:20081" },
+            "accessToken": { "type": "string", "description": "User Access Token" },
+            "refreshToken": { "type": "string", "description": "User Refresh Token (Optional)" },
+            "ssoUrl": { "type": "string", "description": "SSO URL for refreshing token", "default": "https://www.bingolink.biz:443/sso" },
+            "groupId": { "type": "string", "description": "Group ID to monitor (enables group bot mode)" },
+            "botToken": { "type": "string", "description": "Group bot webhook token" },
+            "notificationApiUrl": { "type": "string", "description": "Webhook base URL", "default": "https://notificationapi.bingolink.biz:443/notificationapi" }
+          }
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rlynicrisis/link",
-  "version": "0.0.9",
+  "version": "0.1.1",
   "type": "module",
   "description": "OpenClaw Link channel plugin",
   "files": [

package/src/bot.ts

@@ -2,29 +2,34 @@ import {
   type ClawdbotConfig,
   type RuntimeEnv,
 } from "openclaw/plugin-sdk";
-import { LinkConfig } from "./types.js";
-import { createLinkClient, getLinkClient } from "./client-manager.js";
+import { LinkConfig, LinkChannelConfig, resolveAccountConfig, applyLinkDefaults } from "./types.js";
+import { createLinkClient, getLinkClient, removeLinkClient } from "./client-manager.js";
 import { getLinkRuntime } from "./runtime.js";
 import { createLinkReplyDispatcher } from "./reply-dispatcher.js";
 import { EmbMessage } from "./link/types.js";
 import { MsgType, ParticipantType } from "./link/constants.js";
 
-export async function startLinkBot(cfg: ClawdbotConfig, runtime: RuntimeEnv) {
-  const linkCfg = cfg.channels?.link as LinkConfig | undefined;
-  
-  // Basic validation
-  if (!linkCfg) {
-    // Channel not enabled or configured
+export async function startLinkBot(cfg: ClawdbotConfig, runtime: RuntimeEnv, accountId: string = "default") {
+  const channelCfg = cfg.channels?.link as LinkChannelConfig | undefined;
+
+  if (!channelCfg) {
     return;
   }
-  
+
+  const rawCfg = resolveAccountConfig(channelCfg, accountId);
+
+  if (!rawCfg) {
+    runtime.log?.(`Link: no config found for accountId=${accountId}`);
+    return;
+  }
+
+  const linkCfg = applyLinkDefaults(rawCfg);
+
   if (!linkCfg.accessToken) {
-    runtime.log?.("Link channel configured but missing accessToken");
+    runtime.log?.(`Link channel configured but missing accessToken for accountId=${accountId}`);
     return;
   }
-  
-  const accountId = "default"; // For now single account support
-  
+
   let client = getLinkClient(accountId);
   if (!client) {
     client = createLinkClient(accountId, linkCfg);
@@ -51,8 +56,8 @@ export async function startLinkBot(cfg: ClawdbotConfig, runtime: RuntimeEnv) {
   }
 }
 
-export async function stopLinkBot() {
-  // Implement cleanup if needed
+export async function stopLinkBot(accountId: string = "default") {
+  removeLinkClient(accountId);
 }
 
 async function handleLinkMessage(params: {
@@ -75,15 +80,17 @@ async function handleLinkMessage(params: {
 
   const senderId = msg.fromId || "unknown";
   
-  // SECURITY: Only process messages sent by the bot user itself AND sent to itself (FileHelper/Self)
-  // Note: userId is populated in client.ts into verifyInfo during connection
   const allowedUserId = linkCfg.verifyInfo?.userId;
   const receiverId = msg.toId || "unknown";
 
-  console.log(`[LinkBot] allowedUserId=${allowedUserId}, senderId=${senderId}, receiverId=${receiverId}`);
+  console.log(`[LinkBot] allowedUserId=${allowedUserId}, senderId=${senderId}, receiverId=${receiverId}, toType=${msg.toType}`);
 
-  if (!allowedUserId || senderId !== allowedUserId || receiverId !== allowedUserId) {
-    return;
+  if (linkCfg.groupId) {
+    // Group mode: only accept messages sent to the configured group
+    if (msg.toId !== linkCfg.groupId || msg.toType !== ParticipantType.GROUP) return;
+  } else {
+    // FileHelper mode: only accept self-messages (sender == receiver == self)
+    if (!allowedUserId || senderId !== allowedUserId || receiverId !== allowedUserId) return;
   }
 
   // Convert content to string if it's a buffer

package/src/channel.ts

@@ -1,6 +1,7 @@
 import type { ChannelPlugin } from "openclaw/plugin-sdk";
 import { startLinkBot, stopLinkBot } from "./bot.js";
 import { linkOnboardingAdapter } from "./onboarding.js";
+import { LinkChannelConfig } from "./types.js";
 
 export const linkPlugin: ChannelPlugin<any> = {
   id: "link",
@@ -51,17 +52,21 @@ export const linkPlugin: ChannelPlugin<any> = {
   },
   config: {
     listAccountIds: (cfg) => {
-        // Return default account if channel is configured
-        if (cfg?.channels?.link?.accessToken) { return ["default"]; }
-        return []; 
+      const linkCfg = cfg?.channels?.link as LinkChannelConfig | undefined;
+      if (!linkCfg) return [];
+      if (linkCfg.accounts) {
+        return Object.keys(linkCfg.accounts);
+      }
+      // Backward compat: single-account root config
+      if (linkCfg.accessToken) return ["default"];
+      return [];
     },
     resolveAccount: (cfg, accountId) => {
-      // Return dummy account for now
       return {
         accountId,
         enabled: true,
         configured: true,
-        name: "Link Bot",
+        name: `Link Bot (${accountId})`,
       } as any;
     },
     defaultAccountId: (cfg) => "default",
@@ -77,11 +82,11 @@ export const linkPlugin: ChannelPlugin<any> = {
   },
   gateway: {
     startAccount: async (ctx) => {
-      await startLinkBot(ctx.cfg, ctx.runtime);
-      
+      await startLinkBot(ctx.cfg, ctx.runtime, ctx.accountId);
+
       return new Promise((resolve) => {
         ctx.abortSignal.addEventListener("abort", () => {
-          stopLinkBot();
+          stopLinkBot(ctx.accountId);
           resolve(undefined);
         });
       });

package/src/client-manager.ts

@@ -1,5 +1,5 @@
 import { LinkClient } from "./link/client.js";
-import { LinkConfig } from "./types.js";
+import { LinkConfig, LINK_DEFAULTS } from "./types.js";
 
 const clients = new Map<string, LinkClient>();
 
@@ -14,7 +14,7 @@ export function createLinkClient(accountId: string, config: LinkConfig): LinkCli
   }
   
   // Parse host:port
-  const parts = config.host.split(':');
+  const parts = (config.host || LINK_DEFAULTS.host).split(':');
   let host = parts[0];
   let port = 20081; // Default port
   

package/src/link/client.ts

@@ -13,6 +13,7 @@ export class LinkClient extends EventEmitter {
   private heartbeatInterval: NodeJS.Timeout | null = null;
   private reconnectTimeout: NodeJS.Timeout | null = null;
   private isConnected = false;
+  private immediateReconnect = false;
   
   constructor(
     public readonly config: {
@@ -181,11 +182,13 @@ export class LinkClient extends EventEmitter {
 
   private scheduleReconnect() {
     if (this.reconnectTimeout) return;
+    const delay = this.immediateReconnect ? 0 : 5000;
+    this.immediateReconnect = false;
     this.reconnectTimeout = setTimeout(() => {
       this.reconnectTimeout = null;
       console.log('Reconnecting...');
       this.connect();
-    }, 5000);
+    }, delay);
   }
 
   private processBuffer() {
@@ -250,6 +253,7 @@ export class LinkClient extends EventEmitter {
         if (body) {
           try {
             const msg = decodeMessage(body);
+            this.sendReceipt(msg.id);
             this.emit('message', msg);
           } catch (e) {
             console.error('Failed to decode message:', e);
@@ -278,11 +282,22 @@ export class LinkClient extends EventEmitter {
         // Ignore for now or log
         // console.log(`Received cmd: 0x${cmdCode.toString(16)}, body: ${body}`);
         break;
+      case CmdCodes.FORCE_RECONNECT_DOWN:
+        console.log('Server signaled session reset (0x6b), will reconnect immediately on disconnect');
+        this.immediateReconnect = true;
+        break;
       default:
          console.log(`Received unknown cmd: 0x${cmdCode.toString(16)}, body: ${body}`);
     }
   }
 
+  private sendReceipt(msgId: unknown) {
+    if (!this.socket || !this.isConnected) return;
+    console.log('Sending receipt for message:', msgId);
+    const packet = encodePacket(CmdCodes.SEND_MSG_RECEIPT, String(msgId));
+    this.socket.write(packet);
+  }
+
   private async refreshAccessToken() {
     if (!this.config.refreshToken || !this.config.ssoUrl) {
       console.error('Cannot refresh token: Missing refreshToken or ssoUrl in config');

package/src/link/constants.ts

@@ -19,6 +19,7 @@ export const CmdCodes = {
   SERVICE_TOKEN_UP: 0x10,
   SERVICE_TOKEN_DOWN: 0x11,
   CLEAR_DEVICE_OFFMSG: 0x14,
+  FORCE_RECONNECT_DOWN: 0x6b,   // Server signals session reset / connection cycling
 } as const;
 
 export enum MsgType {

package/src/link/message.js

@@ -1,5 +1,6 @@
 /*eslint-disable block-scoped-var, id-length, no-control-regex, no-magic-numbers, no-prototype-builtins, no-redeclare, no-shadow, no-var, sort-vars*/
-import * as $protobuf from "protobufjs/minimal.js";
+import * as $protobufNs from "protobufjs/minimal.js";
+const $protobuf = $protobufNs.default || $protobufNs;
 
 // Common aliases
 const $Reader = $protobuf.Reader, $Writer = $protobuf.Writer, $util = $protobuf.util;

package/src/send.ts

@@ -8,32 +8,48 @@ export async function sendMessageLink(params: {
   to: string;
   text: string;
   accountId?: string;
-  cfg: LinkConfig; // Might need config for some context
+  cfg: LinkConfig;
 }): Promise<void> {
+  const { cfg } = params;
+
+  // Group bot mode: send via HTTP webhook
+  if (cfg.groupId && cfg.botToken && cfg.notificationApiUrl) {
+    const url = `${cfg.notificationApiUrl}/hook/send?token=${cfg.botToken}`;
+    const res = await fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        msgType: 'text',
+        content: { text: params.text }
+      })
+    });
+    if (!res.ok) {
+      throw new Error(`Group bot webhook failed: ${res.status} ${res.statusText}`);
+    }
+    return;
+  }
+
+  // FileHelper mode: send via TCP self-message
   const accountId = params.accountId || "default";
   const client = getLinkClient(accountId);
-  
+
   if (!client) {
     throw new Error(`Link client not found for account ${accountId}`);
   }
 
-  // SECURITY: Only allow sending messages to self
-  // Note: verifyInfo.userId is populated in client.ts
+  // SECURITY: Only allow sending messages to self in non-group mode
   const allowedUserId = client.config.verifyInfo?.userId;
   if (!allowedUserId || params.to !== allowedUserId) {
-    // console.warn(`Link: Blocked outgoing message to ${params.to}. Only self-messages are allowed.`);
-    // Silently fail or throw? Throwing might cause retries or errors in logs.
-    // Let's throw for now to make it explicit.
-    throw new Error(`Link: Sending messages to others (${params.to}) is restricted. Only self-messages allowed.`);
+    throw new Error(`Link: Sending messages to others (${params.to}) is restricted. Only self-messages allowed in non-group mode.`);
   }
 
   const msg: EmbMessage = {
     id: randomUUID(),
     type: MsgType.TEXT,
     content: params.text,
-    fromType: ParticipantType.USER, // Or SYSTEM? Using USER for bot acting as user
+    fromType: ParticipantType.USER,
     fromId: allowedUserId,
-    toType: ParticipantType.USER,  
+    toType: ParticipantType.USER,
     toId: params.to,
     sendTime: Date.now(),
     read: false

package/src/types.ts

@@ -1,18 +1,63 @@
 import type { ClawdbotConfig } from "openclaw/plugin-sdk";
 import { ClientVerifyInfo } from "./link/types.js";
 
+export const LINK_DEFAULTS = {
+  host: 'embtcp.bingolink.biz:20081',
+  ssoUrl: 'https://www.bingolink.biz:443/sso',
+  notificationApiUrl: 'https://notificationapi.bingolink.biz:443/notificationapi',
+} as const;
+
 export interface LinkConfig {
-  host: string;
+  host?: string;                 // Default: embtcp.bingolink.biz:20081
   // port: number; // merged into host
   accessToken: string;
   refreshToken?: string;
-  ssoUrl?: string;
+  ssoUrl?: string;               // Default: https://www.bingolink.biz:443/sso
   verifyInfo?: Partial<ClientVerifyInfo>;
   heartbeatIntervalMs?: number;
   protocol?: "tcp" | "ws"; // Default tcp
+  // Group bot config
+  groupId?: string;              // Group ID to monitor
+  botToken?: string;             // Group bot webhook token
+  notificationApiUrl?: string;   // Default: https://notificationapi.bingolink.biz:443/notificationapi
+}
+
+/** Fill in default values for optional fields that have known defaults. */
+export function applyLinkDefaults(cfg: LinkConfig): LinkConfig {
+  return {
+    ...cfg,
+    host: cfg.host || LINK_DEFAULTS.host,
+    ssoUrl: cfg.ssoUrl || LINK_DEFAULTS.ssoUrl,
+    notificationApiUrl: cfg.notificationApiUrl || LINK_DEFAULTS.notificationApiUrl,
+  };
 }
 
 export interface LinkAccountConfig {
   accountId?: string;
   config: LinkConfig;
 }
+
+/** Top-level channels.link config — supports both single-account and multi-account */
+export interface LinkChannelConfig extends Partial<LinkConfig> {
+  accounts?: Record<string, LinkConfig>;
+}
+
+/**
+ * Resolve the LinkConfig for a given accountId.
+ * When `accounts` is present, looks up the named entry.
+ * Otherwise falls back to the root config (backward-compat single-account "default").
+ */
+export function resolveAccountConfig(
+  channelCfg: LinkChannelConfig,
+  accountId: string
+): LinkConfig | undefined {
+  if (channelCfg.accounts) {
+    return channelCfg.accounts[accountId];
+  }
+  // Backward compat: treat root-level fields as the "default" account
+  if (accountId === "default" && channelCfg.host && channelCfg.accessToken) {
+    const { accounts, ...rest } = channelCfg as any;
+    return rest as LinkConfig;
+  }
+  return undefined;
+}