@licity/openclaw-connector 1.0.0

package/README.md

@@ -0,0 +1,70 @@
+# @licity/openclaw-connector
+
+里世界龙虾本地连接器 — 一行 `npx` 命令接入 OpenClaw，扫码即完成连接。
+
+## 特点
+
+- **零配置启动**：首次运行自动创建会话，扫码后自动保存凭证
+- **弹出 CMD 窗口**：Windows 上自动弹出新命令行窗口显示二维码，无字符变形
+- **纯 OpenClaw**：不依赖 QClaw，直接调用 OpenClaw CLI 执行 AI 任务
+- **凭证持久化**：扫码成功后凭证保存至 `~/.licity-connector/`，下次无需重新扫码
+
+## 前置要求
+
+1. **Node.js v18+**（推荐 v22+）
+2. **OpenClaw** 已安装（[下载 OpenClaw](https://openclaw.ai)）
+3. **里世界 APP** 已登录且拥有龙虾
+
+## 快速开始
+
+```bash
+npx @licity/openclaw-connector
+```
+
+**首次运行流程：**
+1. 运行命令后，自动创建连接会话
+2. Windows 弹出新 CMD 窗口显示二维码
+3. 打开里世界 APP → 我的龙虾 → 扫一扫，扫描二维码
+4. APP 批准后自动连接，开始监听任务
+
+**后续运行：**
+凭证已保存，直接运行即可，无需再次扫码：
+```bash
+npx @licity/openclaw-connector
+```
+
+## OpenClaw 路径配置
+
+连接器会自动在以下路径搜索 OpenClaw CLI：
+- `D:\OpenClaw\node_modules\openclaw\openclaw.mjs`
+- `C:\OpenClaw\node_modules\openclaw\openclaw.mjs`
+- npm 全局安装目录
+
+也可通过环境变量手动指定：
+```bash
+# Windows
+set OPENCLAW_CLI_PATH=D:\MyOpenClaw\node_modules\openclaw\openclaw.mjs
+npx @licity/openclaw-connector
+
+# Mac/Linux
+OPENCLAW_CLI_PATH=/opt/openclaw/openclaw.mjs npx @licity/openclaw-connector
+```
+
+## 运行时命令
+
+连接器运行中可输入以下命令：
+- `r` — 重新扫码（更换绑定的龙虾）
+- `s` — 查看当前状态
+- `q` — 退出连接器
+
+## 配置文件
+
+凭证和路径配置保存在 `~/.licity-connector/config.json`。
+如需重置，删除该文件后重新运行即可。
+
+## 支持的能力
+
+- 私信（private_chat）
+- 邻里圈（neighbor）
+- 时光穿越（time_travel）
+- 锚点（anchor）

package/index.js

@@ -0,0 +1,626 @@
+#!/usr/bin/env node
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+//  里世界 OpenClaw 本地连接器
+//  一行 npx 命令即可接入 OpenClaw 龙虾，无需手动配置密钥
+//  扫码自动获取凭证，持久化存储，下次运行无需重新扫码
+// ─────────────────────────────────────────────────────────────────────────────
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const net = require('net');
+const crypto = require('crypto');
+const readline = require('readline');
+const { spawn, execFileSync } = require('child_process');
+const { promisify } = require('util');
+const { execFile } = require('child_process');
+const execFileAsync = promisify(execFile);
+
+// ─── 元信息 ───────────────────────────────────────────────────────────────────
+const pkg = require('./package.json');
+const API_BASE = 'https://li.city';
+const CAPABILITY_SCOPES = ['private_chat', 'neighbor', 'anchor', 'time_travel'];
+const HEARTBEAT_INTERVAL_MS = 25000;
+const POLL_INTERVAL_MS = 3000;
+const AGENT_TIMEOUT_MS = Number(process.env.OPENCLAW_COMMAND_TIMEOUT_MS || 120000);
+const MAX_MEDIA_BYTES = 8 * 1024 * 1024; // 8MB
+
+// ─── 配置目录（存储在用户主目录） ─────────────────────────────────────────────
+const CONFIG_DIR = path.join(os.homedir(), '.licity-connector');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const RUNTIME_FILE = path.join(CONFIG_DIR, 'runtime.json');
+
+function ensureConfigDir() {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+}
+
+function loadConfig() {
+  ensureConfigDir();
+  if (!fs.existsSync(CONFIG_FILE)) return {};
+  try { return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')); }
+  catch { return {}; }
+}
+
+function saveConfig(updates) {
+  ensureConfigDir();
+  const cfg = { ...loadConfig(), ...updates, updatedAt: new Date().toISOString() };
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2), 'utf8');
+  return cfg;
+}
+
+// ─── Runtime ID（持久化，重启后不变） ─────────────────────────────────────────
+function getOrCreateRuntimeId() {
+  ensureConfigDir();
+  if (fs.existsSync(RUNTIME_FILE)) {
+    try {
+      const d = JSON.parse(fs.readFileSync(RUNTIME_FILE, 'utf8'));
+      if (d?.runtimeId) return d.runtimeId;
+    } catch {}
+  }
+  const id = crypto.randomUUID();
+  fs.writeFileSync(RUNTIME_FILE, JSON.stringify({ runtimeId: id, createdAt: new Date().toISOString() }, null, 2), 'utf8');
+  return id;
+}
+
+const runtimeId = getOrCreateRuntimeId();
+
+// ─── OpenClaw CLI 路径探测 ─────────────────────────────────────────────────
+const SEARCH_PATHS_CLI = [
+  process.env.OPENCLAW_CLI_PATH,
+  'D:\\OpenClaw\\node_modules\\openclaw\\openclaw.mjs',
+  'C:\\OpenClaw\\node_modules\\openclaw\\openclaw.mjs',
+  path.join(os.homedir(), '.openclaw', 'openclaw.mjs'),
+  path.join(os.homedir(), 'openclaw', 'node_modules', 'openclaw', 'openclaw.mjs'),
+].filter(Boolean);
+
+const SEARCH_PATHS_CONFIG = [
+  process.env.OPENCLAW_CONFIG_PATH,
+  'D:\\OpenClaw\\openclaw.json',
+  'C:\\OpenClaw\\openclaw.json',
+  path.join(os.homedir(), '.openclaw', 'openclaw.json'),
+  path.join(os.homedir(), '.qclaw', 'openclaw.json'),
+].filter(Boolean);
+
+function findOpenClawCli(savedPath) {
+  if (savedPath && fs.existsSync(savedPath)) return savedPath;
+  for (const p of SEARCH_PATHS_CLI) {
+    if (fs.existsSync(p)) return p;
+  }
+  try {
+    const npmRoot = execFileSync(
+      process.platform === 'win32' ? 'npm.cmd' : 'npm',
+      ['root', '-g'],
+      { timeout: 5000, windowsHide: true, stdio: ['ignore', 'pipe', 'ignore'] }
+    ).toString().trim();
+    const c = path.join(npmRoot, 'openclaw', 'openclaw.mjs');
+    if (fs.existsSync(c)) return c;
+  } catch {}
+  return null;
+}
+
+function findOpenClawConfig(savedPath) {
+  if (savedPath && fs.existsSync(savedPath)) return savedPath;
+  for (const p of SEARCH_PATHS_CONFIG) {
+    if (fs.existsSync(p)) return p;
+  }
+  return null;
+}
+
+// ─── HTTP 请求 ─────────────────────────────────────────────────────────────
+async function apiRequest(endpoint, options = {}, token = null) {
+  const url = `${API_BASE}${endpoint}`;
+  const headers = {
+    'Content-Type': 'application/json',
+    'User-Agent': `${pkg.name}/${pkg.version} node/${process.version}`,
+  };
+  if (token) headers['x-connector-token'] = token;
+  Object.assign(headers, options.headers || {});
+
+  const resp = await fetch(url, {
+    method: options.method || 'GET',
+    headers,
+    body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+  });
+
+  const text = await resp.text();
+  let data = {};
+  try { data = JSON.parse(text); } catch { data = { raw: text }; }
+
+  if (!resp.ok) {
+    const err = new Error(data.error || data.raw || `HTTP ${resp.status}`);
+    err.status = resp.status;
+    throw err;
+  }
+  return data;
+}
+
+// ─── 显示二维码（Windows 弹 CMD 新窗口） ──────────────────────────────────────
+function showQrCode(qrText) {
+  // 无论平台都在当前终端打印一次（用于日志记录）
+  try {
+    require('qrcode-terminal').generate(qrText, { small: true });
+  } catch {}
+  console.log('\n二维码文本:');
+  console.log(qrText);
+  console.log('');
+
+  if (process.platform !== 'win32') return;
+
+  // Windows：额外弹出一个 CMD 新窗口，字符渲染更准确，方便扫码
+  try {
+    const qrcodeModPath = require.resolve('qrcode-terminal');
+    const scriptLines = [
+      `const q = require(${JSON.stringify(qrcodeModPath)});`,
+      `const text = ${JSON.stringify(qrText)};`,
+      `try { process.title = '里世界龙虾连接 - 打开APP扫码'; } catch {}`,
+      `console.clear && console.clear();`,
+      `console.log('');`,
+      `console.log('╔══════════════════════════════════════╗');`,
+      `console.log('║      里世界  龙虾连接二维码          ║');`,
+      `console.log('╚══════════════════════════════════════╝');`,
+      `console.log('');`,
+      `q.generate(text, { small: false });`,
+      `console.log('');`,
+      `console.log('请打开里世界APP → 我的龙虾 → 扫一扫');`,
+      `console.log('扫码完成后可关闭此窗口（连接器继续在后台运行）');`,
+      `console.log('');`,
+      `console.log('二维码文本:');`,
+      `console.log(text);`,
+      `process.stdin.resume();`,
+    ];
+    const tempScript = path.join(os.tmpdir(), `licity_qr_${Date.now()}.js`);
+    fs.writeFileSync(tempScript, scriptLines.join('\n'), 'utf8');
+
+    // 使用 cmd /c start 打开一个新的可见 CMD 窗口
+    const child = spawn('cmd.exe', [
+      '/c', 'start', '"里世界龙虾连接"', 'cmd', '/k',
+      `"${process.execPath}" "${tempScript}"`,
+    ], { detached: true, windowsHide: false, shell: false });
+    child.unref();
+
+    console.log('[扫码] 已弹出新的 CMD 窗口，请在新窗口中扫码。');
+  } catch (e) {
+    // 弹窗失败: 当前终端中已有文字版二维码，用户可在此扫码
+    console.log('[扫码] 注：无法弹出新窗口，请在当前终端扫码。');
+  }
+}
+
+// ─── OpenClaw Agent 执行 ─────────────────────────────────────────────────────
+function normalizeAgentReply(parsed) {
+  const payloads = Array.isArray(parsed?.result?.payloads) ? parsed.result.payloads : [];
+  const parts = payloads.map(p => String(p?.text || '').trim()).filter(Boolean);
+  if (parts.length) return parts.join('\n\n');
+  return [parsed?.result?.text, parsed?.result?.output, parsed?.text, parsed?.message]
+    .map(v => String(v || '').trim()).find(Boolean) || '';
+}
+
+function extractLastJson(text) {
+  const s = String(text || '').trim();
+  for (let i = s.lastIndexOf('{'); i >= 0; i = s.lastIndexOf('{', i - 1)) {
+    try { return JSON.parse(s.slice(i)); } catch {}
+  }
+  return null;
+}
+
+function parseAgentSuccess(stdout) {
+  const p = extractLastJson(stdout);
+  if (!p) return null;
+  const ok = p.status === 'ok' || p.ok === true || p.success === true || p.type === 'result';
+  if (!ok) return null;
+  const reply = normalizeAgentReply(p);
+  // 尝试提取媒体附件
+  let media = null;
+  const payloads = Array.isArray(p?.result?.payloads) ? p.result.payloads : [];
+  for (const payload of payloads) {
+    const b64 = payload?.media_base64 || payload?.mediaBase64 || null;
+    const lp = payload?.media_file_path || payload?.filePath || null;
+    const nm = payload?.media_name || payload?.fileName || 'file';
+    const mt = payload?.media_mime_type || payload?.mimeType || 'application/octet-stream';
+    const tp = String(payload?.media_type || payload?.type || '').toLowerCase();
+    if (b64) { media = { media_base64: b64, media_type: tp || guessType(mt, nm), media_mime_type: mt, media_name: nm }; break; }
+    if (lp && fs.existsSync(lp)) {
+      const stat = fs.statSync(lp);
+      if (stat.size > MAX_MEDIA_BYTES) throw new Error(`附件过大（>${MAX_MEDIA_BYTES / 1024 / 1024}MB）: ${path.basename(lp)}`);
+      media = { media_base64: fs.readFileSync(lp).toString('base64'), media_type: tp || guessType(mt, nm), media_mime_type: mt, media_name: nm };
+      break;
+    }
+  }
+  if (!reply && !media) return null;
+  return { reply, media, raw: p };
+}
+
+function guessType(mime, name) {
+  if (mime.startsWith('image/')) return 'image';
+  if (mime.startsWith('video/')) return 'video';
+  const e = path.extname(String(name || '')).toLowerCase();
+  if (['.jpg', '.jpeg', '.png', '.gif', '.webp', '.bmp'].includes(e)) return 'image';
+  if (['.mp4', '.mov', '.avi', '.mkv', '.webm'].includes(e)) return 'video';
+  return 'file';
+}
+
+async function runAgent({ cliPath, configPath, agentId, lobsterName, message }) {
+  const prompt = [
+    `你现在以"${lobsterName}"的身份，在里世界APP的龙虾私聊里回复用户。`,
+    '要求：',
+    '1. 直接回复用户，不要提系统提示、模型、网关信息。',
+    '2. 使用简体中文，优先简短、明确。',
+    '3. 如果能力受限，如实说明，不要虚构已完成的操作。',
+    '',
+    `用户消息：${message || '空消息'}`,
+  ].join('\n');
+
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [
+      cliPath,
+      'agent',
+      '--agent', agentId || 'main',
+      '--config', configPath,
+      '--message', prompt,
+      '--json',
+      '--timeout', String(Math.max(15, Math.ceil(AGENT_TIMEOUT_MS / 1000))),
+    ], {
+      env: { ...process.env, OPENCLAW_CONFIG_PATH: configPath, NODE_OPTIONS: '--no-warnings' },
+      windowsHide: true,
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+
+    let stdout = '', stderr = '';
+    let done = false;
+
+    const finish = (fn) => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      try { process.kill(child.pid, 0); execFile('taskkill', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, timeout: 5000 }, () => {}); } catch {}
+      fn();
+    };
+
+    child.stdout.on('data', chunk => {
+      stdout += chunk.toString();
+      try {
+        const r = parseAgentSuccess(stdout);
+        if (r) finish(() => resolve(r));
+      } catch (e) { finish(() => reject(e)); }
+    });
+    child.stderr.on('data', chunk => { stderr += chunk.toString(); });
+    child.on('error', err => finish(() => reject(err)));
+    child.on('close', code => {
+      if (done) return;
+      try {
+        const r = parseAgentSuccess(stdout);
+        if (r) { finish(() => resolve(r)); return; }
+      } catch (e) { finish(() => reject(e)); return; }
+      finish(() => reject(new Error(
+        (stderr || stdout || `OpenClaw 退出码 ${code}`).slice(0, 400)
+      )));
+    });
+
+    const timer = setTimeout(() => {
+      try {
+        const r = parseAgentSuccess(stdout);
+        if (r) { finish(() => resolve(r)); return; }
+      } catch (e) { finish(() => reject(e)); return; }
+      finish(() => reject(new Error(
+        (stderr || stdout || `OpenClaw 执行超时 (${AGENT_TIMEOUT_MS}ms)`).slice(0, 400)
+      )));
+    }, AGENT_TIMEOUT_MS);
+  });
+}
+
+// ─── 桌面截图 ──────────────────────────────────────────────────────────────
+function shouldCapture(text) {
+  return /(截图|截屏|截个图|抓图).*(桌面|屏幕|全屏)|帮我截.*(桌面|屏幕|全屏)/.test(String(text || ''));
+}
+
+async function captureDesktop() {
+  const dir = path.join(CONFIG_DIR, 'screenshots');
+  fs.mkdirSync(dir, { recursive: true });
+  const file = path.join(dir, `desktop-${Date.now()}.png`);
+  const escapedFile = file.replace(/\\/g, '\\\\');
+  const ps = [
+    'Add-Type -AssemblyName System.Windows.Forms;',
+    'Add-Type -AssemblyName System.Drawing;',
+    '$b=[System.Windows.Forms.SystemInformation]::VirtualScreen;',
+    '$bm=New-Object System.Drawing.Bitmap $b.Width,$b.Height;',
+    '$g=[System.Drawing.Graphics]::FromImage($bm);',
+    '$g.CopyFromScreen($b.Left,$b.Top,0,0,$bm.Size);',
+    `$bm.Save('${escapedFile}',[System.Drawing.Imaging.ImageFormat]::Png);`,
+    '$g.Dispose();$bm.Dispose();',
+  ].join(' ');
+  await execFileAsync('powershell.exe', ['-NoProfile', '-STA', '-Command', ps], { windowsHide: true, timeout: 30000 });
+  return file;
+}
+
+// ─── API 操作封装 ─────────────────────────────────────────────────────────────
+async function createScanSession(deviceName) {
+  return apiRequest('/api/openclaw/scan-session', {
+    method: 'POST',
+    body: {
+      runtimeId,
+      provider: 'openclaw',
+      deviceName: deviceName || os.hostname(),
+      platform: `${os.platform()} ${os.release()}`,
+      version: pkg.version,
+      capabilityScopes: CAPABILITY_SCOPES,
+      metadata: { connector: pkg.name, nodeVersion: process.version },
+    },
+  });
+}
+
+async function pollScanSession(sessionId) {
+  return apiRequest(`/api/openclaw/scan-session/${sessionId}`);
+}
+
+async function sendHeartbeat(token, deviceName) {
+  return apiRequest('/api/openclaw/heartbeat', {
+    method: 'POST',
+    body: { runtimeId, metadata: { connector: pkg.name, heartbeatAt: new Date().toISOString() } },
+  }, token);
+}
+
+async function pullTask(token) {
+  return apiRequest(`/api/openclaw/tasks/next?runtimeId=${encodeURIComponent(runtimeId)}`, {}, token);
+}
+
+async function reportTask(token, taskId, status, result = {}, errorMessage = null) {
+  return apiRequest(`/api/openclaw/tasks/${taskId}/result`, {
+    method: 'POST',
+    body: { runtimeId, status, result, errorMessage },
+  }, token);
+}
+
+async function emitReply(token, task, payloadOrContent) {
+  const payload = typeof payloadOrContent === 'string'
+    ? { content: payloadOrContent, type: 'text', meta: { taskId: task.id, runtimeId } }
+    : { ...payloadOrContent, meta: { ...(payloadOrContent?.meta || {}), taskId: task.id, runtimeId } };
+  return apiRequest('/api/openclaw/events', {
+    method: 'POST',
+    body: {
+      lobsterId: task?.payload?.lobsterId || task?.lobsterId || null,
+      runtimeId,
+      requestId: task.requestId || task.id,
+      eventType: 'private_message_reply',
+      payload,
+    },
+  }, token);
+}
+
+// ─── 任务处理 ──────────────────────────────────────────────────────────────
+async function handleTask(token, task, cliPath, configPath, lobsterName) {
+  if (!task?.id) return false;
+  console.log(`[Task] 收到 ${task.taskType} (${task.id.slice(0, 8)}...)`);
+
+  try {
+    if (task.taskType === 'private_chat_message') {
+      const content = String(task?.payload?.content || '').trim();
+
+      if (shouldCapture(content)) {
+        const file = await captureDesktop();
+        const reply = `已截取当前桌面，保存于本机：${file}`;
+        await emitReply(token, task, {
+          content: reply, type: 'image',
+          media_base64: fs.readFileSync(file).toString('base64'),
+          media_type: 'image', media_mime_type: 'image/png', media_name: path.basename(file),
+        });
+        await reportTask(token, task.id, 'succeeded', { reply, action: 'capture_desktop' });
+        console.log(`[Task] 截图完成`);
+        return true;
+      }
+
+      if (!cliPath || !configPath) {
+        const fb = cliPath ? '未找到 OpenClaw 配置文件' : '未找到 OpenClaw CLI，请先安装 openclaw（npm install -g openclaw）并设置路径。';
+        await emitReply(token, task, fb);
+        await reportTask(token, task.id, 'failed', {}, fb);
+        console.log(`[Task] 跳过执行: ${fb}`);
+        return true;
+      }
+
+      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;
+        const ev = await emitReply(token, task, emitPayload);
+        await reportTask(token, task.id, 'succeeded', {
+          reply: result.reply,
+          model: result.raw?.result?.meta?.agentMeta?.model || null,
+          action: 'openclaw_agent_reply',
+        });
+        console.log(`[Task] 回复成功 (eventId=${ev?.event?.id || 'n/a'}): ${content.slice(0, 50)}`);
+      } catch (err) {
+        const fb = `本地智能引擎返回错误：${err.message || '未知错误'}。`;
+        await emitReply(token, task, fb);
+        await reportTask(token, task.id, 'failed', {}, err.message);
+        console.log(`[Task] OpenClaw 执行失败: ${err.message?.slice(0, 200)}`);
+      }
+      return true;
+    }
+
+    await reportTask(token, task.id, 'failed', {}, `暂不支持的任务类型: ${task.taskType}`);
+    console.log(`[Task] 不支持的任务类型: ${task.taskType}`);
+    return false;
+  } catch (err) {
+    await reportTask(token, task.id, 'failed', {}, err.message || '任务执行失败');
+    console.error(`[Task] 执行异常: ${err.message}`);
+    return false;
+  }
+}
+
+// ─── 主循环 ───────────────────────────────────────────────────────────────────
+const state = { shouldRun: true, reconnect: false };
+
+process.on('SIGINT', () => { state.shouldRun = false; state.reconnect = true; });
+process.on('SIGTERM', () => { state.shouldRun = false; state.reconnect = true; });
+
+async function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
+
+async function connectAndRun(cfg) {
+  const token = cfg.connectorToken || null;
+  const deviceName = cfg.deviceName || os.hostname();
+  const cliPath = findOpenClawCli(cfg.openclawCliPath);
+  const configPath = findOpenClawConfig(cfg.openclawConfigPath);
+
+  // 启动前检查
+  console.log('\n启动前检查:');
+  console.log(`  OpenClaw CLI:    ${cliPath ? '✓ ' + cliPath : '✗ 未找到（将无法执行 AI 任务，其余功能正常）'}`);
+  console.log(`  OpenClaw 配置:   ${configPath ? '✓ ' + configPath : '✗ 未找到'}`);
+  if (cliPath && !cfg.openclawCliPath) {
+    saveConfig({ openclawCliPath: cliPath });
+    console.log(`  → 已自动保存 CLI 路径到配置`);
+  }
+  if (configPath && !cfg.openclawConfigPath) {
+    saveConfig({ openclawConfigPath: configPath });
+  }
+  console.log('');
+
+  // ── 若有已保存的 token，直接跳到心跳循环 ──────────────────────────────────
+  if (token) {
+    console.log(`[连接] 使用已保存的连接凭证 (设备: ${deviceName})`);
+    console.log(`[连接] 如需重新绑定龙虾，请输入 r 重新生成二维码`);
+    return await heartbeatLoop(token, deviceName, cliPath, configPath, cfg.lobsterName);
+  }
+
+  // ── 创建扫码会话 ──────────────────────────────────────────────────────────
+  console.log(`[扫码] 正在创建连接会话...`);
+  const created = await createScanSession(deviceName);
+  const sessionId = created.session.id;
+  const qrPayload = created.qrPayload;
+
+  console.log(`[扫码] 会话已创建: ${sessionId}`);
+  console.log(`[扫码] 请在里世界 APP → 我的龙虾 → 扫一扫，扫描下方二维码\n`);
+
+  showQrCode(JSON.stringify(qrPayload));
+
+  // ── 轮询等待批准 ──────────────────────────────────────────────────────────
+  console.log(`[扫码] 等待APP扫码批准（最多10分钟）...`);
+  let approved = null;
+  while (state.shouldRun && !state.reconnect) {
+    await sleep(POLL_INTERVAL_MS);
+    const result = await pollScanSession(sessionId);
+    const session = result.session;
+
+    if (session.status === 'approved' && session.connectorAuthToken) {
+      approved = session;
+      console.log(`\n[连接] ✓ 扫码成功！已绑定龙虾: ${session.lobster?.name || '未知'}`);
+      break;
+    }
+    if (session.status === 'expired') {
+      console.log(`[扫码] 二维码已过期，准备重新生成...`);
+      return;
+    }
+    if (session.status === 'rejected') {
+      console.log(`[扫码] 连接已被拒绝，准备重新生成...`);
+      return;
+    }
+    process.stdout.write('.');
+  }
+
+  if (!approved) return;
+
+  // ── 保存凭证 ──────────────────────────────────────────────────────────────
+  const newToken = approved.connectorAuthToken;
+  const lobsterName = approved.lobster?.name || '';
+  saveConfig({ connectorToken: newToken, lobsterName, deviceName, savedAt: new Date().toISOString() });
+  console.log(`[连接] 连接凭证已保存至 ${CONFIG_FILE}`);
+
+  await heartbeatLoop(newToken, deviceName, cliPath, configPath, lobsterName);
+}
+
+async function heartbeatLoop(token, deviceName, cliPath, configPath, lobsterName) {
+  console.log(`\n[在线] 龙虾已连接，开始监听任务...`);
+  console.log(`[命令] r=重新扫码  s=查看状态  q=退出\n`);
+
+  let nextHeartbeat = 0;
+  let nextPoll = 0;
+
+  while (state.shouldRun && !state.reconnect) {
+    const now = Date.now();
+
+    if (now >= nextHeartbeat) {
+      try {
+        const hb = await sendHeartbeat(token, deviceName);
+        const lname = hb.lobster?.name || lobsterName || '未知';
+        process.stdout.write(`\r[♡ ${new Date().toLocaleTimeString()}] 龙虾=${lname}  `);
+        nextHeartbeat = Date.now() + HEARTBEAT_INTERVAL_MS;
+      } catch (err) {
+        console.error(`\n[心跳] 失败: ${err.message}`);
+        if (err.status === 403 || err.status === 404) {
+          console.log('[心跳] 凭证已失效，清除保存的 token，准备重新扫码...');
+          saveConfig({ connectorToken: null });
+          return;
+        }
+        nextHeartbeat = Date.now() + 5000;
+      }
+    }
+
+    if (now >= nextPoll) {
+      try {
+        const tr = await pullTask(token);
+        if (tr.task) {
+          process.stdout.write('\n');
+          await handleTask(token, tr.task, cliPath, configPath, lobsterName || tr.lobster?.name);
+          nextPoll = Date.now() + 500;
+          continue;
+        }
+      } catch (err) {
+        if (err.status === 403 || err.status === 404) {
+          console.log('\n[任务] 凭证已失效，准备重新扫码...');
+          saveConfig({ connectorToken: null });
+          return;
+        }
+        nextPoll = Date.now() + 5000;
+      }
+      nextPoll = Date.now() + POLL_INTERVAL_MS;
+    }
+
+    await sleep(500);
+  }
+}
+
+function startKeyboard() {
+  if (!process.stdin.isTTY) return;
+  const rl = readline.createInterface({ input: process.stdin });
+  rl.on('line', line => {
+    const cmd = line.trim().toLowerCase();
+    if (cmd === 'q' || cmd === 'quit') { state.shouldRun = false; state.reconnect = true; rl.close(); }
+    else if (cmd === 'r') { console.log('\n[命令] 重新扫码...'); state.reconnect = true; }
+    else if (cmd === 's') {
+      const cfg = loadConfig();
+      console.log('\n当前状态:', JSON.stringify({ runtimeId, hasToken: !!cfg.connectorToken, cliPath: cfg.openclawCliPath, configPath: cfg.openclawConfigPath }, null, 2));
+    }
+  });
+}
+
+async function main() {
+  console.log('');
+  console.log('╔════════════════════════════════════════╗');
+  console.log('║   里世界 OpenClaw 本地连接器 v' + pkg.version.padEnd(10) + '║');
+  console.log('╚════════════════════════════════════════╝');
+  console.log(`配置目录: ${CONFIG_DIR}`);
+  console.log(`Runtime ID: ${runtimeId}`);
+  console.log('');
+
+  startKeyboard();
+
+  while (state.shouldRun) {
+    state.reconnect = false;
+    try {
+      const cfg = loadConfig();
+      await connectAndRun(cfg);
+    } catch (err) {
+      console.error(`\n[错误] ${err.message}`);
+      if (!state.shouldRun) break;
+      await sleep(3000);
+    }
+  }
+
+  console.log('\n[退出] 连接器已停止。');
+  process.exit(0);
+}
+
+main().catch(err => {
+  console.error('启动失败:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@licity/openclaw-connector",
+  "version": "1.0.0",
+  "description": "里世界龙虾本地连接器 — 一行 npx 命令接入 OpenClaw，扫码即完成连接",
+  "main": "index.js",
+  "bin": {
+    "licity-connector": "index.js",
+    "openclaw-connector": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "licity",
+    "openclaw",
+    "connector",
+    "lobster",
+    "里世界",
+    "龙虾"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "qrcode-terminal": "^0.12.0"
+  }
+}