aicq-chat-plugin 2.6.5 → 3.0.1

package/openclaw.plugin.json

@@ -1,53 +1,68 @@
 {
+  "kind": "channel",
   "id": "aicq-chat",
   "name": "AICQ Encrypted Chat",
-  "version": "2.6.5",
-  "description": "End-to-end encrypted chat plugin for OpenClaw agents — Node.js implementation with full UI",
+  "version": "3.0.1",
+  "description": "End-to-end encrypted chat channel via AICQ protocol — in-process Channel plugin",
   "entry": "index.js",
   "activation": {
     "onStartup": true
   },
   "enabledByDefault": true,
+  "channels": [
+    "aicq-chat"
+  ],
+  "channelConfigs": {
+    "aicq-chat": {
+      "accounts": {
+        "type": "object",
+        "properties": {
+          "accountId": {
+            "type": "string",
+            "description": "绑定到 OpenClaw 智能体的账户 ID",
+            "default": "{{agent.id}}"
+          },
+          "autoAcceptFriends": {
+            "type": "boolean",
+            "default": true,
+            "description": "是否自动接受好友请求"
+          }
+        },
+        "required": [
+          "accountId"
+        ]
+      }
+    }
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
-      "enabled": {
-        "type": "boolean",
-        "description": "Enable the AICQ chat plugin (default: true).",
-        "default": true
+      "serverUrl": {
+        "type": "string",
+        "description": "AICQ 服务器地址",
+        "default": "https://aicq.online"
       },
-      "port": {
-        "type": "number",
-        "description": "Port for the AICQ sidecar server (default: 6109).",
-        "default": 6109,
-        "minimum": 1024,
-        "maximum": 65535
-      },
-      "autoStart": {
+      "autoAcceptFriends": {
         "type": "boolean",
-        "description": "Automatically start the sidecar server on gateway startup (default: true).",
+        "description": "自动接受好友请求",
         "default": true
       },
       "debug": {
         "type": "boolean",
-        "description": "Enable verbose debug logging (default: false).",
+        "description": "Enable verbose debug logging",
         "default": false
       }
     }
   },
   "uiHints": {
-    "enabled": {
-      "label": "Enable AICQ",
-      "help": "Toggle the AICQ encrypted chat plugin on or off."
-    },
-    "port": {
-      "label": "Sidecar Port",
-      "help": "The port the AICQ sidecar server listens on."
+    "serverUrl": {
+      "label": "AICQ Server URL",
+      "help": "The AICQ signaling server URL for WebSocket connections."
     },
-    "autoStart": {
-      "label": "Auto Start",
-      "help": "Start the AICQ server automatically when OpenClaw gateway starts."
+    "autoAcceptFriends": {
+      "label": "Auto Accept Friends",
+      "help": "Automatically accept incoming friend requests."
     },
     "debug": {
       "label": "Debug Mode",
@@ -85,19 +100,13 @@
       "aicq.groups.silent"
     ]
   },
-  "sidecar": {
-    "command": "node",
-    "args": [
-      "index.js"
-    ],
-    "port": 6109
-  },
   "runtime": "node",
   "requires": {
     "node": ">=18.0.0",
     "packages": [
       "sql.js",
       "tweetnacl",
+      "tweetnacl-util",
       "ws",
       "qrcode",
       "express"

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "aicq-chat-plugin",
-  "version": "2.6.5",
-  "description": "AICQ End-to-end Encrypted Chat Plugin for OpenClaw — Full UI with friend management, group chat, file transfer, and AI agent communication",
+  "version": "3.0.1",
+  "description": "AICQ End-to-end Encrypted Chat Channel Plugin for OpenClaw — In-process Channel architecture with friend management, group chat, file transfer, and AI agent communication",
   "main": "index.js",
   "bin": {
     "aicq-plugin": "cli.js"
   },
   "files": [
-    "extension.js",
     "index.js",
+    "setup-entry.js",
     "cli.js",
     "postinstall.js",
+    "src/",
     "lib/",
     "public/",
     "openclaw.plugin.json",
@@ -29,6 +30,7 @@
     "e2ee",
     "openclaw",
     "plugin",
+    "channel",
     "ai-agent",
     "messaging",
     "p2p"
@@ -59,10 +61,12 @@
     "node": ">=18.0.0"
   },
   "openclaw": {
-    "id": "aicq-chat",
-    "extensions": [
-      "./extension.js"
-    ],
+    "channel": {
+      "id": "aicq-chat",
+      "label": "AICQ Encrypted Chat",
+      "blurb": "端到端加密即时通讯频道，基于 NaCl (X25519 + XSalsa20-Poly1305)",
+      "icon": "🔐"
+    },
     "compat": {
       "pluginApi": ">=2026.3.24-beta.2"
     }

package/postinstall.js

@@ -1,355 +1,26 @@
 #!/usr/bin/env node
 /**
- * AICQ Chat Plugin — Post-install script
+ * AICQ Chat Plugin — Post-install script (v3.0 Channel)
  *
- * Automatically installs the plugin into OpenClaw's skills/ and plugins/ directories.
- * OpenClaw discovers skills by scanning skills/ directories for SKILL.md marker files.
- * OpenClaw reads openclaw.plugin.json from plugins/ to launch sidecar processes.
+ * Displays setup information after npm install.
+ * v3.0 uses Channel architecture - no independent port needed.
  */
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { execSync } = require('child_process');
-
-const PLUGIN_ID = 'aicq-chat';
-const PLUGIN_DIR = path.resolve(__dirname);
-
-// ── SKILL.md template ─────────────────────────────────────────────
-const SKILL_MD_TEMPLATE = `---
-name: aicq-chat
-description: AICQ End-to-end Encrypted Chat Plugin for OpenClaw — Full UI with friend management, group chat, file transfer, and AI agent communication
-license: MIT
-metadata:
-  author: AICQ
-  version: "{VERSION}"
----
-
-# AICQ Encrypted Chat
-
-AICQ 是一个端到端加密聊天插件，适用于 OpenClaw 的完整聊天 UI。支持好友管理、群组聊天、文件传输和 AI Agent 通信。
-
-## 功能特性
-
-- **端到端加密 (E2EE)** — 基于 NaCl (libsodium) 的加密体系，消息仅通信双方可读
-- **Agent 管理** — 支持多 Agent 切换、创建和删除
-- **好友管理** — 好友码添加、QR 码扫描、好友列表同步
-- **群组聊天** — 创建群组、邀请成员、静默模式
-- **消息功能** — Markdown/LaTeX 渲染、图片/文件上传、@提及
-- **密钥管理** — 公钥/私钥显示、密钥轮换、指纹验证
-- **P2P 通信** — 握手、文本传输、文件传输
-
-## 一键启动
-
-\`\`\`bash
-# 1. 卸载旧版
-openclaw plugins uninstall aicq-chat
-
-# 2. 安装新版
-openclaw plugins install npm:aicq-chat-plugin
-
-# 3. 重启 gateway
-openclaw gateway restart
-
-# 4. 浏览器访问聊天界面
-open http://localhost:6109
-\`\`\`
-
-## OpenClaw 集成
-
-插件会自动注册为 OpenClaw sidecar，提供以下工具和网关：
-
-### 工具
-- \`chat-friend\` — 好友管理
-- \`chat-send\` — 发送消息
-- \`chat-export-key\` — 导出密钥
-
-### 网关方法
-- \`aicq.status\` — 插件状态
-- \`aicq.friends.list/add/remove\` — 好友操作
-- \`aicq.chat.send/history/delete\` — 聊天操作
-- \`aicq.groups.list/create/join\` — 群组操作
-- \`aicq.identity.info\` — 身份信息
-
-## 配置
-
-| 变量 | 默认值 | 说明 |
-|------|--------|------|
-| \`AICQ_PORT\` | 6109 | 插件服务端口 |
-| \`AICQ_SERVER_URL\` | https://aicq.online | AICQ 服务器地址 |
-| \`AICQ_DATA_DIR\` | ~/.aicq-plugin | 数据存储目录 |
-
-## Chat UI
-
-启动后访问 http://localhost:6109 即可使用完整的聊天界面。
-`;
-
-// ── Find OpenClaw installation ──────────────────────────────────────
-function findOpenClawDir() {
-  const candidates = [
-    path.join(os.homedir(), '.openclaw'),
-    path.join(os.homedir(), 'openclaw'),
-    path.join(os.homedir(), '.config', 'openclaw'),
-  ];
-
-  if (process.env.OPENCLAW_HOME) {
-    candidates.unshift(process.env.OPENCLAW_HOME);
-  }
-
-  for (const dir of candidates) {
-    if (fs.existsSync(dir)) {
-      return dir;
-    }
-  }
-  return null;
-}
-
-// ── Find OpenClaw workspace (for skills/ directory) ────────────────
-function findOpenClawWorkspace() {
-  if (process.env.OPENCLAW_WORKSPACE) {
-    return process.env.OPENCLAW_WORKSPACE;
-  }
-
-  const home = os.homedir();
-  const candidates = [
-    process.cwd(),
-    path.join(home, 'my-project'),
-    path.join(home, 'openclaw'),
-    path.join(home, '.openclaw'),
-  ];
-
-  for (const dir of candidates) {
-    const skillsDir = path.join(dir, 'skills');
-    if (fs.existsSync(skillsDir)) {
-      return dir;
-    }
-  }
-
-  // Check parent directories
-  let current = process.cwd();
-  for (let i = 0; i < 3; i++) {
-    const skillsDir = path.join(current, 'skills');
-    if (fs.existsSync(skillsDir)) {
-      return current;
-    }
-    current = path.dirname(current);
-  }
-
-  // If no existing skills/ found, fall back to the OpenClaw directory itself.
-  // This handles the case where ~/.openclaw/ exists but has no skills/ yet.
-  // We'll auto-create skills/ inside it during installation.
-  const openclawDir = findOpenClawDir();
-  if (openclawDir) {
-    return openclawDir;
-  }
-
-  return null;
-}
-
-// ── Recursively copy a directory ────────────────────────────────────
-function copyDirRecursive(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      if (entry.name === 'node_modules') continue;
-      copyDirRecursive(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-// ── Install plugin files to a target directory ─────────────────────
-function installToDir(sourceDir, targetDir, version) {
-  const filesToCopy = [
-    'extension.js',
-    'index.js',
-    'cli.js',
-    'postinstall.js',
-    'openclaw.plugin.json',
-    'package.json',
-    'README.md',
-  ];
-
-  const dirsToCopy = [
-    'lib',
-    'public',
-  ];
-
-  // Create target directory if needed
-  if (!fs.existsSync(targetDir)) {
-    fs.mkdirSync(targetDir, { recursive: true });
-  }
-
-  // Copy individual files
-  for (const file of filesToCopy) {
-    const src = path.join(sourceDir, file);
-    const dest = path.join(targetDir, file);
-    if (fs.existsSync(src)) {
-      fs.copyFileSync(src, dest);
-    }
-  }
-
-  // Copy directories
-  for (const dir of dirsToCopy) {
-    const src = path.join(sourceDir, dir);
-    const dest = path.join(targetDir, dir);
-    if (fs.existsSync(src)) {
-      if (fs.existsSync(dest)) {
-        fs.rmSync(dest, { recursive: true, force: true });
-      }
-      copyDirRecursive(src, dest);
-    }
-  }
-
-  // Generate SKILL.md with current version
-  const skillMd = SKILL_MD_TEMPLATE.replace('{VERSION}', version);
-  fs.writeFileSync(path.join(targetDir, 'SKILL.md'), skillMd, 'utf8');
-}
-
-// ── Install to skills/ directory ────────────────────────────────────
-function installToSkillsDir(workspace, version) {
-  const skillsDir = path.join(workspace, 'skills');
-  const targetDir = path.join(skillsDir, PLUGIN_ID);
-
-  if (!fs.existsSync(skillsDir)) {
-    fs.mkdirSync(skillsDir, { recursive: true });
-  }
-
-  console.log(`[AICQ] Installing skill to ${targetDir}`);
-
-  installToDir(PLUGIN_DIR, targetDir, version);
-
-  // Install npm dependencies
-  console.log('[AICQ] Installing skill dependencies...');
-  try {
-    execSync('npm install --omit=dev', {
-      cwd: targetDir,
-      stdio: 'pipe',
-      timeout: 120000,
-    });
-    console.log('[AICQ] Skill dependencies installed.');
-  } catch (e) {
-    console.log('[AICQ] Warning: npm install failed. You may need to run it manually:');
-    console.log(`  cd ${targetDir} && npm install`);
-  }
-
-  return targetDir;
-}
-
-// ── Install to plugins/ directory ───────────────────────────────────
-function installToPluginsDir(openclawDir, version) {
-  const pluginsDir = path.join(openclawDir, 'plugins');
-  const targetDir = path.join(pluginsDir, PLUGIN_ID);
-
-  if (!fs.existsSync(pluginsDir)) {
-    fs.mkdirSync(pluginsDir, { recursive: true });
-  }
-
-  console.log(`[AICQ] Installing plugin to ${targetDir}`);
-
-  installToDir(PLUGIN_DIR, targetDir, version);
-
-  // Install npm dependencies
-  console.log('[AICQ] Installing plugin dependencies...');
-  try {
-    execSync('npm install --omit=dev', {
-      cwd: targetDir,
-      stdio: 'pipe',
-      timeout: 120000,
-    });
-    console.log('[AICQ] Plugin dependencies installed.');
-  } catch (e) {
-    console.log('[AICQ] Warning: npm install failed. You may need to run it manually:');
-    console.log(`  cd ${targetDir} && npm install`);
-  }
-
-  return targetDir;
-}
-
-// ── Main ────────────────────────────────────────────────────────────
 console.log('');
 console.log('  ╔══════════════════════════════════════════════╗');
-console.log('  ║       AICQ Chat Plugin — Installing...       ║');
+console.log('  ║     AICQ Chat Plugin v3.0 Installed!        ║');
+console.log('  ╠══════════════════════════════════════════════╣');
+console.log('  ║                                              ║');
+console.log('  ║   Architecture: Channel (in-process)         ║');
+console.log('  ║   No independent port needed!                ║');
+console.log('  ║                                              ║');
+console.log('  ║   Install via openclaw CLI:                  ║');
+console.log('  ║     openclaw plugins uninstall aicq-chat     ║');
+console.log('  ║     openclaw plugins install npm:aicq-chat-plugin ║');
+console.log('  ║     openclaw gateway restart                 ║');
+console.log('  ║                                              ║');
+console.log('  ║   UI: /plugins/aicq-chat/ui/                 ║');
+console.log('  ║   API: /plugins/aicq-chat/api/*              ║');
+console.log('  ║   Docs: https://aicq.online                  ║');
 console.log('  ╚══════════════════════════════════════════════╝');
 console.log('');
-
-// Read version from package.json
-let version = '2.6.0';
-try {
-  const pkg = JSON.parse(fs.readFileSync(path.join(PLUGIN_DIR, 'package.json'), 'utf8'));
-  version = pkg.version;
-} catch (e) {}
-
-let skillInstalled = false;
-let pluginInstalled = false;
-
-// Step 1: Install to skills/ directory (for dashboard discovery)
-const workspace = findOpenClawWorkspace();
-if (workspace) {
-  console.log(`[AICQ] Found workspace at: ${workspace}`);
-  try {
-    const skillDir = installToSkillsDir(workspace, version);
-    console.log(`[AICQ] Skill installed to: ${skillDir}`);
-    skillInstalled = true;
-  } catch (e) {
-    console.error('[AICQ] Skill install failed:', e.message);
-  }
-}
-
-// Step 2: Install to plugins/ directory (for sidecar startup)
-const openclawDir = findOpenClawDir();
-if (openclawDir) {
-  console.log(`[AICQ] Found OpenClaw at: ${openclawDir}`);
-  try {
-    const pluginDir = installToPluginsDir(openclawDir, version);
-    console.log(`[AICQ] Plugin installed to: ${pluginDir}`);
-    pluginInstalled = true;
-  } catch (e) {
-    console.error('[AICQ] Plugin install failed:', e.message);
-  }
-}
-
-// Summary
-console.log('');
-if (skillInstalled || pluginInstalled) {
-  console.log('  ╔══════════════════════════════════════════════╗');
-  console.log('  ║     AICQ Plugin Installed Successfully!      ║');
-  console.log('  ╠══════════════════════════════════════════════╣');
-  console.log('  ║                                              ║');
-  if (skillInstalled) {
-    console.log('  ║   ✅ Skill installed (dashboard visible)     ║');
-  }
-  if (pluginInstalled) {
-    console.log('  ║   ✅ Plugin installed (sidecar ready)        ║');
-  }
-  console.log('  ║                                              ║');
-  console.log('  ║   Restart OpenClaw to activate the plugin.   ║');
-  console.log('  ║                                              ║');
-  console.log('  ║   Chat UI: http://localhost:6109             ║');
-  console.log('  ║   Docs: https://aicq.online                  ║');
-  console.log('  ╚══════════════════════════════════════════════╝');
-} else {
-  console.log('  ╔══════════════════════════════════════════════╗');
-  console.log('  ║       AICQ Chat Plugin Installed!            ║');
-  console.log('  ╠══════════════════════════════════════════════╣');
-  console.log('  ║                                              ║');
-  console.log('  ║   OpenClaw not found — auto-install skipped  ║');
-  console.log('  ║                                              ║');
-  console.log('  ║   Set environment variables:                 ║');
-  console.log('  ║     OPENCLAW_HOME=<openclaw-root>            ║');
-  console.log('  ║     OPENCLAW_WORKSPACE=<workspace-dir>       ║');
-  console.log('  ║                                              ║');
-  console.log('  ║   Or install via openclaw CLI:               ║');
-  console.log('  ║     openclaw plugins install npm:aicq-chat-plugin ║');
-  console.log('  ║                                              ║');
-  console.log('  ║   Chat UI: http://localhost:6109             ║');
-  console.log('  ║   Docs: https://aicq.online                  ║');
-  console.log('  ╚══════════════════════════════════════════════╝');
-}
-console.log('');

package/public/index.html

@@ -419,11 +419,24 @@ let pendingDeleteMsgId = null;
 const API = '';
 
 // ─── API Helper ─────────────────────────────────────────────────────
+function errMsg(err) {
+  if (!err) return '未知错误';
+  if (typeof err === 'string') return err;
+  if (err.message) return err.message;
+  if (err.error && typeof err.error === 'string') return err.error;
+  if (err.error && typeof err.error === 'object') return errMsg(err.error);
+  try { return JSON.stringify(err); } catch { return '未知错误'; }
+}
+
 async function api(method, path, body = null) {
   const opts = { method, headers: { 'Content-Type': 'application/json' } };
   if (body) opts.body = JSON.stringify(body);
   const resp = await fetch(API + path, opts);
-  return resp.json();
+  const data = await resp.json();
+  if (!resp.ok && !data.success) {
+    throw new Error(errMsg(data.error) || `HTTP ${resp.status}`);
+  }
+  return data;
 }
 
 // ─── Agents ─────────────────────────────────────────────────────────
@@ -791,7 +804,7 @@ async function uploadFile(input, type) {
     if (data.success) {
       await loadMessages();
     } else {
-      alert('上传失败: ' + (data.error || '未知错误'));
+      alert('上传失败: ' + errMsg(data.error));
     }
   } catch (e) {
     alert('上传失败: ' + e.message);
@@ -882,7 +895,7 @@ async function addFriendByCode() {
       document.getElementById('friendCodeInput').value = '';
       await loadFriends();
     } else {
-      alert('添加失败: ' + (result.error || '未知错误'));
+      alert('添加失败: ' + errMsg(result.error));
     }
   } catch (e) {
     alert('添加失败: ' + e.message);
@@ -1041,7 +1054,7 @@ async function handlePluginAvatarUpload(input) {
       }
       alert('头像已更新');
     } else {
-      alert('上传失败: ' + (data.error || '未知错误'));
+      alert('上传失败: ' + errMsg(data.error));
     }
   } catch (e) {
     alert('头像上传失败: ' + e.message);

package/setup-entry.js

@@ -0,0 +1,61 @@
+/**
+ * AICQ Chat Plugin — Setup Wizard Entry Point
+ *
+ * Provides a multi-step setup wizard for first-time configuration.
+ * OpenClaw loads this via defineSetupPluginEntry convention.
+ */
+
+const SETUP_STEPS = [
+  {
+    id: 'welcome',
+    title: '欢迎使用 AICQ 加密聊天',
+    description: '本插件为您的智能体提供端到端加密即时通讯能力，基于 NaCl (X25519 + XSalsa20-Poly1305) 加密体系',
+    type: 'info',
+  },
+  {
+    id: 'server',
+    title: 'AICQ 服务器配置',
+    type: 'form',
+    fields: [
+      {
+        name: 'serverUrl',
+        label: '服务器地址',
+        type: 'text',
+        default: 'https://aicq.online',
+        description: 'AICQ 信令服务器地址，用于 WebSocket 连接',
+      },
+      {
+        name: 'autoAccept',
+        label: '自动接受好友请求',
+        type: 'checkbox',
+        default: true,
+        description: '是否自动接受来自其他智能体的好友请求',
+      },
+    ],
+  },
+  {
+    id: 'complete',
+    title: '配置完成',
+    description: '您的智能体现在可以通过 AICQ 进行加密通讯了。在频道设置中管理好友列表，或使用 chat-friend 工具添加好友。',
+    type: 'info',
+  },
+];
+
+function register() {
+  return {
+    id: 'aicq-chat-setup',
+    label: 'AICQ Chat Setup',
+    version: '3.0.0',
+    steps: SETUP_STEPS,
+  };
+}
+
+function getSteps() {
+  return SETUP_STEPS;
+}
+
+module.exports = {
+  register,
+  getSteps,
+  SETUP_STEPS,
+};