AionUi

这是什么？适合谁？

AionUi（github.com/iOfficeAI/AionUi，约 32.2k Stars，Apache-2.0）是一款免费开源的多 AI Agent Cowork（协同办公）桌面应用，官方定位是「Open-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20+ more CLI Agent」。它不是一个普通的聊天客户端，而是一个让多个 AI Agent 在你的电脑上「并肩工作」的平台：读写文件、写代码、浏览网页、定时跑任务，全程可视化，随时可介入审批。

与 Anthropic 推出的 Claude Cowork 相比，AionUi 常被称为它的「开源跨平台增强版」。Claude Cowork 仅支持 macOS、且锁定 Claude 模型、月费高达 $100；AionUi 则同时支持 macOS / Windows / Linux，可接入 Gemini、Claude、DeepSeek、OpenAI、Ollama 等 30+ 平台模型，还额外提供 Cron 定时任务（24/7 无人值守）与 WebUI / Telegram / 飞书 / 钉钉 / 微信远程通道，且完全免费。与 OpenClaw（另一款多平台 Agent 网关）相比，AionUi 的特点是内置 Agent 引擎、开箱即用——不需要先装好各类 CLI Agent 也能直接工作。

适合谁：① 想用 AI 自动整理文件、生成 PPT/Word/Excel 的办公用户；② 已在使用 Claude Code、Codex、Hermes 等 CLI Agent、想在一个界面统一管理的开发者；③ 需要 24/7 定时跑报表、巡检、汇总的运营/技术团队。

使用前提：会下载安装桌面应用即可（自带 Agent，零配置起步）；进阶玩法（多 Agent 团队、WebUI 远程）需要基础的 API Key 概念。

准备工作

1. 系统要求（来自官方 README）：macOS 10.15+ / Windows 10+ / Ubuntu 18.04+（Debian 10+、Fedora 32+），内存 4GB+ 推荐，磁盘 500MB+。
2. 安装包获取：从 GitHub Releases 下载对应平台安装程序；macOS 也可用 Homebrew：

   brew install aionui
   

3. API Key（任选其一即可）：AionUi 本身免费，但需要你自带模型 Key（BYOK）。常见来源：DeepSeek（platform.deepseek.com）、OpenAI、Anthropic、Google Gemini、Moonshot Kimi、智谱、通义 Dashscope 等；也支持 Ollama / LM Studio 本地模型（无需 Key）。
4. 前置知识：无硬性要求。官方明确「无需先安装 Gemini CLI 或 Claude Code」——内置 Agent 装完即用；若你已装 CLI Agent，AionUi 会自动检测并接入。
5. 替代方案：若你只想要轻量多平台 Agent 网关，可考虑 OpenClaw；若你只用单一 CLI，直接用 Claude Code / Codex 即可；若你更需要的是「目录式发现工具」而非桌面 Cowork，可看本站的 awesome-deepseek-harness 插件清单。

快速上手（4步）

第一步：安装并启动

从 Releases 下载安装包，双击安装后启动；macOS 也可 brew install aionui。预期结果：打开主界面，看到内置助手列表（Cowork、PPT Creator、Word Creator 等 21 个专业助手）。

第二步：填入 API Key

进入「设置 → 模型配置」，粘贴任意一个平台的 API Key（例如 DeepSeek 的 sk-...），选择对应模型。预期结果：模型选择器里出现该平台模型，可以正常发起对话。

第三步：跑第一个 Cowork 任务

在对话框输入一句自然语言指令，例如：

请帮我整理「下载」文件夹：按 文档/图片/安装包 分类，并把重复文件列出来

预期结果：内置 Agent 自动规划并执行文件操作，右侧预览面板实时展示改动，每一步操作你都可以确认或拒绝。

第四步：接入你的 CLI Agent（可选）

如果你本机已装了 Claude Code / Codex / Hermes，AionUi 会自动检测到它们。进入「多 Agent 模式」选择对应 Agent，即可在统一界面里用你自己的 CLI Agent 继续 Cowork。预期结果：同一会话里可以切换/并行多个 Agent，各自独立上下文。

常见踩坑（7条）

踩坑 1：升级到某版本后登录失败

• 现象：更新到 .49 等版本后无法登录（#3876）。
• 原因：版本回归 bug，登录逻辑改动引入问题。
• 解决：到 Releases 回退到上一个稳定版本，并在 issue 下反馈版本号与日志。

踩坑 2：挂代理/科学上网时 OAuth 个人认证失败

• 现象：代理开启状态下，第三方平台 OAuth 登录一直转圈或报错（#18）。
• 原因：代理拦截了 OAuth 回调请求。
• 解决：临时关闭系统代理后再走 OAuth；或改用「粘贴 API Key」方式绕过 OAuth。

踩坑 3：WebUI 配对码登录后「退出登录」不生效

• 现象：网页端用配对码登录，点退出后刷新页面又自动登进去了（#3886）。
• 原因：会话令牌/本地缓存未彻底清理。
• 解决：清除浏览器该站点的 localStorage 后刷新；或重启 WebUI 服务。

踩坑 4：飞书通道消息样式变化

• 现象：升级到 1.8.10 后，飞书机器人回复的消息样式变了（#882）。
• 原因：通道渲染逻辑调整导致的展示差异。
• 解决：确认是否为版本预期改动（看 CHANGELOG），非预期则在 issue 反馈。

踩坑 5：填了 API Key 但模型不识别/报错

• 现象：粘贴 Key 后选择模型失败或调用报错。
• 原因：Key 余额不足、权限未开，或平台/模型选错。
• 解决：到对应平台控制台确认 Key 余额与可用模型，再对照官方 LLM 配置指南 核对平台选择。

踩坑 6：手机/外网访问 WebUI 连不上

• 现象：局域网或公网访问 WebUI 失败。
• 原因：防火墙未放行端口、或跨网络部署未做穿透。
• 解决：参考官方 Remote Internet Access 教程 配置端口与访问方式。

踩坑 7：定时任务到点没触发

• 现象：Cron 任务在设定时间未执行。
• 原因：系统休眠导致错过触发。
• 解决：AionUi 自带 keep-awake（任务激活时防休眠、唤醒后检测漏触发），确认该选项已开启，并核对 cron 时区设置。

踩坑 8：部分 Agent 后端接入后工作异常

• 现象：接入某些 CLI Agent（如 Factory Droid）后执行任务异常（#37）。
• 原因：不同 CLI Agent 的协议/版本与 AionUi 支持矩阵存在兼容差异。
• 解决：确认该 Agent 版本在官方支持列表内，升级 AionUi 与 Agent 后重试；原生接入需求可跟踪 #2815。

初级用法

1. 智能文件整理：对 Agent 说「按文件类型整理这个文件夹，并把图片统一重命名为 日期-序号」，一键完成批量重命名与归类。
2. 生成 PPT / Word / Excel：选用内置的 PPT Creator / Word Creator / Excel Creator 助手，一句话生成可编辑的 .pptx / .docx / .xlsx（由 OfficeCLI 驱动，支持 Morph 动画 PPT）。
3. Excel 数据分析：把 Excel 拖进会话，让 Agent 清洗数据、自动美化图表并输出分析结论，直接在预览面板查看结果。
4. 图片生成与编辑：配置支持图像生成的模型后，用自然语言生成或修改图片。
5. 本地模型离线跑：通过 Ollama / LM Studio 接入本地模型，不联网、不花 API 费用地使用 Cowork Agent。
6. 生成 3D 游戏：用内置「3D Game」助手一句话生成单文件 3D 游戏（HTML/JS），直接在预览面板试玩。
7. UI/UX 设计稿：用「UI/UX Pro Max」助手生成专业界面设计（内置 57 种风格、95 套配色），或输出 Mermaid 流程图、架构图。

高级玩法

1. Team Mode 多 Agent 团队：设置一个 Leader Agent 把任务拆解成子任务，通过内置 Team MCP Server 分派给多个 Teammate Agent 并行执行（支持 Claude Code、Codex、Hermes、Gemini、Snow CLI 等后端），共享工作区、各自独立审批。
2. 24/7 定时自动化：用 Cron 表达式（如 0 9 * * 1）或固定间隔创建定时任务，让 Agent 每天自动聚合数据、生成日报、整理文件，实现真正的无人值守。
3. 跨平台远程通道：在「设置 → WebUI 设置 → Channel」配置 Telegram / 飞书 / 钉钉 / 微信 Bot Token，把 AionUi 变成随身可用的远程 Agent 入口。
4. 自定义助手与三级技能：通过「设置 → Skills」导入或创建自定义技能（内置 pptx/docx/pdf/xlsx/mermaid 等），并定义你自己的专业助手。
5. MCP 统一管理：在 AionUi 里集中管理 MCP（Model Context Protocol）工具，AionUi 会根据每个 Agent 的能力自动注入或同步兼容的传输方式。
6. 贡献者计划与 Kimi 合作福利：参与开源贡献可领取 Kimi “Allegretto” 免费高级套餐（价值 $39/月），详见 官方 campaign；Kimi K3 在 AionUi 中开箱即用。

小技巧

1. 先用内置「Cowork」助手跑通基本流程，再逐步尝试多 Agent，避免一次配置太多变量。
2. 关注 trendshift.io/repositories/15423 和 Releases 更新，及时升级但保留回退意识。
3. 用「配对码登录」的 WebUI 场景，优先走局域网，公网务必配合访问控制。
4. 多 Agent 并行时，给每个 Agent 分配独立工作目录，避免互相覆盖文件。
5. 加入官方 Discord 或微信中文群，遇到版本问题能快速拿到 workaround。
6. 善用内置「AionUi Butler」助手，直接在应用内询问产品用法与排障，比翻 Wiki 更快。

常见问题 FAQ

Q1：AionUi 真的免费吗？要花多少钱？

A：软件本身完全免费开源（Apache-2.0，无订阅费）。唯一成本是你自带的模型 API Key 费用，按用量计费：以 DeepSeek 为例，deepseek-v4-flash 输入约 $0.22/M token（闲时价），远低于 Claude Cowork 的 $100/月订阅。来源：DeepSeek 官方定价。

Q2：它和 Claude Cowork 有什么区别？

A：AionUi 是 Claude Cowork 的开源跨平台增强版——后者仅 macOS、仅 Claude、$100/月；AionUi 支持三大桌面系统 + 30+ 模型 + Cron 自动化 + 多远程通道，且免费。来源：README 对比表。

Q3：我必须先装 Claude Code 或 Gemini CLI 吗？

A：不用。AionUi 自带内置 Agent 引擎（基于 aionrs），装完即可用；只有在你希望复用已装的 CLI Agent 时才需要它们，且会被自动检测。来源：README Quick Q&A。

Q4：支持哪些模型和平台？

A：官方平台 Gemini/Anthropic/OpenAI、国内 Dashscope/智谱/Moonshot/千帆/混元、DeepSeek/MiniMax/OpenRouter/xAI/火山方舟、以及 Ollama/LM Studio 本地模型，共 30+ 平台。来源：README 平台列表。

Q5：如何获取帮助或反馈 bug？

A：优先查官方 Wiki FAQ 和 Getting-Started；bug 到 GitHub Issues 报告，交流可进 Discord。

进阶学习建议

• 深入 OfficeCLI 链路：AionUi 的 PPT/Word/Excel 输出由同组织开源的 OfficeCLI 驱动，理解 pptx/docx/xlsx 技能与 Morph PPT 预设，能让你生成更高质量的办公文档。
• 研究 AionCore 与 aionrs：AionUi 本地后端是 Rust 写的 AionCore（含 aionrs agent 引擎），内置助手目录在 assistants.json，想定制内置助手/技能可以从这里入手。
• 实战项目：搭建团队级自动报表流水线：用 Team Mode 设 Leader + 多个 Teammate，配合 Cron 让团队每天自动从飞书/钉钉拉数据、生成 Excel 报表并推送，参考官方 excel-processing 与 ACP-Setup。
• 误区提示：不要以为「多 Agent 并行 = 更快更准」——共享工作区时多个 Agent 可能互相覆盖文件，务必用 Team Mode 的隔离工作区或独立目录，并开启各自的权限审批。

参考链接

• AionUi GitHub 仓库
• 官方网站
• 安装指南 Wiki
• LLM 配置指南
• Discord 社区

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。