NexoraAgent
See the code
✨ 贯通大模型生态与全渠道社交终端的零信任本地主权 AI 自动化中枢 ✨
Engineered for Absolute Privacy 🛡️. Powered by Local Intelligence 🧠. Driven by Zero-Trust Architecture 🔒.
🐣 小白零门槛安装教程 • 💡 系统用途与应用场景 • 🖥️ 主要功能介绍 • 🔄 系统运行全流程与机制 • 🏛️ 四层主权架构白皮书 • 🛠️ 自愈诊断与故障排查
███╗ ██╗███████╗██╗ ██╗██████╗ ██████╗ █████╗ █████╗ ██████╗ ███████╗██╗ ██╗████████╗
████╗ ██║██╔════╝╚██╗██╔╝██╔══██╗██╔══██╗██╔══██╗ ██╔══██╗██╔════╝ ██╔════╝██║ ██║╚══██╔══╝
██╔██╗ ██║█████╗ ╚███╔╝ ██████╔╝██████╔╝███████║ ███████║██║ ███╗█████╗ ███████║ ██║
██║╚██╗██║██╔══╝ ██╔██╗ ██╔══██╗██╔══██╗██╔══██║ ██╔══██║██║ ██║██╔══╝ ██╔══██║ ██║
██║ ╚████║███████╗██╔╝ ██╗██║ ██║██║ ██║██║ ██║ ██║ ██║╚██████╔╝███████╗██║ ██║ ██║
╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝ ╚═╝
┌─────────────────────────────────────────────────────────────────────────────────────────────┐
│ 🚀 NEXORA AGENT KERNEL TELEMETRY (SOVEREIGN ENGINE LIVE BOOT STREAM) │
├─────────────────────────────────────────────────────────────────────────────────────────────┤
│ [SYSTEM] Bootstrapping Nexora Agent Core Engine... [SUCCESS 🟢] │
│ [SANDBOX] Attached Portable Node.js LTS Hardened Environment (18ms ⚡) │
│ [ROUTER] Omni-Channel Connectors Loaded: WeChat 🟢, Feishu 🔷, QQBot 🐧, Slack 💬 │
│ [RECONNECT] Exponential Backoff Circuit Breaker Primed. Auto-Retry Floor: Infinity │
│ [MEMORY] Incremental Long-Term Memory Synced (~/.openclaw/MEMORY.md). Deduplicated. 🧠 │
│ [ROLLOVER] Session Overflow Rollover Circuit Armed. Auto-Compaction Ready. 🔄 │
│ [SKILLS] Loaded Native Skill Plugins: Image 🎨, Video 🎬, Desktop RPA 🖱️ │
│ [METRICS] Data Center Telemetry Service Initialized on Local IPC Pipeline. 📊 │
│ [GATEWAY] Gateway Online at http://127.0.0.1:18789. All Systems Operational 🌌 │
└─────────────────────────────────────────────────────────────────────────────────────────────┘
即使您完全没有任何编程基础或电脑技术背景,只需按照以下 4 个极简步骤,即可在 3 分钟内 完成搭建并让 AI 助手代替您在微信、飞书或 QQ 中自动答复!✨
flowchart LR
A[📦 1. 下载一键安装包] --> B[🚀 2. 点击「启动服务」]
B --> C[🔑 3. 填入 API Key 脑区]
C --> D[📱 4. 手机微信扫码授权]
D --> E[🎉 托管成功!AI 自动代答]
[!TIP] 💡 准备工作(仅需 2 样东西):
- 一台普通的 Windows 10 或 Windows 11 电脑(不需要高性能显卡)。
- 一个大模型厂商的 API Key(推荐使用 DeepSeek 或 阿里云百炼,注册即送免费试用额度)。
Nexora-Agent-Setup-2.0.5.exe(Windows x64)。其他版本见 Releases。.exe 文件。向导会自动选择最佳路径安装,并在桌面建立 Nexora Agent 赛博风快捷启动图标。Nexora Agent。端口: 18789 提示,表示 AI 大脑中枢已在本地成功唤醒。DeepSeek 或 阿里云百炼)。sk-xxxxxxxxx),粘贴到密钥输入框中。🟢 连通成功 (延迟 xx ms),代表 AI 大脑已成功连通!Nexora Agent 是一款面向个人智囊、企业私域与自动化运维的 零信任本地主权 AI 自动化中枢 🛡️。它将各大公有云/私有化大模型的认知能力与微信、飞书、QQ、钉钉等全渠道社交终端及物理操作系统无缝无痕无感连接 🔗。
graph TD
A[👥 用户及团队终端<br/>💬 微信 / 🔷 飞书 / 🐧 QQ / 🌐 网页] -->|🛡️ 安全隔离通讯| B(🤖 Nexora Agent 本地主权中枢)
B -->|🔒 零信任加密通道| C[🧠 大模型矩阵<br/>⚡ DeepSeek / ☁️ 阿里云百炼 / 🚀 SiliconFlow / 🏠 离线Ollama]
B -->|🖱️ 本地自动化控制| D[🖥️ 物理操作系统控制<br/>⚙️ Win32 API / 📷 屏幕截屏 / 📁 文件读写]
B -->|🎨 本地媒体生成| E[🛠️ 技能中心<br/>🎨 文生图 / 🎬 文生视频]
B -->|📊 全盘数据监控| F[📈 数据中心 Dashboard<br/>💻 CPU / 🧠 GPU / 🪙 Token 消耗 / 🌊 流量流速]
user32.dll 驱动模拟物理鼠标点击与键盘敲击,自动完成表单填写、软件测试与数据抓取。
🛡️ 零信任物理隔离Zero-Trust Physical Isolation🔒 所有的聊天日志、通讯凭证与记忆切片 100% 存放在本机磁盘,不经过任何第三方中间件。私密数据绝对不出本机。 |
⚡ 无限退避自动重连High-Availability Circuit Breaker🔄 独创 v3 智能心跳监测算法。遇到局域网闪断或路由重启,自动开启指数退避静默热重连,45 秒内自适应恢复上线。 |
🧠 增量长期记忆中枢Markdown Long-Term Memory📝 内置记忆自动提取与去重引擎。将用户的偏好与设定增量沉淀至本地 Markdown 库,跨会话自动注入 Prompt,打造越用越聪明的专属 AI 人格。 |
🖥️ 物理级 Win32 桌面控制Win32 Synthetic Actuator🖱️ 穿透 DPI 动态缩放,调用 user32.dll 物理事件驱动。大模型可如真人般操控 Windows 桌面,完成截图、点击与按键自动化。 |
🔄 超长会话无缝滚存Session Overflow Rollover📑 突破 Token 长度限制。当会话超出上下文阈值时,自动提取关键摘要并滚存至新会话,保持长期对话连续不中断。 |
🛠️ 技能扩展中枢Native Skill Center🎨 提供生图、生视频、抓屏与网络诊断等多维技能插件,支持热加载与灵活调度,大幅扩展大模型的能力边界。 |
📊 数据中心仪表盘Data Center Telemetry📈 提供全盘可视化监控,实时图表展示 CPU/内存/网络吞吐量及 Token 消耗动态,系统健康度一清二楚。 | ||
以下介绍常用功能面板及其主要用途:
┌─────────────────────────┬───────────────────────────────────────────────────────────────────────┐
│ NEXORA AGENT NAV 🚀 │ 🟢 核心服务就绪 | 端口: 18789 [ 🚀 启动/终止 ] [ 🔍 探针诊断 ] │
├─────────────────────────┼───────────────────────────────────────────────────────────────────────┤
│ ⚡ 1. 控制面板 │ 🚀 核心服务控制台、三色指示灯状态控制、启动探针管理与负载微波图 │
│ 📱 2. 通讯管理 │ 📱 微信/飞书/QQ/Slack/Matrix 全渠道机器人卡片与 Base64 扫码绑定 │
│ 🧠 3. 模型配置 │ 🔑 大模型厂商 API Key 注入、模型探针延迟测试、识图视觉模型自动对齐 │
│ 🎭 4. 模型角色 │ 🎭 系统 Prompt 提示词预设、AI 人格语气与专家角色模板库 │
│ 💬 5. 模型会话 │ 💬 实时 AI 对话交互、模型下拉切换、富媒体气泡与无缝滚存提示 │
│ 🦞 6. OpenClaw │ 🦞 原生底层 Web 管理面板无缝嵌套与赛博暗黑 CSS 主题自动同步 │
│ 📈 7. 用量监控 │ 🪙 Token 消费统计、模型调用频次与首字延迟 (TTFT) 深度耗时分析 │
│ 🧩 8. 内置插件 │ 🧩 8 大内置扩展插件生态列表、启停开关与热加载参数控制 │
│ 🛠️ 9. 技能中心 │ 🎨 文生图、🎬 文生视频、🖱️ 物理桌面 RPA、📷 网页截屏技能扩展 │
│ 📂 10. 会话归档 │ 📁 历史超长会话检索、关键字搜索、滚存备份记录查看与 Markdown 导出 │
│ 📊 11. 数据总览 │ 📈 可视化 ECharts 仪表盘、CPU/内存/网络带宽/Token 消耗实时折线图 │
│ 💻 12. 内置终端 │ 💻 免安装便携 PTY 伪终端控制台,支持命令行脚本直接交互与诊断 │
│ 📜 13. 运行日志 │ 📜 毫秒级时间戳流式 stdout/stderr 日志捕获与级别过滤视界 │
│ ⚙️ 14. 系统设置 │ ⚙️ 多语言切换 (i18n)、开机自启、高级参数与 Doctor 诊断面板 │
└─────────────────────────┴───────────────────────────────────────────────────────────────────────┘
console-view)18789)开启监听,随时响应全渠道请求。http://127.0.0.1:18789)。gateway-boot-harden.js,自动擦除异常残留锁并挂载便携 .node-sandbox 环境。communication-view)config-view)image 兼容,防止传图时报错。roles-view)chat-view)openclaw-panel-view)dashboard-view)plugins-view)error-filter、session-overflow-rollover、memory-rotate 等已加载的插件。skills-view)session-archive-view).txt 或 Markdown .md 文件。data-center-view)terminal-view)syslogs-view)ALL、INFO、WARN、ERROR 进行快速过滤。settings-view)sequenceDiagram
autonumber
actor User as 👤 用户
participant Main as 🖥️ Electron 主进程
participant Sandbox as 📦 免安装 Node.js 沙箱
participant Gateway as 🦞 OpenClaw 网关引擎
User->>Main: 点击「🚀 启动 Nexora Agent」
Main->>Sandbox: 挂载 .node-sandbox 便携环境 (18ms ⚡)
Sandbox->>Gateway: 拉起 start-gateway.js (端口 18789)
Gateway-->>Main: 输出 "Gateway Online" 标志位
Main->>User: 状态灯置绿 🟢 (核心服务就绪)
flowchart TD
A[📱 外部社交平台<br/>🟢 微信 / 🔷 飞书 / 🐧 QQ] -->|接收消息| B[📱 通讯管理适配器]
B -->|格式标准化| C[🧠 OpenClaw LLM 统一路由]
C -->|调用配置的模型 API| E[☁️ 公有云 / 私有云大模型]
E -->|返回回复内容| C
C -->|解析技能 / 媒体指令| F{🎨 包含 MEDIA 指令?}
F -- 是 --> G[🎨 生成本地图片/视频/截图]
F -- 否 --> H[💬 纯文本 Markdown 渲染]
G --> I[✨ 气泡直接富媒体渲染并回复社交终端]
H --> I
I -->|回复消息| A
flowchart LR
A[📩 收到新消息] --> B(🪙 计算当前会话总 Token 数)
B --> C{📊 是否达到溢出门槛?<br/>reserveTokensFloor}
C -- 否 --> D[💬 正常追加上下文并发起对话]
C -- 是 --> E[🔄 激活 Session Rollover 滚存回路]
E --> F[📝 自动提取前文关键事实与记忆碎片]
F --> G[📁 创建新 Session 隔离区]
G --> H[📌 注入摘要头信息保持上下文连贯]
H --> D
Nexora Agent 采用了分层解耦的四层软件架构设计,保障了系统的极高可靠性与扩展性 💎:
+-----------------------------------------------------------------------------------+
| Layer 3: Omni-Channel Actuators & Interface (全双工适配与交互层 📱) |
| - WeChat Connector 🟢 / Feishu Connector 🔷 / QQBot Connector 🐧 |
| - Inline Media Rich-Text Bubble Renderer & Data Center Telemetry 📊 |
+-----------------------------------------------------------------------------------+
│ (JSON-RPC / WebSockets / IPC)
▼
+-----------------------------------------------------------------------------------+
| Layer 2: Cognitive Engine & Memory Matrix (认知智能与记忆中枢层 🧠) |
| - OpenClaw LLM Router & Unified OpenAI Protocol Translator |
| - Markdown-based Incremental Long-Term Memory Deduplicator (MEMORY.md) 📝 |
| - Context Compaction & Token Salience Floor (reserveTokensFloor) |
| - Automatic Session Overflow Seamless Rollover Engine 🔄 |
+-----------------------------------------------------------------------------------+
│ (IPC / Process Lifecycle)
▼
+-----------------------------------------------------------------------------------+
| Layer 1: Gateway Lifecycle & Recovery (网关生命周期与故障恢复层 🛠️) |
| - Automatic Crash-Loop Breaker Bypass & Override Handler 🛠️ |
+-----------------------------------------------------------------------------------+
│ (Win32 System Calls & Native Addons)
▼
+-----------------------------------------------------------------------------------+
| Layer 0: Hardware, Runtime & OS Sandbox (物理硬件与系统沙箱层 📦) |
| - Portable Node.js LTS Sandbox & node:sqlite Engine |
| - Win32 User32.dll Direct Input Driver (Synthetic Mouse/Keyboard Injection) 🖱️ |
| - Multi-Monitor High-DPI Desktop Capture Engine 📷 |
+-----------------------------------------------------------------------------------+
[!NOTE] 💡 常见的系统运行问题均可根据以下排查指南在数秒内完成自主修复:
| 🔍 故障现象 | ⚠️ 底层诱发原因 | 🛠️ 自愈排查解决方案 |
|---|---|---|
通道提示 crash-loop breaker tripped | 多次强制杀死进程导致异常关机计数超限 | 最新系统已内置自愈。点击「终止服务」后再点击「启动」,主进程会自动擦除锁定标号。 |
| 微信连接成功但网络断开后不自动恢复 | 网络波动引发 WebSocket 物理连接断开 | 系统已内置 v3 高可用重连引擎,网络恢复后 45 秒内自动静默热重连,无需重新扫码。 |
| 扫码后提示二维码失效 | 二维码生成超时或手机确认时间过长 | 在「通讯管理」中点击「重新生成二维码」,掏出手机即刻扫描并点击确认。 |
macOS 支持:在 Mac 上运行 npm run app:dist:mac 构建对应架构的 DMG/ZIP,包含独立 Node/npm 运行时。环境要求、验证和签名说明见 macOS 构建文档。
# 克隆项目代码仓库
git clone https://github.com/2014-y/NexoraAgent.git
cd NexoraAgent
# 安装本地依赖
npm install
# 启动 Electron 本地开发调试模式
npm run app:start
# 构建一键安装包 (NSIS Installer)
npm run app:dist
在 plugins/my-custom-skill/ 目录下创建 index.js:
'use strict';
class CustomSkillPlugin {
constructor(context) {
this.ctx = context; // 注入系统主权上下文
}
async onload() {
this.ctx.log?.info('[CustomSkill] 技能插件成功加载');
// 注册自定义路由或工具监听
}
async onunload() {
this.ctx.log?.info('[CustomSkill] 技能插件已卸载');
}
}
module.exports = CustomSkillPlugin;
本项目基于 MIT License 开源协议发布。您可以自由修改、商业化部署、二次开发或分发。
636 commits
JavaScript
80.1%
TypeScript
6.4%
HTML
5.0%
CSS
4.3%
Shell
1.5%
PowerShell
1.4%
NexoraAgent
See the code
✨ 贯通大模型生态与全渠道社交终端的零信任本地主权 AI 自动化中枢 ✨
Engineered for Absolute Privacy 🛡️. Powered by Local Intelligence 🧠. Driven by Zero-Trust Architecture 🔒.
🐣 小白零门槛安装教程 • 💡 系统用途与应用场景 • 🖥️ 主要功能介绍 • 🔄 系统运行全流程与机制 • 🏛️ 四层主权架构白皮书 • 🛠️ 自愈诊断与故障排查
███╗ ██╗███████╗██╗ ██╗██████╗ ██████╗ █████╗ █████╗ ██████╗ ███████╗██╗ ██╗████████╗
████╗ ██║██╔════╝╚██╗██╔╝██╔══██╗██╔══██╗██╔══██╗ ██╔══██╗██╔════╝ ██╔════╝██║ ██║╚══██╔══╝
██╔██╗ ██║█████╗ ╚███╔╝ ██████╔╝██████╔╝███████║ ███████║██║ ███╗█████╗ ███████║ ██║
██║╚██╗██║██╔══╝ ██╔██╗ ██╔══██╗██╔══██╗██╔══██║ ██╔══██║██║ ██║██╔══╝ ██╔══██║ ██║
██║ ╚████║███████╗██╔╝ ██╗██║ ██║██║ ██║██║ ██║ ██║ ██║╚██████╔╝███████╗██║ ██║ ██║
╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚═╝ ╚═╝ ╚═╝
┌─────────────────────────────────────────────────────────────────────────────────────────────┐
│ 🚀 NEXORA AGENT KERNEL TELEMETRY (SOVEREIGN ENGINE LIVE BOOT STREAM) │
├─────────────────────────────────────────────────────────────────────────────────────────────┤
│ [SYSTEM] Bootstrapping Nexora Agent Core Engine... [SUCCESS 🟢] │
│ [SANDBOX] Attached Portable Node.js LTS Hardened Environment (18ms ⚡) │
│ [ROUTER] Omni-Channel Connectors Loaded: WeChat 🟢, Feishu 🔷, QQBot 🐧, Slack 💬 │
│ [RECONNECT] Exponential Backoff Circuit Breaker Primed. Auto-Retry Floor: Infinity │
│ [MEMORY] Incremental Long-Term Memory Synced (~/.openclaw/MEMORY.md). Deduplicated. 🧠 │
│ [ROLLOVER] Session Overflow Rollover Circuit Armed. Auto-Compaction Ready. 🔄 │
│ [SKILLS] Loaded Native Skill Plugins: Image 🎨, Video 🎬, Desktop RPA 🖱️ │
│ [METRICS] Data Center Telemetry Service Initialized on Local IPC Pipeline. 📊 │
│ [GATEWAY] Gateway Online at http://127.0.0.1:18789. All Systems Operational 🌌 │
└─────────────────────────────────────────────────────────────────────────────────────────────┘
即使您完全没有任何编程基础或电脑技术背景,只需按照以下 4 个极简步骤,即可在 3 分钟内 完成搭建并让 AI 助手代替您在微信、飞书或 QQ 中自动答复!✨
flowchart LR
A[📦 1. 下载一键安装包] --> B[🚀 2. 点击「启动服务」]
B --> C[🔑 3. 填入 API Key 脑区]
C --> D[📱 4. 手机微信扫码授权]
D --> E[🎉 托管成功!AI 自动代答]
[!TIP] 💡 准备工作(仅需 2 样东西):
- 一台普通的 Windows 10 或 Windows 11 电脑(不需要高性能显卡)。
- 一个大模型厂商的 API Key(推荐使用 DeepSeek 或 阿里云百炼,注册即送免费试用额度)。
Nexora-Agent-Setup-2.0.5.exe(Windows x64)。其他版本见 Releases。.exe 文件。向导会自动选择最佳路径安装,并在桌面建立 Nexora Agent 赛博风快捷启动图标。Nexora Agent。端口: 18789 提示,表示 AI 大脑中枢已在本地成功唤醒。DeepSeek 或 阿里云百炼)。sk-xxxxxxxxx),粘贴到密钥输入框中。🟢 连通成功 (延迟 xx ms),代表 AI 大脑已成功连通!Nexora Agent 是一款面向个人智囊、企业私域与自动化运维的 零信任本地主权 AI 自动化中枢 🛡️。它将各大公有云/私有化大模型的认知能力与微信、飞书、QQ、钉钉等全渠道社交终端及物理操作系统无缝无痕无感连接 🔗。
graph TD
A[👥 用户及团队终端<br/>💬 微信 / 🔷 飞书 / 🐧 QQ / 🌐 网页] -->|🛡️ 安全隔离通讯| B(🤖 Nexora Agent 本地主权中枢)
B -->|🔒 零信任加密通道| C[🧠 大模型矩阵<br/>⚡ DeepSeek / ☁️ 阿里云百炼 / 🚀 SiliconFlow / 🏠 离线Ollama]
B -->|🖱️ 本地自动化控制| D[🖥️ 物理操作系统控制<br/>⚙️ Win32 API / 📷 屏幕截屏 / 📁 文件读写]
B -->|🎨 本地媒体生成| E[🛠️ 技能中心<br/>🎨 文生图 / 🎬 文生视频]
B -->|📊 全盘数据监控| F[📈 数据中心 Dashboard<br/>💻 CPU / 🧠 GPU / 🪙 Token 消耗 / 🌊 流量流速]
user32.dll 驱动模拟物理鼠标点击与键盘敲击,自动完成表单填写、软件测试与数据抓取。
🛡️ 零信任物理隔离Zero-Trust Physical Isolation🔒 所有的聊天日志、通讯凭证与记忆切片 100% 存放在本机磁盘,不经过任何第三方中间件。私密数据绝对不出本机。 |
⚡ 无限退避自动重连High-Availability Circuit Breaker🔄 独创 v3 智能心跳监测算法。遇到局域网闪断或路由重启,自动开启指数退避静默热重连,45 秒内自适应恢复上线。 |
🧠 增量长期记忆中枢Markdown Long-Term Memory📝 内置记忆自动提取与去重引擎。将用户的偏好与设定增量沉淀至本地 Markdown 库,跨会话自动注入 Prompt,打造越用越聪明的专属 AI 人格。 |
🖥️ 物理级 Win32 桌面控制Win32 Synthetic Actuator🖱️ 穿透 DPI 动态缩放,调用 user32.dll 物理事件驱动。大模型可如真人般操控 Windows 桌面,完成截图、点击与按键自动化。 |
🔄 超长会话无缝滚存Session Overflow Rollover📑 突破 Token 长度限制。当会话超出上下文阈值时,自动提取关键摘要并滚存至新会话,保持长期对话连续不中断。 |
🛠️ 技能扩展中枢Native Skill Center🎨 提供生图、生视频、抓屏与网络诊断等多维技能插件,支持热加载与灵活调度,大幅扩展大模型的能力边界。 |
📊 数据中心仪表盘Data Center Telemetry📈 提供全盘可视化监控,实时图表展示 CPU/内存/网络吞吐量及 Token 消耗动态,系统健康度一清二楚。 | ||
以下介绍常用功能面板及其主要用途:
┌─────────────────────────┬───────────────────────────────────────────────────────────────────────┐
│ NEXORA AGENT NAV 🚀 │ 🟢 核心服务就绪 | 端口: 18789 [ 🚀 启动/终止 ] [ 🔍 探针诊断 ] │
├─────────────────────────┼───────────────────────────────────────────────────────────────────────┤
│ ⚡ 1. 控制面板 │ 🚀 核心服务控制台、三色指示灯状态控制、启动探针管理与负载微波图 │
│ 📱 2. 通讯管理 │ 📱 微信/飞书/QQ/Slack/Matrix 全渠道机器人卡片与 Base64 扫码绑定 │
│ 🧠 3. 模型配置 │ 🔑 大模型厂商 API Key 注入、模型探针延迟测试、识图视觉模型自动对齐 │
│ 🎭 4. 模型角色 │ 🎭 系统 Prompt 提示词预设、AI 人格语气与专家角色模板库 │
│ 💬 5. 模型会话 │ 💬 实时 AI 对话交互、模型下拉切换、富媒体气泡与无缝滚存提示 │
│ 🦞 6. OpenClaw │ 🦞 原生底层 Web 管理面板无缝嵌套与赛博暗黑 CSS 主题自动同步 │
│ 📈 7. 用量监控 │ 🪙 Token 消费统计、模型调用频次与首字延迟 (TTFT) 深度耗时分析 │
│ 🧩 8. 内置插件 │ 🧩 8 大内置扩展插件生态列表、启停开关与热加载参数控制 │
│ 🛠️ 9. 技能中心 │ 🎨 文生图、🎬 文生视频、🖱️ 物理桌面 RPA、📷 网页截屏技能扩展 │
│ 📂 10. 会话归档 │ 📁 历史超长会话检索、关键字搜索、滚存备份记录查看与 Markdown 导出 │
│ 📊 11. 数据总览 │ 📈 可视化 ECharts 仪表盘、CPU/内存/网络带宽/Token 消耗实时折线图 │
│ 💻 12. 内置终端 │ 💻 免安装便携 PTY 伪终端控制台,支持命令行脚本直接交互与诊断 │
│ 📜 13. 运行日志 │ 📜 毫秒级时间戳流式 stdout/stderr 日志捕获与级别过滤视界 │
│ ⚙️ 14. 系统设置 │ ⚙️ 多语言切换 (i18n)、开机自启、高级参数与 Doctor 诊断面板 │
└─────────────────────────┴───────────────────────────────────────────────────────────────────────┘
console-view)18789)开启监听,随时响应全渠道请求。http://127.0.0.1:18789)。gateway-boot-harden.js,自动擦除异常残留锁并挂载便携 .node-sandbox 环境。communication-view)config-view)image 兼容,防止传图时报错。roles-view)chat-view)openclaw-panel-view)dashboard-view)plugins-view)error-filter、session-overflow-rollover、memory-rotate 等已加载的插件。skills-view)session-archive-view).txt 或 Markdown .md 文件。data-center-view)terminal-view)syslogs-view)ALL、INFO、WARN、ERROR 进行快速过滤。settings-view)sequenceDiagram
autonumber
actor User as 👤 用户
participant Main as 🖥️ Electron 主进程
participant Sandbox as 📦 免安装 Node.js 沙箱
participant Gateway as 🦞 OpenClaw 网关引擎
User->>Main: 点击「🚀 启动 Nexora Agent」
Main->>Sandbox: 挂载 .node-sandbox 便携环境 (18ms ⚡)
Sandbox->>Gateway: 拉起 start-gateway.js (端口 18789)
Gateway-->>Main: 输出 "Gateway Online" 标志位
Main->>User: 状态灯置绿 🟢 (核心服务就绪)
flowchart TD
A[📱 外部社交平台<br/>🟢 微信 / 🔷 飞书 / 🐧 QQ] -->|接收消息| B[📱 通讯管理适配器]
B -->|格式标准化| C[🧠 OpenClaw LLM 统一路由]
C -->|调用配置的模型 API| E[☁️ 公有云 / 私有云大模型]
E -->|返回回复内容| C
C -->|解析技能 / 媒体指令| F{🎨 包含 MEDIA 指令?}
F -- 是 --> G[🎨 生成本地图片/视频/截图]
F -- 否 --> H[💬 纯文本 Markdown 渲染]
G --> I[✨ 气泡直接富媒体渲染并回复社交终端]
H --> I
I -->|回复消息| A
flowchart LR
A[📩 收到新消息] --> B(🪙 计算当前会话总 Token 数)
B --> C{📊 是否达到溢出门槛?<br/>reserveTokensFloor}
C -- 否 --> D[💬 正常追加上下文并发起对话]
C -- 是 --> E[🔄 激活 Session Rollover 滚存回路]
E --> F[📝 自动提取前文关键事实与记忆碎片]
F --> G[📁 创建新 Session 隔离区]
G --> H[📌 注入摘要头信息保持上下文连贯]
H --> D
Nexora Agent 采用了分层解耦的四层软件架构设计,保障了系统的极高可靠性与扩展性 💎:
+-----------------------------------------------------------------------------------+
| Layer 3: Omni-Channel Actuators & Interface (全双工适配与交互层 📱) |
| - WeChat Connector 🟢 / Feishu Connector 🔷 / QQBot Connector 🐧 |
| - Inline Media Rich-Text Bubble Renderer & Data Center Telemetry 📊 |
+-----------------------------------------------------------------------------------+
│ (JSON-RPC / WebSockets / IPC)
▼
+-----------------------------------------------------------------------------------+
| Layer 2: Cognitive Engine & Memory Matrix (认知智能与记忆中枢层 🧠) |
| - OpenClaw LLM Router & Unified OpenAI Protocol Translator |
| - Markdown-based Incremental Long-Term Memory Deduplicator (MEMORY.md) 📝 |
| - Context Compaction & Token Salience Floor (reserveTokensFloor) |
| - Automatic Session Overflow Seamless Rollover Engine 🔄 |
+-----------------------------------------------------------------------------------+
│ (IPC / Process Lifecycle)
▼
+-----------------------------------------------------------------------------------+
| Layer 1: Gateway Lifecycle & Recovery (网关生命周期与故障恢复层 🛠️) |
| - Automatic Crash-Loop Breaker Bypass & Override Handler 🛠️ |
+-----------------------------------------------------------------------------------+
│ (Win32 System Calls & Native Addons)
▼
+-----------------------------------------------------------------------------------+
| Layer 0: Hardware, Runtime & OS Sandbox (物理硬件与系统沙箱层 📦) |
| - Portable Node.js LTS Sandbox & node:sqlite Engine |
| - Win32 User32.dll Direct Input Driver (Synthetic Mouse/Keyboard Injection) 🖱️ |
| - Multi-Monitor High-DPI Desktop Capture Engine 📷 |
+-----------------------------------------------------------------------------------+
[!NOTE] 💡 常见的系统运行问题均可根据以下排查指南在数秒内完成自主修复:
| 🔍 故障现象 | ⚠️ 底层诱发原因 | 🛠️ 自愈排查解决方案 |
|---|---|---|
通道提示 crash-loop breaker tripped | 多次强制杀死进程导致异常关机计数超限 | 最新系统已内置自愈。点击「终止服务」后再点击「启动」,主进程会自动擦除锁定标号。 |
| 微信连接成功但网络断开后不自动恢复 | 网络波动引发 WebSocket 物理连接断开 | 系统已内置 v3 高可用重连引擎,网络恢复后 45 秒内自动静默热重连,无需重新扫码。 |
| 扫码后提示二维码失效 | 二维码生成超时或手机确认时间过长 | 在「通讯管理」中点击「重新生成二维码」,掏出手机即刻扫描并点击确认。 |
macOS 支持:在 Mac 上运行 npm run app:dist:mac 构建对应架构的 DMG/ZIP,包含独立 Node/npm 运行时。环境要求、验证和签名说明见 macOS 构建文档。
# 克隆项目代码仓库
git clone https://github.com/2014-y/NexoraAgent.git
cd NexoraAgent
# 安装本地依赖
npm install
# 启动 Electron 本地开发调试模式
npm run app:start
# 构建一键安装包 (NSIS Installer)
npm run app:dist
在 plugins/my-custom-skill/ 目录下创建 index.js:
'use strict';
class CustomSkillPlugin {
constructor(context) {
this.ctx = context; // 注入系统主权上下文
}
async onload() {
this.ctx.log?.info('[CustomSkill] 技能插件成功加载');
// 注册自定义路由或工具监听
}
async onunload() {
this.ctx.log?.info('[CustomSkill] 技能插件已卸载');
}
}
module.exports = CustomSkillPlugin;
本项目基于 MIT License 开源协议发布。您可以自由修改、商业化部署、二次开发或分发。
636 commits
JavaScript
80.1%
TypeScript
6.4%
HTML
5.0%
CSS
4.3%
Shell
1.5%
PowerShell
1.4%