@lumachat/lumachat 0.15.4 → 0.15.5

package/README.md

@@ -1,41 +1,61 @@
 # LumaChat OpenClaw 通道插件
 
-该插件用于将 OpenClaw 接入 LumaChat App，当前配对方式为 **OAuth 2.0 Device Flow**（授权码 + 扫码）。
+用于把 OpenClaw 接入 LumaChat App。  
+从 `0.15.5` 开始，登录方式升级为 **OAuth 2.0 Device Flow（仅扫码）**，不再使用“配对码 + 安全码”双码流程。
 
-## 版本与安装
+## 快速开始（站在 OpenClaw 用户视角）
 
-当前版本：`0.15.4`
+### 1) 安装或升级插件
+
+在 OpenClaw 项目目录执行：
 
 ```bash
-pnpm openclaw plugins install @lumachat/lumachat@0.15.4
-# 或升级
+pnpm openclaw plugins install @lumachat/lumachat@0.15.5
+# 已安装过则可直接升级
 pnpm openclaw plugins update lumachat
 openclaw gateway restart
 ```
 
-## 配对流程（OAuth 设备授权）
+建议确认当前插件版本：
 
-1. 在 Clawdbot 机器执行：
+```bash
+pnpm openclaw plugins list
+```
+
+### 2) 发起登录授权
 
 ```bash
-openclaw channels login --channel lumachat
+pnpm openclaw channels login --channel lumachat
 ```
 
-2. 终端会输出：
-   - 二维码（可直接扫码）
-   - 6 位授权码（`user_code`，可手动输入）
+预期输出：
+- 终端二维码（ASCII）
+- 仅显示扫码二维码
+
+### 3) 在 App 内完成授权
 
-3. 在 LumaChat App 中进入：`设置 -> Clawdbot 配对`
-   - 可扫码授权
-   - 或手动输入 6 位授权码
+打开 LumaChat App：`设置 -> Clawdbot 配对`
+- 直接扫码授权
 
-4. 授权成功后，插件会自动保存 `channelToken` 并建立连接。
+授权完成后，插件会自动保存 `channelToken` 并连接网关。
+
+## 常用命令
+
+```bash
+# 重新登录（换绑/重绑）
+pnpm openclaw channels logout --channel lumachat
+pnpm openclaw channels login --channel lumachat
+
+# 查看插件版本
+pnpm openclaw plugins list
+```
 
 ## 常见问题
 
-- 提示 `授权码已过期`：重新执行 `openclaw channels login --channel lumachat`
-- 提示 `OAuth client_id 无效`：升级插件和后端到最新版本
-- 一直等待授权：确认 App 已登录并在配对页完成授权
+- 仍看到“配对码 + 安全码”：当前还在用旧版本，请升级到 `@lumachat/lumachat@0.15.5` 后重启网关。
+- 提示 `授权已过期`：重新执行 `pnpm openclaw channels login --channel lumachat`。
+- 提示 `OAuth client_id 无效`：插件和后端版本不匹配，请同时升级。
+- 一直等待授权：确认 App 已登录账号，并停留在配对页面完成授权。
 
 ## 可选环境变量
 
@@ -44,9 +64,9 @@ openclaw channels login --channel lumachat
 - `CLAWDCHAT_API_BASE_URL`：同上（兼容旧变量）
 - `CLAWDCHAT_CHANNEL_KEY` / `CLAWDCHAT_SHARED_KEY`：同上（兼容旧变量）
 
-## 备注
+## 技术备注
 
-- 插件 OAuth 相关接口：
+- OAuth 设备授权接口：
   - `POST /oauth/device/code`
   - `POST /oauth/token`
-- WebSocket 连接地址：`/ws/channel/clawdchat`
+- WebSocket 地址：`/ws/channel/clawdchat`

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "lumachat",
   "name": "LumaChat Channel",
   "description": "LumaChat mobile channel for OpenClaw",
-  "version": "0.15.4",
+  "version": "0.15.5",
   "channels": [
     "lumachat",
     "clawdchat"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumachat/lumachat",
-  "version": "0.15.4",
+  "version": "0.15.5",
   "description": "LumaChat channel plugin for OpenClaw",
   "type": "module",
   "license": "Apache-2.0",
@@ -24,9 +24,9 @@
     "channel": {
       "id": "lumachat",
       "label": "LumaChat",
-      "selectionLabel": "LumaChat (授权码/扫码)",
+      "selectionLabel": "LumaChat (扫码授权)",
       "docsPath": "/channels/lumachat",
-      "blurb": "通过 OAuth 授权码或扫码把 Clawdbot 接入 LumaChat。",
+      "blurb": "通过扫码授权把 Clawdbot 接入 LumaChat。",
       "aliases": [
         "lumachat",
         "clawdchat"

package/src/index.ts

@@ -388,7 +388,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
       case "slow_down":
         return "slow_down";
       case "expired_token":
-        return "授权码已过期，请重新执行登录。";
+        return "授权已过期，请重新执行登录。";
       case "invalid_client":
         return "OAuth client_id 无效，请升级插件或检查后端配置。";
       case "invalid_grant":
@@ -430,7 +430,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
       const message = formatTokenError(result);
       if (message === "authorization_pending") {
         if (onProgress) {
-          onProgress(`等待授权确认中（授权码 ${session.userCode}）...`);
+          onProgress("等待扫码授权确认中...");
         }
       } else if (message === "slow_down") {
         pollIntervalMs += DEVICE_AUTH_SLOW_DOWN_ADD_MS;
@@ -906,7 +906,7 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
         const expires = session.expiresAt ? ` (expires ${session.expiresAt})` : "";
         return {
           qrDataUrl,
-          message: `OAuth user code: ${session.userCode}${expires}`,
+          message: `请在 LumaChat App 扫码授权${expires}`,
         };
       },
       loginWithQrWait: async ({ accountId, timeoutMs }) => {
@@ -973,11 +973,9 @@ const createClawdchatPlugin = (api: OpenClawPluginApi): ChannelPlugin<ResolvedCl
           log("LumaChat 扫码授权二维码：");
           log(terminalQr);
         } else {
-          warn("二维码生成失败，请改用 6 位授权码手动输入。");
+          warn("二维码生成失败，请重新执行登录。");
         }
-        log(`LumaChat 授权码：${session.userCode}`);
-        log("请在 LumaChat App -> 设置 -> Clawdbot 配对 中输入授权码，或直接扫码授权。");
-        log(`授权链接：${session.verificationUriComplete}`);
+        log("请在 LumaChat App -> 设置 -> Clawdbot 配对 中扫码授权。");
 
         const expiresAtMs = parseUtcTimestamp(session.expiresAt);
         const deadline = expiresAtMs && Number.isFinite(expiresAtMs)