@lumachat/lumachat 0.15.2 → 0.15.3

package/README.md

@@ -3,7 +3,7 @@
 该目录包含 LumaChat 的 OpenClaw 通道插件实现。
 
 ## 已实现功能
-- 完整配对流程（请求配对码+安全码、轮询状态、保存 token 到 `channels.clawdchat`）。
+- 完整配对流程（请求配对码+安全码、轮询状态、保存 token 到 `channels.lumachat`，兼容读取 `channels.clawdchat`）。
 - 与 LumaChat 后端保持 WebSocket 长连接。
 - 入站消息接入（LumaChat -> OpenClaw），按 `request_id` 回传回复。
 - CLI 配对入口（`openclaw channels login --channel lumachat`）。
@@ -22,7 +22,7 @@ corepack prepare pnpm@latest --activate
 
 安装插件：
 ```
-openclaw plugins install @lumachat/lumachat@0.15.0
+openclaw plugins install @lumachat/lumachat@0.15.2
 ```
 
 ## 更新
@@ -40,9 +40,17 @@ openclaw plugins install @lumachat/lumachat@0.15.0
 - 支持返回并展示 6 位安全码（pairing confirm code），与 App 双码配对流程保持一致。
 - 补齐 clawdchat 消息目标解析（`chat:<uuid>` / `clawdchat:<uuid>`），避免 `Unknown target` 导致回复丢失。
 
+### 0.15.1
+- 修复 `openclaw plugins install @lumachat/lumachat` 后配置校验 `plugin not found: lumachat` 的问题。
+- 插件 ID 迁移为 `lumachat`，并保持对旧 ID `clawdchat` 的兼容读取。
+- 若本地历史配置里存在 `plugins.entries.clawdchat`，请删除该键并改为 `plugins.entries.lumachat`。
+
+### 0.15.2
+- 发布 `@lumachat/lumachat@0.15.2`，作为当前稳定安装版本。
+
 升级：
 ```
-openclaw plugins install @lumachat/lumachat@0.15.0
+openclaw plugins install @lumachat/lumachat@0.15.2
 ```
 
 ## 配对流程（当前）
@@ -52,6 +60,8 @@ openclaw plugins install @lumachat/lumachat@0.15.0
 4. 插件会保存通道 token 并自动连接后端。
 
 ## 可选配置
+- `LUMACHAT_API_BASE_URL`：覆盖后端地址（默认：`https://api-love2.huaizuo2029.cn`；本地开发可设为 `http://127.0.0.1:8000`）。
+- `LUMACHAT_CHANNEL_KEY` / `LUMACHAT_SHARED_KEY`：当后端要求 `X-Clawdchat-Channel-Key` 时使用。
 - `CLAWDCHAT_API_BASE_URL`：覆盖后端地址（默认：`https://api-love2.huaizuo2029.cn`；本地开发可设为 `http://127.0.0.1:8000`）。
 - `CLAWDCHAT_CHANNEL_KEY` / `CLAWDCHAT_SHARED_KEY`：当后端要求 `X-Clawdchat-Channel-Key` 时使用。
 

package/openclaw.plugin.json

@@ -1,9 +1,10 @@
 {
-  "id": "clawdchat",
+  "id": "lumachat",
   "name": "LumaChat Channel",
   "description": "LumaChat mobile channel for OpenClaw",
-  "version": "0.15.2",
+  "version": "0.15.3",
   "channels": [
+    "lumachat",
     "clawdchat"
   ],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumachat/lumachat",
-  "version": "0.15.2",
+  "version": "0.15.3",
   "description": "LumaChat channel plugin for OpenClaw",
   "type": "module",
   "license": "Apache-2.0",
@@ -21,14 +21,14 @@
       "./src/index.ts"
     ],
     "channel": {
-      "id": "clawdchat",
+      "id": "lumachat",
       "label": "LumaChat",
       "selectionLabel": "LumaChat (配对码)",
-      "docsPath": "/channels/clawdchat",
+      "docsPath": "/channels/lumachat",
       "blurb": "通过配对码把 Clawdbot 接入 LumaChat。",
       "aliases": [
-        "clawdchat",
-        "lumachat"
+        "lumachat",
+        "clawdchat"
       ]
     },
     "install": {

package/src/index.ts

@@ -17,6 +17,8 @@ const RECONNECT_BASE_MS = 2_000;
 const RECONNECT_MAX_MS = 20_000;
 const PAIRING_POLL_INTERVAL_MS = 2_000;
 const PAIRING_WAIT_TIMEOUT_MS = 10 * 60 * 1000;
+const CHANNEL_ID = "lumachat";
+const LEGACY_CHANNEL_ID = "clawdchat";
 
 const HEADER_CHANNEL_KEY = "X-Clawdchat-Channel-Key";
 const HEADER_PAIRING_SECRET = "X-Pairing-Secret";
@@ -83,15 +85,18 @@ const normalizeValue = (value?: string | null): string | undefined => {
 };
 
 const resolveClawdchatSection = (cfg: OpenClawConfig): ClawdchatConfigSection =>
-  (cfg.channels?.clawdchat ?? {}) as ClawdchatConfigSection;
+  (cfg.channels?.lumachat ?? cfg.channels?.clawdchat ?? {}) as ClawdchatConfigSection;
 
 const resolveBaseUrl = (cfg: OpenClawConfig): string =>
   normalizeValue(resolveClawdchatSection(cfg).baseUrl) ??
+  normalizeValue(process.env.LUMACHAT_API_BASE_URL) ??
   normalizeValue(process.env.CLAWDCHAT_API_BASE_URL) ??
   DEFAULT_BASE_URL;
 
 const resolveSharedKey = (cfg: OpenClawConfig): string | undefined =>
   normalizeValue(resolveClawdchatSection(cfg).sharedKey) ??
+  normalizeValue(process.env.LUMACHAT_CHANNEL_KEY) ??
+  normalizeValue(process.env.LUMACHAT_SHARED_KEY) ??
   normalizeValue(process.env.CLAWDCHAT_CHANNEL_KEY) ??
   normalizeValue(process.env.CLAWDCHAT_SHARED_KEY);
 
@@ -101,7 +106,7 @@ const buildConfigPatch = (cfg: OpenClawConfig, patch: Partial<ClawdchatConfigSec
     ...cfg,
     channels: {
       ...cfg.channels,
-      clawdchat: {
+      lumachat: {
         ...current,
         ...patch,
       },
@@ -111,14 +116,17 @@ const buildConfigPatch = (cfg: OpenClawConfig, patch: Partial<ClawdchatConfigSec
 
 const removeClawdchatFields = (cfg: OpenClawConfig, fields: Array<keyof ClawdchatConfigSection>) => {
   const current = { ...resolveClawdchatSection(cfg) } as Record<string, unknown>;
+  const legacy = { ...(cfg.channels?.clawdchat ?? {}) } as Record<string, unknown>;
   for (const field of fields) {
     delete current[field as string];
+    delete legacy[field as string];
   }
   return {
     ...cfg,
     channels: {
       ...cfg.channels,
-      clawdchat: current,
+      lumachat: current,
+      clawdchat: legacy,
     },
   } as OpenClawConfig;
 };
@@ -204,7 +212,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
   const resolveAccount = (cfg: OpenClawConfig, accountId?: string | null): ResolvedClawdchatAccount => {
     const section = resolveClawdchatSection(cfg);
     const resolvedId = accountId ?? DEFAULT_ACCOUNT_ID;
-    const name = section.name?.trim() || "Clawdchat";
+    const name = section.name?.trim() || "LumaChat";
     return {
       accountId: resolvedId,
       name,
@@ -299,18 +307,18 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
     };
 
     if (!requestId || !conversationId || !content) {
-      await respondError("invalid_message", "Invalid clawdchat payload.");
+      await respondError("invalid_message", "Invalid lumachat payload.");
       return;
     }
 
     const timestampMs = payload.timestamp ? Date.parse(payload.timestamp) : Date.now();
     const route = api.runtime.channel.routing.resolveAgentRoute({
       cfg,
-      channel: "clawdchat",
+      channel: CHANNEL_ID,
       peer: { kind: "dm", id: conversationId },
     });
 
-    const senderLabel = `clawdchat:${conversationId}`;
+    const senderLabel = `${CHANNEL_ID}:${conversationId}`;
     const storePath = api.runtime.channel.session.resolveStorePath(cfg.session?.store, {
       agentId: route.agentId,
     });
@@ -320,7 +328,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
     });
     const envelopeOptions = api.runtime.channel.reply.resolveEnvelopeFormatOptions(cfg);
     const body = api.runtime.channel.reply.formatAgentEnvelope({
-      channel: "Clawdchat",
+      channel: "LumaChat",
       from: senderLabel,
       timestamp: timestampMs,
       previousTimestamp,
@@ -340,13 +348,13 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
       ConversationLabel: senderLabel,
       SenderName: senderLabel,
       SenderId: conversationId,
-      Provider: "clawdchat" as const,
-      Surface: "clawdchat" as const,
+      Provider: CHANNEL_ID as const,
+      Surface: CHANNEL_ID as const,
       MessageSid: requestId,
       Timestamp: timestampMs,
       CommandAuthorized: true,
       CommandSource: "text" as const,
-      OriginatingChannel: "clawdchat" as const,
+      OriginatingChannel: CHANNEL_ID as const,
       OriginatingTo: `chat:${conversationId}`,
     });
 
@@ -394,7 +402,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
           }
         },
         onError: (err) => {
-          log?.warn?.(`clawdchat reply error: ${String(err)}`);
+          log?.warn?.(`lumachat reply error: ${String(err)}`);
         },
       });
 
@@ -420,7 +428,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         }
       }
     } catch (err) {
-      log?.error?.(`clawdchat dispatch failed: ${String(err)}`);
+      log?.error?.(`lumachat dispatch failed: ${String(err)}`);
       await respondError("assistant_unavailable", "Assistant unavailable.");
     }
   };
@@ -466,7 +474,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         heartbeat = setInterval(() => {
           sendJson(socket, { type: "heartbeat" }).catch(() => undefined);
         }, HEARTBEAT_INTERVAL_MS);
-        log?.info?.("clawdchat channel connected");
+        log?.info?.("lumachat channel connected");
       });
 
       socket.on("message", (data) => {
@@ -475,7 +483,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         try {
           payload = JSON.parse(text) as InboundPayload;
         } catch (err) {
-          log?.warn?.(`clawdchat payload parse error: ${String(err)}`);
+          log?.warn?.(`lumachat payload parse error: ${String(err)}`);
           return;
         }
         if (payload.type === "heartbeat") {
@@ -495,7 +503,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
       });
 
       socket.on("error", (err) => {
-        log?.warn?.(`clawdchat socket error: ${String(err)}`);
+        log?.warn?.(`lumachat socket error: ${String(err)}`);
       });
 
       socket.on("close", (code, reason) => {
@@ -503,7 +511,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         signal.removeEventListener("abort", abortHandler);
         update({ running: false, lastStopAt: new Date().toISOString() });
         const reasonText = reason?.toString?.() ?? "";
-        log?.warn?.(`clawdchat channel closed (${code}) ${reasonText}`);
+        log?.warn?.(`lumachat channel closed (${code}) ${reasonText}`);
         resolve();
       });
 
@@ -557,14 +565,14 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
   };
 
   return {
-    id: "clawdchat",
+    id: CHANNEL_ID,
     meta: {
-      id: "clawdchat",
-      label: "Clawdchat",
-      selectionLabel: "Clawdchat (pair code)",
-      docsPath: "/channels/clawdchat",
-      blurb: "Pair Clawdchat with a 6-digit code.",
-      aliases: ["clawdchat"],
+      id: CHANNEL_ID,
+      label: "LumaChat",
+      selectionLabel: "LumaChat (pair code)",
+      docsPath: "/channels/lumachat",
+      blurb: "Pair LumaChat with a 6-digit code.",
+      aliases: [CHANNEL_ID, LEGACY_CHANNEL_ID],
     },
     capabilities: {
       chatTypes: ["direct"],
@@ -580,7 +588,10 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         if (!trimmed) return undefined;
         const lower = trimmed.toLowerCase();
         if (lower.startsWith("chat:")) return trimmed;
-        if (lower.startsWith("clawdchat:")) return `chat:${trimmed.slice("clawdchat:".length)}`;
+        if (lower.startsWith(`${CHANNEL_ID}:`)) return `chat:${trimmed.slice(`${CHANNEL_ID}:`.length)}`;
+        if (lower.startsWith(`${LEGACY_CHANNEL_ID}:`)) {
+          return `chat:${trimmed.slice(`${LEGACY_CHANNEL_ID}:`.length)}`;
+        }
         if (UUID_REGEX.test(trimmed)) return `chat:${trimmed}`;
         return undefined;
       },
@@ -588,13 +599,20 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         looksLikeId: (raw, normalized) => {
           const lower = raw.trim().toLowerCase();
           if (!lower) return false;
-          if (lower.startsWith("chat:") || lower.startsWith("clawdchat:")) return true;
+          if (
+            lower.startsWith("chat:") ||
+            lower.startsWith(`${CHANNEL_ID}:`) ||
+            lower.startsWith(`${LEGACY_CHANNEL_ID}:`)
+          ) {
+            return true;
+          }
           if (UUID_REGEX.test(lower)) return true;
           return Boolean(normalized && normalized.toLowerCase().startsWith("chat:"));
         },
-        hint: "使用 clawdchat 会话 ID（形如 chat:<uuid>）。",
+        hint: "使用 lumachat 会话 ID（形如 chat:<uuid>）。",
       },
-      formatTargetDisplay: ({ target }) => target.replace(/^chat:/i, "").replace(/^clawdchat:/i, ""),
+      formatTargetDisplay: ({ target }) =>
+        target.replace(/^chat:/i, "").replace(/^lumachat:/i, "").replace(/^clawdchat:/i, ""),
     },
     config: {
       listAccountIds: () => [DEFAULT_ACCOUNT_ID],
@@ -616,7 +634,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
     outbound: {
       deliveryMode: "direct",
       sendText: async () => {
-        throw new Error("Clawdchat outbound is only supported for inbound replies.");
+        throw new Error("LumaChat outbound is only supported for inbound replies.");
       },
     },
     status: {
@@ -632,10 +650,10 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         for (const account of accounts) {
           if (!account.configured) {
             issues.push({
-              channel: "clawdchat",
+              channel: CHANNEL_ID,
               accountId: account.accountId ?? DEFAULT_ACCOUNT_ID,
               kind: "config",
-              message: "Clawdchat channel not paired",
+              message: "LumaChat channel not paired",
             });
           }
         }
@@ -673,7 +691,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         const cfg = api.runtime.config.loadConfig();
         const account = resolveAccount(cfg, resolvedId);
         if (account.channelToken && !force) {
-          return { message: "Clawdchat already paired." };
+          return { message: "LumaChat already paired." };
         }
         const baseUrl = account.baseUrl;
         const sharedKey = account.sharedKey;
@@ -718,7 +736,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
             });
             await api.runtime.config.writeConfigFile(nextCfg);
             pairingSessions.delete(resolvedId);
-            return { connected: true, message: "Clawdchat paired." };
+            return { connected: true, message: "LumaChat paired." };
           }
           if (status.status === "expired") {
             pairingSessions.delete(resolvedId);
@@ -744,7 +762,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         const warn = runtime.error ?? console.warn;
 
         if (account.channelToken) {
-          log("Clawdchat 已配对。若需重新配对，请先执行 `openclaw channels logout --channel clawdchat`。");
+          log("LumaChat 已配对。若需重新配对，请先执行 `openclaw channels logout --channel lumachat`。");
           return;
         }
 
@@ -755,9 +773,9 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         if (!pairing.pairingId || !pairing.pairingCode || !pairing.pairingConfirmCode || !pairing.pairingSecret) {
           throw new Error("Failed to request pairing code.");
         }
-        log(`Clawdchat 配对码：${pairing.pairingCode}`);
-        log(`Clawdchat 安全码：${pairing.pairingConfirmCode}`);
-        log("请在 clawdchat App -> 设置 -> Clawdbot 配对 中输入配对码与安全码。");
+        log(`LumaChat 配对码：${pairing.pairingCode}`);
+        log(`LumaChat 安全码：${pairing.pairingConfirmCode}`);
+        log("请在 LumaChat App -> 设置 -> Clawdbot 配对 中输入配对码与安全码。");
 
         const session: PairingSession = {
           accountId: resolvedId,
@@ -787,7 +805,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
               pairedAt: new Date().toISOString(),
             });
             await api.runtime.config.writeConfigFile(nextCfg);
-            log("Clawdchat 配对成功。");
+            log("LumaChat 配对成功。");
             return;
           }
           if (status.status === "expired") {