@wu529778790/open-im 1.0.3 → 1.1.0

package/dist/setup.js

@@ -26,6 +26,7 @@ function getConfiguredPlatforms(existing) {
         { k: "telegram", label: "Telegram" },
         { k: "feishu", label: "飞书" },
         { k: "wechat", label: "微信" },
+        { k: "wework", label: "企业微信" },
     ];
     return names
         .filter(({ k }) => {
@@ -36,8 +37,11 @@ function getConfiguredPlatforms(existing) {
             return !!p.botToken;
         if (k === "feishu")
             return !!(p.appId && p.appSecret);
+        // 微信支持 AGP 协议（token + guid + userId）或标准协议（appId + appSecret）
         if (k === "wechat")
-            return !!(p.appId && p.appSecret);
+            return !!(p.token && p.guid && p.userId) || !!(p.appId && p.appSecret);
+        if (k === "wework")
+            return !!(p.corpId && p.secret);
         return false;
     })
         .map(({ label }) => label);
@@ -78,6 +82,13 @@ function printManualInstructions(configPath) {
       "appSecret": "你的微信 App Secret（可选）",
       "wsUrl": "AGP WebSocket URL（可选，默认使用官方服务）",
       "allowedUserIds": ["允许访问的微信用户 ID（可选）"]
+    },
+    "wework": {
+      "enabled": false,
+      "corpId": "你的企业微信 Corp ID（可选）",
+      "agentId": "你的企业微信 Agent ID（可选）",
+      "secret": "你的企业微信 Secret（可选）",
+      "allowedUserIds": ["允许访问的企业微信用户 ID（可选）"]
     }
   },
   "claudeWorkDir": "${process.cwd().replace(/\\/g, "/")}",
@@ -85,8 +96,8 @@ function printManualInstructions(configPath) {
   "aiCommand": "claude"
 }`);
     console.log("");
-    console.log("提示：至少需要配置 Telegram、Feishu 或 WeChat 其中一个平台");
-    console.log("或设置环境变量: TELEGRAM_BOT_TOKEN=xxx、FEISHU_APP_ID=xxx 或 WECHAT_APP_ID=xxx 后再运行");
+    console.log("提示：至少需要配置 Telegram、Feishu、WeChat 或 WeWork 其中一个平台");
+    console.log("或设置环境变量: TELEGRAM_BOT_TOKEN=xxx、FEISHU_APP_ID=xxx、WECHAT_APP_ID=xxx 或 WEWORK_CORP_ID=xxx 后再运行");
     console.log("");
 }
 export async function runInteractiveSetup() {
@@ -111,7 +122,9 @@ export async function runInteractiveSetup() {
     };
     const hasTg = !!existing?.platforms?.telegram?.botToken;
     const hasFs = !!(existing?.platforms?.feishu?.appId && existing?.platforms?.feishu?.appSecret);
-    const hasWc = !!(existing?.platforms?.wechat?.appId && existing?.platforms?.wechat?.appSecret);
+    const wc = existing?.platforms?.wechat;
+    const hasWc = !!(wc?.token && wc?.guid && wc?.userId) || !!(wc?.appId && wc?.appSecret);
+    const hasWw = !!(existing?.platforms?.wework?.corpId && existing?.platforms?.wework?.secret);
     // 第一步：选择平台（在选项和提示中显示已配置项）
     const configuredHint = configured.length > 0 ? `（当前已配置: ${configured.join("、")}）` : "";
     const platformResp = await prompts({
@@ -129,10 +142,15 @@ export async function runInteractiveSetup() {
                 value: "feishu",
             },
             {
-                title: "微信 (WeChat) - 需要 App ID 和 App Secret（AGP 协议）" +
+                title: "微信 (WeChat) - 扫码登录获取 token（QClaw/AGP 协议）" +
                     (hasWc ? " ✓已配置" : ""),
                 value: "wechat",
             },
+            {
+                title: "企业微信 (WeCom/WeWork) - 需要 Bot ID 和 Secret" +
+                    (hasWw ? " ✓已配置" : ""),
+                value: "wework",
+            },
             { title: "配置多个平台", value: "multi" },
         ],
         initial: 0,
@@ -153,6 +171,7 @@ export async function runInteractiveSetup() {
                 { title: "Telegram" + (hasTg ? " ✓已配置" : ""), value: "telegram", selected: hasTg },
                 { title: "飞书 (Feishu)" + (hasFs ? " ✓已配置" : ""), value: "feishu", selected: hasFs },
                 { title: "微信 (WeChat)" + (hasWc ? " ✓已配置" : ""), value: "wechat", selected: hasWc },
+                { title: "企业微信 (WeWork)" + (hasWw ? " ✓已配置" : ""), value: "wework", selected: hasWw },
             ],
         }, { onCancel });
         if (!multiResp.platforms || multiResp.platforms.length === 0) {
@@ -211,39 +230,95 @@ export async function runInteractiveSetup() {
         }
     }
     if (selectedPlatforms.includes("wechat")) {
-        const wechatResp = await prompts([
-            {
+        const wc = existing?.platforms?.wechat;
+        const hasToken = !!(wc?.token && wc?.guid && wc?.userId);
+        const wechatModeResp = await prompts({
+            type: "select",
+            name: "mode",
+            message: "微信登录方式",
+            choices: [
+                {
+                    title: "扫码登录（推荐）- 用微信扫描二维码，自动获取 token",
+                    value: "qr",
+                },
+                {
+                    title: "使用已有配置" + (hasToken ? " ✓" : "（需已通过扫码登录获取）"),
+                    value: "keep",
+                    disabled: !hasToken,
+                },
+            ],
+            initial: hasToken ? 1 : 0,
+        }, { onCancel });
+        if (wechatModeResp.mode === "qr") {
+            console.log("\n正在启动微信扫码登录...\n");
+            const appIdResp = await prompts({
                 type: "text",
                 name: "appId",
-                message: "微信 App ID（从微信开放平台获取）",
-                initial: existing?.platforms?.wechat?.appId ?? "",
-                validate: (v) => (v.trim() ? true : "App ID 不能为空"),
-            },
+                message: "请输入微信 AppID",
+                initial: wc?.appId ?? "",
+                validate: (v) => (v.trim() ? true : "AppID 不能为空"),
+            }, { onCancel });
+            try {
+                const { performWeChatLogin } = await import("./wechat/auth/index.js");
+                const credentials = await performWeChatLogin({
+                    envName: "production",
+                    appId: appIdResp.appId?.trim() || wc?.appId || "",
+                });
+                config.platforms.wechat = {
+                    appId: appIdResp.appId?.trim() || wc?.appId,
+                    enabled: true,
+                    token: credentials.channelToken,
+                    jwtToken: credentials.jwtToken,
+                    loginKey: credentials.loginKey,
+                    guid: credentials.guid,
+                    userId: credentials.userId,
+                    wsUrl: "wss://mmgrcalltoken.3g.qq.com/agentwss",
+                };
+                console.log("\n✅ 微信登录成功，配置已获取");
+            }
+            catch (err) {
+                console.error("\n❌ 微信登录失败:", err instanceof Error ? err.message : String(err));
+                if (platform === "wechat")
+                    return false;
+            }
+        }
+        else if (hasToken) {
+            config.platforms.wechat = {
+                ...wc,
+                enabled: true,
+            };
+        }
+        else if (platform === "wechat") {
+            return false;
+        }
+    }
+    if (selectedPlatforms.includes("wework")) {
+        const weworkResp = await prompts([
             {
                 type: "text",
-                name: "appSecret",
-                message: "微信 App Secret（从微信开放平台获取）",
-                initial: existing?.platforms?.wechat?.appSecret ?? "",
-                validate: (v) => (v.trim() ? true : "App Secret 不能为空"),
+                name: "corpId",
+                message: "企业微信 Bot ID（从企业微信管理后台获取）",
+                initial: existing?.platforms?.wework?.corpId ?? "",
+                validate: (v) => (v.trim() ? true : "Bot ID 不能为空"),
             },
             {
                 type: "text",
-                name: "wsUrl",
-                message: "AGP WebSocket URL（可选，留空使用默认）",
-                initial: existing?.platforms?.wechat?.wsUrl ?? "",
+                name: "secret",
+                message: "企业微信 Secret（从企业微信管理后台获取）",
+                initial: existing?.platforms?.wework?.secret ?? "",
+                validate: (v) => (v.trim() ? true : "Secret 不能为空"),
             },
         ], { onCancel });
-        const wcAppId = wechatResp.appId?.trim() || existing?.platforms?.wechat?.appId;
-        const wcAppSecret = wechatResp.appSecret?.trim() || existing?.platforms?.wechat?.appSecret;
-        if (wcAppId && wcAppSecret) {
-            config.platforms.wechat = {
+        const wwCorpId = weworkResp.corpId?.trim() || existing?.platforms?.wework?.corpId;
+        const wwSecret = weworkResp.secret?.trim() || existing?.platforms?.wework?.secret;
+        if (wwCorpId && wwSecret) {
+            config.platforms.wework = {
                 enabled: true,
-                appId: wcAppId,
-                appSecret: wcAppSecret,
-                wsUrl: wechatResp.wsUrl?.trim() || existing?.platforms?.wechat?.wsUrl || undefined,
+                corpId: wwCorpId,
+                secret: wwSecret,
             };
         }
-        else if (platform === "wechat") {
+        else if (platform === "wework") {
             return false;
         }
     }
@@ -251,6 +326,7 @@ export async function runInteractiveSetup() {
     const tgIds = existing?.platforms?.telegram?.allowedUserIds?.join(", ") ?? "";
     const fsIds = existing?.platforms?.feishu?.allowedUserIds?.join(", ") ?? "";
     const wcIds = existing?.platforms?.wechat?.allowedUserIds?.join(", ") ?? "";
+    const wwIds = existing?.platforms?.wework?.allowedUserIds?.join(", ") ?? "";
     const aiIdx = ["claude", "codex", "cursor"].indexOf(existing?.aiCommand ?? "claude");
     const commonPrompts = [];
     if (selectedPlatforms.includes("telegram")) {
@@ -277,6 +353,14 @@ export async function runInteractiveSetup() {
             initial: wcIds,
         });
     }
+    if (selectedPlatforms.includes("wework")) {
+        commonPrompts.push({
+            type: "text",
+            name: "weworkAllowedUserIds",
+            message: "企业微信白名单用户 ID（可选，逗号分隔，留空=所有人可访问）",
+            initial: wwIds,
+        });
+    }
     commonPrompts.push({
         type: "select",
         name: "aiCommand",
@@ -310,6 +394,9 @@ export async function runInteractiveSetup() {
     const wechatIds = selectedPlatforms.includes("wechat")
         ? parseIds(commonResp.wechatAllowedUserIds)
         : parseIds(existing?.platforms?.wechat?.allowedUserIds?.join(", "));
+    const weworkIds = selectedPlatforms.includes("wework")
+        ? parseIds(commonResp.weworkAllowedUserIds)
+        : parseIds(existing?.platforms?.wework?.allowedUserIds?.join(", "));
     // 增量合并：以已有配置为底，只覆盖本次选中的平台（不写入根级旧字段 telegramBotToken 等）
     const base = existing
         ? JSON.parse(JSON.stringify(existing))
@@ -358,12 +445,18 @@ export async function runInteractiveSetup() {
         out.platforms.feishu = { enabled: false, allowedUserIds: feishuIds };
     }
     if (selectedPlatforms.includes("wechat")) {
+        const wcConfig = config.platforms?.wechat;
         out.platforms.wechat = {
             ...base?.platforms?.wechat,
             enabled: true,
-            appId: config.platforms.wechat?.appId,
-            appSecret: config.platforms.wechat?.appSecret,
-            wsUrl: config.platforms.wechat?.wsUrl,
+            appId: wcConfig?.appId ?? base?.platforms?.wechat?.appId,
+            appSecret: wcConfig?.appSecret ?? base?.platforms?.wechat?.appSecret,
+            token: wcConfig?.token ?? base?.platforms?.wechat?.token,
+            jwtToken: wcConfig?.jwtToken ?? base?.platforms?.wechat?.jwtToken,
+            loginKey: wcConfig?.loginKey ?? base?.platforms?.wechat?.loginKey,
+            guid: wcConfig?.guid ?? base?.platforms?.wechat?.guid,
+            userId: wcConfig?.userId ?? base?.platforms?.wechat?.userId,
+            wsUrl: wcConfig?.wsUrl ?? base?.platforms?.wechat?.wsUrl,
             allowedUserIds: wechatIds,
         };
     }
@@ -376,6 +469,24 @@ export async function runInteractiveSetup() {
     else {
         out.platforms.wechat = { enabled: false, allowedUserIds: wechatIds };
     }
+    if (selectedPlatforms.includes("wework")) {
+        out.platforms.wework = {
+            ...base?.platforms?.wework,
+            enabled: true,
+            corpId: config.platforms.wework?.corpId,
+            secret: config.platforms.wework?.secret,
+            allowedUserIds: weworkIds,
+        };
+    }
+    else if (base?.platforms?.wework) {
+        out.platforms.wework = {
+            ...base.platforms.wework,
+            allowedUserIds: weworkIds.length > 0 ? weworkIds : base.platforms.wework.allowedUserIds,
+        };
+    }
+    else {
+        out.platforms.wework = { enabled: false, allowedUserIds: weworkIds };
+    }
     const dir = dirname(configPath);
     if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });

package/dist/shared/active-chats.d.ts

@@ -1,4 +1,4 @@
 export declare function loadActiveChats(): void;
-export declare function getActiveChatId(platform: 'feishu' | 'telegram' | 'wechat'): string | undefined;
-export declare function setActiveChatId(platform: 'feishu' | 'telegram' | 'wechat', chatId: string): void;
+export declare function getActiveChatId(platform: 'feishu' | 'telegram' | 'wechat' | 'wework'): string | undefined;
+export declare function setActiveChatId(platform: 'feishu' | 'telegram' | 'wechat' | 'wework', chatId: string): void;
 export declare function flushActiveChats(): void;

package/dist/wechat/auth/device-bind.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 设备绑定：生成企微客服链接，用户在微信中打开后才有对话入口
+ */
+import type { QClawAPI } from './qclaw-api.js';
+export interface DeviceBindResult {
+    success: boolean;
+    contactUrl?: string;
+    message: string;
+}
+export declare function performDeviceBinding(api: QClawAPI, options?: {
+    timeoutMs?: number;
+    showQr?: (url: string) => void | Promise<void>;
+}): Promise<DeviceBindResult>;

package/dist/wechat/auth/device-bind.js

@@ -0,0 +1,76 @@
+/**
+ * 设备绑定：生成企微客服链接，用户在微信中打开后才有对话入口
+ */
+function nested(obj, ...keys) {
+    let cur = obj;
+    for (const k of keys) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[k];
+    }
+    return cur;
+}
+const DEFAULT_OPEN_KFID = 'wkzLlJLAAAfbxEV3ZcS-lHZxkaKmpejQ';
+const POLL_INTERVAL_MS = 2000;
+const DEFAULT_TIMEOUT_MS = 180_000; // 3 分钟
+export async function performDeviceBinding(api, options) {
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const showQr = options?.showQr;
+    console.log('[微信登录] 正在调用 4018 接口生成绑定链接...');
+    let linkResult;
+    try {
+        linkResult = await Promise.race([
+            api.generateContactLink(DEFAULT_OPEN_KFID),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('4018 接口超时（15秒）')), 15_000)),
+        ]);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, message: `生成绑定链接失败: ${msg}` };
+    }
+    if (!linkResult.success) {
+        return { success: false, message: `生成绑定链接失败: ${linkResult.message}` };
+    }
+    const linkData = linkResult.data;
+    const bindUrl = nested(linkData, 'url') ||
+        nested(linkData, 'data', 'url') ||
+        nested(linkData, 'resp', 'url') ||
+        nested(linkData, 'resp', 'data', 'url') ||
+        '';
+    if (!bindUrl) {
+        console.warn('[微信登录] 4018 响应结构:', JSON.stringify(linkData, null, 2).slice(0, 500));
+        return { success: false, message: '生成绑定链接失败，未返回 URL。服务端响应结构可能已变更' };
+    }
+    if (showQr) {
+        await showQr(bindUrl);
+    }
+    else {
+        console.log('\n' + '='.repeat(64));
+        console.log('【设备绑定】请复制下方链接，在企微/微信中打开：');
+        console.log('  → 打开后会进入客服会话，后续发消息必须在此会话中进行');
+        console.log('='.repeat(64));
+        console.log(bindUrl);
+        console.log('='.repeat(64) + '\n');
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+        const queryResult = await api.queryDeviceByGuid();
+        if (!queryResult.success)
+            continue;
+        const data = queryResult.data;
+        const inner = nested(data, 'data');
+        const isBind = nested(data, 'is_bind') ?? inner?.is_bind;
+        const nickname = (nested(data, 'nickname') ?? inner?.nickname);
+        const externalUserId = (nested(data, 'external_user_id') ?? inner?.external_user_id);
+        // 与 wechat-access 一致：nickname 或 external_user_id 表示已绑定
+        if (isBind === true || isBind === 1 || !!nickname || !!externalUserId) {
+            return { success: true, contactUrl: bindUrl, message: '设备绑定成功' };
+        }
+    }
+    return {
+        success: false,
+        contactUrl: bindUrl,
+        message: '绑定超时，请稍后重新登录并完成绑定',
+    };
+}

package/dist/wechat/auth/device-guid.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 设备唯一标识生成
+ * 首次运行时随机生成并持久化到 ~/.open-im/wechat-guid
+ */
+export declare function getDeviceGuid(): string;

package/dist/wechat/auth/device-guid.js

@@ -0,0 +1,28 @@
+/**
+ * 设备唯一标识生成
+ * 首次运行时随机生成并持久化到 ~/.open-im/wechat-guid
+ */
+import { randomUUID, createHash } from 'node:crypto';
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { APP_HOME } from '../../constants.js';
+const GUID_FILE = join(APP_HOME, 'wechat-guid');
+export function getDeviceGuid() {
+    try {
+        const existing = readFileSync(GUID_FILE, 'utf-8').trim();
+        if (existing)
+            return existing;
+    }
+    catch {
+        /* 文件不存在 */
+    }
+    const guid = createHash('md5').update(randomUUID()).digest('hex');
+    try {
+        mkdirSync(dirname(GUID_FILE), { recursive: true });
+        writeFileSync(GUID_FILE, guid, 'utf-8');
+    }
+    catch {
+        /* 写入失败不致命 */
+    }
+    return guid;
+}

package/dist/wechat/auth/environments.d.ts

@@ -0,0 +1,5 @@
+/**
+ * QClaw 环境配置（生产/测试）
+ */
+import type { QClawEnvironment } from './types.js';
+export declare function getEnvironment(name: string, appId: string): QClawEnvironment;

package/dist/wechat/auth/environments.js

@@ -0,0 +1,21 @@
+/**
+ * QClaw 环境配置（生产/测试）
+ */
+const ENVIRONMENT_CONFIGS = {
+    production: {
+        jprxGateway: 'https://jprx.m.qq.com/',
+        wxLoginRedirectUri: 'https://security.guanjia.qq.com/login',
+        wechatWsUrl: 'wss://mmgrcalltoken.3g.qq.com/agentwss',
+    },
+    test: {
+        jprxGateway: 'https://jprx.sparta.html5.qq.com/',
+        wxLoginRedirectUri: 'https://security-test.guanjia.qq.com/login',
+        wechatWsUrl: 'wss://jprx.sparta.html5.qq.com/agentwss',
+    },
+};
+export function getEnvironment(name, appId) {
+    const config = ENVIRONMENT_CONFIGS[name];
+    if (!config)
+        throw new Error(`未知环境: ${name}，可选: ${Object.keys(ENVIRONMENT_CONFIGS).join(', ')}`);
+    return { ...config, wxAppId: appId };
+}

package/dist/wechat/auth/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 微信扫码登录（QClaw 体系）
+ */
+export { performWeChatLogin, getEnvironment } from './wechat-login.js';
+export type { LoginCredentials, QClawEnvironment } from './types.js';
+export type { PerformWeChatLoginOptions } from './wechat-login.js';
+export { getDeviceGuid } from './device-guid.js';

package/dist/wechat/auth/index.js

@@ -0,0 +1,5 @@
+/**
+ * 微信扫码登录（QClaw 体系）
+ */
+export { performWeChatLogin, getEnvironment } from './wechat-login.js';
+export { getDeviceGuid } from './device-guid.js';

package/dist/wechat/auth/qclaw-api.d.ts

@@ -0,0 +1,26 @@
+/**
+ * QClaw JPRX 网关 API 客户端
+ * 用于微信扫码登录、token 刷新、设备绑定
+ */
+import type { QClawEnvironment } from './types.js';
+export interface QClawApiResponse {
+    success: boolean;
+    data?: Record<string, unknown>;
+    message?: string;
+}
+export declare class QClawAPI {
+    private env;
+    private guid;
+    loginKey: string;
+    jwtToken: string;
+    userId: string;
+    constructor(env: QClawEnvironment, guid: string, jwtToken?: string);
+    private headers;
+    private post;
+    getWxLoginState(): Promise<QClawApiResponse>;
+    wxLogin(code: string, state: string): Promise<QClawApiResponse>;
+    generateContactLink(openKfId: string): Promise<QClawApiResponse>;
+    queryDeviceByGuid(): Promise<QClawApiResponse>;
+    /** 刷新渠道 token（4058），连接前调用以获取最新 channel_token */
+    refreshChannelToken(): Promise<string | null>;
+}

package/dist/wechat/auth/qclaw-api.js

@@ -0,0 +1,100 @@
+/**
+ * QClaw JPRX 网关 API 客户端
+ * 用于微信扫码登录、token 刷新、设备绑定
+ */
+function nested(obj, ...keys) {
+    let cur = obj;
+    for (const k of keys) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[k];
+    }
+    return cur;
+}
+export class QClawAPI {
+    env;
+    guid;
+    loginKey = 'm83qdao0AmE5';
+    jwtToken = '';
+    userId = '';
+    constructor(env, guid, jwtToken = '') {
+        this.env = env;
+        this.guid = guid;
+        this.jwtToken = jwtToken;
+    }
+    headers() {
+        const h = {
+            'Content-Type': 'application/json',
+            'X-Version': '1',
+            'X-Token': this.loginKey,
+            'X-Guid': this.guid,
+            'X-Account': this.userId || '1',
+            'X-Session': '',
+        };
+        if (this.jwtToken)
+            h['X-OpenClaw-Token'] = this.jwtToken;
+        return h;
+    }
+    async post(path, body = {}) {
+        const url = `${this.env.jprxGateway}${path}`;
+        const payload = { ...body, web_version: '1.4.0', web_env: 'release' };
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(30_000),
+        });
+        const newToken = res.headers.get('X-New-Token');
+        if (newToken)
+            this.jwtToken = newToken;
+        const data = (await res.json());
+        const ret = data.ret;
+        const commonCode = nested(data, 'data', 'resp', 'common', 'code') ??
+            nested(data, 'data', 'common', 'code') ??
+            nested(data, 'resp', 'common', 'code') ??
+            nested(data, 'common', 'code');
+        if (ret === 0 || commonCode === 0) {
+            const respData = nested(data, 'data', 'resp', 'data') ??
+                nested(data, 'data', 'data') ??
+                data.data ??
+                data;
+            return { success: true, data: respData };
+        }
+        const message = nested(data, 'data', 'common', 'message') ??
+            nested(data, 'resp', 'common', 'message') ??
+            nested(data, 'common', 'message') ??
+            '请求失败';
+        return { success: false, message, data: data };
+    }
+    async getWxLoginState() {
+        return this.post('data/4050/forward', { guid: this.guid });
+    }
+    async wxLogin(code, state) {
+        return this.post('data/4026/forward', { guid: this.guid, code, state });
+    }
+    async generateContactLink(openKfId) {
+        return this.post('data/4018/forward', {
+            guid: this.guid,
+            user_id: Number(this.userId),
+            open_id: openKfId,
+            contact_type: 'open_kfid',
+        });
+    }
+    async queryDeviceByGuid() {
+        return this.post('data/4019/forward', { guid: this.guid });
+    }
+    /** 刷新渠道 token（4058），连接前调用以获取最新 channel_token */
+    async refreshChannelToken() {
+        const result = await this.post('data/4058/forward', {});
+        if (result.success && result.data) {
+            const d = result.data;
+            const token = nested(d, 'openclaw_channel_token') ??
+                nested(d, 'data', 'openclaw_channel_token') ??
+                nested(d, 'resp', 'openclaw_channel_token') ??
+                nested(d, 'resp', 'data', 'openclaw_channel_token') ??
+                null;
+            return token;
+        }
+        return null;
+    }
+}

package/dist/wechat/auth/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 微信扫码登录（QClaw 体系）类型定义
+ */
+export interface QClawEnvironment {
+    jprxGateway: string;
+    wxLoginRedirectUri: string;
+    wechatWsUrl: string;
+    wxAppId: string;
+}
+export interface LoginCredentials {
+    channelToken: string;
+    jwtToken: string;
+    userId: string;
+    guid: string;
+    /** 4058 刷新 token 时需用此值作为 X-Token header */
+    loginKey?: string;
+    userInfo?: Record<string, unknown>;
+}

package/dist/wechat/auth/types.js

@@ -0,0 +1,4 @@
+/**
+ * 微信扫码登录（QClaw 体系）类型定义
+ */
+export {};

package/dist/wechat/auth/wechat-login.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 微信扫码登录流程
+ * 1. 获取 state → 2. 显示二维码 → 3. 等待 code → 4. 换 token → 5. 设备绑定
+ */
+import type { QClawEnvironment, LoginCredentials } from './types.js';
+import { getEnvironment } from './environments.js';
+export interface PerformWeChatLoginOptions {
+    envName?: string;
+    appId?: string;
+    bypassInvite?: boolean;
+}
+/**
+ * 执行微信扫码登录，返回 token、guid、userId
+ */
+export declare function performWeChatLogin(options?: PerformWeChatLoginOptions): Promise<LoginCredentials>;
+export { getEnvironment };
+export type { QClawEnvironment, LoginCredentials };