AionUi 安装部署与快速上手完整指南：免费多智能体 AI 界面 10 分钟从零跑起来？-迪斯科星球

AionUi 安装部署与快速上手完整指南：免费多智能体 AI 界面 10 分钟从零跑起来？

【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20+ more CLI Agent | Customize your assistants | Team them up｜Star if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi

AionUi 是一款免费、开源、本地运行的多智能体 AI 图形化界面，内置 Agent 引擎，接入 Claude Code、Codex、OpenCode 等 20+ CLI 智能体。装完你得到一个能读写文件、生成文档、手机远程访问的 AI 工作台。

装完你能得到什么

内置 Agent，零配置：不用装 CLI，粘贴任意 API Key 即可使用，读写文件、生成 PPT/Word/Excel、联网搜索、MCP 工具
21 个现成助手：Cowork、PPT Creator、Excel Creator 等，开箱即用
多智能体接入：自动检测已装的 Claude Code、Codex、Qwen Code 等，一个界面统一管理
跨设备访问：WebUI + 定时任务，手机上也能 24/7 盯任务

30 秒环境自检

确认下面三项就绪，再动手安装：

Git：用于克隆仓库
Node.js 22+：项目要求>=22 <25，建议直接用 v22（官网或用nvm install 22安装）
npm：随 Node.js 自带，无需单独装

Ubuntu/Debian 下缺 Git 可一行补上：

sudo apt update && sudo apt install -y git

装好后可用node -v确认版本是否为 22 及以上。

从零到跑起来的最短路径

先在终端把仓库克隆到本地：

git clone https://gitcode.com/GitHub_Trending/ai/AionUi

克隆完成后，进入项目根目录：

cd AionUi

接着安装全部依赖，会下载 Electron 等较大依赖，视网络情况约需 3~5 分钟：

npm install

依赖装好后启动应用，约 30 秒弹出 AionUi 桌面窗口：

npm start

窗口出现即代表安装成功，可进入配置环节。

首次配置与核心体验

配一个模型：点左下角「设置」→「LLM/模型管理」，选择平台（Gemini、OpenAI、Anthropic、Ollama 等 30+ 平台），填入 API Key 并保存。
用内置助手跑个任务：新建对话选 Cowork 或 Excel Creator 等助手，输入需求，即可生成可编辑文档，无需切应用。
多模型切换与远程访问：输入框下方选择不同模型对比响应；另开终端启动 Web 端，用浏览器或手机访问。

启动 Web 端（另开一个终端）：

npm run webui

启动后按终端输出的地址访问，开发模式默认http://localhost:25809，以实际输出为准；局域网访问可加--remote。

跑不起来时：问题速查

npm install报依赖错误→ 确认 Node 为 22+；删除node_modules后重装
npm start无窗口弹出→ 确认依赖装完；Linux 需补齐运行库，参考 docs/guides/deploy-server.md
WebUI 端口占用→ 设置AIONUI_PORT换端口，或看终端输出确认实际端口
API Key 不生效 / 报 401→ 核对 Key 与所选平台是否匹配、权限是否足够
远程访问打不开→ 确认已加--remote且设备在同一网络，详见 docs/guides/webui.md

🚀 AionUi 把命令行智能体变成了人人能用的图形化工作台，免费开源、数据本地存储。现在就按上面最短路径跑起来，粘贴一个 API Key，几分钟内让 AI 帮你整理文件、生成文档，甚至手机上远程盯任务。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析