evolclaw 2.4.0 → 2.5.0

package/dist/utils/init-channel.js

@@ -9,9 +9,31 @@ import fs from 'fs';
 import readline from 'readline';
 import path from 'path';
 import os from 'os';
+import crypto from 'crypto';
+import { createRequire } from 'module';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
 import { resolvePaths } from '../paths.js';
 import { normalizeChannelInstances } from '../config.js';
 import { selectInstance } from './init.js';
+import { isWindows } from './cross-platform.js';
+const execFileAsync = promisify(execFile);
+async function npmInstallGlobal(pkg) {
+    try {
+        await execFileAsync('npm', ['install', '-g', pkg], { timeout: 180000 });
+    }
+    catch (e) {
+        if (e.stderr?.includes('EACCES') || e.message?.includes('EACCES')) {
+            if (isWindows) {
+                throw new Error('权限不足。请以管理员身份运行 PowerShell 或 CMD，然后重试');
+            }
+            await execFileAsync('sudo', ['npm', 'install', '-g', pkg], { timeout: 180000 });
+        }
+        else {
+            throw e;
+        }
+    }
+}
 function ask(rl, question) {
     return new Promise(resolve => rl.question(question, resolve));
 }
@@ -362,8 +384,9 @@ export async function runWechatQrFlow() {
     console.log('请用微信扫描上方二维码...\n');
     const deadline = Date.now() + LOGIN_TIMEOUT_MS;
     let scannedPrinted = false;
+    let currentPollUrl = DEFAULT_BASE_URL;
     while (Date.now() < deadline) {
-        const status = await pollQRStatus(DEFAULT_BASE_URL, qrResp.qrcode);
+        const status = await pollQRStatus(currentPollUrl, qrResp.qrcode);
         switch (status.status) {
             case 'wait':
                 process.stdout.write('.');
@@ -374,6 +397,11 @@ export async function runWechatQrFlow() {
                     scannedPrinted = true;
                 }
                 break;
+            case 'scaned_but_redirect':
+                if (status.redirect_host) {
+                    currentPollUrl = `https://${status.redirect_host}`;
+                }
+                break;
             case 'expired':
                 console.error('\n二维码已过期');
                 return null;
@@ -440,8 +468,9 @@ export async function cmdInitWechat() {
     console.log('请用微信扫描上方二维码...\n');
     const deadline = Date.now() + LOGIN_TIMEOUT_MS;
     let scannedPrinted = false;
+    let currentPollUrl = DEFAULT_BASE_URL;
     while (Date.now() < deadline) {
-        const status = await pollQRStatus(DEFAULT_BASE_URL, qrResp.qrcode);
+        const status = await pollQRStatus(currentPollUrl, qrResp.qrcode);
         switch (status.status) {
             case 'wait':
                 process.stdout.write('.');
@@ -452,6 +481,11 @@ export async function cmdInitWechat() {
                     scannedPrinted = true;
                 }
                 break;
+            case 'scaned_but_redirect':
+                if (status.redirect_host) {
+                    currentPollUrl = `https://${status.redirect_host}`;
+                }
+                break;
             case 'expired':
                 console.log('\n二维码已过期，请重新运行 evolclaw init wechat');
                 process.exit(1);
@@ -528,10 +562,88 @@ export async function cmdInitWechat() {
     process.exit(1);
 }
 // ==================== AUN ====================
+// 最低 @eleans/aun-core-sdk 版本要求
+const MIN_AUN_CORE_SDK = [0, 2, 9];
+const AUN_CORE_SDK_PKG = '@eleans/aun-core-sdk';
+function compareVersion(a, min) {
+    const parts = a.split('.').map(n => parseInt(n, 10));
+    if (parts.length < 3 || parts.some(isNaN))
+        return false;
+    if (parts[0] !== min[0])
+        return parts[0] > min[0];
+    if (parts[1] !== min[1])
+        return parts[1] > min[1];
+    return parts[2] >= min[2];
+}
+function resolveAunCoreSdkPkg() {
+    try {
+        const esmRequire = createRequire(import.meta.url);
+        const entry = esmRequire.resolve(AUN_CORE_SDK_PKG);
+        const pkgPath = path.join(path.dirname(entry), 'package.json');
+        if (!fs.existsSync(pkgPath)) {
+            // 向上回溯查找 package.json
+            let dir = path.dirname(entry);
+            for (let i = 0; i < 5; i++) {
+                const candidate = path.join(dir, 'package.json');
+                if (fs.existsSync(candidate)) {
+                    const data = JSON.parse(fs.readFileSync(candidate, 'utf-8'));
+                    if (data.name === AUN_CORE_SDK_PKG)
+                        return { version: data.version, path: candidate };
+                }
+                dir = path.dirname(dir);
+            }
+            return null;
+        }
+        const data = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        return { version: data.version, path: pkgPath };
+    }
+    catch {
+        return null;
+    }
+}
 export async function checkAunEnvironment(rl) {
     console.log('\n🔍 AUN 环境检查...\n');
-    // TS SDK (@eleans/aun-core-node) is bundled as npm dependency — no external deps needed
-    console.log('  ✓ @eleans/aun-core-node (TS SDK)');
+    const minVer = MIN_AUN_CORE_SDK.join('.');
+    const installed = resolveAunCoreSdkPkg();
+    if (!installed) {
+        console.log(`  ✗ ${AUN_CORE_SDK_PKG} 未安装`);
+        const answer = (await ask(rl, `  → 是否安装 ${AUN_CORE_SDK_PKG}@latest？[Y/n] `)).trim().toLowerCase();
+        if (answer === 'n' || answer === 'no') {
+            console.log('  已取消');
+            return false;
+        }
+        console.log(`  正在安装 ${AUN_CORE_SDK_PKG}...`);
+        try {
+            await npmInstallGlobal(`${AUN_CORE_SDK_PKG}@latest`);
+            console.log(`  ✓ ${AUN_CORE_SDK_PKG} 安装完成`);
+        }
+        catch (e) {
+            console.log(`  ✗ 安装失败: ${e.message?.slice(0, 200) || e}`);
+            return false;
+        }
+        console.log('');
+        return true;
+    }
+    if (compareVersion(installed.version, MIN_AUN_CORE_SDK)) {
+        console.log(`  ✓ ${AUN_CORE_SDK_PKG} v${installed.version}`);
+        console.log('');
+        return true;
+    }
+    console.log(`  ✗ ${AUN_CORE_SDK_PKG} v${installed.version} — 需要 >= ${minVer}`);
+    const answer = (await ask(rl, `  → 是否升级 ${AUN_CORE_SDK_PKG}？[Y/n] `)).trim().toLowerCase();
+    if (answer === 'n' || answer === 'no') {
+        console.log('  已取消');
+        return false;
+    }
+    console.log(`  正在升级 ${AUN_CORE_SDK_PKG}...`);
+    try {
+        await npmInstallGlobal(`${AUN_CORE_SDK_PKG}@latest`);
+        console.log(`  ✓ ${AUN_CORE_SDK_PKG} 升级完成`);
+    }
+    catch (e) {
+        console.log(`  ✗ 升级失败: ${e.message?.slice(0, 200) || e}`);
+        return false;
+    }
     console.log('');
     return true;
 }
@@ -541,7 +653,7 @@ function isValidAid(name) {
 }
 export async function setupAunAid(rl, _config) {
     let aid = '';
-    let gatewayPort;
+    let gatewayPort; // only used locally for AID creation, not written to config
     // Outer loop: allows retrying with a different AID
     while (true) {
         // Ask AID with format validation
@@ -579,7 +691,7 @@ export async function setupAunAid(rl, _config) {
         console.log('  正在创建 AID...');
         let failed = false;
         try {
-            const { AUNClient } = await import('@eleans/aun-core-node');
+            const { AUNClient } = await import('@eleans/aun-core-sdk');
             const client = new AUNClient({ aun_path: aunPath });
             // Set gateway URL from AID domain + port
             const domain = aid.split('.').slice(1).join('.');
@@ -587,6 +699,19 @@ export async function setupAunAid(rl, _config) {
             client._gatewayUrl = `wss://gateway.${domain}:${port}/aun`;
             const result = await client.auth.createAid({ aid });
             console.log(`  ✓ AID ${result.aid} 创建成功`);
+            // Collect agent.md info and publish
+            const typeInput = (await ask(rl, '  Agent 类型 human/ai [ai]: ')).trim().toLowerCase();
+            const agentType = typeInput === 'human' ? 'human' : 'ai';
+            const agentName = aid.split('.')[0];
+            const agentMdContent = `---\naid: "${aid}"\nname: "${agentName}"\ntype: "${agentType}"\nversion: "1.0.0"\ndescription: ""\ntags:\n  - evolclaw\n---\n`;
+            try {
+                await client.auth.uploadAgentMd(agentMdContent);
+                console.log('  ✓ agent.md 已发布');
+                fs.writeFileSync(path.join(aidDir, 'agent.md'), agentMdContent, 'utf-8');
+            }
+            catch (e) {
+                console.log(`  ⚠ agent.md 发布失败（可稍后用 /agentmd put 重试）: ${String(e.message || e).slice(0, 100)}`);
+            }
             try {
                 await client.close();
             }
@@ -607,7 +732,7 @@ export async function setupAunAid(rl, _config) {
             break;
         // default: retry with new AID
     }
-    return { aid, gatewayPort };
+    return { aid };
 }
 export async function cmdInitAun() {
     const p = resolvePaths();
@@ -636,7 +761,6 @@ export async function cmdInitAun() {
         config.channels.aun = {
             enabled: true,
             aid: result.aid,
-            ...(result.gatewayPort && { gatewayPort: result.gatewayPort }),
         };
         if (!config.channels.defaultChannel)
             config.channels.defaultChannel = 'aun';
@@ -647,3 +771,605 @@ export async function cmdInitAun() {
         rl.close();
     }
 }
+// ==================== DingTalk ====================
+const DINGTALK_BASE_URL = 'https://oapi.dingtalk.com';
+const DINGTALK_SOURCE = 'openClaw';
+async function dingtalkApiPost(path, payload) {
+    const res = await fetch(`${DINGTALK_BASE_URL}${path}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+    });
+    if (!res.ok)
+        throw new Error(`DingTalk API ${path} failed: ${res.status}`);
+    const data = await res.json();
+    if (data.errcode && data.errcode !== 0) {
+        throw new Error(`DingTalk API ${path}: ${data.errmsg || 'unknown error'} (errcode=${data.errcode})`);
+    }
+    return data;
+}
+async function runDingtalkQrFlow() {
+    // Step 1: init → nonce
+    const initData = await dingtalkApiPost('/app/registration/init', { source: DINGTALK_SOURCE });
+    const nonce = initData.nonce?.trim();
+    if (!nonce)
+        throw new Error('DingTalk init: 未返回 nonce');
+    // Step 2: begin → device_code + verification_uri_complete
+    const beginData = await dingtalkApiPost('/app/registration/begin', { nonce });
+    const deviceCode = beginData.device_code?.trim();
+    const verificationUri = beginData.verification_uri_complete?.trim();
+    if (!deviceCode)
+        throw new Error('DingTalk begin: 未返回 device_code');
+    if (!verificationUri)
+        throw new Error('DingTalk begin: 未返回 verification_uri_complete');
+    // Display QR code
+    try {
+        const qrterm = await import('qrcode-terminal');
+        await new Promise(resolve => {
+            qrterm.default.generate(verificationUri, { small: true }, (qr) => {
+                console.log(qr);
+                resolve();
+            });
+        });
+    }
+    catch {
+        console.log(`请在浏览器中打开此链接扫码: ${verificationUri}\n`);
+    }
+    console.log('请用钉钉扫描上方二维码...\n');
+    console.log('提示: 扫码页面标注 "OpenClaw" 是钉钉生态接入桥，可放心使用。\n');
+    console.log('按 q 退出 | 按 s 跳过扫码手动输入\n');
+    let userAction = null;
+    const setupKeyListener = () => {
+        if (!process.stdin.isTTY)
+            return () => { };
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        const handler = (key) => {
+            if (key === 'q' || key === '\u0003')
+                userAction = QUIT;
+            if (key === 's')
+                userAction = SKIP;
+        };
+        process.stdin.on('data', handler);
+        return () => {
+            process.stdin.removeListener('data', handler);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+        };
+    };
+    const cleanup = setupKeyListener();
+    const pollInterval = Math.max(Number(beginData.interval ?? 3), 2);
+    const expiresIn = Number(beginData.expires_in ?? 7200);
+    const startedAt = Date.now();
+    try {
+        while (Date.now() - startedAt < expiresIn * 1000) {
+            if (userAction === QUIT)
+                return QUIT;
+            if (userAction === SKIP)
+                return SKIP;
+            await new Promise(r => setTimeout(r, pollInterval * 1000));
+            const pollData = await dingtalkApiPost('/app/registration/poll', { device_code: deviceCode });
+            const status = (pollData.status || '').trim().toUpperCase();
+            if (status === 'SUCCESS') {
+                if (!pollData.client_id || !pollData.client_secret) {
+                    throw new Error('授权成功但未返回凭据');
+                }
+                return {
+                    clientId: pollData.client_id.trim(),
+                    clientSecret: pollData.client_secret.trim(),
+                };
+            }
+            if (status === 'WAITING') {
+                continue;
+            }
+            if (status === 'EXPIRED') {
+                throw new Error('扫码会话已过期');
+            }
+            if (status === 'FAIL') {
+                throw new Error(`授权失败: ${pollData.fail_reason || '未知原因'}`);
+            }
+            // Unknown status — keep polling
+        }
+        throw new Error('等待扫码结果超时');
+    }
+    finally {
+        cleanup();
+    }
+}
+export async function runDingtalkQrFlowSimple() {
+    try {
+        const result = await runDingtalkQrFlow();
+        if (result === QUIT || result === SKIP)
+            return null;
+        return result;
+    }
+    catch (error) {
+        console.error(`\n登录失败: ${error instanceof Error ? error.message : error}`);
+        return null;
+    }
+}
+export async function cmdInitDingtalk() {
+    const p = resolvePaths();
+    if (!fs.existsSync(p.config)) {
+        console.log('❌ 配置文件不存在，请先运行 evolclaw init');
+        return;
+    }
+    const config = JSON.parse(fs.readFileSync(p.config, 'utf-8'));
+    // Normalize existing instances and filter out placeholders
+    const allInstances = normalizeChannelInstances(config.channels?.dingtalk, 'dingtalk');
+    const validInstances = [];
+    for (let i = 0; i < allInstances.length; i++) {
+        const inst = allInstances[i];
+        if (!inst.clientId || !inst.clientSecret)
+            continue;
+        if (inst.clientId.includes('your-') || inst.clientId.includes('placeholder'))
+            continue;
+        if (inst.clientSecret.includes('your-') || inst.clientSecret.includes('placeholder'))
+            continue;
+        validInstances.push({ ...inst, originalIndex: i });
+    }
+    let choice = null;
+    if (validInstances.length > 0) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            choice = await selectInstance(rl, 'dingtalk', validInstances);
+            if (choice === null)
+                return;
+        }
+        finally {
+            rl.close();
+        }
+    }
+    console.log('正在获取钉钉登录二维码...\n');
+    let result;
+    try {
+        const flowResult = await runDingtalkQrFlow();
+        if (flowResult === QUIT) {
+            console.log('已退出');
+            return;
+        }
+        if (flowResult === SKIP) {
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                console.log('\n手动输入模式：\n');
+                let clientId = '';
+                while (!clientId) {
+                    clientId = (await ask(rl, '  钉钉 Client ID (AppKey): ')).trim();
+                    if (!clientId)
+                        console.log('  ⚠ 不能为空');
+                }
+                let clientSecret = '';
+                while (!clientSecret) {
+                    clientSecret = (await ask(rl, '  钉钉 Client Secret (AppSecret): ')).trim();
+                    if (!clientSecret)
+                        console.log('  ⚠ 不能为空');
+                }
+                result = { clientId, clientSecret };
+            }
+            finally {
+                rl.close();
+            }
+        }
+        else {
+            result = flowResult;
+        }
+    }
+    catch (error) {
+        console.error(`\n登录失败: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+    // Write config to the correct slot
+    if (!config.channels)
+        config.channels = {};
+    if (choice && choice.action === 'overwrite' && Array.isArray(config.channels.dingtalk)) {
+        const idx = validInstances[choice.index]?.originalIndex ?? choice.index;
+        config.channels.dingtalk[idx].clientId = result.clientId;
+        config.channels.dingtalk[idx].clientSecret = result.clientSecret;
+        config.channels.dingtalk[idx].enabled = true;
+    }
+    else if (choice && choice.action === 'overwrite' && !Array.isArray(config.channels.dingtalk)) {
+        config.channels.dingtalk = config.channels.dingtalk || {};
+        config.channels.dingtalk.clientId = result.clientId;
+        config.channels.dingtalk.clientSecret = result.clientSecret;
+        config.channels.dingtalk.enabled = true;
+    }
+    else if (choice && choice.action === 'add') {
+        const newInst = {
+            name: choice.name,
+            clientId: result.clientId,
+            clientSecret: result.clientSecret,
+            enabled: true,
+        };
+        if (Array.isArray(config.channels.dingtalk)) {
+            config.channels.dingtalk.push(newInst);
+        }
+        else if (config.channels.dingtalk) {
+            const oldInst = { ...config.channels.dingtalk, name: config.channels.dingtalk.name || 'dingtalk' };
+            config.channels.dingtalk = [oldInst, newInst];
+        }
+        else {
+            config.channels.dingtalk = [newInst];
+        }
+    }
+    else {
+        config.channels.dingtalk = {
+            clientId: result.clientId,
+            clientSecret: result.clientSecret,
+            enabled: true,
+        };
+    }
+    if (!config.channels.defaultChannel)
+        config.channels.defaultChannel = 'dingtalk';
+    fs.writeFileSync(p.config, JSON.stringify(config, null, 2) + '\n');
+    console.log(`\n✅ 钉钉连接成功！`);
+    console.log(`  Client ID: ${result.clientId}`);
+    if (choice) {
+        console.log(`  实例: ${choice.name} (${choice.action === 'add' ? '新增' : '覆盖'})`);
+    }
+    console.log(`  配置已写入: ${p.config}`);
+    console.log(`\n现在可以启动服务: evolclaw restart`);
+}
+// ==================== QQBot ====================
+const QQBOT_PORTAL_HOST = 'q.qq.com';
+const QQBOT_CREATE_PATH = '/lite/create_bind_task';
+const QQBOT_POLL_PATH = '/lite/poll_bind_result';
+const QQBOT_QR_TEMPLATE = 'https://q.qq.com/qqbot/openclaw/connect.html?task_id={task_id}&_wv=2&source=hermes';
+const QQBOT_POLL_INTERVAL_MS = 2000;
+const QQBOT_POLL_TIMEOUT_MS = 600_000; // 10 minutes
+function qqbotApiHeaders() {
+    return {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json', // Required — without it, q.qq.com returns anti-bot HTML
+        'User-Agent': 'EvolClaw/QQBotInit',
+    };
+}
+function generateBindKey() {
+    const keyBuffer = crypto.randomBytes(32);
+    return { keyBase64: keyBuffer.toString('base64'), keyBuffer };
+}
+function decryptSecret(encryptedBase64, keyBuffer) {
+    const raw = Buffer.from(encryptedBase64, 'base64');
+    const iv = raw.subarray(0, 12);
+    const authTag = raw.subarray(raw.length - 16);
+    const ciphertext = raw.subarray(12, raw.length - 16);
+    const decipher = crypto.createDecipheriv('aes-256-gcm', keyBuffer, iv);
+    decipher.setAuthTag(authTag);
+    const decrypted = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+    return decrypted.toString('utf-8');
+}
+async function runQQBotBindFlow() {
+    // Step 1: Generate AES key and create bind task
+    const { keyBase64, keyBuffer } = generateBindKey();
+    const createRes = await fetch(`https://${QQBOT_PORTAL_HOST}${QQBOT_CREATE_PATH}`, {
+        method: 'POST',
+        headers: qqbotApiHeaders(),
+        body: JSON.stringify({ key: keyBase64 }),
+    });
+    if (!createRes.ok)
+        throw new Error(`create_bind_task failed: ${createRes.status}`);
+    const createData = await createRes.json();
+    if (createData.retcode !== 0) {
+        throw new Error(`create_bind_task: ${createData.msg || 'unknown error'}`);
+    }
+    const taskId = createData.data?.task_id;
+    if (!taskId)
+        throw new Error('create_bind_task: 未返回 task_id');
+    // Step 2: Build QR URL and display
+    const qrUrl = QQBOT_QR_TEMPLATE.replace('{task_id}', encodeURIComponent(taskId));
+    try {
+        const qrterm = await import('qrcode-terminal');
+        await new Promise(resolve => {
+            qrterm.default.generate(qrUrl, { small: true }, (qr) => {
+                console.log(qr);
+                resolve();
+            });
+        });
+    }
+    catch {
+        console.log(`请在浏览器中打开此链接扫码: ${qrUrl}\n`);
+    }
+    console.log('请用 QQ 扫描上方二维码绑定机器人...\n');
+    console.log('按 q 退出 | 按 s 跳过扫码手动输入\n');
+    let userAction = null;
+    const setupKeyListener = () => {
+        if (!process.stdin.isTTY)
+            return () => { };
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        const handler = (key) => {
+            if (key === 'q' || key === '\u0003')
+                userAction = QUIT;
+            if (key === 's')
+                userAction = SKIP;
+        };
+        process.stdin.on('data', handler);
+        return () => {
+            process.stdin.removeListener('data', handler);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+        };
+    };
+    const cleanup = setupKeyListener();
+    const startedAt = Date.now();
+    try {
+        // Step 3: Poll for bind result
+        while (Date.now() - startedAt < QQBOT_POLL_TIMEOUT_MS) {
+            if (userAction === QUIT)
+                return QUIT;
+            if (userAction === SKIP)
+                return SKIP;
+            await new Promise(r => setTimeout(r, QQBOT_POLL_INTERVAL_MS));
+            const pollRes = await fetch(`https://${QQBOT_PORTAL_HOST}${QQBOT_POLL_PATH}`, {
+                method: 'POST',
+                headers: qqbotApiHeaders(),
+                body: JSON.stringify({ task_id: taskId }),
+            });
+            if (!pollRes.ok)
+                continue; // transient error, keep polling
+            const pollData = await pollRes.json();
+            if (pollData.retcode !== 0)
+                continue;
+            const status = pollData.data?.status ?? 0 /* QQBotBindStatus.NONE */;
+            if (status === 2 /* QQBotBindStatus.COMPLETED */) {
+                const botAppId = pollData.data?.bot_appid;
+                const encryptedSecret = pollData.data?.bot_encrypt_secret;
+                if (!botAppId || !encryptedSecret) {
+                    throw new Error('绑定成功但未返回完整凭据');
+                }
+                // Step 4: Decrypt the secret
+                const clientSecret = decryptSecret(encryptedSecret, keyBuffer);
+                return { appId: botAppId, clientSecret };
+            }
+            if (status === 3 /* QQBotBindStatus.EXPIRED */) {
+                throw new Error('二维码已过期');
+            }
+            // NONE or PENDING — keep polling
+        }
+        throw new Error('等待扫码结果超时');
+    }
+    finally {
+        cleanup();
+    }
+}
+export async function runQQBotBindFlowSimple() {
+    try {
+        const result = await runQQBotBindFlow();
+        if (result === QUIT || result === SKIP)
+            return null;
+        return result;
+    }
+    catch (error) {
+        console.error(`\n绑定失败: ${error instanceof Error ? error.message : error}`);
+        return null;
+    }
+}
+export async function cmdInitQQBot() {
+    const p = resolvePaths();
+    if (!fs.existsSync(p.config)) {
+        console.log('❌ 配置文件不存在，请先运行 evolclaw init');
+        return;
+    }
+    const config = JSON.parse(fs.readFileSync(p.config, 'utf-8'));
+    // Normalize existing instances and filter out placeholders
+    const allInstances = normalizeChannelInstances(config.channels?.qqbot, 'qqbot');
+    const validInstances = [];
+    for (let i = 0; i < allInstances.length; i++) {
+        const inst = allInstances[i];
+        if (!inst.appId || !inst.clientSecret)
+            continue;
+        if (inst.appId.includes('your-') || inst.appId.includes('placeholder'))
+            continue;
+        if (inst.clientSecret.includes('your-') || inst.clientSecret.includes('placeholder'))
+            continue;
+        validInstances.push({ ...inst, originalIndex: i });
+    }
+    let choice = null;
+    if (validInstances.length > 0) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            choice = await selectInstance(rl, 'qqbot', validInstances);
+            if (choice === null)
+                return;
+        }
+        finally {
+            rl.close();
+        }
+    }
+    console.log('正在创建 QQ 机器人绑定任务...\n');
+    let result;
+    try {
+        const flowResult = await runQQBotBindFlow();
+        if (flowResult === QUIT) {
+            console.log('已退出');
+            return;
+        }
+        if (flowResult === SKIP) {
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                console.log('\n手动输入模式：\n');
+                let appId = '';
+                while (!appId) {
+                    appId = (await ask(rl, '  QQ 机器人 App ID: ')).trim();
+                    if (!appId)
+                        console.log('  ⚠ 不能为空');
+                }
+                let clientSecret = '';
+                while (!clientSecret) {
+                    clientSecret = (await ask(rl, '  QQ 机器人 Client Secret: ')).trim();
+                    if (!clientSecret)
+                        console.log('  ⚠ 不能为空');
+                }
+                result = { appId, clientSecret };
+            }
+            finally {
+                rl.close();
+            }
+        }
+        else {
+            result = flowResult;
+        }
+    }
+    catch (error) {
+        console.error(`\n绑定失败: ${error instanceof Error ? error.message : error}`);
+        process.exit(1);
+    }
+    // Write config to the correct slot
+    if (!config.channels)
+        config.channels = {};
+    if (choice && choice.action === 'overwrite' && Array.isArray(config.channels.qqbot)) {
+        const idx = validInstances[choice.index]?.originalIndex ?? choice.index;
+        config.channels.qqbot[idx].appId = result.appId;
+        config.channels.qqbot[idx].clientSecret = result.clientSecret;
+        config.channels.qqbot[idx].enabled = true;
+    }
+    else if (choice && choice.action === 'overwrite' && !Array.isArray(config.channels.qqbot)) {
+        config.channels.qqbot = config.channels.qqbot || {};
+        config.channels.qqbot.appId = result.appId;
+        config.channels.qqbot.clientSecret = result.clientSecret;
+        config.channels.qqbot.enabled = true;
+    }
+    else if (choice && choice.action === 'add') {
+        const newInst = {
+            name: choice.name,
+            appId: result.appId,
+            clientSecret: result.clientSecret,
+            enabled: true,
+        };
+        if (Array.isArray(config.channels.qqbot)) {
+            config.channels.qqbot.push(newInst);
+        }
+        else if (config.channels.qqbot) {
+            const oldInst = { ...config.channels.qqbot, name: config.channels.qqbot.name || 'qqbot' };
+            config.channels.qqbot = [oldInst, newInst];
+        }
+        else {
+            config.channels.qqbot = [newInst];
+        }
+    }
+    else {
+        config.channels.qqbot = {
+            appId: result.appId,
+            clientSecret: result.clientSecret,
+            enabled: true,
+        };
+    }
+    if (!config.channels.defaultChannel)
+        config.channels.defaultChannel = 'qqbot';
+    fs.writeFileSync(p.config, JSON.stringify(config, null, 2) + '\n');
+    console.log(`\n✅ QQ 机器人绑定成功！`);
+    console.log(`  App ID: ${result.appId}`);
+    if (choice) {
+        console.log(`  实例: ${choice.name} (${choice.action === 'add' ? '新增' : '覆盖'})`);
+    }
+    console.log(`  配置已写入: ${p.config}`);
+    console.log(`\n现在可以启动服务: evolclaw restart`);
+}
+// ==================== WeCom (企业微信) ====================
+export async function cmdInitWecom() {
+    const p = resolvePaths();
+    if (!fs.existsSync(p.config)) {
+        console.log('❌ 配置文件不存在，请先运行 evolclaw init');
+        return;
+    }
+    const config = JSON.parse(fs.readFileSync(p.config, 'utf-8'));
+    // Normalize existing instances and filter out placeholders
+    const allInstances = normalizeChannelInstances(config.channels?.wecom, 'wecom');
+    const validInstances = [];
+    for (let i = 0; i < allInstances.length; i++) {
+        const inst = allInstances[i];
+        if (!inst.botId || !inst.secret)
+            continue;
+        if (inst.botId.includes('your-') || inst.botId.includes('placeholder'))
+            continue;
+        if (inst.secret.includes('your-') || inst.secret.includes('placeholder'))
+            continue;
+        validInstances.push({ ...inst, originalIndex: i });
+    }
+    let choice = null;
+    if (validInstances.length > 0) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            choice = await selectInstance(rl, 'wecom', validInstances);
+            if (choice === null)
+                return;
+        }
+        finally {
+            rl.close();
+        }
+    }
+    // WeCom uses manual input only (no QR flow)
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    let result;
+    try {
+        console.log('企业微信 AI Bot 配置\n');
+        console.log('请在企业微信管理后台 → AI Bot 页面获取 Bot ID 和 Secret\n');
+        let botId = '';
+        while (!botId) {
+            botId = (await ask(rl, '  Bot ID: ')).trim();
+            if (!botId)
+                console.log('  ⚠ 不能为空');
+        }
+        let secret = '';
+        while (!secret) {
+            secret = (await ask(rl, '  Secret: ')).trim();
+            if (!secret)
+                console.log('  ⚠ 不能为空');
+        }
+        result = { botId, secret };
+    }
+    finally {
+        rl.close();
+    }
+    // Write config to the correct slot
+    if (!config.channels)
+        config.channels = {};
+    if (choice && choice.action === 'overwrite' && Array.isArray(config.channels.wecom)) {
+        const idx = validInstances[choice.index]?.originalIndex ?? choice.index;
+        config.channels.wecom[idx].botId = result.botId;
+        config.channels.wecom[idx].secret = result.secret;
+        config.channels.wecom[idx].enabled = true;
+    }
+    else if (choice && choice.action === 'overwrite' && !Array.isArray(config.channels.wecom)) {
+        config.channels.wecom = config.channels.wecom || {};
+        config.channels.wecom.botId = result.botId;
+        config.channels.wecom.secret = result.secret;
+        config.channels.wecom.enabled = true;
+    }
+    else if (choice && choice.action === 'add') {
+        const newInst = {
+            name: choice.name,
+            botId: result.botId,
+            secret: result.secret,
+            enabled: true,
+        };
+        if (Array.isArray(config.channels.wecom)) {
+            config.channels.wecom.push(newInst);
+        }
+        else if (config.channels.wecom) {
+            const oldInst = { ...config.channels.wecom, name: config.channels.wecom.name || 'wecom' };
+            config.channels.wecom = [oldInst, newInst];
+        }
+        else {
+            config.channels.wecom = [newInst];
+        }
+    }
+    else {
+        config.channels.wecom = {
+            botId: result.botId,
+            secret: result.secret,
+            enabled: true,
+        };
+    }
+    if (!config.channels.defaultChannel)
+        config.channels.defaultChannel = 'wecom';
+    fs.writeFileSync(p.config, JSON.stringify(config, null, 2) + '\n');
+    console.log(`\n✅ 企业微信 AI Bot 配置成功！`);
+    console.log(`  Bot ID: ${result.botId}`);
+    if (choice) {
+        console.log(`  实例: ${choice.name} (${choice.action === 'add' ? '新增' : '覆盖'})`);
+    }
+    console.log(`  配置已写入: ${p.config}`);
+    console.log(`\n现在可以启动服务: evolclaw restart`);
+}