@henryxiaoyang/wechat-access-unqclawed 1.0.10 → 1.0.12

package/auth/qclaw-api.ts

@@ -126,4 +126,24 @@ export class QClawAPI {
     }
     return null;
   }
+
+  /** 生成企微客服专属链接 (cmd_id=4018) */
+  async generateContactLink(openKfId: string): Promise<QClawApiResponse> {
+    return this.post("data/4018/forward", {
+      guid: this.guid,
+      user_id: this.userId,
+      open_id: openKfId,
+      contact_type: "open_kfid",
+    });
+  }
+
+  /** 查询设备绑定状态 (cmd_id=4019) */
+  async queryDeviceByGuid(): Promise<QClawApiResponse> {
+    return this.post("data/4019/forward", { guid: this.guid });
+  }
+
+  /** 断开设备绑定 (cmd_id=4020) */
+  async disconnectDevice(): Promise<QClawApiResponse> {
+    return this.post("data/4020/forward", { guid: this.guid });
+  }
 }

package/index.ts

@@ -3,7 +3,7 @@ import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { WechatAccessWebSocketClient, handlePrompt, handleCancel } from "./websocket/index.js";
 // import { handleSimpleWecomWebhook } from "./http/webhook.js";
 import { setWecomRuntime, getWecomRuntime } from "./common/runtime.js";
-import { performLogin, loadState, clearState, saveState, getDeviceGuid, getEnvironment, QClawAPI, buildAuthUrl, fetchQrUuid, fetchQrImageDataUrl, pollQrStatus } from "./auth/index.js";
+import { performLogin, loadState, clearState, saveState, getDeviceGuid, getEnvironment, QClawAPI, TokenExpiredError, buildAuthUrl, fetchQrUuid, fetchQrImageDataUrl, pollQrStatus } from "./auth/index.js";
 import type { QClawEnvironment, PersistedAuthState } from "./auth/index.js";
 import { nested } from "./auth/utils.js";
 
@@ -199,6 +199,65 @@ const tencentAccessPlugin = {
           }
         } catch { /* non-fatal */ }
 
+        // 7. 生成企微客服链接，等待设备绑定
+        const OPEN_KFID = "wkzLlJLAAAfbxEV3ZcS-lHZxkaKmpejQ";
+        runtime.log("\n[wechat-access] 生成企微客服链接...");
+        const linkResult = await api.generateContactLink(OPEN_KFID);
+        let deviceBound = false;
+
+        if (!linkResult.success) {
+          runtime.log(`[wechat-access] 生成链接失败: ${linkResult.message ?? "未知错误"}（跳过设备绑定）`);
+        } else {
+          const linkData = linkResult.data as Record<string, unknown>;
+          const contactUrl =
+            (nested(linkData, "url") as string) ||
+            (nested(linkData, "data", "url") as string) ||
+            "";
+
+          if (!contactUrl) {
+            runtime.log("[wechat-access] 返回数据中没有 URL（跳过设备绑定）");
+          } else {
+            runtime.log("=".repeat(60));
+            runtime.log("  用微信扫描下方二维码，进入客服对话完成设备绑定");
+            runtime.log("=".repeat(60));
+
+            try {
+              const qrterm = await import("qrcode-terminal");
+              const generate = qrterm.default?.generate ?? qrterm.generate;
+              generate(contactUrl, { small: true }, (qrcode: string) => {
+                runtime.log("\n" + qrcode);
+              });
+            } catch {
+              runtime.log("(qrcode-terminal 不可用)");
+            }
+            runtime.log(`\n或手动打开: ${contactUrl}\n`);
+
+            // 轮询等待绑定
+            runtime.log("[wechat-access] 等待微信扫码绑定 (超时 5 分钟)...");
+            const bindDeadline = Date.now() + 300_000;
+            while (Date.now() < bindDeadline) {
+              await new Promise((r) => setTimeout(r, 2000));
+              try {
+                const status = await api.queryDeviceByGuid();
+                if (status.success) {
+                  const sd = status.data as Record<string, unknown>;
+                  const nick =
+                    (nested(sd, "nickname") as string) ||
+                    (nested(sd, "data", "nickname") as string);
+                  if (nick) {
+                    runtime.log(`[wechat-access] 设备绑定成功! 微信昵称: ${nick}`);
+                    deviceBound = true;
+                    break;
+                  }
+                }
+              } catch { /* continue polling */ }
+            }
+            if (!deviceBound) {
+              runtime.log("[wechat-access] 设备绑定超时，可稍后重新执行 channels login");
+            }
+          }
+        }
+
         // 写入 openclaw.json（统一存储）
         try {
           const wRuntime = getWecomRuntime();
@@ -216,7 +275,7 @@ const tencentAccessPlugin = {
             models.providers = providers;
             nextCfg.models = models;
           }
-          await runtime.config.writeConfigFile(nextCfg);
+          await wRuntime.config.writeConfigFile(nextCfg);
         } catch { /* non-fatal: fallback to state file */ }
 
         // 备份到独立文件（兜底）
@@ -279,22 +338,66 @@ const tencentAccessPlugin = {
       });
 
       // Token 获取策略：配置 > 已保存的登录态 > 提示用户手动登录
-      if (!token) {
-        const savedState = loadState(authStatePath);
-        if (savedState?.channelToken) {
-          token = savedState.channelToken;
-          log?.info(`[wechat-access] 使用已保存的 token: ${token.substring(0, 6)}...`);
-        } else {
-          log?.warn(`[wechat-access] 未找到 token，请运行 "openclaw channels login --channel wechat-access-unqclawed" 完成扫码登录，然后重启 Gateway`);
-          return;
-        }
+      const savedState = loadState(authStatePath);
+      if (!token && savedState?.channelToken) {
+        token = savedState.channelToken;
+        log?.info(`[wechat-access] 使用已保存的 token: ${token.substring(0, 6)}...`);
       }
 
       if (!token) {
-        log?.warn(`[wechat-access] token 为空，跳过 WebSocket 连接`);
+        log?.warn(`[wechat-access] 未找到 token，请运行 "openclaw channels login --channel wechat-access-unqclawed" 完成扫码登录，然后重启 Gateway`);
         return;
       }
 
+      // Token 刷新：用 jwt_token 调 4058 获取最新 channel_token（QClaw 客户端每次打开都会刷新）
+      const jwtToken = savedState?.jwtToken || "";
+      if (jwtToken) {
+        const api = new QClawAPI(env, guid, jwtToken);
+        api.userId = String((savedState?.userInfo as Record<string, unknown>)?.user_id ?? "");
+        const savedLoginKey = (savedState?.userInfo as Record<string, unknown>)?.loginKey as string | undefined;
+        if (savedLoginKey) api.loginKey = savedLoginKey;
+
+        let refreshed = false;
+        for (let attempt = 0; attempt < 3; attempt++) {
+          try {
+            const newToken = await api.refreshChannelToken();
+            if (newToken) {
+              token = newToken;
+              log?.info(`[wechat-access] channel_token 已刷新: ${token.substring(0, 6)}...`);
+              // 更新保存的状态和配置
+              if (savedState) {
+                savedState.channelToken = newToken;
+                savedState.savedAt = Date.now();
+                saveState(savedState, authStatePath);
+              }
+              try {
+                const wRuntime = getWecomRuntime();
+                const fullCfg = wRuntime.config.loadConfig();
+                const channels = { ...(fullCfg.channels ?? {}) } as Record<string, any>;
+                channels["wechat-access-unqclawed"] = {
+                  ...(channels["wechat-access-unqclawed"] ?? {}),
+                  token: newToken,
+                };
+                await wRuntime.config.writeConfigFile({ ...fullCfg, channels });
+              } catch { /* non-fatal */ }
+              refreshed = true;
+              break;
+            }
+          } catch (e) {
+            if (e instanceof TokenExpiredError) {
+              clearState(authStatePath);
+              log?.warn(`[wechat-access] jwt_token 已过期，请重新运行 "openclaw channels login --channel wechat-access-unqclawed"`);
+              return;
+            }
+            log?.warn(`[wechat-access] token 刷新失败 (${attempt + 1}/3): ${e instanceof Error ? e.message : String(e)}`);
+          }
+          if (attempt < 2) await new Promise(r => setTimeout(r, 1500));
+        }
+        if (!refreshed) {
+          log?.info(`[wechat-access] token 刷新失败，使用旧 token 尝试连接`);
+        }
+      }
+
       const wsConfig = {
         url: wsUrl,
         token,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryxiaoyang/wechat-access-unqclawed",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "type": "module",
   "description": "OpenClaw 微信通路插件 — 扫码登录 + AGP WebSocket 双向通信",
   "author": "HenryXiaoYang",