平台的功能架构与实战入门)
AionUi 完全指南开源 24/7 AI 代理协作Cowork平台的功能架构与实战入门【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20 more CLI Agent | Customize your assistants | Team them upStar if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUiAionUi 是一款免费、开源的 AI 代理协作桌面应用它把「内置代理引擎」「多代理接入」「定时自动化」与「随时随地远程访问」整合进同一套界面让 Claude Code、Codex、Gemini CLI、OpenClaw 等 20 终端代理与内置代理在同一工作区协同工作。本文基于仓库中的乌克兰语版官方文档docs/readme/readme_uk.md展开并结合源码与配套指南帮助你完整掌握 AionUi 的核心能力、配置方式与运行原理读完即可上手安装、配置 API Key 并跑通第一个代理任务。一、Cowork不只是聊天客户端而是与你并肩工作的代理平台AionUi 的核心定位是Cowork协作工作平台而不是普通的 AI 聊天客户端。代理在你的电脑上与你并肩工作读取文件、编写代码、联网搜索、自动化执行任务。你始终可以看到代理正在做什么并保有最终控制权。官方文档用一张对比表明确了它与传统 AI 聊天客户端的差异这里完整保留并补充说明能力维度传统 AI 聊天客户端AionUiCoworkAI 能否操作你的文件受限或不能可以——内置代理拥有完整文件访问能力AI 能否执行多步骤任务受限可以——在你的确认下自主执行手机远程访问少见WebUI Telegram / Lark飞书/ DingTalk / WeChat按计划自动执行不支持Cron 定时任务——7×24 无人值守同时运行多个 AI 代理不支持数十种外部代理Claude Code、Codex、Qwen Code、Hermes Agent、Cursor Agent 等统一接入一个界面价格免费 / 付费免费且开源Apache-2.0从这份表格可以看出AionUi 的差异化能力集中在四条主线上文件级操作、多步自主执行、远程访问与定时自动化后续章节将逐一展开。二、内置代理安装即用零配置与需要单独安装 CLI 代理的工具不同AionUi 内置了完整的 AI 代理引擎安装完成即可使用。官方文档列出了内置代理的四个特点无需安装 CLI 工具——代理引擎已经内置无需复杂配置——粘贴任意一个 API Key 即可开始完整代理能力——文件读写、联网搜索、图像生成、MCPModel Context Protocol工具开箱即用的助手——内置 21 个专业助手Cowork、PPT Creator、Word Creator、Word Form Creator、Excel Creator、Morph PPT、Morph PPT 3D、Pitch Deck Creator、Dashboard Creator、Academic Paper Writer、Financial Model Creator 等。从仓库源码结构看桌面端入口与代理进程管理位于 packages/desktop/src/process渲染层界面位于 packages/desktop/src/renderer这印证了「Electron 前端 本地后端」的双层架构设计。办公助手PPT、Word 与 Excel文档特别强调了一条与真实产品能力对应的「办公助手」路径Morph PPT 预设 pptx/docx/xlsx技能。三种助手分别对应不同的文件工作流最终产物都是可直接编辑、复用的真实文件PPT 助手产物可编辑的 Morph PPT.pptx带 Morph 动画的幻灯片间平滑过渡与连贯叙事节奏由 OfficeCLI 驱动生成。Word 助手产物可编辑的 Word.docx通过docx技能完成论文/文章撰写与生产级文档编辑由 OfficeCLI 驱动。Excel 助手产物可用的 Excel.xlsx/.xlsm/.csv通过xlsx技能生成并刷新表格用于数据分析、自动格式化与图表制作由 OfficeCLI 驱动。文档明确指出这些助手的权威定义assistant catalog与内置技能built-in skills由 AionCore 仓库统一维护助手规则本身以 Markdown 形式保存并可在 AionUi 内自定义——这体现了「定义与规则分离、可配置化」的设计思路。三、多代理模式已有 CLI 代理直接接入如果你已经在使用 Claude Code、Codex、Hermes Agent 或 OpenClawAionUi 会自动检测到它们并允许它们与内置代理一起工作。文档列出的受支持代理包括内置代理基于内嵌的 aionrs 代理引擎、Claude Code、Codex、Qwen Code、Gemini CLI、Goose、OpenClaw、Augment Code、CodeBuddy、Kimi CLI、OpenCode、Factory Droid、GitHub Copilot、Qoder、Mistral Vibe、Nanobot、Snow、Hermes、Cursor Agent、Pi、MiMo Code、omp、Antigravity 等。多代理模式的核心能力自动发现——自动识别已安装的 CLI 工具统一界面——一个平台管理所有 AI 代理并行会话——同时运行多个代理各自拥有独立上下文MCP 统一管理——在一个地方管理 MCP 工具AionUi 会根据每个代理的能力注入或同步兼容的传输方式YOLO / 全自动模式——受支持的代理可开启无人值守模式可用模式与权限行为取决于所选代理。从实现层面看外部代理通过 ACPAgent Client Protocol接入AionUi 在其中承担协调者角色——这一点在 Team Mode 中体现得尤为明显见下节。Team Mode协调式多代理协作Team Mode 让多个 AI 代理以「组织化团队」的形式工作Leader 代理接收你的指令将其拆解为子任务并通过内置的Team MCP Server委派给Teammate 代理。Teammate 并行执行任务通过异步邮箱交换结果并写入共享任务看板。文档中 Team Mode 的细节要点并行多代理执行——Leader 拆解并委派任务给并行运行的 Teammate外部代理通过 ACP 协议接入由 AionUi 协调团队Leader 编排——Leader 负责分配、跟踪并汇总结果受支持的后端包括 Claude Code、Codex、Hermes Agent、Gemini、Snow CLI、Aion CLI团队隔离工作区——所有代理共享同一个文件夹每个代理拥有独立的权限确认对话框侧边栏徽标显示待处理的确认请求共享工作区——所有代理读写同一个文件夹文件面板全程保持可见动态扩缩容——团队运行过程中可随时增删 Teammate静默无响应的代理会自动升级为 failed 状态支持一键移除细粒度权限——每个代理都有自己的权限确认对话框文件共享——Leader 可以向 Teammate 传递文件附件。补充说明官方文档指出除上述后端外其他具备mcpCapabilities.stdio能力的 ACP 后端也会被自动支持。四、任意 API Key即可获得完整 Cowork 代理其他 AI 应用通常只给你一个聊天框。AionUi 给你的是一个完整的 Cowork 代理——文件读写、联网搜索、图像生成这些能力与底层模型无关无论用哪个厂商的 Key 都一样。文档中的「API Key → 能力」对照表你的 API Key你将获得Gemini API基于 Gemini 的 Cowork 代理OpenAI API基于 GPT 的 Cowork 代理Anthropic API基于 Claude 的 Cowork 代理Ollama / LM Studio本地本地模型 Cowork 代理NewAPI 网关统一访问 20 模型AionUi 总共支持30 AI 平台覆盖云服务与本地部署。文档完整列出的平台清单如下官方平台——Gemini、GeminiVertex AI、AnthropicClaude、OpenAI云服务商——AWS Bedrock、New API统一 AI 模型网关国内平台——Dashscope通义千问、Dashscope Coding Plan、智谱Zhipu、月之暗面Moonshot/Kimi、百度千帆Qianfan、腾讯混元Hunyuan、零一万物Lingyi、ModelScope、InfiniAI、天翼云Ctyun、阶跃星辰StepFun、SiliconFlow-CN、PPIO国际平台——DeepSeek、MiniMax、Novita、OpenRouter、SiliconFlow、xAI、火山方舟Ark、Poe本地模型——Ollama、LM Studio通过 Custom 平台配置本地 API 端点。从 readme.md 的 Quick QA 可以确认你只需为所选供应商的 API 用量付费应用本身完全免费开源。五、可扩展的助手与技能体系AionUi 采用「21 个内置专业助手 三层技能体系」的设计并支持创建、管理自己的助手与技能。三层技能体系内置技能Builtin——随 AionUi 一起分发如pptx、docx、pdf、xlsx、mermaid等自定义技能Custom——用户自己创建的技能扩展技能Extension——由第三方扩展Extension SDK贡献的技能。技能支持按对话启用/禁用聊天头部会有一个技能指示器显示当前对话激活的技能。文档完整列出的 21 个内置助手 Cowork——自主任务执行文件操作、文档处理、工作流规划 PPT Creator / Morph PPT / Morph PPT 3D——生成带 Morph 过渡动画的 PPTX 演示文稿 Pitch Deck Creator——面向投资者的融资路演 PPT 生成 Dashboard Creator——数据看板生成 Word Creator——生产级 Word.docx文档生成 Word Form Creator——结构化 Word 表单 / 合同模板生成 Excel Creator——含分析、图表与自动格式化的电子表格生成 Academic Paper Writer——结构化学术论文写作 Financial Model Creator——财务模型与预测 3D Game——单文件 3D 游戏生成 UI/UX Pro Max——专业 UI/UX 设计57 种风格、95 种配色 Planning with Files——基于文件的复杂任务规划Manus 风格持久化 Markdown 规划 HUMAN 3.0 Coach——个人成长教练 Social Job Publisher——职位发布 moltbook——零部署的 AI 代理社交网络 Beautiful Mermaid——流程图、时序图等图表生成 OpenClaw Setup——OpenClaw 集成配置助手 Story Roleplay——沉浸式剧情角色扮演兼容 SillyTavern AionUi Butler——应用内产品指引、配置帮助与故障排查。技能的使用路径是在设置 → Skills中导入或创建技能然后按需将其附加到指定助手。六、随时随地 CoworkWebUI 与消息平台接入AionUi 提供「7×24 全天候 AI 助手」的远程访问能力WebUI 模式——通过浏览器从手机、平板或任意电脑访问支持局域网LAN、跨网络与服务器部署登录方式为二维码或密码消息平台集成Telegram——直接在 Telegram 里与代理协作Lark飞书——通过飞书机器人进行企业协作DingTalk钉钉——AI 卡片流式输出带自动降级WeChat微信——个人微信账号接入WeCom企业微信、Slack、Discord等更多平台即将上线。配置入口AionUi 设置 → WebUI 设置 → 渠道Channel配置 Bot Token 即可接入对应平台。仓库中的 docs/guides/webui.md 提供了完整的 WebUI 启动指南桌面版通过--webui参数以内置 Web 服务器方式启动配合--remote允许局域网远程访问默认访问地址为http://localhost:3000端口可能变化以应用输出为准。配置优先级为CLI 参数 环境变量 用户配置文件webui.config.json位于 Electron 用户数据目录常用环境变量包括AIONUI_PORT、AIONUI_ALLOW_REMOTE、AIONUI_HOST若忘记 WebUI 管理员密码可用--resetpass命令重置会同时轮换 JWT 密钥、失效旧令牌。七、定时任务Cowork 自动驾驶「设置一次代理按计划自动运行」是 AionUi 最实用的自动化能力官方文档称其为Cowork on Autopilot自动驾驶。核心特性自然语言——像聊天一样告诉代理要做什么三种调度模式——标准 cron 表达式支持时区、固定间隔每 N 分钟/小时、一次性触发AI 创建任务——代理可以在对话过程中自主创建定时任务典型场景——数据采集、报告生成、文件整理、提醒。调度模式Cron 表达式——标准 5 字段 cron支持时区例如0 9 * * 1、Asia/Shanghai每 N 分钟/小时——固定间隔例如每 30 分钟运行一次一次性——在指定日期/时间触发一次之后自动停用。执行模式在现有对话中继续——追加到绑定的对话AI 保留完整上下文历史每次创建新对话——每次触发开启全新会话适合相互独立的周期性报告。其他能力对话绑定——每个定时任务绑定到一个对话保留上下文与历史自动执行——到点自动运行并向对话发送消息简单管理——随时创建、修改、启用/禁用、删除、查看任务防睡眠模式——有活动任务时 AionUi 自动阻止系统进入睡眠并在唤醒后检测错过的触发高级配置——每个任务可单独配置模型、工作目录与推理强度reasoning effort。从源码看定时任务模块在前端有完整的页面实现packages/desktop/src/renderer/pages/cron 下包含任务创建弹窗CreateTaskDialog.tsx、任务详情页TaskDetailPage.tsx、列表页index.tsx以及对话头部入口组件CronJobManager.tsxdocs/prds/cron/cron-entry-optimization.md 还记录了该模块的体验优化设计对话头部空态收敛、列表页「对话创建 / 手动创建」双路径可供深入理解交互逻辑。八、预览面板与智能文件管理预览面板即时查看 AI 生成结果支持 10 种格式PDF、Word、Excel、PPT、代码、Markdown、图片、HTML、Diff——无需切换应用即可全部预览。即时预览——代理生成文件后立刻查看结果实时跟踪 可编辑——自动跟踪文件变化支持 Markdown、代码、HTML 的实时编辑多标签页——同时打开多个文件每个文件独立标签。文档给出的完整格式清单文档类PDFWord.doc/.docx/.odtExcel.xls/.xlsx/.ods/.csvPowerPoint.ppt/.pptx/.odp、代码类JavaScript、TypeScript、Python、Java、Go、Rust、C/C、CSS、JSON、XML、YAML、Shell 脚本等 30 语言、标记类Markdown、HTML、图片类PNG、JPG、JPEG、GIF、SVG、WebP、BMP、ICO、TIFF、AVIF、其他Diff.diff/.patch。智能文件管理自动化日常操作支持批量重命名、自动整理、智能分类、文件合并自动整理——智能识别内容并自动分类保持文件夹整洁高效批处理——一键重命名、合并文件自动化执行——AI 代理可独立执行文件操作自动读写文件完成任务。典型使用场景按文件类型整理杂乱的下载目录、为照片批量重命名、合并多个文档、按内容自动分类文件。九、为什么选择 AionUi与 Claude Cowork 对比官方文档指出AionUi 是免费开源的多 AI 代理桌面应用与仅支持 macOS、且只能使用 Claude 的 Claude Cowork 相比AionUi 是「全模型、跨平台」的增强版本。对比表完整保留如下维度Claude CoworkAionUi操作系统仅 macOSmacOS / Windows / Linux模型仅 ClaudeGemini、Claude、DeepSeek、OpenAI、Ollama 等交互界面桌面 GUI桌面 WebUI Telegram / Lark / DingTalk / WeChat自动化仅手动Cron 定时任务——7×24 无人值守费用$100/月免费且开源免责说明以上对比内容出自官方文档docs/readme/readme_uk.md其中 Claude Cowork 的定价等信息以官方文档表述为准本文仅转述。十、快速开始安装与三步上手系统要求来自 readme.mdmacOS10.15 及以上WindowsWindows 10 及以上LinuxUbuntu 18.04 / Debian 10 / Fedora 32内存建议 4GB存储可用空间 500MB。安装方式从 Releases 页面下载对应平台macOS / Windows / Linux的安装包macOS 也可以通过 Homebrew 安装brew install aionui仓库中的 homebrew/aionui.rb.example 提供了 Homebrew cask 定义的参考模板可查看它如何按 CPU 架构arm64 / x64匹配对应的.dmg下载地址并定义卸载清理路径。三步上手安装AionUi添加任意 API Key 开始使用开始工作——内置代理已经就绪。常见疑问来自官方 README 的 Quick QA不需要事先安装 Gemini CLI 或 Claude Code——内置代理安装后立即可用数据全部保存在本地 SQLite 数据库中不会上传到任何服务器WebUI 模式可作为独立 HTTP 服务运行在服务器上无头模式。十一、社区、贡献与本地开发社区与支持GitHub Discussions——分享想法与经验Issues——报告 Bug 与功能请求Discord——英文社区微信群resources/wx-23.png——中文社区。参与贡献提交 PR 前请先阅读 CONTRIBUTING.md。标准流程为Fork 本项目 → 创建功能分支git checkout -b feature/AmazingFeature→ 提交变更git commit -m Add some AmazingFeature→ 推送分支git push origin feature/AmazingFeature→ 发起 Pull Request。本地开发环境AionUi 的本地开发涉及两个仓库AionUiElectron 前端与AionCore本地后端。macOS、Linux、Windows 的完整搭建说明见 docs/contributing/development.md。本项目遵循 Apache-2.0 开源协议见 LICENSE。十二、深入仓库进一步探索的入口如果你想在源码层面继续研究 AionUi以下文件是最佳起点项目主 READMEreadme.md含系统要求、Quick QA、更多使用场景乌克兰语官方文档docs/readme/readme_uk.md本文的基础材料WebUI 启动与远程访问指南docs/guides/webui.md定时任务模块源码packages/desktop/src/renderer/pages/cron定时任务体验优化设计文档docs/prds/cron/cron-entry-optimization.md开发环境搭建docs/contributing/development.mdHomebrew cask 模板homebrew/aionui.rb.example。至此从「Cowork 是什么」到「定时任务如何配置」「WebUI 如何远程访问」AionUi 的核心能力与实战路径已全部覆盖。接下来只需下载安装、填入 API Key即可让内置代理开始为你工作。【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20 more CLI Agent | Customize your assistants | Team them upStar if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考