@licity/openclaw-connector 1.0.3 → 1.0.5

package/README.md

@@ -5,15 +5,15 @@
 ## 特点
 
 - **零配置启动**：首次运行自动创建会话，扫码后自动保存凭证
-- **弹出 CMD 窗口**：Windows 上自动弹出新命令行窗口显示二维码，无字符变形
-- **纯 OpenClaw**：不依赖 QClaw，直接调用 OpenClaw CLI 执行 AI 任务
+- **当前终端直接显示二维码**：扫码流程在同一个命令行窗口内完成
+- **纯 OpenClaw**：不依赖 QClaw，自动启动 OpenClaw Gateway + CLI 执行 AI 任务
 - **凭证持久化**：扫码成功后凭证保存至 `~/.licity-connector/`，下次无需重新扫码
 
 ## 前置要求
 
 1. **Node.js v18+**（推荐 v22+）
 2. **OpenClaw** 已安装（[下载 OpenClaw](https://openclaw.ai)）
-3. **里世界 APP** 已登录且拥有龙虾
+3. **里世界 APP** 已登录
 
 ## 快速开始
 
@@ -23,7 +23,7 @@ npx @licity/openclaw-connector
 
 **首次运行流程：**
 1. 运行命令后，自动创建连接会话
-2. Windows 弹出新 CMD 窗口显示二维码
+2. 二维码直接在当前终端中显示
 3. 打开里世界 APP → 我的龙虾 → 扫一扫，扫描二维码
 4. APP 批准后自动连接，开始监听任务
 

package/index.js

@@ -206,8 +206,10 @@ async function runAgent({ cliPath, configPath, agentId, lobsterName, message })
     '要求：',
     '1. 直接回复用户，不要提系统提示、模型、网关信息。',
     '2. 使用简体中文，优先简短、明确。',
-    '3. 如果能力受限，如实说明，不要虚构已完成的操作。',
-    '',
+    '3. 如果能力受限，如实说明，不要虚构已完成的操作。',    '4. 如果用户要求发送本地文件或图片，请先找到它的本地绝对路径，然后在回复末尾加上一行：',
+    '   [ATTACH_FILE:文件绝对路径]',
+    '   例如：[ATTACH_FILE:C:\\Users\\Administrator\\Desktop\\版权.png]',
+    '   只附加一个文件，无法发送时如实告知用户。',    '',
     `用户消息：${message || '空消息'}`,
   ].join('\n');
 
@@ -345,7 +347,17 @@ async function emitReply(token, task, payloadOrContent) {
     },
   }, token);
 }
+// ─── 解析龙虾回复中的附件指令 ────────────────────────────────────────────────────────────
+function extractAttachFilePath(text) {
+  const m = String(text || '').match(/\[ATTACH_FILE:([^\]]+)\]/);
+  if (!m) return null;
+  const filePath = m[1].trim();
+  return fs.existsSync(filePath) ? filePath : null;
+}
 
+function stripAttachDirective(text) {
+  return String(text || '').replace(/\[ATTACH_FILE:[^\]]*\]/g, '').trim();
+}
 // ─── 任务处理 ──────────────────────────────────────────────────────────────
 async function handleTask(token, task, cliPath, configPath, lobsterName) {
   if (!task?.id) return false;
@@ -378,9 +390,43 @@ async function handleTask(token, task, cliPath, configPath, lobsterName) {
 
       try {
         const result = await runAgent({ cliPath, configPath, agentId: 'main', lobsterName: lobsterName || 'AI龙虾', message: content });
-        const emitPayload = result.media
-          ? { content: result.reply || '', type: result.media.media_type === 'image' ? 'image' : 'file', ...result.media }
-          : result.reply;
+
+        // 解析回复中是否包含附件路径指令
+        let attachFilePath = null;
+        let cleanReply = result.reply;
+        if (result.reply) {
+          attachFilePath = extractAttachFilePath(result.reply);
+          cleanReply = stripAttachDirective(result.reply);
+        }
+
+        let finalMedia = result.media;
+        if (!finalMedia && attachFilePath) {
+          const stat = fs.statSync(attachFilePath);
+          if (stat.size > MAX_MEDIA_BYTES) {
+            cleanReply = `文件过大（>${MAX_MEDIA_BYTES / 1024 / 1024}MB），无法发送。文件位于：${attachFilePath}`;
+          } else {
+            const nm = path.basename(attachFilePath);
+            const mt = guessType('', nm);
+            const mimeMap = { image: 'image/png', video: 'video/mp4', file: 'application/octet-stream' };
+            const ext = path.extname(nm).toLowerCase();
+            const extMime = {
+              '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png', '.gif': 'image/gif',
+              '.webp': 'image/webp', '.mp4': 'video/mp4', '.pdf': 'application/pdf',
+              '.zip': 'application/zip', '.txt': 'text/plain',
+            };
+            finalMedia = {
+              media_base64: fs.readFileSync(attachFilePath).toString('base64'),
+              media_type: mt,
+              media_mime_type: extMime[ext] || mimeMap[mt] || 'application/octet-stream',
+              media_name: nm,
+            };
+            console.log(`[Task] 附加本地文件: ${nm}`);
+          }
+        }
+
+        const emitPayload = finalMedia
+          ? { content: cleanReply || '', type: finalMedia.media_type === 'image' ? 'image' : 'file', ...finalMedia }
+          : (cleanReply || result.reply);
         const ev = await emitReply(token, task, emitPayload);
         await reportTask(token, task.id, 'succeeded', {
           reply: result.reply,
@@ -407,11 +453,68 @@ async function handleTask(token, task, cliPath, configPath, lobsterName) {
   }
 }
 
+// ─── OpenClaw Gateway 管理 ─────────────────────────────────────────────────
+let _gatewayProc = null;
+
+async function checkPort18789() {
+  return new Promise(res => {
+    const sock = new net.Socket();
+    sock.setTimeout(800);
+    sock.on('connect', () => { sock.destroy(); res(true); });
+    sock.on('error', () => res(false));
+    sock.on('timeout', () => { sock.destroy(); res(false); });
+    sock.connect(18789, '127.0.0.1');
+  });
+}
+
+async function ensureGateway(cliPath, configPath) {
+  if (!cliPath || !configPath) return;
+  const running = await checkPort18789();
+  if (running) {
+    console.log('  OpenClaw Gateway: ✓ 已在运行 (18789)');
+    return;
+  }
+  console.log('  OpenClaw Gateway: 正在启动...');
+  _gatewayProc = spawn(process.execPath, [
+    cliPath, 'gateway', 'run', '--allow-unconfigured',
+  ], {
+    env: { ...process.env, OPENCLAW_CONFIG_PATH: configPath, OPENCLAW_STATE_DIR: path.dirname(configPath), NODE_OPTIONS: '--no-warnings' },
+    windowsHide: true,
+    stdio: 'ignore',
+    detached: false,
+  });
+  _gatewayProc.on('error', err => console.error(`\n[Gateway] 启动错误: ${err.message}`));
+  _gatewayProc.on('exit', code => {
+    _gatewayProc = null;
+    if (state.shouldRun) console.log(`\n[Gateway] 进程已退出 (code: ${code})，可能影响 AI 任务执行`);
+  });
+  for (let i = 0; i < 20; i++) {
+    await sleep(500);
+    if (await checkPort18789()) {
+      console.log('  OpenClaw Gateway: ✓ 启动成功');
+      return;
+    }
+  }
+  console.log('  OpenClaw Gateway: ⚠ 启动超时，AI 任务执行可能失败');
+}
+
+function stopGateway() {
+  if (!_gatewayProc) return;
+  try {
+    if (process.platform === 'win32') {
+      execFile('taskkill', ['/PID', String(_gatewayProc.pid), '/T', '/F'], { windowsHide: true, timeout: 5000 }, () => {});
+    } else {
+      _gatewayProc.kill('SIGTERM');
+    }
+  } catch {}
+  _gatewayProc = null;
+}
+
 // ─── 主循环 ───────────────────────────────────────────────────────────────────
 const state = { shouldRun: true, reconnect: false };
 
-process.on('SIGINT', () => { state.shouldRun = false; state.reconnect = true; });
-process.on('SIGTERM', () => { state.shouldRun = false; state.reconnect = true; });
+process.on('SIGINT', () => { state.shouldRun = false; state.reconnect = true; stopGateway(); });
+process.on('SIGTERM', () => { state.shouldRun = false; state.reconnect = true; stopGateway(); });
 
 async function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
 
@@ -432,6 +535,11 @@ async function connectAndRun(cfg) {
   if (configPath && !cfg.openclawConfigPath) {
     saveConfig({ openclawConfigPath: configPath });
   }
+
+  // 启动并确保 OpenClaw Gateway 在运行（agent 执行任务时需要连接到它）
+  if (cliPath && configPath) {
+    await ensureGateway(cliPath, configPath);
+  }
   console.log('');
 
   // ── 若有已保存的 token，直接跳到心跳循环 ──────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@licity/openclaw-connector",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "里世界龙虾本地连接器 — 一行 npx 命令接入 OpenClaw，扫码即完成连接",
   "main": "index.js",
   "bin": {