@dcrays/dcgchat-test 0.3.39 → 0.3.40

package/index.ts

@@ -4,8 +4,7 @@ import { dcgchatPlugin } from './src/channel.js'
 import { setDcgchatRuntime, setWorkspaceDir } from './src/utils/global.js'
 import { monitoringToolMessage } from './src/tool.js'
 import { setOpenClawConfig } from './src/utils/global.js'
-import { startDcgchatGatewaySocket } from './src/gateway/socket.js'
-import { createDcgchatMessageTool } from './src/tools/meeageToll.js'
+import { createDcgchatMessageTool } from './src/tools/messageTool.js'
 
 const plugin = {
   id: "dcgchat-test",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcrays/dcgchat-test",
-  "version": "0.3.39",
+  "version": "0.3.40",
   "type": "module",
   "description": "OpenClaw channel plugin for 书灵墨宝 (WebSocket)",
   "main": "index.ts",

package/src/bot.ts

@@ -1,8 +1,6 @@
 import path from 'node:path'
-import fs from 'node:fs'
-import os from 'node:os'
-import type { PluginRuntime, ReplyPayload } from 'openclaw/plugin-sdk'
-import { createPluginRuntimeStore, createReplyPrefixContext, createTypingCallbacks } from 'openclaw/plugin-sdk'
+import type { ReplyPayload } from 'openclaw/plugin-sdk'
+import { createReplyPrefixContext, createTypingCallbacks } from 'openclaw/plugin-sdk'
 import type { InboundMessage } from './types.js'
 import {
   clearSentMediaKeys,
@@ -126,20 +124,18 @@ function resolveReplyMediaList(payload: ReplyPayload): string[] {
   if (payload.mediaUrls?.length) return payload.mediaUrls.filter(Boolean)
   return payload.mediaUrl ? [payload.mediaUrl] : []
 }
+
 const typingCallbacks = createTypingCallbacks({
-  start: async () => {
-    console.log('typing start')
-  },
+  start: async () => {},
   onStartError: (err) => {
-    console.log('typing start error', err)
+    dcgLogger(`typing start error: ${String(err)}`, 'error')
   }
 })
+
 /**
  * 处理一条用户消息，调用 Agent 并返回回复
  */
 export async function handleDcgchatMessage(msg: InboundMessage, accountId: string): Promise<void> {
-  let finalSent = false
-
   let completeText = ''
   const config = getOpenClawConfig()
   if (!config) {
@@ -164,7 +160,7 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
   const embeddedAgentId = extractAgentIdFromConversationId(conversationId)
 
   const effectiveAgentId = embeddedAgentId ?? route.agentId
-  const effectiveSessionKey = getSessionKey(msg.content, account.accountId)
+  const dcgSessionKey = getSessionKey(msg.content, account.accountId)
 
   const mergedParams = {
     userId: msg._userId,
@@ -175,13 +171,12 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
     appId: msg.content.app_id,
     botId: msg.content.bot_id ?? '',
     agentId: msg.content.agent_id ?? '',
-    sessionKey: effectiveSessionKey,
+    sessionKey: dcgSessionKey,
     real_mobook
   }
-  setParamsMessage(effectiveSessionKey, mergedParams)
-  setParamsMessage(userId, mergedParams)
-  dcgLogger(`target alias bound: aliasTarget=${userId} -> sessionKey=${effectiveSessionKey}`)
-  const outboundCtx = getEffectiveMsgParams(effectiveSessionKey)
+  setParamsMessage(dcgSessionKey, mergedParams)
+  dcgLogger(`target alias bound: aliasTarget=${userId} -> sessionKey=${dcgSessionKey}`)
+  const outboundCtx = getEffectiveMsgParams(dcgSessionKey)
   const agentEntry =
     effectiveAgentId && effectiveAgentId !== 'main' ? config.agents?.list?.find((a) => a.id === effectiveAgentId) : undefined
   const agentDisplayName = agentEntry?.name ?? (effectiveAgentId && effectiveAgentId !== 'main' ? effectiveAgentId : undefined)
@@ -218,8 +213,8 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
       RawBody: text,
       CommandBody: text,
       From: userId,
-      To: effectiveSessionKey,
-      SessionKey: effectiveSessionKey,
+      To: dcgSessionKey,
+      SessionKey: dcgSessionKey,
       AccountId: route.accountId,
       ChatType: 'direct',
       SenderName: agentDisplayName,
@@ -231,9 +226,9 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
       WasMentioned: true,
       CommandAuthorized: true,
       OriginatingChannel: "dcgchat-test",
-      OriginatingTo: effectiveSessionKey,
-      Target: effectiveSessionKey,
-      SourceTarget: effectiveSessionKey,
+      OriginatingTo: dcgSessionKey,
+      Target: dcgSessionKey,
+      SourceTarget: dcgSessionKey,
       ...mediaPayload
     })
 
@@ -254,26 +249,22 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
       humanDelay: core.channel.reply.resolveHumanDelayConfig(config, route.agentId),
       onReplyStart: async () => {},
       deliver: async (payload: ReplyPayload, info) => {
-        if (sessionStreamSuppressed.has(effectiveSessionKey)) return
+        if (sessionStreamSuppressed.has(dcgSessionKey)) return
         const mediaList = resolveReplyMediaList(payload)
         for (const mediaUrl of mediaList) {
           const key = getMediaKey(mediaUrl)
           if (sentMediaKeys.has(key)) continue
           sentMediaKeys.add(key)
-          await sendDcgchatMedia({ sessionKey: effectiveSessionKey, mediaUrl, text: '' })
+          await sendDcgchatMedia({ sessionKey: dcgSessionKey, mediaUrl, text: '' })
         }
       },
       onError: (err: unknown, info: { kind: string }) => {
-        setMsgStatus(effectiveSessionKey, 'finished')
+        setMsgStatus(dcgSessionKey, 'finished')
         sendFinal(outboundCtx, 'error')
-        dcgLogger(`${info.kind} reply failed: ${String(err)}`, 'error')
-        activeRunIdBySessionKey.delete(effectiveSessionKey)
-        streamChunkIdxBySessionKey.delete(effectiveSessionKey)
-        if (sessionStreamSuppressed.has(effectiveSessionKey)) {
-          dcgLogger(`${info.kind} reply failed (stream suppressed): ${String(err)}`, 'error')
-          return
-        }
-        dcgLogger(`${info.kind} reply failed: ${String(err)}`, 'error')
+        activeRunIdBySessionKey.delete(dcgSessionKey)
+        streamChunkIdxBySessionKey.delete(dcgSessionKey)
+        const suppressed = sessionStreamSuppressed.has(dcgSessionKey)
+        dcgLogger(`${info.kind} reply failed${suppressed ? ' (stream suppressed)' : ''}: ${String(err)}`, 'error')
       },
       onIdle: () => {
         typingCallbacks.onIdle?.()
@@ -282,8 +273,8 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
 
     try {
       if (!interruptCommand.includes(text?.trim())) {
-        sessionStreamSuppressed.delete(effectiveSessionKey)
-        streamChunkIdxBySessionKey.set(effectiveSessionKey, 0)
+        sessionStreamSuppressed.delete(dcgSessionKey)
+        streamChunkIdxBySessionKey.set(dcgSessionKey, 0)
       }
 
       if (systemCommand.includes(text?.trim())) {
@@ -300,7 +291,7 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
                 ...replyOptions,
                 onModelSelected: prefixContext.onModelSelected,
                 onAgentRunStart: (runId) => {
-                  activeRunIdBySessionKey.set(effectiveSessionKey, runId)
+                  activeRunIdBySessionKey.set(dcgSessionKey, runId)
                 }
               }
             })
@@ -309,7 +300,7 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
         dcgLogger(`interrupt command: ${text}`)
         sendFinal(outboundCtx, 'abort')
         sendText('会话已终止', outboundCtx)
-        sessionStreamSuppressed.add(effectiveSessionKey)
+        sessionStreamSuppressed.add(dcgSessionKey)
 
         const abortOneSession = async (sessionKey: string) => {
           try {
@@ -319,11 +310,11 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
           }
         }
 
-        const keysToAbort = new Set<string>(getChildSessionKeysTrackedForRequester(effectiveSessionKey))
+        const keysToAbort = new Set<string>(getChildSessionKeysTrackedForRequester(dcgSessionKey))
         try {
           const listed = await sendGatewayRpc<{ sessions?: Array<{ key?: string }> }>({
             method: 'sessions.list',
-            params: { spawnedBy: effectiveSessionKey, limit: 256 }
+            params: { spawnedBy: dcgSessionKey, limit: 256 }
           })
           for (const s of listed?.sessions ?? []) {
             const k = typeof s?.key === 'string' ? s.key.trim() : ''
@@ -335,29 +326,29 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
         for (const sk of keysToAbort) {
           await abortOneSession(sk)
         }
-        await abortOneSession(effectiveSessionKey)
+        await abortOneSession(dcgSessionKey)
 
         try {
           await sendGatewayRpc({
             method: 'sessions.reset',
-            params: { key: effectiveSessionKey, reason: 'reset' }
+            params: { key: dcgSessionKey, reason: 'reset' }
           })
         } catch (e) {
           dcgLogger(`sessions.reset: ${String(e)}`, 'error')
         }
 
-        activeRunIdBySessionKey.delete(effectiveSessionKey)
-        streamChunkIdxBySessionKey.delete(effectiveSessionKey)
-        resetSubagentStateForRequesterSession(effectiveSessionKey)
-        setMsgStatus(effectiveSessionKey, 'finished')
+        activeRunIdBySessionKey.delete(dcgSessionKey)
+        streamChunkIdxBySessionKey.delete(dcgSessionKey)
+        resetSubagentStateForRequesterSession(dcgSessionKey)
+        setMsgStatus(dcgSessionKey, 'finished')
         clearSentMediaKeys(msg.content.message_id)
-        clearParamsMessage(effectiveSessionKey)
+        clearParamsMessage(dcgSessionKey)
         clearParamsMessage(userId)
 
         sendFinal(outboundCtx, 'stop')
         return
       } else {
-        const params = getEffectiveMsgParams(effectiveSessionKey)
+        const params = getEffectiveMsgParams(dcgSessionKey)
         if (!ignoreToolCommand.includes(text?.trim())) {
           wsSendRaw(params, {
             is_finish: -1,
@@ -385,10 +376,10 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
                 ...replyOptions,
                 onModelSelected: prefixContext.onModelSelected,
                 onAgentRunStart: (runId) => {
-                  activeRunIdBySessionKey.set(effectiveSessionKey, runId)
+                  activeRunIdBySessionKey.set(dcgSessionKey, runId)
                 },
                 onPartialReply: async (payload: ReplyPayload) => {
-                  if (sessionStreamSuppressed.has(effectiveSessionKey)) return
+                  if (sessionStreamSuppressed.has(dcgSessionKey)) return
 
                   if (payload.text) {
                     completeText = payload.text
@@ -399,8 +390,8 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
                       ? payload.text.slice(streamedTextLen)
                       : payload.text
                     if (delta.trim()) {
-                      const prev = streamChunkIdxBySessionKey.get(effectiveSessionKey) ?? 0
-                      streamChunkIdxBySessionKey.set(effectiveSessionKey, prev + 1)
+                      const prev = streamChunkIdxBySessionKey.get(dcgSessionKey) ?? 0
+                      streamChunkIdxBySessionKey.set(dcgSessionKey, prev + 1)
                       sendChunk(delta, outboundCtx, prev)
                       dcgLogger(`[stream]: chunkIdx=${prev} len=${delta.length} user=${msg._userId} ${delta.slice(0, 100)}`)
                     }
@@ -414,7 +405,7 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
                     const key = getMediaKey(mediaUrl)
                     if (sentMediaKeys.has(key)) continue
                     sentMediaKeys.add(key)
-                    await sendDcgchatMedia({ sessionKey: effectiveSessionKey, mediaUrl, text: '' })
+                    await sendDcgchatMedia({ sessionKey: dcgSessionKey, mediaUrl, text: '' })
                   }
                 }
               }
@@ -426,26 +417,26 @@ export async function handleDcgchatMessage(msg: InboundMessage, accountId: strin
     }
 
     if (![...systemCommand, ...interruptCommand].includes(text?.trim())) {
-      if (sessionStreamSuppressed.has(effectiveSessionKey)) {
-        sessionStreamSuppressed.delete(effectiveSessionKey)
+      if (sessionStreamSuppressed.has(dcgSessionKey)) {
+        sessionStreamSuppressed.delete(dcgSessionKey)
       }
     }
     clearSentMediaKeys(msg.content.message_id)
     const storePath = core.channel.session.resolveStorePath(config.session?.store)
-    await waitUntilSubagentsIdle(effectiveSessionKey, { timeoutMs: 600_000 })
+    await waitUntilSubagentsIdle(dcgSessionKey, { timeoutMs: 600_000 })
     sendFinal(outboundCtx, 'end')
     dcgLogger(
-      `record session route: rawTarget=${userId}, normalizedTarget=${effectiveSessionKey}, updateLastRoute.to=${effectiveSessionKey}, accountId=${route.accountId}`
+      `record session route: rawTarget=${userId}, normalizedTarget=${dcgSessionKey}, updateLastRoute.to=${dcgSessionKey}, accountId=${route.accountId}`
     )
     core.channel.session
       .recordInboundSession({
         storePath,
-        sessionKey: effectiveSessionKey,
+        sessionKey: dcgSessionKey,
         ctx: ctxPayload,
         updateLastRoute: {
-          sessionKey: effectiveSessionKey,
+          sessionKey: dcgSessionKey,
           channel: "dcgchat-test",
-          to: effectiveSessionKey,
+          to: dcgSessionKey,
           accountId: route.accountId
         },
         onRecordError: (err) => {

package/src/channel.ts

@@ -105,7 +105,8 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
     effects: true
     // blockStreaming: true,
   },
-  reload: { configPrefixes: ['channels.dcgchat'] },
+  /** 当前构建的 channel id + 兼容旧配置键 `channels.dcgchat` */
+  reload: { configPrefixes: [`channels.${"dcgchat-test"}`, 'channels.dcgchat'] },
   configSchema: {
     schema: {
       type: 'object',
@@ -114,7 +115,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
         enabled: { type: 'boolean' },
         wsUrl: { type: 'string' },
         botToken: { type: 'string' },
-        userId: { type: 'string', description: 'WebSocket 连接参数 _userId，与 message 工具的 target（effectiveSessionKey）无关' },
+        userId: { type: 'string', description: 'WebSocket 连接参数 _userId，与 message 工具的 target（dcgSessionKey）无关' },
         appId: { type: 'string' },
         domainId: { type: 'string' },
         capabilities: { type: 'array', items: { type: 'string' } }
@@ -123,7 +124,7 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
     uiHints: {
       userId: {
         label: 'WS 连接 _userId',
-        help: '仅用于拼接网关 WebSocket URL 的查询参数，不是 Agent 发消息时的 target。发消息请使用 effectiveSessionKey（与入站上下文 SessionKey 相同，格式如 agent:main:mobook:direct:<agent_id>:<session_id>）。'
+        help: '仅用于拼接网关 WebSocket URL 的查询参数，不是 Agent 发消息时的 target。发消息请使用 dcgSessionKey（与入站上下文 SessionKey 相同）。'
       }
     }
   },
@@ -131,16 +132,18 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
     listAccountIds: () => [DEFAULT_ACCOUNT_ID],
     resolveAccount: (cfg, accountId) => resolveAccount(cfg, accountId),
     defaultAccountId: () => DEFAULT_ACCOUNT_ID,
-    setAccountEnabled: ({ cfg, enabled }) => ({
-      ...cfg,
-      channels: {
-        ...cfg.channels,
-        dcgchat: {
-          ...(cfg.channels?.["dcgchat-test"] as Record<string, unknown> | undefined),
-          enabled
+    setAccountEnabled: ({ cfg, enabled }) => {
+      const channelKey = "dcgchat-test"
+      const prev =
+        (cfg.channels?.[channelKey as keyof NonNullable<typeof cfg.channels>] as Record<string, unknown> | undefined) ?? {}
+      return {
+        ...cfg,
+        channels: {
+          ...cfg.channels,
+          [channelKey]: { ...prev, enabled }
         }
       }
-    }),
+    },
     isConfigured: (account) => account.configured,
     describeAccount: (account) => ({
       accountId: account.accountId,
@@ -157,13 +160,14 @@ export const dcgchatPlugin: ChannelPlugin<ResolvedDcgchatAccount> = {
     normalizeTarget: (raw) => raw || undefined,
     targetResolver: {
       looksLikeId: (raw) => Boolean(raw?.trim()),
-      hint: 'effectiveSessionKey（与 SessionKey 一致；勿填配置里的 WS userId）'
+      hint: 'dcgSessionKey（与 SessionKey 一致；勿填配置里的 WS userId）'
     }
   },
   agentPrompt: {
     messageToolHints: () => [
       '生成文件后，**尽可能不要**把文件路径、地址直接告诉用户。',
       '生成文件后，把文件名告诉用户。',
+      '调用 message 工具时，target 必须填写 dcgSessionKey（即 SessionKey），绝不能填写 WS userId。',
       '生成文件后，必须调用 message 工具发送文件，不可以直接在文本回复里包含文件路径、文件名、地址。'
     ]
   },

package/src/gateway/socket.ts

@@ -212,7 +212,7 @@ async function connectPersistentGateway(): Promise<void> {
     startPingTimer(gw)
     dcgLogger(`Gateway 持久连接成功 connId=${gw.getConnId() ?? '?'}`)
   } catch (e) {
-    dcgLogger(`Gateway 连接失败11: ${e}`, 'error')
+    dcgLogger(`Gateway 连接失败: ${e}`, 'error')
     persistentConn = null
     clearPingTimer()
     if (!socketStopped) {
@@ -230,8 +230,10 @@ export function startDcgchatGatewaySocket(): void {
   socketStopped = false
   clearReconnectTimer()
   if (startupConnectTimer != null) return
-  startupConnectTimer = null
-  void connectPersistentGateway()
+  startupConnectTimer = setTimeout(() => {
+    startupConnectTimer = null
+    void connectPersistentGateway()
+  }, 0)
 }
 
 /**

package/src/tool.ts

@@ -205,7 +205,6 @@ export function getActiveSubagentCount(sessionKey: string): number {
  * 注意：须在收到 `subagent_spawned` 之后才会计入；仅 spawning 未 spawned 的不会阻塞。
  */
 export function waitUntilSubagentsIdle(sessionKey: string, opts?: { timeoutMs?: number; signal?: AbortSignal }): Promise<void> {
-  console.log('🚀 ~ waitUntilSubagentsIdle ~ sessionKey:', sessionKey)
   const sk = sessionKey?.trim()
   if (!sk) return Promise.resolve()
 

package/src/tools/{meeageToll.ts → messageTool.ts}

@@ -2,15 +2,15 @@ import fs from 'node:fs'
 import path from 'node:path'
 import type { AnyAgentTool } from 'openclaw/plugin-sdk'
 import { jsonResult } from 'openclaw/plugin-sdk'
+import { sendDcgchatMedia } from '../channel.js'
+import { getOutboundMsgParams } from '../utils/params.js'
+import { sendText } from '../transport.js'
 
 /** 与 `registerTool` 工厂入参一致（主包未导出 `OpenClawPluginToolContext` 时仅用所需字段）。 */
 export type DcgchatMessageToolContext = {
   sessionKey?: string
   workspaceDir?: string
 }
-import { sendDcgchatMedia } from '../channel.js'
-import { getOutboundMsgParams } from '../utils/params.js'
-import { sendText } from '../transport.js'
 
 const SAFE_PREFIXES = ['/workspace/', '/mobook/']
 
@@ -22,7 +22,13 @@ const SAFE_EXTENSIONS = new Set([...fileType1, ...fileType2, ...fileType3, ...fi
 
 const messageToolParameters = {
   type: 'object',
+  additionalProperties: false,
   properties: {
+    target: {
+      type: 'string',
+      description:
+        '目标会话键（sessionKey），必须与当前会话 SessionKey 一致，禁止填写 userId。'
+    },
     content: {
       type: 'string',
       description: '发送文本内容'
@@ -32,6 +38,7 @@ const messageToolParameters = {
       description: '发送附件',
       items: {
         type: 'object',
+        additionalProperties: false,
         properties: {
           file: {
             type: 'string',
@@ -41,7 +48,8 @@ const messageToolParameters = {
         required: ['file']
       }
     }
-  }
+  },
+  oneOf: [{ required: ['content'] }, { required: ['media'] }]
 }
 
 function extractPaths(text?: string) {
@@ -68,12 +76,12 @@ function isSafeFile(filepath: string) {
  * 通过注册时的 `OpenClawPluginToolContext.sessionKey` 出站，不再使用非标准的 `execute(args, ctx)`。
  */
 export function createDcgchatMessageTool(pluginCtx: DcgchatMessageToolContext): AnyAgentTool {
-  console.log('🚀 ~ createDcgchatMessageTool ~ pluginCtx:', pluginCtx)
   return {
     name: 'message',
     label: 'message',
     description: `
       向用户发送消息。
+      若传 target，target 必须是 sessionKey，不能是 userId。
       如果发送附件：必须使用 media 字段
       支持路径目录：
       /workspace/

package/src/transport.ts

@@ -152,11 +152,14 @@ export function wsSend(ctx: IMsgParams, content: Record<string, unknown>): boole
  */
 export function wsSendRaw(ctx: IMsgParams, content: Record<string, unknown>, isLog = true): boolean {
   const ws = getWsConnection()
-  if (isWsOpen()) {
-    ws?.send(JSON.stringify(buildOpenclawBotChat(ctx, content, { mergeChannelDefaults: true })))
-    if (isLog) {
-      dcgLogger('已发送：' + JSON.stringify(buildOpenclawBotChat(ctx, content, { mergeChannelDefaults: true })))
-    }
+  if (ws?.readyState !== WebSocket.OPEN) {
+    dcgLogger(`server socket not ready ${ws?.readyState}`, 'error')
+    return false
+  }
+  const envelope = buildOpenclawBotChat(ctx, content, { mergeChannelDefaults: true })
+  ws.send(JSON.stringify(envelope))
+  if (isLog) {
+    dcgLogger('已发送：' + JSON.stringify(envelope))
   }
   return true
 }

package/src/utils/global.ts

@@ -1,6 +1,12 @@
-/** socket connection */
 import type WebSocket from 'ws'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { createPluginRuntimeStore, type OpenClawConfig, type PluginRuntime } from 'openclaw/plugin-sdk'
+import { channelInfo, ENV } from './constant.js'
+import { dcgLogger } from './log.js'
 
+/** socket connection */
 let ws: WebSocket | null = null
 
 export function setWsConnection(next: WebSocket | null) {
@@ -11,7 +17,6 @@ export function getWsConnection(): WebSocket | null {
   return ws
 }
 
-// OpenClawConfig
 let config: OpenClawConfig | null = null
 
 export function setOpenClawConfig(next: OpenClawConfig | null) {
@@ -22,15 +27,7 @@ export function getOpenClawConfig(): OpenClawConfig | null {
   return config
 }
 
-import { createPluginRuntimeStore, type OpenClawConfig, type PluginRuntime } from 'openclaw/plugin-sdk'
-import { dcgLogger } from './log.js'
-import { channelInfo, ENV } from './constant.js'
-
-const path = require('path')
-const fs = require('fs')
-const os = require('os')
-
-function getWorkspacePath() {
+function getWorkspacePath(): string | null {
   const workspacePath = path.join(
     os.homedir(),
     config?.channels?.["dcgchat-test"]?.appId == 110 ? '.mobook' : '.openclaw',
@@ -42,19 +39,21 @@ function getWorkspacePath() {
   return null
 }
 
-let workspaceDir: string = getWorkspacePath()
+let workspaceDir: string = getWorkspacePath() ?? ''
 
 export function setWorkspaceDir(dir?: string) {
   if (dir) {
     workspaceDir = dir
   }
 }
+
 export function getWorkspaceDir(): string {
   if (!workspaceDir) {
     dcgLogger?.('Workspace directory not initialized', 'error')
   }
   return workspaceDir
 }
+
 const { setRuntime: setDcgchatRuntime, getRuntime: getDcgchatRuntime } = createPluginRuntimeStore<PluginRuntime>(
   `${"dcgchat-test"} runtime not initialized`
 )
@@ -127,7 +126,7 @@ export const getSessionKey = (content: any, accountId: string) => {
   const { real_mobook, agent_id, agent_clone_code, session_id } = content
   const core = getDcgchatRuntime()
 
-  const anentCode = agent_clone_code || 'main'
+  const agentCode = agent_clone_code || 'main'
 
   const route = core.channel.routing.resolveAgentRoute({
     cfg: getOpenClawConfig() as OpenClawConfig,
@@ -135,7 +134,7 @@ export const getSessionKey = (content: any, accountId: string) => {
     accountId: accountId || 'default',
     peer: { kind: 'direct', id: session_id }
   })
-  return real_mobook == '1' ? route.sessionKey : `agent:${anentCode}:mobook:direct:${agent_id}:${session_id}`.toLowerCase()
+  return real_mobook == '1' ? route.sessionKey : `agent:${agentCode}:mobook:direct:${agent_id}:${session_id}`.toLowerCase()
 }
 
 export function getInfoBySessionKey(sk: string): { sessionId: string; agentId: string } {

package/src/utils/params.ts

@@ -47,7 +47,7 @@ export function getEffectiveMsgParams(sessionKey?: string): IMsgParams {
 }
 
 /**
- * Agent `message` 工具的 `target` 应为 `effectiveSessionKey`（如 `agent:main:mobook:direct:...`）。
+ * Agent `message` 工具的 `target` 应为 `dcgSessionKey`（如 `agent:main:mobook:direct:...`）。
  * `setParamsMessage` 使用的 key 与此一致。若按 preferredKey 查不到 map，
  * 则回落到当前会话 `currentSessionKey`，避免拿到空 `messageId` / `sessionId` 导致无文件卡片、WS 上下文错误。
  */