lightclawbot 1.2.0-beta.2 → 1.2.3

package/dist/src/config.js

@@ -32,7 +32,7 @@ export const WS_URL = `wss://${DOMAIN}`;
 /** HTTP API 基础地址 */
 export const API_BASE_URL = `https://${DOMAIN}`;
 /** 文件存储相关配置 */
-export const COS_BASE_URL = `https://${DOMAIN}`;
+export const SERVER_UPLOAD_BASE_URL = `https://${DOMAIN}`;
 // ============================================================
 // WebSocket 配置
 // ============================================================

package/dist/src/download-tool.js

@@ -9,7 +9,7 @@
  */
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { getFileDownloadUrl, downloadFileFromCos, uploadFileToCos, } from "./file-storage.js";
+import { getFileDownloadUrl, downloadFileFromServer, uploadFileToServer, } from "./file-storage.js";
 import { formatFileSize } from "./media.js";
 import { resolveEffectiveApiKey } from "./config.js";
 // ============================================================
@@ -79,7 +79,7 @@ export function registerDownloadTool(api) {
                             };
                         }
                         case "download_to_local": {
-                            const result = await downloadFileFromCos(filePath, { apiKey });
+                            const result = await downloadFileFromServer(filePath, { apiKey });
                             const targetDir = localDir || process.cwd();
                             // 确保目录存在
                             if (!fs.existsSync(targetDir)) {
@@ -107,7 +107,7 @@ export function registerDownloadTool(api) {
                                     content: [{ type: "text", text: `Error: local file not found: ${filePath}` }],
                                 };
                             }
-                            const uploadResult = await uploadFileToCos(filePath, { apiKey });
+                            const uploadResult = await uploadFileToServer(filePath, { apiKey });
                             const fileName = path.basename(filePath);
                             return {
                                 content: [{

package/dist/src/file-storage.js

@@ -10,7 +10,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { guessMimeByExt } from "./media.js";
-import { COS_BASE_URL, API_PATH_UPLOAD, API_PATH_DOWNLOAD, UPLOAD_TIMEOUT, } from "./config.js";
+import { SERVER_UPLOAD_BASE_URL, API_PATH_UPLOAD, API_PATH_DOWNLOAD, UPLOAD_TIMEOUT, } from "./config.js";
 import { buildAuthHeaders } from './utils/index.js';
 // ============================================================
 // 核心方法
@@ -23,7 +23,7 @@ import { buildAuthHeaders } from './utils/index.js';
  * @param customFileName - 自定义文件名（可选，默认使用原文件名）
  * @returns 上传结果，包含公网 URL
  */
-export async function uploadFileToCos(localPath, config = {}, customFileName) {
+export async function uploadFileToServer(localPath, config = {}, customFileName) {
     // 验证文件存在
     if (!fs.existsSync(localPath)) {
         throw new Error(`File not found: ${localPath}`);
@@ -48,7 +48,7 @@ export async function uploadFileToCos(localPath, config = {}, customFileName) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), UPLOAD_TIMEOUT);
     try {
-        const response = await fetch(`${COS_BASE_URL}${API_PATH_UPLOAD}`, {
+        const response = await fetch(`${SERVER_UPLOAD_BASE_URL}${API_PATH_UPLOAD}`, {
             method: "POST",
             body: formData,
             headers,
@@ -60,7 +60,7 @@ export async function uploadFileToCos(localPath, config = {}, customFileName) {
         }
         const result = (await response.json());
         if (result.code === 0 && result.data?.uploaded) {
-            return { url: `${COS_BASE_URL}${API_PATH_DOWNLOAD}?filePath=${filePath}`, filePath, isUploaded: true };
+            return { url: `${SERVER_UPLOAD_BASE_URL}${API_PATH_DOWNLOAD}?filePath=${filePath}`, filePath, isUploaded: true };
         }
         throw new Error(`Upload failed other (HTTP ${response.status}): ${result.data}`);
     }
@@ -77,7 +77,7 @@ export async function uploadFileToCos(localPath, config = {}, customFileName) {
  * @param config - 文件存储配置
  * @returns 上传结果，包含公网 URL
  */
-export async function uploadBufferToCos(buffer, fileName, mimeType, config = {}) {
+export async function uploadBufferToServer(buffer, fileName, mimeType, config = {}) {
     const filePath = `${Date.now()}/${fileName}`;
     const { Blob: NodeBlob } = await import("node:buffer");
     const blob = new NodeBlob([new Uint8Array(buffer)], { type: mimeType });
@@ -88,7 +88,7 @@ export async function uploadBufferToCos(buffer, fileName, mimeType, config = {})
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), UPLOAD_TIMEOUT);
     try {
-        const response = await fetch(`${COS_BASE_URL}${API_PATH_UPLOAD}`, {
+        const response = await fetch(`${SERVER_UPLOAD_BASE_URL}${API_PATH_UPLOAD}`, {
             method: "POST",
             body: formData,
             headers,
@@ -100,7 +100,7 @@ export async function uploadBufferToCos(buffer, fileName, mimeType, config = {})
         }
         const result = (await response.json());
         if (result.code === 0 && result.data?.uploaded) {
-            return { url: `${COS_BASE_URL}${API_PATH_DOWNLOAD}?filePath=${filePath}`, filePath, isUploaded: true };
+            return { url: `${SERVER_UPLOAD_BASE_URL}${API_PATH_DOWNLOAD}?filePath=${filePath}`, filePath, isUploaded: true };
         }
         throw new Error(`Upload failed (HTTP ${response.status}): ${result.data}`);
     }
@@ -116,7 +116,7 @@ export async function uploadBufferToCos(buffer, fileName, mimeType, config = {})
  * @returns 公网下载 URL
  */
 export function getFileDownloadUrl(filePath) {
-    return `${COS_BASE_URL}${API_PATH_DOWNLOAD}?filePath=${encodeURIComponent(filePath)}`;
+    return `${SERVER_UPLOAD_BASE_URL}${API_PATH_DOWNLOAD}?filePath=${encodeURIComponent(filePath)}`;
 }
 /**
  * 从云端存储下载文件内容
@@ -125,8 +125,8 @@ export function getFileDownloadUrl(filePath) {
  * @param config - 文件存储配置
  * @returns 下载结果，包含 Buffer 和文件信息
  */
-export async function downloadFileFromCos(filePath, config = {}) {
-    const url = filePath.startsWith("http") ? filePath : `${COS_BASE_URL}${API_PATH_DOWNLOAD}?filePath=${encodeURIComponent(filePath)}`;
+export async function downloadFileFromServer(filePath, config = {}) {
+    const url = filePath.startsWith("http") ? filePath : `${SERVER_UPLOAD_BASE_URL}${API_PATH_DOWNLOAD}?filePath=${encodeURIComponent(filePath)}`;
     const headers = buildAuthHeaders(config.apiKey ?? "");
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), UPLOAD_TIMEOUT);
@@ -154,6 +154,6 @@ export async function downloadFileFromCos(filePath, config = {}) {
  * @returns 公网可访问的下载 URL
  */
 export async function uploadAndGetPublicUrl(localPath, config = {}) {
-    const result = await uploadFileToCos(localPath, config);
+    const result = await uploadFileToServer(localPath, config);
     return result.url || '';
 }

package/dist/src/inbound.js

@@ -8,12 +8,12 @@
  *   - /stop 及自然语言 abort 由 tryFastAbortFromMessage 统一处理并递归 kill subagent。
  */
 import { emitSignal } from './utils/common.js';
-import { CHANNEL_KEY, MEDIA_MAX_BYTES, resolveEffectiveApiKey, setSessionApiKey, DEFAULT_AGENT_ID } from './config.js';
+import { CHANNEL_KEY, MEDIA_MAX_BYTES, resolveEffectiveApiKey, setSessionApiKey, DEFAULT_AGENT_ID, LOCALFILE_SCHEME } from './config.js';
 import { getLightclawRuntime } from './runtime.js';
 import { createChannelReplyPipeline } from 'openclaw/plugin-sdk/channel-reply-pipeline';
 import { generateMsgId } from './dedup.js';
 import { parseDataUrl, formatFileSize } from './media.js';
-import { uploadFileToCos, downloadFileFromCos, getFileDownloadUrl } from './file-storage.js';
+import { uploadFileToServer, downloadFileFromServer, getFileDownloadUrl } from './file-storage.js';
 import { createStreamReplyConfig } from './streaming/index.js';
 export function createInboundHandler(account, emitter, log) {
     return async (msg) => {
@@ -92,7 +92,7 @@ export function createInboundHandler(account, emitter, log) {
             try {
                 let buffer;
                 let mimeType;
-                let cosPublicUrl;
+                let uploadPublicUrl;
                 const parsed = file.bytes ? parseDataUrl(file.bytes) : null;
                 if (parsed) {
                     buffer = parsed.buffer;
@@ -100,10 +100,10 @@ export function createInboundHandler(account, emitter, log) {
                 }
                 else if (file.uri) {
                     log?.info(`[${CHANNEL_KEY}] File has URI, downloading from cloud: ${file.uri}`);
-                    const downloaded = await downloadFileFromCos(file.uri, { apiKey: effectiveApiKey });
+                    const downloaded = await downloadFileFromServer(file.uri, { apiKey: effectiveApiKey });
                     buffer = downloaded.buffer;
                     mimeType = file.mimeType;
-                    cosPublicUrl = file.uri.startsWith('http') ? file.uri : getFileDownloadUrl(file.uri);
+                    uploadPublicUrl = file.uri.startsWith('http') ? file.uri : getFileDownloadUrl(file.uri);
                 }
                 else {
                     // 来源 3：既无 bytes 也无 uri，无法处理，跳过此文件
@@ -114,19 +114,20 @@ export function createInboundHandler(account, emitter, log) {
                 const saved = await pluginRuntime.channel.media.saveMediaBuffer(buffer, mimeType, 'inbound', MEDIA_MAX_BYTES, file.name);
                 localMediaPaths.push(saved.path);
                 localMediaTypes.push(mimeType);
-                if (cosPublicUrl) {
-                    publicMediaUrls.push(cosPublicUrl);
+                const localPath = `${LOCALFILE_SCHEME}${saved.path}`;
+                if (uploadPublicUrl) {
+                    publicMediaUrls.push(localPath);
                 }
                 else {
-                    // data URL 来源：上传到 COS 获取公网 URL，失败则 fallback 到本地路径
+                    // data URL 来源：用户自行上传到服务器
                     try {
-                        const uploadResult = await uploadFileToCos(saved.path, { apiKey: effectiveApiKey });
-                        publicMediaUrls.push(uploadResult.url || `file://${saved.path}`);
+                        const uploadResult = await uploadFileToServer(saved.path, { apiKey: effectiveApiKey });
+                        publicMediaUrls.push(localPath);
                         log?.info(`[${CHANNEL_KEY}] Uploaded inbound file: ${saved.path} → ${uploadResult.url}`);
                     }
                     catch (uploadErr) {
                         log?.warn(`[${CHANNEL_KEY}] Upload failed, falling back to local path: ${uploadErr}`);
-                        publicMediaUrls.push(`file://${saved.path}`);
+                        publicMediaUrls.push(localPath);
                     }
                 }
                 const attachmentUrl = publicMediaUrls[publicMediaUrls.length - 1];

package/dist/src/socket/handlers.js

@@ -12,11 +12,11 @@
  * 所有出站 socket.emit 通过 ReliableEmitter 实现 ACK 确认 + 自动重试，
  * 保证消息在网络抖动时不丢失。
  */
-import { CHANNEL_KEY, EVENT_MESSAGE_PRIVATE, EVENT_HISTORY_REQUEST, EVENT_HISTORY_RESPONSE, DEFAULT_HISTORY_LIMIT, DEFAULT_AGENT_ID, EVENT_SESSIONS_REQUEST, EVENT_SESSIONS_RESPONSE, KIND_FILE_DOWNLOAD, FILE_DOWNLOAD_STATUS, resolveEffectiveApiKey } from '../config.js';
+import { CHANNEL_KEY, EVENT_MESSAGE_PRIVATE, EVENT_HISTORY_REQUEST, EVENT_HISTORY_RESPONSE, DEFAULT_HISTORY_LIMIT, DEFAULT_AGENT_ID, EVENT_SESSIONS_REQUEST, EVENT_SESSIONS_RESPONSE, KIND_FILE_DOWNLOAD, FILE_DOWNLOAD_STATUS } from '../config.js';
 import { isDuplicate, debounceHistoryRequest, generateMsgId } from '../dedup.js';
 import { getLightclawRuntime } from '../runtime.js';
 import { readSessionHistoryWithCron, listSessions } from '../history/index.js';
-import { uploadFileToCos } from '../file-storage.js';
+import { uploadFileToServer } from '../file-storage.js';
 import { guessMimeByExt } from '../media.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -51,7 +51,7 @@ export function bindSocketHandlers(socket, deps) {
                 if (isDuplicate(data.msgId))
                     return;
                 onEvent?.();
-                void handleFileDownloadReq(data, botClientId, reliableEmitter, log);
+                void handleFileDownloadReq(data, botClientId, reliableEmitter, account, log);
             }
             // 其他 status（ready/url/error）是本端自己发出的下行消息，理论上不会从前端回流；
             // 即便误触发，此处直接 return 不做处理，避免进入 AI 处理队列
@@ -199,14 +199,14 @@ export function bindSocketHandlers(socket, deps) {
 //   1. 从 data.extra.transferData 解析 transferId / localPath
 //   2. 基础校验：必须是绝对路径，文件必须存在
 //   3. 先回告 download_ready 帧（transferId + 文件元数据），前端据此更新下载按钮状态
-//   4. 通过 uploadFileToCos 将本机文件上传到 ai-server，拿到下载 URL
+//   4. 通过 uploadFileToServer 将本机文件上传到 ai-server，拿到下载 URL
 //   5. 回告 download_url 帧（transferId + url），前端触发浏览器原生下载
 //   6. 任一阶段失败 → 回告 download_error 帧（transferId + error message）
 //
 // 备注：不走目录白名单校验，因为 localPath 来自 AI 工具返回的 localfile:// 链接，
 // AI 只会返回自己刚写盘的文件；上传到 ai-server 后会经过一轮内容审核兜底。
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-async function handleFileDownloadReq(data, botClientId, reliableEmitter, log) {
+async function handleFileDownloadReq(data, botClientId, reliableEmitter, account, log) {
     const transferData = data.extra?.transferData;
     const transferId = transferData?.transferId;
     const localPath = transferData?.localPath;
@@ -268,8 +268,8 @@ async function handleFileDownloadReq(data, botClientId, reliableEmitter, log) {
     // 上传本机文件到 ai-server（含审核），成功后把 URL 回告前端
     try {
         // 通过 senderId 解析真实 apiKey，用于 /drive/save 鉴权
-        const apiKey = resolveEffectiveApiKey({ senderId: data.from });
-        const uploadResult = await uploadFileToCos(resolvedPath, { apiKey });
+        const apiKey = account.apiKey;
+        const uploadResult = await uploadFileToServer(resolvedPath, { apiKey });
         if (!uploadResult.isUploaded || !uploadResult.url) {
             sendError('Upload to ai-server failed');
             return;

package/dist/src/streaming/stream-reply-sink.js

@@ -13,7 +13,7 @@
  *   counts / *Count  计数器，供 markComplete 推断 NO_REPLY 原因
  */
 import { CHANNEL_KEY } from "../config.js";
-import { uploadFileToCos } from "../file-storage.js";
+import { uploadFileToServer } from "../file-storage.js";
 import { mediaUrlsToFiles } from "../media.js";
 import { createDeltaTrackerState, toStreamDeltaText } from "./delta-tracker.js";
 import { emitSignal } from "../utils/common.js";
@@ -87,7 +87,7 @@ export function createStreamReplyConfig(opts, prefixOptions, signalCtx) {
                 if (localPath.startsWith("/") || localPath.match(/^[A-Za-z]:\\/)) {
                     const { existsSync } = await import("node:fs");
                     if (existsSync(localPath)) {
-                        const result = await uploadFileToCos(localPath, storageConfig);
+                        const result = await uploadFileToServer(localPath, storageConfig);
                         publicUrls.push(result.url || "");
                         log?.info(`[${CHANNEL_KEY}] [stream] Uploaded to COS: ${localPath} → ${result.url}`);
                     }

package/openclaw.plugin.json

@@ -1,10 +1,84 @@
 {
   "id": "lightclawbot",
-  "channels": ["lightclawbot"],
-  "skills": ["./skills"],
+  "name": "LightClawBot",
+  "description": "Connect OpenClaw to your LightClawBot via WebSocket long-connection",
+  "kind": "channel",
+  "channels": [
+    "lightclawbot"
+  ],
+  "skills": [
+    "./skills"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {}
+  },
+  "channelConfigs": {
+    "lightclawbot": {
+      "label": "LightClawBot",
+      "description": "Connect OpenClaw to your LightClawBot via WebSocket long-connection",
+      "schema": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Whether this channel is enabled."
+          },
+          "name": {
+            "type": "string",
+            "description": "Human-readable account/channel name."
+          },
+          "dmPolicy": {
+            "type": "string",
+            "enum": ["open", "allowlist", "disabled"],
+            "description": "Policy that controls who can DM the bot."
+          },
+          "allowFrom": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Allowlist of user IDs ('*' means everyone)."
+          },
+          "systemPrompt": {
+            "type": "string",
+            "description": "Custom system prompt applied to this account."
+          },
+          "defaultAccount": {
+            "type": "string",
+            "description": "Default account id to use when none is specified."
+          },
+          "accounts": {
+            "type": "object",
+            "description": "Per-account configuration keyed by account id (typically the uin).",
+            "additionalProperties": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "enabled": { "type": "boolean" },
+                "name": { "type": "string" },
+                "apiKey": { "type": "string" },
+                "apiBaseUrl": { "type": "string" },
+                "dmPolicy": {
+                  "type": "string",
+                  "enum": ["open", "allowlist", "disabled"]
+                },
+                "allowFrom": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                },
+                "systemPrompt": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "contracts": {
+    "tools": [
+      "lightclaw_upload_file"
+    ]
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightclawbot",
-  "version": "1.2.0-beta.2",
+  "version": "1.2.3",
   "description": "LightClawBot channel plugin with message support, cron jobs, and proactive messaging",
   "type": "module",
   "files": [