@dcrays/dcgchat-test 0.4.24 → 0.4.26

package/README.md

@@ -0,0 +1,83 @@
+# OpenClaw 书灵墨宝 插件
+
+连接 OpenClaw 与 书灵墨宝 产品的通道插件。
+
+## 架构
+
+```
+┌──────────┐      WebSocket       ┌──────────────┐      WebSocket      ┌─────────────────────┐
+│ Web 前端 │  ←───────────────→   │  公司后端服务  │  ←───────────────→  │ OpenClaw（工作电脑） │
+└──────────┘                      └──────────────┘   (OpenClaw 主动连)   └─────────────────────┘
+```
+
+- OpenClaw 插件**主动连接**后端的 WebSocket 服务（不需要公网 IP）
+- 后端收到用户消息后转发给 OpenClaw，OpenClaw 回复后发回后端
+
+## 快速开始
+
+### 1. 安装插件
+
+```bash
+pnpm openclaw plugins install -l /path/to/openclaw-dcgchat
+```
+
+### 2. 配置
+
+```bash
+openclaw config set channels.dcgchat.enabled true
+openclaw config set channels.dcgchat.wsUrl "ws://your-backend:8080/openclaw/ws"
+```
+
+### 3. 启动
+
+```bash
+pnpm openclaw gateway
+```
+
+## 消息协议（MVP）
+
+### 下行：后端 → OpenClaw（用户消息）
+
+```json
+{ "type": "message", "userId": "user_001", "text": "你好" }
+```
+
+### 上行：OpenClaw → 后端（Agent 回复）
+
+```json
+{ "type": "reply", "userId": "user_001", "text": "你好！有什么可以帮你的？" }
+```
+
+## 配置项
+
+| 配置键 | 类型 | 说明 |
+|--------|------|------|
+| `channels.dcgchat.enabled` | boolean | 是否启用 |
+| `channels.dcgchat.wsUrl` | string | 后端 WebSocket 地址 |
+
+## 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 类型检查
+pnpm typecheck
+```
+
+## 文件结构
+
+- `index.ts` - 插件入口
+- `src/channel.ts` - ChannelPlugin 定义
+- `src/runtime.ts` - 插件 runtime
+- `src/types.ts` - 类型定义
+- `src/monitor.ts` - WebSocket 连接与断线重连
+- `src/bot.ts` - 消息处理与 Agent 调用
+
+## 后续迭代
+
+- [ ] Token 认证
+- [ ] 流式输出
+- [ ] Typing 指示
+- [ ] messageId 去重
+- [ ] 错误消息类型

package/index.ts

@@ -3,11 +3,12 @@ import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk'
 import { dcgchatPlugin } from './src/channel.js'
 import { setDcgchatRuntime, setWorkspaceDir } from './src/utils/global.js'
 import { monitoringToolMessage } from './src/tool.js'
+import { channelInfo, ENV } from './src/utils/constant.js'
 import { setOpenClawConfig } from './src/utils/global.js'
 import { createDcgchatMessageTool } from './src/tools/messageTool.js'
 
 const plugin = {
-  id: "dcgchat-test",
+  id: channelInfo[ENV],
   name: '书灵墨宝',
   description: '连接 OpenClaw 与 书灵墨宝 产品（WebSocket）',
   configSchema: emptyPluginConfigSchema(),

package/openclaw.plugin.json

@@ -1,11 +1,9 @@
 {
   "id": "dcgchat-test",
-  "channels": [
-    "dcgchat-test"
-  ],
+  "channels": ["dcgchat-test"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {}
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcrays/dcgchat-test",
-  "version": "0.4.24",
+  "version": "0.4.26",
   "type": "module",
   "description": "OpenClaw channel plugin for 书灵墨宝 (WebSocket)",
   "main": "index.ts",
@@ -16,6 +16,12 @@
     "websocket",
     "ai"
   ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build:production": "npx tsx scripts/build.ts production",
+    "build:prod": "npx tsx scripts/build.ts production",
+    "build:test": "npx tsx scripts/build.ts test"
+  },
   "dependencies": {
     "ali-oss": "file:src/libs/ali-oss-6.23.0.tgz",
     "axios": "file:src/libs/axios-1.13.6.tgz",
@@ -31,15 +37,19 @@
       "id": "dcgchat-test",
       "label": "书灵墨宝",
       "selectionLabel": "书灵墨宝",
-      "docsPath": "/channels/dcgchat-test",
+      "docsPath": "/channels/dcgchat",
       "docsLabel": "dcgchat-test",
       "blurb": "连接 OpenClaw 与 书灵墨宝 产品",
       "order": 80
     },
     "install": {
       "npmSpec": "@dcrays/dcgchat-test",
-      "localPath": "extensions/dcgchat-test",
+      "localPath": "extensions/dcgchat",
       "defaultChoice": "npm"
     }
+  },
+  "devDependencies": {
+    "openclaw": "^2026.3.13",
+    "typescript": "~5.8.0"
   }
 }

package/src/bot.ts

@@ -11,7 +11,7 @@ import {
   getWorkspaceDir,
   setMsgStatus
 } from './utils/global.js'
-import { resolveAccount, sendDcgchatMedia } from './channel.js'
+import { normalizeOutboundMediaPaths, resolveAccount, sendDcgchatMedia } from './channel.js'
 import { generateSignUrl } from './request/api.js'
 import { sendChunk, sendFinal, sendText as sendTextMsg, sendError, wsSendRaw, sendText } from './transport.js'
 import { dcgLogger } from './utils/log.js'
@@ -143,8 +143,11 @@ function buildMediaPayload(mediaList: MediaInfo[]): MediaPayload {
 }
 
 function resolveReplyMediaList(payload: ReplyPayload): string[] {
-  if (payload.mediaUrls?.length) return payload.mediaUrls.filter(Boolean)
-  return payload.mediaUrl ? [payload.mediaUrl] : []
+  const p = payload as { mediaUrls?: unknown[]; mediaUrl?: unknown }
+  if (p.mediaUrls != null && Array.isArray(p.mediaUrls) && p.mediaUrls.length > 0) {
+    return normalizeOutboundMediaPaths(p.mediaUrls)
+  }
+  return normalizeOutboundMediaPaths(p.mediaUrl ?? null)
 }
 
 const typingCallbacks = createTypingCallbacks({
@@ -187,7 +190,7 @@ async function handleDcgchatMessageInboundTurn(msg: InboundMessage, accountId: s
 
   const route = core.channel.routing.resolveAgentRoute({
     cfg: config,
-    channel: "dcgchat-test",
+    channel: channelInfo[ENV],
     accountId: account.accountId,
     peer: { kind: 'direct', id: conversationId }
   })
@@ -204,7 +207,7 @@ async function handleDcgchatMessageInboundTurn(msg: InboundMessage, accountId: s
     sessionId: conversationId,
     messageId: msg.content.message_id,
     domainId: msg.content.domain_id,
-    appId: config.channels?.["dcgchat-test"]?.appId || 100,
+    appId: config.channels?.[channelInfo[ENV]]?.appId || 100,
     botId: msg.content.bot_id ?? '',
     agentId: msg.content.agent_id ?? '',
     sessionKey: dcgSessionKey,
@@ -266,13 +269,13 @@ async function handleDcgchatMessageInboundTurn(msg: InboundMessage, accountId: s
       ChatType: 'direct',
       SenderName: agentDisplayName,
       SenderId: userId,
-      Provider: "dcgchat-test",
-      Surface: "dcgchat-test",
+      Provider: channelInfo[ENV],
+      Surface: channelInfo[ENV],
       MessageSid: msg.content.message_id,
       Timestamp: Date.now(),
       WasMentioned: true,
       CommandAuthorized: true,
-      OriginatingChannel: "dcgchat-test",
+      OriginatingChannel: channelInfo[ENV],
       OriginatingTo: dcgSessionKey,
       Target: dcgSessionKey,
       SourceTarget: dcgSessionKey,
@@ -295,7 +298,7 @@ async function handleDcgchatMessageInboundTurn(msg: InboundMessage, accountId: s
     const prefixContext = createReplyPrefixContext({
       cfg: config,
       agentId: effectiveAgentId ?? '',
-      channel: "dcgchat-test",
+      channel: channelInfo[ENV],
       accountId: account.accountId
     })
 
@@ -476,7 +479,7 @@ async function handleDcgchatMessageInboundTurn(msg: InboundMessage, accountId: s
         ctx: ctxPayload,
         updateLastRoute: {
           sessionKey: dcgSessionKey,
-          channel: "dcgchat-test",
+          channel: channelInfo[ENV],
           to: dcgSessionKey,
           accountId: route.accountId
         },

package/src/channel.ts

@@ -1,3 +1,4 @@
+import fs from 'node:fs'
 import type { ChannelPlugin, OpenClawConfig, PluginRuntime } from 'openclaw/plugin-sdk'
 import { createPluginRuntimeStore, DEFAULT_ACCOUNT_ID } from 'openclaw/plugin-sdk'
 import type { ResolvedDcgchatAccount, DcgchatConfig } from './types.js'
@@ -12,6 +13,7 @@ import {
   setCronMessageId
 } from './utils/global.js'
 import { isWsOpen, mergeDefaultParams, mergeSessionParams, sendFinal, wsSendRaw } from './transport.js'
+import { channelInfo, ENV } from './utils/constant.js'
 import { dcgLogger, setLogger } from './utils/log.js'
 import { getOutboundMsgParams, getParamsMessage } from './utils/params.js'
 import { isSessionActiveForTool } from './tool.js'
@@ -19,7 +21,7 @@ import { startDcgchatGatewaySocket } from './gateway/socket.js'
 import { getCronJobsPath, readCronJob } from './cron.js'
 
 function dcgchatChannelCfg(): DcgchatConfig {
-  return (getOpenClawConfig()?.channels?.["dcgchat-test"] as DcgchatConfig | undefined) ?? {}
+  return (getOpenClawConfig()?.channels?.[channelInfo[ENV]] as DcgchatConfig | undefined) ?? {}
 }
 
 /** `agent:<code>:mobook:direct:<agentId>:<sessionId>`（与 getSessionKey 非 real_mobook 分支一致） */
@@ -103,6 +105,53 @@ function outboundChatId(rawTo: string | undefined, normalizedTo: string): string
   return raw.indexOf('dcg-cron:') >= 0 ? raw : normalizedTo
 }
 
+/**
+ * 仅从 JSON / `{ file | path | url }` 等结构里取出路径字符串，不做改写（不拼 workspace、不 normalize）。
+ */
+function collectOutboundMediaPaths(item: unknown, out: string[]): void {
+  if (item == null) return
+  if (typeof item === 'string') {
+    const t = item.trim()
+    if (!t) return
+    if (t.startsWith('[')) {
+      try {
+        const parsed = JSON.parse(t) as unknown
+        collectOutboundMediaPaths(parsed, out)
+        return
+      } catch {
+        /* 非 JSON，按普通路径处理 */
+      }
+    }
+    out.push(t)
+    return
+  }
+  if (Array.isArray(item)) {
+    for (const el of item) collectOutboundMediaPaths(el, out)
+    return
+  }
+  if (typeof item === 'object') {
+    const o = item as Record<string, unknown>
+    const raw = o.file ?? o.path ?? o.url
+    if (typeof raw === 'string' && raw.trim()) {
+      out.push(raw.trim())
+    }
+  }
+}
+
+/** 将出站 media 展平为路径字符串列表（去重保序；路径保持 Core 原样） */
+export function normalizeOutboundMediaPaths(raw: unknown): string[] {
+  const acc: string[] = []
+  collectOutboundMediaPaths(raw, acc)
+  const seen = new Set<string>()
+  const deduped: string[] = []
+  for (const p of acc) {
+    if (!p || seen.has(p)) continue
+    seen.add(p)
+    deduped.push(p)
+  }
+  return deduped
+}
+
 export async function sendDcgchatMedia(opts: DcgchatMediaSendOptions): Promise<void> {
   const rawOpt = (opts.sessionKey ?? '').trim()
   const strippedForCron = rawOpt.replace(/^dcg-cron:/i, '').trim()
@@ -129,7 +178,34 @@ export async function sendDcgchatMedia(opts: DcgchatMediaSendOptions): Promise<v
     return
   }
 
-  const mediaUrl = opts.mediaUrl
+  const expanded = normalizeOutboundMediaPaths(opts.mediaUrl)
+  if (expanded.length === 0) {
+    dcgLogger(
+      `dcgchat: sendMedia skipped (no resolvable path): ${typeof opts.mediaUrl === 'string' ? opts.mediaUrl : JSON.stringify(opts.mediaUrl)} sessionKey=${sessionKey}`,
+      'error'
+    )
+    return
+  }
+  if (expanded.length > 1) {
+    for (const single of expanded) {
+      await sendDcgchatMedia({ ...opts, mediaUrl: single })
+    }
+    return
+  }
+  const mediaUrl = expanded[0]
+  if (!mediaUrl || !msgCtx.sessionId) {
+    dcgLogger(`dcgchat: sendMedia skipped (duplicate in session): ${mediaUrl} sessionId=${msgCtx.sessionId} sessionKey=${sessionKey}`)
+    return
+  }
+  // 判断文件存在
+  try {
+    if (!fs.existsSync(mediaUrl)) {
+      dcgLogger(`dcgchat: sendMedia skipped (file not found): ${mediaUrl} sessionKey=${sessionKey}`, 'error')
+      return
+    }
+  } catch (err) {
+    dcgLogger(`dcgchat: sendMedia skipped (cannot stat path): ${mediaUrl} ${String(err)} sessionKey=${sessionKey}`, 'error')
+  }
 
   if (mediaUrl && msgCtx.sessionId) {
     if (hasSentMediaKey(msgCtx.sessionId, mediaUrl)) {
@@ -143,14 +219,10 @@ export async function sendDcgchatMedia(opts: DcgchatMediaSendOptions): Promise<v
   if (!msgCtx.sessionId) {
     msgCtx.sessionId = sessionId
   }
-  if (!mediaUrl || !msgCtx.sessionId) {
-    dcgLogger(`dcgchat: sendMedia skipped (duplicate in session): ${mediaUrl} sessionId=${msgCtx.sessionId} sessionKey=${sessionKey}`)
-    return
-  }
   const fileName = mediaUrl?.split(/[\\/]/).pop() || ''
   const notMessageId = `${msgCtx?.messageId}`?.length === 13 || !msgCtx?.messageId
   try {
-    const botToken = msgCtx.botToken ?? getOpenClawConfig()?.channels?.["dcgchat-test"]?.botToken ?? ''
+    const botToken = msgCtx.botToken ?? getOpenClawConfig()?.channels?.[channelInfo[ENV]]?.botToken ?? ''
     const url = opts.mediaUrl ? await ossUpload(opts.mediaUrl, botToken, 1) : ''
     if (!msgCtx.agentId) {
       msgCtx.agentId = agentId
@@ -175,7 +247,7 @@ export async function sendDcgchatMedia(opts: DcgchatMediaSendOptions): Promise<v
 
 export function resolveAccount(cfg: OpenClawConfig, accountId?: string | null): ResolvedDcgchatAccount {
   const id = accountId ?? DEFAULT_ACCOUNT_ID
-  const raw = (cfg.channels?.["dcgchat-test"] as DcgchatConfig | undefined) ?? {}
+  const raw = (cfg.channels?.[channelInfo[ENV]] as DcgchatConfig | undefined) ?? {}
   return {
     accountId: id,
     enabled: raw.enabled !== false,
@@ -189,13 +261,13 @@ export function resolveAccount(cfg: OpenClawConfig, accountId?: string | null):
 }
 
 export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
-  id: "dcgchat-test",
+  id: channelInfo[ENV],
   meta: {
-    id: "dcgchat-test",
+    id: channelInfo[ENV],
     label: '书灵墨宝',
     selectionLabel: '书灵墨宝',
     docsPath: '/channels/dcgchat',
-    docsLabel: "dcgchat-test",
+    docsLabel: channelInfo[ENV],
     blurb: '连接 OpenClaw 与 书灵墨宝 产品',
     order: 80
   },
@@ -212,7 +284,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
     // blockStreaming: true,
   },
   /** 当前构建的 channel id + 兼容旧配置键 `channels.dcgchat` */
-  reload: { configPrefixes: [`channels.${"dcgchat-test"}`, 'channels.dcgchat'] },
+  reload: { configPrefixes: [`channels.${channelInfo[ENV]}`, 'channels.dcgchat'] },
   configSchema: {
     schema: {
       type: 'object',
@@ -248,7 +320,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
     resolveAccount: (cfg, accountId) => resolveAccount(cfg, accountId),
     defaultAccountId: () => DEFAULT_ACCOUNT_ID,
     setAccountEnabled: ({ cfg, enabled }) => {
-      const channelKey = "dcgchat-test"
+      const channelKey = channelInfo[ENV]
       const prev = (cfg.channels?.[channelKey as keyof NonNullable<typeof cfg.channels>] as Record<string, unknown> | undefined) ?? {}
       return {
         ...cfg,
@@ -320,7 +392,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
             if (!isSessionActiveForTool(to)) {
               dcgLogger(`channel sendText dropped (session not active): to=${to}`)
               return {
-                channel: "dcgchat-test",
+                channel: channelInfo[ENV],
                 messageId: '',
                 chatId: outboundChatId(ctx.to, to)
               }
@@ -332,7 +404,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
         }
       }
       return {
-        channel: "dcgchat-test",
+        channel: channelInfo[ENV],
         messageId: `${messageId}`,
         chatId: outboundChatId(ctx.to, to)
       }
@@ -353,20 +425,26 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
       if (!sessionId) {
         dcgLogger(`channel sendMedia to ${ctx.to} -> sessionId not found`, 'error')
         return {
-          channel: "dcgchat-test",
+          channel: channelInfo[ENV],
           messageId,
           chatId: outboundChatId(ctx.to, to || '')
         }
       }
 
       dcgLogger(`channel sendMedia to ${ctx.to}`)
-      await sendDcgchatMedia({
-        sessionKey: to || '',
-        mediaUrl: ctx.mediaUrl || '',
-        ...(isCron ? { messageId } : {})
-      })
+
+      const ctxExt = ctx as { mediaUrls?: unknown; mediaUrl?: string }
+      const rawMedia = ctxExt.mediaUrls ?? ctxExt.mediaUrl
+      const paths = normalizeOutboundMediaPaths(rawMedia)
+      for (const mediaUrl of paths) {
+        await sendDcgchatMedia({
+          sessionKey: to || '',
+          mediaUrl,
+          ...(isCron ? { messageId } : {})
+        })
+      }
       return {
-        channel: "dcgchat-test",
+        channel: channelInfo[ENV],
         messageId,
         chatId: outboundChatId(ctx.to, to || '')
       }

package/src/utils/constant.ts

@@ -1,5 +1,9 @@
 export const ENV: 'production' | 'test' | 'develop' = 'test'
 
+export const channelInfo: Record<string, string> = {
+  production: 'dcgchat',
+  test: 'dcgchat-test'
+}
 
 export const systemCommand = ['/new', '/status']
 export const stopCommand = ['/stop']

package/src/utils/global.ts

@@ -30,7 +30,7 @@ export function getOpenClawConfig(): OpenClawConfig | null {
 function getWorkspacePath(): string | null {
   const workspacePath = path.join(
     os.homedir(),
-    config?.channels?.["dcgchat-test"]?.appId == 110 ? '.mobook' : '.openclaw',
+    config?.channels?.[channelInfo[ENV]]?.appId == 110 ? '.mobook' : '.openclaw',
     'workspace'
   )
   if (fs.existsSync(workspacePath)) {
@@ -55,7 +55,7 @@ export function getWorkspaceDir(): string {
 }
 
 const { setRuntime: setDcgchatRuntime, getRuntime: getDcgchatRuntime } = createPluginRuntimeStore<PluginRuntime>(
-  `${"dcgchat-test"} runtime not initialized`
+  `${channelInfo[ENV]} runtime not initialized`
 )
 export { setDcgchatRuntime, getDcgchatRuntime }
 
@@ -147,7 +147,7 @@ export const getSessionKey = (content: any, accountId: string) => {
 
   const route = core.channel.routing.resolveAgentRoute({
     cfg: getOpenClawConfig() as OpenClawConfig,
-    channel: "dcgchat-test",
+    channel: channelInfo[ENV],
     accountId: accountId || 'default',
     peer: { kind: 'direct', id: session_id }
   })

package/src/utils/log.ts

@@ -1,4 +1,5 @@
 import { RuntimeEnv } from 'openclaw/plugin-sdk'
+import { channelInfo, ENV } from './constant.js'
 
 let logger: RuntimeEnv | null = null
 
@@ -10,6 +11,6 @@ export function dcgLogger(message: string, type: 'log' | 'error' = 'log'): void
   if (logger) {
     logger[type](`书灵墨宝🚀 ~ [${new Date().toISOString()}] ${message}`)
   } else {
-    console[type](`书灵墨宝🚀 ~ ${new Date().toISOString()} [${"dcgchat-test"}]: ${message}`)
+    console[type](`书灵墨宝🚀 ~ ${new Date().toISOString()} [${channelInfo[ENV]}]: ${message}`)
   }
 }

package/src/utils/params.ts

@@ -9,7 +9,7 @@ const paramsMessageMap = new Map<string, IMsgParams>()
 
 /** 从 OpenClaw 配置读取当前 channel 的基础参数（唯一来源，供 transport / resolve 等复用） */
 export function getParamsDefaults(): IMsgParams {
-  const ch = (getOpenClawConfig()?.channels?.["dcgchat-test"] as DcgchatConfig | undefined) ?? {}
+  const ch = (getOpenClawConfig()?.channels?.[channelInfo[ENV]] as DcgchatConfig | undefined) ?? {}
   return {
     userId: Number(ch.userId ?? 0),
     botToken: ch.botToken ?? '',