evolclaw 2.5.1 → 2.5.3

package/dist/channels/aun.js

@@ -172,7 +172,7 @@ export class AUNChannel {
         }
         if (!gateway) {
             logger.error('[AUN] Cannot resolve gateway URL from AID');
-            return;
+            throw new Error('Cannot resolve gateway URL from AID');
         }
         logger.info(`[AUN] Initializing: aid=${aidName}, gateway=${gateway}, aun_path=${aunPath}`);
         // Create client with FileSecretStore (AES-256-GCM)
@@ -252,7 +252,7 @@ export class AUNChannel {
             if (!accessToken) {
                 logger.error(`[AUN] No accessToken fallback available, scheduling retry`);
                 this.scheduleReconnect();
-                return;
+                throw new Error('Authentication failed and no accessToken fallback available');
             }
             logger.warn(`[AUN] Using accessToken fallback`);
         }
@@ -282,7 +282,7 @@ export class AUNChannel {
         catch (e) {
             logger.error(`[AUN] Connection failed: ${e}`);
             this.scheduleReconnect();
-            return;
+            throw e;
         }
     }
     async sendWelcomeMessage() {
@@ -1026,6 +1026,7 @@ export class AUNChannelPlugin {
                 accessToken: inst.accessToken,
                 flushDelay: inst.flushDelay,
                 encryptionSeed: inst.encryptionSeed,
+                owner: inst.owner,
                 aunTrace: config.debug?.aunTrace,
             });
             const adapter = {

package/dist/utils/init-channel.js

@@ -11,7 +11,7 @@ import path from 'path';
 import os from 'os';
 import crypto from 'crypto';
 import { createRequire } from 'module';
-import { execFile } from 'child_process';
+import { execFile, execFileSync } from 'child_process';
 import { promisify } from 'util';
 import { resolvePaths } from '../paths.js';
 import { normalizeChannelInstances } from '../config.js';
@@ -19,8 +19,9 @@ import { selectInstance } from './init.js';
 import { isWindows } from './cross-platform.js';
 const execFileAsync = promisify(execFile);
 export async function npmInstallGlobal(pkg) {
+    const npmCmd = isWindows ? 'npm.cmd' : 'npm';
     try {
-        await execFileAsync('npm', ['install', '-g', pkg], { timeout: 180000 });
+        await execFileAsync(npmCmd, ['install', '-g', pkg], { timeout: 180000 });
     }
     catch (e) {
         if (e.stderr?.includes('EACCES') || e.message?.includes('EACCES')) {
@@ -576,6 +577,7 @@ function compareVersion(a, min) {
     return parts[2] >= min[2];
 }
 export function resolveAunCoreSdkPkg() {
+    // Strategy 1: createRequire (works when evolclaw and SDK share the same node_modules)
     try {
         const esmRequire = createRequire(import.meta.url);
         const entry = esmRequire.resolve(AUN_CORE_SDK_PKG);
@@ -592,14 +594,25 @@ export function resolveAunCoreSdkPkg() {
                 }
                 dir = path.dirname(dir);
             }
-            return null;
         }
-        const data = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-        return { version: data.version, path: pkgPath };
+        else {
+            const data = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            return { version: data.version, path: pkgPath };
+        }
     }
-    catch {
-        return null;
+    catch { /* fall through to strategy 2 */ }
+    // Strategy 2: npm root -g fallback (handles Windows / path mismatch)
+    try {
+        const npmCmd = isWindows ? 'npm.cmd' : 'npm';
+        const globalRoot = execFileSync(npmCmd, ['root', '-g'], { encoding: 'utf-8', timeout: 10000 }).trim();
+        const pkgPath = path.join(globalRoot, AUN_CORE_SDK_PKG, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const data = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+            return { version: data.version, path: pkgPath };
+        }
     }
+    catch { /* not found */ }
+    return null;
 }
 export async function checkAunEnvironment(rl) {
     console.log('\n🔍 AUN 环境检查...\n');
@@ -699,6 +712,23 @@ 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} 创建成功`);
+            // 下载 CA 根证书（如果本地不存在）
+            const caDir = path.join(aunPath, 'CA', 'root');
+            const caCertPath = path.join(caDir, 'root.crt');
+            if (!fs.existsSync(caCertPath)) {
+                try {
+                    fs.mkdirSync(caDir, { recursive: true });
+                    // Derive HTTPS URL from gateway WebSocket URL (same as SDK's _gatewayHttpUrl)
+                    const resp = await fetch(`https://gateway.${domain}:${port}/pki/chain`);
+                    if (resp.ok) {
+                        fs.writeFileSync(caCertPath, await resp.text());
+                        console.log('  ✓ CA 根证书已下载');
+                    }
+                }
+                catch (e) {
+                    console.warn(`  ⚠ CA 根证书下载失败: ${e}，可稍后手动下载`);
+                }
+            }
             // Collect agent.md info and publish
             const typeInput = (await ask(rl, '  Agent 类型 human/ai [ai]: ')).trim().toLowerCase();
             const agentType = typeInput === 'human' ? 'human' : 'ai';

package/dist/utils/init.js

@@ -401,6 +401,9 @@ export async function cmdInit(options) {
             fs.mkdirSync(defaultPath, { recursive: true });
         config.projects.defaultPath = defaultPath;
         config.projects.list = { [path.basename(defaultPath)]: defaultPath };
+        if (options.channel === 'aun' && !options.aunAid) {
+            throw new Error('--aun-aid is required for AUN channel (e.g. --aun-aid mybot.agentid.pub)');
+        }
         if (options.channel === 'aun' && options.aunAid) {
             // 自动安装 AUN SDK
             const { resolveAunCoreSdkPkg, npmInstallGlobal } = await import('./init-channel.js');
@@ -417,6 +420,22 @@ export async function cmdInit(options) {
                 const domain = options.aunAid.split('.').slice(1).join('.');
                 client._gatewayUrl = `wss://gateway.${domain}:443/aun`;
                 await client.auth.createAid({ aid: options.aunAid });
+                // 下载 CA 根证书（如果本地不存在）
+                const caDir = path.join(aunPath, 'CA', 'root');
+                const caCertPath = path.join(caDir, 'root.crt');
+                if (!fs.existsSync(caCertPath)) {
+                    try {
+                        fs.mkdirSync(caDir, { recursive: true });
+                        const resp = await fetch(`https://gateway.${domain}/pki/chain`);
+                        if (resp.ok) {
+                            fs.writeFileSync(caCertPath, await resp.text());
+                            console.log('✓ CA 根证书已下载');
+                        }
+                    }
+                    catch (e) {
+                        console.warn(`⚠ CA 根证书下载失败: ${e}，可稍后手动下载`);
+                    }
+                }
                 // 写入初始 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`;

package/evolclaw-install-aun.md

@@ -0,0 +1,148 @@
+# EvolClaw AUN 通道安装指南
+
+EvolClaw 是一个开源的 AI Agent 网关，将 Claude/Codex 等 AI 后端连接到 AUN（AgentUnion.Network）消息通道。
+
+- **npm**: https://www.npmjs.com/package/evolclaw
+- **GitHub**: https://github.com/eLeanwang/evolclaw
+- **AUN**: https://agentunion.network
+
+---
+
+## 前置条件
+
+- Node.js >= 18，npm >= 8
+- 一个 AUN Agent ID（AID）——标识你的 Agent
+- 一个 Owner AID——接收欢迎消息和管理权限
+
+---
+
+## 安装步骤
+
+### 步骤 1：检查环境
+
+```bash
+node --version   # 需要 >= 18
+npm --version    # 需要 >= 8
+```
+
+版本不满足请先升级：https://nodejs.org
+
+### 步骤 2：安装 EvolClaw
+
+```bash
+npm install -g evolclaw
+evolclaw --version
+```
+
+遇到权限错误（EACCES）：
+
+```bash
+# 方案 A
+sudo npm install -g evolclaw
+
+# 方案 B（推荐，无需 sudo）
+npm config set prefix ~/.npm-global
+export PATH=~/.npm-global/bin:$PATH
+npm install -g evolclaw
+```
+
+### 步骤 3：准备配置信息
+
+| 参数 | 说明 | 示例 |
+|------|------|------|
+| `--aun-aid` | **必填**，你的 AUN Agent ID | `mybot.agentid.pub` |
+| `--aun-owner` | **必填**，Owner 的 AUN ID | `alice.agentid.pub` |
+| `--default-path` | 默认项目路径（可选，默认当前目录） | `/home/user/myproject` |
+
+如果用户在触发安装时已提供 Owner AID（例如消息中包含"将 xxx 添加为 Owner ID"），直接使用该值，否则询问用户。
+
+### 步骤 4：非交互式初始化
+
+```bash
+evolclaw init --non-interactive \
+  --default-path "$PWD" \
+  --channel aun \
+  --aun-aid <AID> \
+  --aun-owner <Owner AID>
+```
+
+此命令自动完成：
+1. 创建配置文件 `~/.evolclaw/data/evolclaw.json`
+2. 安装 `@eleans/aun-core-sdk`
+3. 创建 AID 密钥对（如本地不存在）
+4. 下载 CA 根证书到 `~/.aun/CA/root/root.crt`
+5. 写入初始 `agent.md`（`initialized: false`）
+6. 写入配置（含 owner 字段）
+
+### 步骤 5：启动前验证
+
+读取配置文件确认关键字段：
+
+```bash
+cat ~/.evolclaw/data/evolclaw.json
+```
+
+检查：
+- `channels.aun.aid` — 你的 AID
+- `channels.aun.owner` — Owner AID
+- `projects.defaultPath` — 项目路径（目录需存在）
+- `channels.defaultChannel` — 应为 `"aun"`
+
+如发现缺失或异常，向用户说明并提供修复方案。
+
+### 步骤 6：启动服务
+
+```bash
+evolclaw start
+```
+
+### 步骤 7：验证运行状态
+
+```bash
+evolclaw status
+tail -n 30 ~/.evolclaw/logs/evolclaw.log
+```
+
+日志中应出现：`[AUN] Connected as @<aid>`
+
+如未出现或有错误，读取完整日志分析原因并提供修复建议。
+
+---
+
+## 首次连接自动行为
+
+EvolClaw 首次连接 AUN 网络时自动：
+
+1. 检测 `~/.aun/AIDs/<aid>/agent.md` 中的 `initialized` 字段
+2. 若为 `false`，生成完整 agent.md 并发布到 AUN 网络
+3. 向 Owner 发送欢迎消息
+
+无需手动触发，连接成功后自动完成。
+
+---
+
+## 安装完成
+
+```
+✅ EvolClaw 安装完成！
+
+服务已启动并连接到 AUN 网络。
+首次连接后你将在 AUN 客户端收到欢迎消息。
+使用 /bind <项目路径> 绑定工作目录即可开始。
+```
+
+---
+
+## 常见问题
+
+**Q: AID 已存在怎么办？**
+`evolclaw init --non-interactive` 会检测本地密钥，已存在则跳过创建。
+
+**Q: 启动失败怎么办？**
+查看 `~/.evolclaw/logs/evolclaw.log` 或运行 `evolclaw diagnose`。
+
+**Q: 如何重启/查看日志？**
+```bash
+evolclaw restart
+evolclaw logs
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evolclaw",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "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",
@@ -11,7 +11,7 @@
     "dist/",
     "!dist/experimental/",
     "data/evolclaw.sample.json",
-    "evolclaw-install.md"
+    "evolclaw-install-aun.md"
   ],
   "scripts": {
     "dev": "tsx watch src/index.ts",

package/evolclaw-install.md

@@ -1,54 +0,0 @@
-请引导我完成 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`