nc-local-im-connector 0.2.0

package/.idea/.name

@@ -0,0 +1 @@
+plugin.ts

package/.idea/material_theme_project_new.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="MaterialThemeProjectNewConfig">
+    <option name="metadata">
+      <MTProjectMetadataState>
+        <option name="migrated" value="true" />
+        <option name="pristineConfig" value="false" />
+        <option name="userId" value="654a8689:19b960f5909:-7ffe" />
+      </MTProjectMetadataState>
+    </option>
+  </component>
+</project>

package/.idea/workspace.xml

@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="72d8575a-9a43-4cdf-a196-80b2045c8c32" name="更改" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="EmbeddingIndexingInfo">
+    <option name="cachedIndexableFilesCount" value="8" />
+    <option name="fileBasedEmbeddingIndicesEnabled" value="true" />
+  </component>
+  <component name="McpProjectServerCommands">
+    <commands />
+    <urls />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 8,
+  &quot;fromUser&quot;: false
+}</component>
+  <component name="ProjectId" id="3Bk7kwJhq7JLlNygBJKC2xPKVrZ" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{
+  &quot;keyToString&quot;: {
+    &quot;ModuleVcsDetector.initialDetectionPerformed&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.MCP Project settings loaded&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.typescript.service.memoryLimit.init&quot;: &quot;true&quot;,
+    &quot;codeWithMe.voiceChat.enabledByDefault&quot;: &quot;false&quot;,
+    &quot;com.intellij.ml.llm.matterhorn.ej.ui.settings.DefaultModelSelectionForGA.v1&quot;: &quot;true&quot;,
+    &quot;javascript.preferred.runtime.type.id&quot;: &quot;node&quot;,
+    &quot;junie.onboarding.icon.badge.shown&quot;: &quot;true&quot;,
+    &quot;last_opened_file_path&quot;: &quot;C:/Users/15015/Desktop/plugins&quot;,
+    &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
+    &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
+    &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
+    &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
+    &quot;nodejs_package_manager_path&quot;: &quot;yarn&quot;,
+    &quot;to.speed.mode.migration.done&quot;: &quot;true&quot;,
+    &quot;ts.external.directory.path&quot;: &quot;D:\\jetapp\\WebStorm\\plugins\\javascript-plugin\\jsLanguageServicesImpl\\external&quot;,
+    &quot;vue.rearranger.settings.migration&quot;: &quot;true&quot;
+  }
+}</component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-3bd3a6803838-JavaScript-WS-261.22158.274" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="默认任务">
+      <changelist id="72d8575a-9a43-4cdf-a196-80b2045c8c32" name="更改" comment="" />
+      <created>1775021361019</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1775021361019</updated>
+      <workItem from="1775021362043" duration="1702000" />
+      <workItem from="1775023777571" duration="3938000" />
+      <workItem from="1775034040086" duration="41000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+</project>

package/README.md

@@ -0,0 +1,150 @@
+# My Chat Plugin - HTTP Webhook 版
+
+通过 HTTP Webhook 接收外部消息，简单易用。
+
+## 文件结构
+
+```
+my-chat-plugin/
+├── openclaw.plugin.json   # 插件元信息
+├── plugin.ts              # 核心插件代码（HTTP Webhook 模式）
+├── package.json           # NPM 依赖配置
+└── README.md             # 本文件
+```
+
+## 快速开始
+
+### 1. 安装插件
+
+将插件目录放入 OpenClaw 扩展目录：
+
+```bash
+cp -r my-chat-plugin ~/.openclaw/extensions/
+```
+
+### 2. 配置插件
+
+在 OpenClaw 配置文件中添加：
+
+```json
+{
+  "channels": {
+    "my-chat-plugin": {
+      "enabled": true,
+      "port": 3000,
+      "replyUrl": "https://your-server.com/reply",
+      "systemPrompt": "你是一个助手...",
+      "gatewayToken": ""
+    }
+  }
+}
+```
+
+**配置项说明：**
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `enabled` | `true` | 是否启用 |
+| `port` | `3000` | HTTP Webhook 监听端口 |
+| `replyUrl` | `""` | AI 回复发送到的 Webhook URL |
+| `systemPrompt` | `""` | 自定义 System Prompt |
+| `gatewayToken` | `""` | Gateway 认证 Token |
+
+### 3. 启动后配置
+
+外部消息系统需要配置 **POST 目标**：
+
+```
+http://<你的服务器>:<port>/webhook
+```
+
+## 消息格式
+
+### 发送消息到插件（外部 → OpenClaw）
+
+POST `http://<你的服务器>:<port>/webhook`
+
+```json
+{
+  "messageId": "msg-001",
+  "senderId": "user-123",
+  "senderName": "张三",
+  "content": "你好，请帮我查一下天气",
+  "conversationId": "conv-456",
+  "isDirect": true
+}
+```
+
+**字段说明：**
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `messageId` | 建议 | 消息唯一ID（用于去重） |
+| `senderId` | **必填** | 发送者ID |
+| `senderName` | 建议 | 发送者名称 |
+| `content` | **必填** | 消息内容 |
+| `conversationId` | 否 | 会话ID（群聊时用） |
+| `isDirect` | 否 | 是否单聊（默认 true 单聊） |
+
+### 插件回复（OpenClaw → 外部）
+
+插件处理完消息后，会 POST 到配置的 `replyUrl`：
+
+```json
+{
+  "senderId": "user-123",
+  "content": "今天北京天气晴，温度15-25度...",
+  "inReplyTo": "msg-001",
+  "conversationId": "conv-456",
+  "channel": "my-chat",
+  "timestamp": 1743400000000
+}
+```
+
+### 测试命令
+
+```bash
+# 模拟发送消息
+curl -X POST http://localhost:3000/webhook \
+  -H "Content-Type: application/json" \
+  -d '{
+    "messageId": "test-001",
+    "senderId": "user-001",
+    "senderName": "测试用户",
+    "content": "你好"
+  }'
+```
+
+## Gateway Methods
+
+插件注册了两个 Gateway Method，供其他插件/Agent 调用：
+
+### 发送消息
+
+```javascript
+await gateway.methods['my-chat-plugin.send']({
+  target: 'user-123',
+  text: 'Hello!'
+})
+```
+
+### 查询状态
+
+```javascript
+await gateway.methods['my-chat-plugin.status']()
+```
+
+## 与钉钉插件对比
+
+| 对比项 | 钉钉插件 | HTTP 插件 |
+|--------|----------|-----------|
+| 消息接收 | 钉钉 Stream 推送 | 被动接收 POST |
+| 消息回复 | 钉钉消息 API | POST 到 replyUrl |
+| 复杂度 | 高（含 AccessToken、AI Card 等） | 低（纯 HTTP） |
+| 适用场景 | 企业内部钉钉机器人 | 任意支持 Webhook 的系统 |
+
+## 下一步
+
+1. 配置 `replyUrl` 指向你的消息服务
+2. 在 `systemPrompt` 中添加你的业务逻辑指示
+3. 参考钉钉插件实现媒体文件上传（图片、文件等）

package/openclaw.plugin.json

@@ -0,0 +1,49 @@
+{
+  "id": "nc-local-im-connector",
+  "name": "nc-local-im-connector",
+  "description": "Local IM Channel Plugin for OpenClaw - 提供 HTTP 和 WebSocket 接口",
+  "version": "1.0.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": true,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "启用或禁用本地 IM 连接器"
+      },
+      "clientWsUrl":{
+        "type": "string",
+        "default": "ws:192.168.100.168:8080",
+        "description": "远程服务"
+      },
+      "connectionMode": {
+        "type": "string",
+        "default": "client",
+        "description": "模式"
+      },
+      "wsPort": {
+        "type": "number",
+        "default": 3001,
+        "description": "WebSocket 服务端口"
+      },
+      "httpPort": {
+        "type": "number",
+        "default": 3002,
+        "description": "HTTP 服务端口"
+      },
+      "gatewayToken": {
+        "type": "string",
+        "description": "Gateway 认证令牌"
+      },
+      "tokenType": {
+        "type": "string",
+        "default": "Bearer",
+        "description": "令牌类型"
+      }
+    }
+  },
+  "channels": [
+    "nc-local-im-connector"
+  ]
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "nc-local-im-connector",
+  "version": "0.2.0",
+  "description": "能诚信聊天插件",
+  "main": "plugin.ts",
+  "scripts": {
+    "build": "tsc plugin.ts --outDir dist --esModuleInterop --target ES2020 --module commonjs",
+    "dev": "tsc plugin.ts --esModuleInterop --target ES2020 --module commonjs --watch"
+  },
+  "openclaw": {
+    "extensions": [
+      "./plugin.ts"
+    ]
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "clawdbot": "^2026.1.24-3",
+    "ws":"^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/plugin.ts

@@ -0,0 +1,496 @@
+/**
+ * Local IM Connector Plugin for Moltbot/OpenClaw
+ * * 提供本地 WebSocket 和 HTTP 服务，允许外部应用通过标准接口与 OpenClaw 智能体对话。
+ * * [New] 支持 Client 长连接模式（类似钉钉 Stream 模式），主动连接外部网关并保持心跳。
+ */
+
+import WebSocket, { WebSocketServer } from 'ws';
+import express from 'express';
+import type { ClawdbotPluginApi, PluginRuntime, ClawdbotConfig } from 'clawdbot/plugin-sdk';
+import * as http from 'http';
+
+export const id = 'nc-local-im-connector';
+
+let runtime: PluginRuntime | null = null;
+
+function getRuntime(): PluginRuntime {
+  if (!runtime) throw new Error('Local IM runtime not initialized');
+  return runtime;
+}
+
+// ============ 配置管理 ============
+
+function getConfig(cfg: ClawdbotConfig) {
+  return (cfg?.channels as any)?.[id] || {};
+}
+
+// ============ 核心 API 调用 ============
+
+interface SessionContext {
+  channel: string;
+  accountId: string;
+  chatType: 'direct' | 'group';
+  peerId: string;
+  conversationId?: string;
+}
+
+function buildSessionContext(userId: string, conversationId?: string): SessionContext {
+  return {
+    channel: 'nc-local-im-connector',
+    accountId: '__default__',
+    chatType: 'direct',
+    peerId: userId,
+    conversationId,
+  };
+}
+
+interface GatewayOptions {
+  userContent: string;
+  sessionContext: SessionContext;
+  peerKind?: 'direct' | 'group';
+  peerId?: string;
+  gatewayPort?: number;
+  log?: any;
+  gatewayToken?: string;
+  tokenType?: 'Bearer' | 'ApiKey';
+}
+
+/**
+ * 封装与 OpenClaw Gateway 的流式通信（与 plugin.ts 保持一致）
+ */
+async function* streamFromGateway(options: GatewayOptions): AsyncGenerator<string, void, unknown> {
+  const { userContent, sessionContext, peerId, gatewayPort, log, gatewayToken, tokenType = 'Bearer' } = options;
+  const rt = getRuntime();
+  const port = gatewayPort || rt.gateway?.port || 18789;
+  const gatewayUrl = `http://127.0.0.1:${port}/v1/chat/completions`;
+
+  const messages = [
+    { role: 'user', content: userContent }
+  ];
+
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+    'X-OpenClaw-Agent-Id': 'main',
+  };
+
+  const memoryUser = `${sessionContext.channel}:${sessionContext.accountId}:${sessionContext.peerId}`;
+  headers['X-OpenClaw-Memory-User'] = Buffer.from(memoryUser, 'utf-8').toString('base64');
+
+  if (gatewayToken) {
+    if (tokenType === 'Bearer') {
+      headers['Authorization'] = `Bearer ${gatewayToken}`;
+    } else if (tokenType === 'ApiKey') {
+      headers['X-API-Key'] = gatewayToken;
+    }
+    log?.info?.(`[LocalIM] 使用 ${tokenType} Token 认证`);
+  }
+
+  const response = await fetch(gatewayUrl, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify({
+      model: 'main',
+      messages,
+      stream: true,
+      user: JSON.stringify(sessionContext),
+    }),
+  });
+
+  if (!response.ok || !response.body) {
+    const errText = response.body ? await response.text() : '(no body)';
+    if (response.status === 401 || response.status === 403) {
+      if (!gatewayToken) {
+        throw new Error(`Gateway 认证失败 (${response.status}): Gateway 需要认证，请在插件配置中设置 gatewayToken`);
+      } else {
+        throw new Error(`Gateway 认证失败 (${response.status}): Token 无效或已过期，请检查 gatewayToken 配置`);
+      }
+    }
+    throw new Error(`Gateway error: ${response.status} - ${errText}`);
+  }
+
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = '';
+
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+
+    buffer += decoder.decode(value, { stream: true });
+    const lines = buffer.split('\n');
+    buffer = lines.pop() || '';
+
+    for (const line of lines) {
+      if (!line.startsWith('data: ')) continue;
+      const data = line.slice(6).trim();
+      if (data === '[DONE]') return;
+
+      try {
+        const chunk = JSON.parse(data);
+        const content = chunk.choices?.[0]?.delta?.content;
+        if (content) yield content;
+      } catch {}
+    }
+  }
+}
+
+// ============ 插件定义 ============
+
+const meta = {
+  id: 'nc-local-im-connector',
+  label: 'Local IM',
+  selectionLabel: 'Local IM (HTTP/WS 本地接入与长连接)',
+  docsPath: '/channels/nc-local-im-connector',
+  docsLabel: 'nc-local-im-connector',
+  blurb: '提供本地 HTTP 和 WebSocket 接口，并支持作为长连接客户端(类似钉钉模式)接入大模型。',
+  order: 80,
+  aliases: ['local', 'local-im'],
+};
+
+const localImPlugin = {
+  id: 'nc-local-im-connector',
+  meta,
+  capabilities: {
+    chatTypes: ['direct'],
+    reactions: false,
+    threads: false,
+    media: false,
+    nativeCommands: false,
+    blockStreaming: false,
+  },
+  reload: { configPrefixes: ['channels.nc-local-im-connector'] },
+  configSchema: {
+    schema: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        enabled: { type: 'boolean', default: true },
+        // 新增长连接模式选择
+        connectionMode: { type: 'string', enum: ['server', 'client'], default: 'server', description: '连接模式' },
+        clientWsUrl: { type: 'string',default:'ws:192.168.100.168:8080' , description: '作为长连接 Client 时，连接的目标 WebSocket 地址' },
+        wsPort: { type: 'number', default: 3001, description: 'Server模式: WebSocket 监听端口' },
+        httpPort: { type: 'number', default: 3002, description: 'Server模式: HTTP 监听端口' },
+        gatewayToken: { type: 'string', description: 'Gateway 认证 Token' },
+        tokenType: { type: 'string', enum: ['Bearer', 'ApiKey'], default: 'Bearer' },
+        name: { type: 'string', default: 'Local IM Channel' },
+      },
+    },
+    uiHints: {
+      enabled: { label: '启用 Local IM' },
+      connectionMode: { label: '运行模式 (Server:本地监听 / Client:主动长连接)' },
+      clientWsUrl: { label: '目标 WS 地址 (Client 模式)' },
+      wsPort: { label: 'WebSocket 端口 (Server 模式)' },
+      httpPort: { label: 'HTTP 端口 (Server 模式)' },
+      gatewayToken: { label: 'Gateway Token' },
+      tokenType: { label: 'Token 类型' },
+      name: { label: '账号名称' },
+    },
+  },
+  config: {
+    listAccountIds: (cfg: ClawdbotConfig) => {
+      const config = getConfig(cfg);
+      return config.accounts ? Object.keys(config.accounts) : ['__default__'];
+    },
+    resolveAccount: (cfg: ClawdbotConfig, accountId?: string) => {
+      const config = getConfig(cfg);
+      const id = accountId || '__default__';
+      if (config.accounts?.[id]) {
+        return {
+          accountId: id,
+          config: { ...config, ...config.accounts[id] },
+          enabled: config.accounts[id].enabled !== false
+        };
+      }
+      return { accountId: '__default__', config, enabled: config.enabled !== false };
+    },
+    defaultAccountId: () => '__default__',
+    isConfigured: (account: any) => {
+      const config = account?.config || {};
+      if (config.connectionMode === 'client') {
+        return Boolean(config.clientWsUrl); // Client 模式下必须配置目标地址
+      }
+      return Boolean(config.wsPort && config.httpPort); // Server 模式验证端口
+    },
+    describeAccount: (account: any) => ({
+      accountId: account.accountId,
+      name: account.config?.name || 'Local IM',
+      enabled: account.enabled,
+      configured: account.config?.connectionMode === 'client'
+          ? Boolean(account.config?.clientWsUrl)
+          : Boolean(account.config?.wsPort && account.config?.httpPort),
+    }),
+  },
+  gateway: {
+    startAccount: async (ctx: any) => {
+      const { account, cfg, abortSignal } = ctx;
+      const config = account.config;
+      const mode = config.connectionMode || 'server';
+
+      let stopped = false;
+      let doStop = (reason: string) => {};
+
+      if (mode === 'server') {
+        // ==========================================
+        // SERVER 模式：本地监听 (增强版：附带长连接心跳与 SSE 支持)
+        // ==========================================
+        const wsPort = config.wsPort || 3001;
+        const httpPort = config.httpPort || 3002;
+        ctx.log?.info(`[LocalIM-Server] 正在启动服务... (WS: ${wsPort}, HTTP: ${httpPort})`);
+
+        // 1. WebSocket 服务 (带长连接心跳)
+        const wss = new WebSocketServer({ port: wsPort });
+        const aliveClients = new WeakSet<WebSocket>();
+
+        // 服务端心跳检测：每 30 秒清理一次断开的死连接
+        const heartbeatInterval = setInterval(() => {
+          wss.clients.forEach((ws) => {
+            if (!aliveClients.has(ws)) return ws.terminate();
+            aliveClients.delete(ws);
+            ws.ping();
+          });
+        }, 30000);
+
+        wss.on('connection', (ws) => {
+          aliveClients.add(ws);
+          ws.on('pong', () => aliveClients.add(ws)); // 收到 pong 则更新活跃状态
+
+          ws.on('message', async (msg) => {
+            try {
+              const data = JSON.parse(msg.toString());
+              const { userId, conversationId, content } = data;
+              if (!userId || !content) return ws.send(JSON.stringify({ error: 'invalid payload' }));
+
+              const sessionContext = buildSessionContext(userId, conversationId);
+              let reply = '';
+
+              for await (const chunk of streamFromGateway({
+                userContent: content,
+                sessionContext,
+                peerId: userId,
+                gatewayPort: cfg.gateway?.port,
+                log: ctx.log,
+                gatewayToken: config.gatewayToken,
+                tokenType: config.tokenType || 'Bearer',
+              })) {
+                reply += chunk;
+                ws.send(JSON.stringify({ type: 'stream', conversationId, content: reply }));
+              }
+              ws.send(JSON.stringify({ type: 'done', conversationId, content: reply }));
+            } catch (err: any) {
+              ctx.log?.error(`[LocalIM-Server] WS 处理错误: ${err.message}`);
+              ws.send(JSON.stringify({ error: err.message }));
+            }
+          });
+        });
+
+        // 2. HTTP 服务 (增加 SSE 接口支持长连接)
+        const app = express();
+        app.use(express.json());
+
+        // 原有 REST 接口：等待完成后返回
+        app.post('/chat', async (req, res) => {
+          const { userId, conversationId, content } = req.body;
+          if (!userId || !content) return res.status(400).json({ error: 'invalid params' });
+
+          const sessionContext = buildSessionContext(userId, conversationId);
+          let reply = '';
+          try {
+            for await (const chunk of streamFromGateway({
+              userContent: content, sessionContext, peerId: userId, gatewayPort: cfg.gateway?.port,
+              log: ctx.log, gatewayToken: config.gatewayToken, tokenType: config.tokenType || 'Bearer'
+            })) { reply += chunk; }
+            res.json({ reply });
+          } catch (err: any) {
+            res.status(500).json({ error: err.message });
+          }
+        });
+
+        // 新增 SSE 接口：支持单向 HTTP 长连接流式输出
+        app.post('/chat/stream', async (req, res) => {
+          const { userId, conversationId, content } = req.body;
+          if (!userId || !content) return res.status(400).json({ error: 'invalid params' });
+
+          res.setHeader('Content-Type', 'text/event-stream');
+          res.setHeader('Cache-Control', 'no-cache');
+          res.setHeader('Connection', 'keep-alive');
+
+          const sessionContext = buildSessionContext(userId, conversationId);
+          try {
+            for await (const chunk of streamFromGateway({
+              userContent: content, sessionContext, peerId: userId, gatewayPort: cfg.gateway?.port,
+              log: ctx.log, gatewayToken: config.gatewayToken, tokenType: config.tokenType || 'Bearer'
+            })) {
+              res.write(`data: ${JSON.stringify({ type: 'stream', conversationId, chunk })}\n\n`);
+            }
+            res.write(`data: ${JSON.stringify({ type: 'done', conversationId })}\n\n`);
+            res.end();
+          } catch (err: any) {
+            res.write(`data: ${JSON.stringify({ error: err.message })}\n\n`);
+            res.end();
+          }
+        });
+
+        const httpServer = http.createServer(app);
+        httpServer.listen(httpPort);
+        ctx.log?.info(`[LocalIM-Server] 服务启动成功！`);
+
+        doStop = (reason: string) => {
+          if (stopped) return;
+          stopped = true;
+          ctx.log?.info(`[LocalIM-Server] 停止服务 (${reason})...`);
+          clearInterval(heartbeatInterval);
+          try { wss.close(); httpServer.close(); } catch (err: any) {}
+        };
+
+      } else if (mode === 'client') {
+        // ==========================================
+        // CLIENT 模式：主动长连接 (参考钉钉 Stream 模式)
+        // ==========================================
+        let wsClient: WebSocket | null = null;
+        let reconnectTimer: NodeJS.Timeout | null = null;
+        let pingTimer: NodeJS.Timeout | null = null;
+
+        const connectClient = () => {
+          if (stopped) return;
+          if (!config.clientWsUrl) {
+            ctx.log?.error('[LocalIM-Client] 未配置 clientWsUrl，无法启动长连接');
+            return;
+          }
+
+          ctx.log?.info(`[LocalIM-Client] 尝试长连接至: ${config.clientWsUrl}`);
+          try {
+            wsClient = new WebSocket(config.clientWsUrl);
+
+            wsClient.on('open', () => {
+              ctx.log?.info('[LocalIM-Client] 长连接建立成功');
+              // 客户端主动发起心跳保活
+              pingTimer = setInterval(() => {
+                if (wsClient?.readyState === WebSocket.OPEN) wsClient.ping();
+              }, 30000);
+            });
+
+            wsClient.on('message', async (msg) => {
+              try {
+                const data = JSON.parse(msg.toString());
+                const { userId, conversationId, content } = data;
+                if (!userId || !content) return;
+
+                const sessionContext = buildSessionContext(userId, conversationId);
+                let reply = '';
+
+                for await (const chunk of streamFromGateway({
+                  userContent: content, sessionContext, peerId: userId, gatewayPort: cfg.gateway?.port,
+                  log: ctx.log, gatewayToken: config.gatewayToken, tokenType: config.tokenType || 'Bearer'
+                })) {
+                  reply += chunk;
+                  if (wsClient?.readyState === WebSocket.OPEN) {
+                    wsClient.send(JSON.stringify({ type: 'stream', conversationId, content: reply }));
+                  }
+                }
+                if (wsClient?.readyState === WebSocket.OPEN) {
+                  wsClient.send(JSON.stringify({ type: 'done', conversationId, content: reply }));
+                }
+              } catch (err: any) {
+                ctx.log?.error(`[LocalIM-Client] 消息处理异常: ${err.message}`);
+                if (wsClient?.readyState === WebSocket.OPEN) {
+                  wsClient.send(JSON.stringify({ error: err.message }));
+                }
+              }
+            });
+
+            wsClient.on('close', () => {
+              ctx.log?.warn('[LocalIM-Client] 长连接已断开');
+              cleanupClient();
+              scheduleReconnect();
+            });
+
+            wsClient.on('error', (err) => {
+              ctx.log?.error(`[LocalIM-Client] WebSocket 异常: ${err.message}`);
+              // Error 之后通常会自动触发 close，交由 close 处理重连
+            });
+
+          } catch (err: any) {
+            ctx.log?.error(`[LocalIM-Client] 创建连接失败: ${err.message}`);
+            scheduleReconnect();
+          }
+        };
+
+        const cleanupClient = () => {
+          if (pingTimer) clearInterval(pingTimer);
+          if (wsClient) {
+            wsClient.removeAllListeners();
+            if (wsClient.readyState === WebSocket.OPEN) wsClient.close();
+            wsClient = null;
+          }
+        };
+
+        const scheduleReconnect = () => {
+          if (stopped) return;
+          ctx.log?.info('[LocalIM-Client] 5秒后尝试断线重连...');
+          reconnectTimer = setTimeout(connectClient, 5000);
+        };
+
+        // 启动客户端连接
+        connectClient();
+
+        doStop = (reason: string) => {
+          if (stopped) return;
+          stopped = true;
+          ctx.log?.info(`[LocalIM-Client] 停止客户端长连接 (${reason})...`);
+          if (reconnectTimer) clearTimeout(reconnectTimer);
+          cleanupClient();
+        };
+      }
+
+      const rt = getRuntime();
+      rt.channel.activity.record('nc-local-im-connector', account.accountId, 'start');
+
+      return new Promise((resolve) => {
+        if (abortSignal) {
+          abortSignal.addEventListener('abort', () => {
+            doStop('abortSignal');
+            rt.channel.activity.record('nc-local-im-connector', account.accountId, 'stop');
+            resolve({
+              stop: () => doStop('manual'),
+              isHealthy: () => !stopped,
+            });
+          });
+        }
+      });
+    },
+  },
+  status: {
+    defaultRuntime: { accountId: '__default__', running: false, lastStartAt: null, lastStopAt: null, lastError: null },
+    probe: async () => ({ ok: true }),
+    buildChannelSummary: ({ snapshot }: any) => ({
+      configured: true,
+      running: snapshot?.running ?? false,
+      lastStartAt: snapshot?.lastStartAt ?? null,
+      lastStopAt: snapshot?.lastStopAt ?? null,
+      lastError: snapshot?.lastError ?? null,
+    }),
+  },
+};
+
+// ============ 插件注册 ============
+
+const plugin = {
+  id: 'nc-local-im-connector',
+  name: 'Local IM Channel',
+  description: 'Provide local WebSocket/HTTP endpoints and Outbound Stream connection to chat with OpenClaw agents.',
+  configSchema: {
+    type: 'object',
+    additionalProperties: true,
+    properties: { enabled: { type: 'boolean', default: true } },
+  },
+  register(api: ClawdbotPluginApi) {
+    runtime = api.runtime;
+    api.registerChannel({ plugin: localImPlugin });
+    api.registerGatewayMethod('nc-local-im-connector.status', async ({ respond }: any) => {
+      respond(true, { ok: true });
+    });
+    api.logger?.info('[nc-LocalIM] 本地通信插件已注册 (支持 Server/Client 双向长连接模式)');
+  },
+};
+
+export default plugin;