evolclaw 2.5.0 → 2.5.1

package/dist/agents/claude-runner.js

@@ -259,14 +259,7 @@ export class AgentRunner {
             }
             // 等待用户交互
             const answer = await new Promise((resolve) => {
-                const timer = setTimeout(() => {
-                    permCtx?.interactionRouter?.cancel(requestId);
-                    permCtx?.cancelIntercept?.(sessionId);
-                    logger.info(`[AgentRunner] AskUserQuestion timeout for ${requestId}`);
-                    resolve(null);
-                }, 5 * 60 * 1000);
                 permCtx?.interactionRouter?.register(requestId, sessionId, (action, values) => {
-                    clearTimeout(timer);
                     if (action === 'cancel') {
                         resolve(null);
                     }
@@ -292,7 +285,7 @@ export class AgentRunner {
                 });
             });
             if (answer === null) {
-                // 超时或取消，自动选第一项
+                // 取消，自动选第一项
                 const firstLabel = q.options[0]?.label || '';
                 answers[q.question] = q.multiSelect ? [firstLabel] : firstLabel;
             }
@@ -323,6 +316,54 @@ export class AgentRunner {
         const updatedInput = { ...input, answers };
         return { behavior: 'allow', updatedInput, decisionClassification: 'user_temporary' };
     }
+    /**
+     * 处理 ExitPlanMode 工具调用：plan mode 审批，等待用户批准后才继续执行
+     */
+    async handleExitPlanMode(sessionId, input, options) {
+        const permCtx = this.permissionContexts.get(sessionId);
+        const sendPrompt = this.sendPromptFn;
+        // 无交互上下文，直接 allow（防御性兜底）
+        if (!permCtx?.adapter?.sendInteraction || !permCtx?.channelId || !sendPrompt) {
+            return { behavior: 'allow', updatedInput: input, decisionClassification: 'user_temporary' };
+        }
+        const requestId = `plan-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const interaction = {
+            type: 'interaction',
+            id: requestId,
+            kind: {
+                kind: 'action',
+                title: '📋 计划审批',
+                body: 'AI 已完成规划，等待审批。\n请查看以上计划内容后决定。',
+                buttons: [
+                    { key: 'approve', label: '✅ 批准执行', style: 'primary' },
+                    { key: 'reject', label: '❌ 拒绝', style: 'danger' },
+                ],
+            },
+            channelId: permCtx.channelId,
+            sessionId,
+        };
+        let cardSent = false;
+        try {
+            const result = await permCtx.adapter.sendInteraction(permCtx.channelId, interaction, permCtx.replyContext);
+            cardSent = !!result;
+        }
+        catch (err) {
+            logger.warn('[AgentRunner] ExitPlanMode card send failed:', err);
+        }
+        if (!cardSent) {
+            await sendPrompt('📋 计划审批\nAI 已完成规划，等待审批。\n回复 /plan approve 批准执行 | /plan reject 拒绝');
+        }
+        return new Promise((resolve) => {
+            permCtx?.interactionRouter?.register(requestId, sessionId, (action) => {
+                if (action === 'approve') {
+                    resolve({ behavior: 'allow', updatedInput: input, decisionClassification: 'user_temporary' });
+                }
+                else {
+                    resolve({ behavior: 'deny', message: '用户拒绝了计划', decisionClassification: 'user_reject' });
+                }
+            });
+        });
+    }
     /**
      * SDK 原始事件 → 标准 AgentEvent 转换
      * 所有 SDK 特有的事件类型引用封装在此方法内
@@ -538,6 +579,10 @@ export class AgentRunner {
             if (toolName === 'AskUserQuestion') {
                 return await this.handleAskUserQuestion(sessionId, input, options);
             }
+            // 特殊处理：ExitPlanMode 工具（plan mode 审批）
+            if (toolName === 'ExitPlanMode') {
+                return await this.handleExitPlanMode(sessionId, input, options);
+            }
             // bypass 模式：一律 allow
             if (this.permissionMode === 'bypass') {
                 return { behavior: 'allow', updatedInput: input, decisionClassification: 'user_permanent' };

package/dist/channels/aun.js

@@ -2,6 +2,7 @@ import { AUNClient, GatewayDiscovery } from '@eleans/aun-core-sdk';
 import crypto from 'crypto';
 import fs from 'fs';
 import path from 'path';
+import os from 'os';
 import { logger, localTimestamp } from '../utils/logger.js';
 import { normalizeChannelInstances, getChannelShowActivities } from '../config.js';
 import { resolvePaths } from '../paths.js';
@@ -275,6 +276,8 @@ export class AUNChannel {
                 }
             }
             logger.info(`[AUN] Connected as ${this._aid}`);
+            // Send welcome message to owner after first connection
+            await this.sendWelcomeMessage();
         }
         catch (e) {
             logger.error(`[AUN] Connection failed: ${e}`);
@@ -282,6 +285,90 @@ export class AUNChannel {
             return;
         }
     }
+    async sendWelcomeMessage() {
+        try {
+            const owner = this.config.owner;
+            if (!owner) {
+                logger.info('[AUN] No owner configured, skipping welcome message');
+                return;
+            }
+            // Check agent.md initialized field
+            const aid = this.config.aid;
+            const aidName = aid.startsWith('@') ? aid.slice(1) : aid;
+            const agentMdPath = path.join(os.homedir(), '.aun', 'AIDs', aidName, 'agent.md');
+            if (!fs.existsSync(agentMdPath)) {
+                logger.warn('[AUN] agent.md not found, skipping welcome message');
+                return;
+            }
+            const agentMdContent = fs.readFileSync(agentMdPath, 'utf-8');
+            const match = agentMdContent.match(/^---\n([\s\S]*?)\n---/);
+            if (!match) {
+                logger.warn('[AUN] agent.md frontmatter not found');
+                return;
+            }
+            const frontmatter = match[1];
+            const initializedMatch = frontmatter.match(/^initialized:\s*(true|false)/m);
+            if (!initializedMatch || initializedMatch[1] === 'true') {
+                logger.info('[AUN] Agent already initialized, skipping welcome message');
+                return;
+            }
+            // Generate new agent.md with proper fields
+            const ownerShortId = owner.split('@')[0].slice(0, 8);
+            const newAgentMd = `---
+aid: "${aid}"
+name: "${ownerShortId}的Evol助手"
+type: "codeagent"
+version: "1.0.0"
+description: "EvolClaw AI Agent Gateway - 连接 Claude/Codex 到消息通道"
+tags:
+  - evolclaw
+  - ai-agent
+  - gateway
+initialized: true
+---
+
+# ${ownerShortId}的Evol助手
+
+EvolClaw AI Agent 网关，支持多项目会话管理和多 AI 后端切换。
+`;
+            // Write locally
+            fs.writeFileSync(agentMdPath, newAgentMd, 'utf-8');
+            logger.info('[AUN] Updated agent.md with initialized=true');
+            // Publish to AUN network via auth.uploadAgentMd
+            try {
+                await this.client.auth.uploadAgentMd(newAgentMd);
+                logger.info('[AUN] Published agent.md to AUN network');
+            }
+            catch (e) {
+                logger.warn(`[AUN] Failed to publish agent.md: ${e}`);
+            }
+            // Send welcome message
+            const welcomeText = `🎉 欢迎使用 EvolClaw！
+
+我是您的 AI Agent 网关，已成功连接到 AUN 网络。
+
+📋 **日常使用方法**：
+
+1. **绑定项目**：发送 \`/bind <项目路径>\` 绑定工作目录
+2. **查看帮助**：发送 \`/help\` 查看所有可用命令
+3. **切换项目**：发送 \`/project <项目名>\` 切换到其他项目
+4. **查看状态**：发送 \`/status\` 查看当前会话状态
+5. **查看 Agent 信息**：发送 \`/agentmd\` 查看 agent.md 内容
+6. **会话管理**：发送 \`/session\` 查看和切换会话
+
+💡 **提示**：
+- 直接发送消息即可与 Claude/Codex 对话
+- 支持多项目会话管理，每个项目独立会话
+- 所有命令以 \`/\` 开头
+
+现在，请先使用 \`/bind\` 命令绑定您的项目目录，然后就可以开始工作了！`;
+            await this.sendMessage(owner, welcomeText);
+            logger.info(`[AUN] Welcome message sent to owner: ${owner}`);
+        }
+        catch (e) {
+            logger.warn(`[AUN] Failed to send welcome message: ${e}`);
+        }
+    }
     // ── Event handlers ──────────────────────────────────────────
     async downloadAttachment(att, channelId) {
         const ownerAid = att.owner_aid || this._aid || '';

package/dist/cli.js

@@ -1306,6 +1306,10 @@ async function cmdCtl(args) {
     }
 }
 // ==================== Main ====================
+function getArgValue(args, flag) {
+    const idx = args.indexOf(flag);
+    return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+}
 export async function main(args) {
     const cmd = args[0] || 'start';
     switch (cmd) {
@@ -1329,7 +1333,19 @@ export async function main(args) {
                 await cmdInitWecom();
             }
             else {
-                await cmdInit();
+                const nonInteractive = args.includes('--non-interactive');
+                if (nonInteractive) {
+                    await cmdInit({
+                        nonInteractive: true,
+                        defaultPath: getArgValue(args, '--default-path') || process.cwd(),
+                        channel: getArgValue(args, '--channel') || 'aun',
+                        aunAid: getArgValue(args, '--aun-aid'),
+                        aunOwner: getArgValue(args, '--aun-owner'),
+                    });
+                }
+                else {
+                    await cmdInit();
+                }
             }
             break;
         case 'start':

package/dist/core/command-handler.js

@@ -112,7 +112,7 @@ const aliases = {
     '/rw': '/rewind'
 };
 // 命令快速路径前缀（所有命令都不进入消息队列）
-const quickCommandPrefixes = ['/new', '/pwd', '/plist', '/project', '/bind', '/help', '/status', '/restart', '/model', '/effort', '/agent', '/slist', '/session', '/rename', '/repair', '/fork', '/stop', '/clear', '/compact', '/safe', '/del', '/perm', '/send', '/check', '/p ', '/s ', '/name ', '/rewind', '/rw', '/rw ', '/activity'];
+const quickCommandPrefixes = ['/new', '/pwd', '/plist', '/project', '/bind', '/help', '/status', '/restart', '/model', '/effort', '/agent', '/slist', '/session', '/rename', '/repair', '/fork', '/stop', '/clear', '/compact', '/safe', '/del', '/perm', '/send', '/check', '/p ', '/s ', '/name', '/rewind', '/rw', '/rw ', '/activity'];
 export class CommandHandler {
     sessionManager;
     config;
@@ -338,23 +338,23 @@ export class CommandHandler {
             items.push({
                 group: '项目管理',
                 commands: [
-                    { cmd: '/pwd', label: '显示当前项目路径' },
-                    { cmd: '/p', args: '[name|path]', label: '列出或切换项目' },
-                    ...(isOwner ? [{ cmd: '/bind', args: '<path>', label: '绑定新项目目录' }] : []),
+                    { cmd: '/pwd', label: '显示当前项目路径', desc: '查看当前会话绑定的项目目录' },
+                    { cmd: '/p', label: '列出或切换项目', desc: '切换到其他已配置的项目', next: { type: 'select', dynamic: true } },
+                    ...(isOwner ? [{ cmd: '/bind', label: '绑定新项目目录', desc: '将当前会话绑定到指定项目路径', next: { type: 'text' } }] : []),
                 ]
             });
         }
         items.push({
             group: '会话管理',
             commands: [
-                { cmd: '/new', args: '[name]', label: '创建新会话（清空历史请用此命令）' },
-                { cmd: '/s', args: '[cli|name|index|uuid]', label: '列出或切换会话（cli 查看未导入的 CLI 会话）' },
-                { cmd: '/name', args: '<name>', label: '重命名当前会话' },
-                { cmd: '/del', args: '<name>', label: '删除指定会话' },
+                { cmd: '/new', label: '创建新会话', desc: '清空历史，开始全新对话', next: { type: 'text' } },
+                { cmd: '/s', label: '切换会话', desc: '切换到同项目下的其他会话', next: { type: 'select', dynamic: true } },
+                { cmd: '/name', label: '重命名当前会话', desc: '为当前会话设置一个易识别的名称', next: { type: 'text' } },
+                { cmd: '/del', label: '删除指定会话', desc: '永久删除一个非活跃会话', next: { type: 'select', dynamic: true } },
                 ...(isAdmin ? [
-                    { cmd: '/fork', args: '[name]', label: '分支当前会话' },
-                    { cmd: '/rewind', args: '[N] [chat|file|all]', label: '查看历史/撤销指定轮次 (别名: /rw)' },
-                    { cmd: '/compact', label: '压缩会话上下文' },
+                    { cmd: '/fork', label: '分支当前会话', desc: '基于当前会话创建独立分支', next: { type: 'text' } },
+                    { cmd: '/rewind', label: '查看历史/撤销指定轮次', desc: '回退会话到指定轮次，可选择撤销文件改动' },
+                    { cmd: '/compact', label: '压缩会话上下文', desc: '将长对话压缩为摘要以节省 token' },
                 ] : []),
             ]
         });
@@ -362,31 +362,55 @@ export class CommandHandler {
             items.push({
                 group: 'Agent 与模型',
                 commands: [
-                    { cmd: '/agent', args: '[name]', label: '查看或切换 Agent 后端' },
-                    { cmd: '/model', args: '[model]', label: '查看或切换模型' },
-                    { cmd: '/effort', args: '[level]', label: '查看或切换推理强度' },
+                    { cmd: '/agent', label: '切换 Agent 后端', desc: '切换当前会话使用的 AI 后端', next: { type: 'select', dynamic: true } },
+                    { cmd: '/model', label: '切换模型', desc: '切换当前 Agent 使用的模型版本', next: { type: 'select', dynamic: true } },
+                    { cmd: '/effort', label: '切换推理强度', desc: '调整模型推理深度，影响响应速度与质量', next: { type: 'select', items: [
+                                { value: 'low', label: 'Low' },
+                                { value: 'medium', label: 'Medium' },
+                                { value: 'high', label: 'High' },
+                                { value: 'max', label: 'Max' },
+                            ] } },
                 ]
             });
             items.push({
                 group: '权限管理',
                 commands: [
-                    { cmd: '/perm', args: isOwner ? '[mode|allow|always|deny]' : '[allow|always|deny]', label: '权限模式管理' },
+                    { cmd: '/perm', label: '权限模式管理', desc: '控制工具调用的审批策略', next: { type: 'select', items: [
+                                ...(isOwner ? [
+                                    { value: 'auto', label: '自动模式', desc: '根据风险等级自动决定是否审批' },
+                                    { value: 'bypass', label: '免审批模式', desc: '跳过所有工具审批确认' },
+                                    { value: 'plan', label: '计划模式', desc: '仅允许只读操作，写操作需审批' },
+                                    { value: 'edit', label: '编辑模式', desc: '允许文件编辑，其他操作需审批' },
+                                    { value: 'request', label: '请求模式', desc: '所有操作均需审批' },
+                                    { value: 'noask', label: '静默模式', desc: '不弹出审批，自动拒绝未授权操作' },
+                                ] : []),
+                                { value: 'allow', label: '允许此操作', desc: '本次允许当前待审批操作' },
+                                { value: 'always', label: '始终允许', desc: '永久允许同类操作' },
+                                { value: 'deny', label: '拒绝此操作', desc: '拒绝当前待审批操作' },
+                            ] } },
                 ]
             });
             items.push({
                 group: '运维',
                 commands: [
-                    { cmd: '/status', label: '显示会话状态' },
-                    { cmd: '/stop', label: '中断当前任务' },
-                    { cmd: '/check', label: '检查渠道状态' },
-                    { cmd: '/activity', args: '[all|dm|owner|none]', label: '查看/控制中间输出显示模式' },
+                    { cmd: '/status', label: '显示会话状态', desc: '查看当前会话、项目、Agent 的详细状态' },
+                    { cmd: '/stop', label: '中断当前任务', desc: '立即中断正在执行的 Agent 任务' },
+                    { cmd: '/check', label: '检查渠道状态', desc: '检查各消息渠道的连接健康状态' },
+                    { cmd: '/activity', label: '控制中间输出显示', desc: '设置工具调用过程的可见范围', next: { type: 'select', items: [
+                                { value: 'all', label: '全部显示', desc: '所有用户均可见中间输出' },
+                                { value: 'dm', label: '仅私聊', desc: '仅私聊中显示中间输出' },
+                                { value: 'owner', label: '仅 owner 私聊', desc: '仅 owner 的私聊中显示' },
+                                { value: 'none', label: '不显示', desc: '关闭所有中间输出' },
+                            ] } },
                     ...(isAdmin ? [
-                        { cmd: '/restart', args: '<channel>', label: '重连指定渠道' },
+                        { cmd: '/restart', label: '重启/重连', desc: '重启服务或重连指定渠道', next: { type: 'select', dynamic: true } },
                     ] : []),
                     ...(isOwner ? [
-                        { cmd: '/restart', label: '重启服务' },
-                        { cmd: '/send', args: '[channel] <path>', label: '发送项目内文件' },
-                        { cmd: '/agentmd', args: '[put|set <内容>]', label: '管理 agent.md' },
+                        { cmd: '/send', label: '发送项目内文件', desc: '将项目目录内的文件发送给用户' },
+                        { cmd: '/agentmd', label: '管理 agent.md', desc: '查看或更新 AUN 网络上的 agent.md 身份文件', next: { type: 'select', items: [
+                                    { value: 'put', label: '上传当前', desc: '将本地 agent.md 上传到 AUN 网络' },
+                                    { value: 'set', label: '直接设置', desc: '输入内容直接更新 agent.md', next: { type: 'text' } },
+                                ] } },
                     ] : []),
                 ]
             });
@@ -395,22 +419,67 @@ export class CommandHandler {
             items.push({
                 group: '其他',
                 commands: [
-                    { cmd: '/status', label: '显示会话状态' },
-                    { cmd: '/check', label: '检查渠道健康' },
+                    { cmd: '/status', label: '显示会话状态', desc: '查看当前会话的基本状态' },
+                    { cmd: '/check', label: '检查渠道健康', desc: '检查消息渠道连接状态' },
                 ]
             });
         }
         items.push({
             group: '帮助',
             commands: [
-                { cmd: '/help', label: '显示帮助信息' },
+                { cmd: '/help', label: '显示帮助信息', desc: '列出所有可用命令及说明' },
             ]
         });
         return items;
     }
-    /**
-     * 快速判断是否为命令（不进队列的命令）
-     */
+    /** 动态子菜单：根据 cmd 路径返回选项列表（供 menu.query + cmd 使用） */
+    async getSubMenuItems(cmd, channel, channelId, userId) {
+        const session = await this.sessionManager.getActiveSession(channel, channelId);
+        if (cmd === '/s' || cmd === '/del') {
+            const sessions = await this.sessionManager.listSessions(channel, channelId);
+            const active = cmd === '/del' ? await this.sessionManager.getActiveSession(channel, channelId) : null;
+            const items = sessions
+                .filter(s => !active || s.id !== active.id)
+                .map(s => {
+                const shortId = s.agentSessionId ? s.agentSessionId.substring(0, 8) : '';
+                const time = s.updatedAt ? formatIdleTime(Date.now() - s.updatedAt) : '';
+                const parts = [shortId, time].filter(Boolean).join(' · ');
+                return {
+                    value: s.name || s.id.slice(0, 8),
+                    label: s.name || s.id.slice(0, 8),
+                    desc: parts || undefined,
+                };
+            });
+            if (cmd === '/s') {
+                items.push({ value: 'cli', label: '查看 CLI 会话', desc: '列出未导入的 CLI 本地会话' });
+            }
+            return items;
+        }
+        if (cmd === '/p') {
+            const list = this.config.projects?.list || {};
+            return Object.entries(list).map(([name, path]) => ({ value: name, label: name, desc: path }));
+        }
+        if (cmd === '/agent') {
+            return [...this.agentMap.keys()].map(name => ({ value: name, label: name }));
+        }
+        if (cmd === '/model') {
+            const agent = this.getAgent(session?.agentId);
+            if (hasModelSwitcher(agent) && agent.listModels) {
+                const models = await agent.listModels() ?? [];
+                if (models.length > 0)
+                    return models.map((m) => ({ value: m, label: m }));
+            }
+            return null;
+        }
+        if (cmd === '/restart') {
+            const isOwner = userId ? this.sessionManager.resolveIdentity(channel, userId).role === 'owner' : false;
+            const channels = [...this.adapters.keys()].map(name => ({ value: name, label: name, desc: '重连此渠道' }));
+            if (isOwner)
+                channels.unshift({ value: '', label: '重启服务', desc: '重启整个 EvolClaw 服务进程' });
+            return channels;
+        }
+        return null;
+    }
     isCommand(content) {
         return content === '/p' || content === '/s' || quickCommandPrefixes.some(cmd => content.startsWith(cmd));
     }
@@ -1879,6 +1948,8 @@ export class CommandHandler {
             return response;
         }
         // /bind 命令：持久化项目到配置（不切换）（owner only）
+        if (normalizedContent === '/bind')
+            return '用法: /bind <路径>';
         if (normalizedContent.startsWith('/bind ')) {
             if (!isOwner)
                 return '❌ 无权限：此命令仅限 owner 使用';
@@ -2205,6 +2276,9 @@ export class CommandHandler {
             return `✓ 已切换到会话: ${targetSession.name || sessionName}${continueHint}${lastInputLine}`;
         }
         // /rename 或 /name 命令：重命名当前会话
+        if (normalizedContent === '/rename' || normalizedContent === '/name') {
+            return '用法: /name <新名称> 或 /rename <新名称>';
+        }
         if (normalizedContent.startsWith('/rename ')) {
             const newName = normalizedContent.slice(8).trim();
             if (!newName)

package/dist/core/message/message-bridge.js

@@ -152,13 +152,27 @@ export class MessageBridge {
             return false;
         if (parsed.type === 'menu.query') {
             const identity = this.sessionManager.resolveIdentity(channel, msg.peerId);
-            const items = this.cmdHandler.getMenuItems(identity.role, msg.chatType || 'private');
-            const response = JSON.stringify({ type: 'menu.response', items });
-            if (adapter?.sendCustomPayload) {
-                adapter.sendCustomPayload(msg.channelId, response);
+            if (parsed.cmd) {
+                // 动态子菜单查询
+                const items = await this.cmdHandler.getSubMenuItems(parsed.cmd, channel, msg.channelId, msg.peerId);
+                const response = JSON.stringify({ type: 'menu.response', cmd: parsed.cmd, items: items ?? [] });
+                if (adapter?.sendCustomPayload) {
+                    adapter.sendCustomPayload(msg.channelId, response);
+                }
+                else {
+                    await sendReply(msg.channelId, response);
+                }
             }
             else {
-                await sendReply(msg.channelId, response);
+                // 全量菜单
+                const items = this.cmdHandler.getMenuItems(identity.role, msg.chatType || 'private');
+                const response = JSON.stringify({ type: 'menu.response', items });
+                if (adapter?.sendCustomPayload) {
+                    adapter.sendCustomPayload(msg.channelId, response);
+                }
+                else {
+                    await sendReply(msg.channelId, response);
+                }
             }
             return true;
         }

package/dist/core/message/message-processor.js

@@ -337,15 +337,18 @@ export class MessageProcessor {
             // 保存当前 flusher，用于 compact 事件
             this.currentFlusher = flusher;
             // 调用 AgentRunner（含上下文过长自动 compact 重试）
+            // 捕获当前消息的上下文（闭包），避免后续消息处理时串台
+            const capturedChannelId = message.channelId;
+            const capturedReplyContext = this.getReplyContext(message);
             // 设置权限审批的消息发送回调（指向当前渠道）
             agent.setSendPrompt(async (text) => {
-                await adapter.sendText(message.channelId, text, this.getReplyContext(message));
+                await adapter.sendText(capturedChannelId, text, capturedReplyContext);
             });
             // 设置权限审批的交互上下文（支持交互卡片）
             agent.setPermissionContext?.(session.id, {
                 adapter,
-                channelId: message.channelId,
-                replyContext: this.getReplyContext(message),
+                channelId: capturedChannelId,
+                replyContext: capturedReplyContext,
                 interactionRouter: this.interactionRouter,
                 interceptNextMessage: this.messageQueue
                     ? (sessionKey, handler) => this.messageQueue.interceptNext(sessionKey, handler)

package/dist/core/permission.js

@@ -94,6 +94,12 @@ export function summarizeToolInput(toolName, input) {
         'Glob': (i) => `pattern: ${i.pattern}`,
         'Agent': (i) => i.description || i.prompt?.substring(0, 80),
         'Skill': (i) => i.skill ? `${i.skill}${i.args ? ' ' + i.args : ''}` : undefined,
+        'ExitPlanMode': (i) => {
+            if (i.allowedPrompts?.length) {
+                return `计划包含 ${i.allowedPrompts.length} 项操作权限`;
+            }
+            return '计划审批';
+        },
         'TodoWrite': (i) => {
             if (Array.isArray(i.todos)) {
                 return i.todos.map((t) => t.content || t.task || t.text).filter(Boolean).join(', ').substring(0, 80);
@@ -186,7 +192,6 @@ export class PermissionGateway {
             },
             channelId: context?.channelId || '',
             sessionId,
-            expiresAt: Date.now() + this.timeout,
         };
         // 尝试富交互
         let interactionSent = false;
@@ -204,16 +209,7 @@ export class PermissionGateway {
             await sendPrompt(`🔐 权限请求\n工具：${toolName}\n操作：${displaySummary}${reasonLine}\n\n回复 /perm allow 本次允许 | always 始终允许 | deny 拒绝`);
         }
         return new Promise((resolve) => {
-            const timer = setTimeout(() => {
-                this.pending.delete(requestId);
-                // 清理 router 注册（仅删除本次请求，不影响其他交互）
-                if (interactionSent && context?.interactionRouter) {
-                    context.interactionRouter.cancel(requestId);
-                }
-                this.eventBus?.publish({ type: 'permission:timeout', sessionId, requestId });
-                resolve('deny');
-            }, this.timeout);
-            this.pending.set(requestId, { sessionId, toolName, resolve, timer });
+            this.pending.set(requestId, { sessionId, toolName, resolve, timer: setTimeout(() => { }, 0) });
             // 如果发了交互卡片，同时注册到 InteractionRouter
             if (interactionSent && context?.interactionRouter) {
                 context.interactionRouter.register(requestId, sessionId, (action) => {

package/dist/utils/init-channel.js

@@ -18,7 +18,7 @@ import { normalizeChannelInstances } from '../config.js';
 import { selectInstance } from './init.js';
 import { isWindows } from './cross-platform.js';
 const execFileAsync = promisify(execFile);
-async function npmInstallGlobal(pkg) {
+export async function npmInstallGlobal(pkg) {
     try {
         await execFileAsync('npm', ['install', '-g', pkg], { timeout: 180000 });
     }
@@ -575,7 +575,7 @@ function compareVersion(a, min) {
         return parts[1] > min[1];
     return parts[2] >= min[2];
 }
-function resolveAunCoreSdkPkg() {
+export function resolveAunCoreSdkPkg() {
     try {
         const esmRequire = createRequire(import.meta.url);
         const entry = esmRequire.resolve(AUN_CORE_SDK_PKG);
@@ -703,7 +703,7 @@ export async function setupAunAid(rl, _config) {
             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`;
+            const agentMdContent = `---\naid: "${aid}"\nname: "${agentName}"\ntype: "${agentType}"\nversion: "1.0.0"\ndescription: ""\ntags:\n  - evolclaw\ninitialized: false\n---\n`;
             try {
                 await client.auth.uploadAgentMd(agentMdContent);
                 console.log('  ✓ agent.md 已发布');
@@ -732,7 +732,24 @@ export async function setupAunAid(rl, _config) {
             break;
         // default: retry with new AID
     }
-    return { aid };
+    // Owner 必填
+    console.log('\n📋 Owner 配置');
+    console.log('  Owner 将接收欢迎消息并拥有管理权限');
+    let owner = '';
+    while (!owner) {
+        const ownerInput = (await ask(rl, '  Owner AID (必填): ')).trim();
+        if (!ownerInput) {
+            console.log('  ⚠ Owner AID 不能为空');
+            continue;
+        }
+        if (!isValidAid(ownerInput)) {
+            console.log('  ⚠ Owner AID 格式无效');
+            continue;
+        }
+        owner = ownerInput;
+        console.log(`  ✓ Owner 已设置: ${owner}`);
+    }
+    return { aid, owner };
 }
 export async function cmdInitAun() {
     const p = resolvePaths();
@@ -761,6 +778,7 @@ export async function cmdInitAun() {
         config.channels.aun = {
             enabled: true,
             aid: result.aid,
+            owner: result.owner,
         };
         if (!config.channels.defaultChannel)
             config.channels.defaultChannel = 'aun';

package/dist/utils/init.js

@@ -376,7 +376,7 @@ async function offerRichContentRenderer(rl, config) {
 // ==================== AUN AID Helpers ====================
 // Moved to init-channel.ts
 // ==================== Main ====================
-export async function cmdInit() {
+export async function cmdInit(options) {
     const p = resolvePaths();
     ensureDataDirs();
     if (fs.existsSync(p.pid)) {
@@ -393,6 +393,56 @@ export async function cmdInit() {
         console.log(`❌ 找不到示例配置: ${sampleSrc}`);
         return;
     }
+    // 非交互式模式
+    if (options?.nonInteractive) {
+        const config = JSON.parse(fs.readFileSync(sampleSrc, 'utf-8'));
+        const defaultPath = options.defaultPath || path.join(os.homedir(), 'evolclaw-project');
+        if (!fs.existsSync(defaultPath))
+            fs.mkdirSync(defaultPath, { recursive: true });
+        config.projects.defaultPath = defaultPath;
+        config.projects.list = { [path.basename(defaultPath)]: defaultPath };
+        if (options.channel === 'aun' && options.aunAid) {
+            // 自动安装 AUN SDK
+            const { resolveAunCoreSdkPkg, npmInstallGlobal } = await import('./init-channel.js');
+            if (!resolveAunCoreSdkPkg()) {
+                console.log('正在安装 @eleans/aun-core-sdk...');
+                await npmInstallGlobal('@eleans/aun-core-sdk@latest');
+            }
+            // 创建 AID（如果本地不存在）
+            const aunPath = path.join(os.homedir(), '.aun');
+            const aidDir = path.join(aunPath, 'AIDs', options.aunAid);
+            if (!fs.existsSync(path.join(aidDir, 'private'))) {
+                const { AUNClient } = await import('@eleans/aun-core-sdk');
+                const client = new AUNClient({ aun_path: aunPath });
+                const domain = options.aunAid.split('.').slice(1).join('.');
+                client._gatewayUrl = `wss://gateway.${domain}:443/aun`;
+                await client.auth.createAid({ aid: options.aunAid });
+                // 写入初始 agent.md（initialized: false）
+                const agentName = options.aunAid.split('.')[0];
+                const agentMd = `---\naid: "${options.aunAid}"\nname: "${agentName}"\ntype: "ai"\nversion: "1.0.0"\ndescription: ""\ntags:\n  - evolclaw\ninitialized: false\n---\n`;
+                try {
+                    await client.auth.uploadAgentMd(agentMd);
+                    fs.writeFileSync(path.join(aidDir, 'agent.md'), agentMd, 'utf-8');
+                }
+                catch { }
+                try {
+                    await client.close();
+                }
+                catch { }
+            }
+            config.channels.aun = {
+                enabled: true,
+                aid: options.aunAid,
+                ...(options.aunOwner && { owner: options.aunOwner }),
+            };
+            config.channels.defaultChannel = 'aun';
+        }
+        fs.writeFileSync(p.config, JSON.stringify(config, null, 2) + '\n');
+        console.log(`✓ 已创建配置文件: ${p.config}`);
+        setupEnvVar(resolveRoot());
+        return;
+    }
+    // 交互式模式
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     try {
         if (fs.existsSync(p.config)) {
@@ -490,6 +540,7 @@ export async function cmdInit() {
                 config.channels.aun = {
                     enabled: true,
                     aid: result.aid,
+                    owner: result.owner,
                 };
                 channelConfigured = true;
                 config.channels.defaultChannel = 'aun';

package/evolclaw-install.md

@@ -0,0 +1,54 @@
+请引导我完成 EvolClaw 的安装和配置。EvolClaw 是一个轻量级 AI Agent 网关，连接 Claude/Codex 到飞书、微信等 IM 通道。
+
+**重要提示**：安装完成后，首次在 IM 渠道（飞书/微信）中与 EvolClaw 交互的用户将自动成为 owner，拥有完整管理权限。
+
+按以下步骤执行：
+
+## 第 1 步：环境检查
+
+运行 `node --version` 和 `npm --version`，确认 Node.js >= 18、npm >= 8。
+如果不符合要求，提示用户先升级 Node.js（https://nodejs.org）后停止。
+
+## 第 2 步：确认安装
+
+使用 AskUserQuestion 询问：
+- 问题：是否立即安装 EvolClaw？
+- 选项 A：立即安装
+- 选项 B：仅显示命令，我稍后手动执行
+
+如果选择 B，输出 `npm install -g evolclaw` 后结束。
+
+## 第 3 步：执行安装
+
+运行 `npm install -g evolclaw`，然后 `evolclaw --version` 验证。
+
+如果失败且是权限问题，提示：
+```
+sudo npm install -g evolclaw
+# 或配置 npm prefix（推荐）：
+npm config set prefix ~/.npm-global && export PATH=~/.npm-global/bin:$PATH
+npm install -g evolclaw
+```
+
+## 第 4 步：初始化配置
+
+运行 `evolclaw init`。
+
+提示用户：EvolClaw 自动继承 Claude Code CLI 的 API Key，无需重复配置。
+
+## 第 5 步：配置消息渠道
+
+使用 AskUserQuestion（multiSelect: true）询问需要配置哪些渠道：
+- 飞书：运行 `evolclaw init feishu`（扫码登录）
+- 微信：运行 `evolclaw init wechat`（扫码登录）
+- 暂不配置：跳过
+
+## 第 6 步：启动并验证
+
+运行 `evolclaw start`，再运行 `evolclaw status` 确认状态为 Running。
+
+安装完成后告知用户：
+- 在飞书/微信中发消息验证连接
+- 发送 `/help` 查看所有命令
+- 发送 `/bind <项目路径>` 绑定项目目录
+- 常用命令：`evolclaw stop/restart/logs`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Lightweight AI Agent gateway connecting Claude Agent SDK to messaging channels (Feishu, ACP) with multi-project session management",
   "type": "module",
   "main": "dist/index.js",
@@ -10,7 +10,8 @@
   "files": [
     "dist/",
     "!dist/experimental/",
-    "data/evolclaw.sample.json"
+    "data/evolclaw.sample.json",
+    "evolclaw-install.md"
   ],
   "scripts": {
     "dev": "tsx watch src/index.ts",