AI Maestro是什么?一站式管理80+ AI Agent的终极编排仪表盘完整解析
AI Maestro是什么?一站式管理80+ AI Agent的终极编排仪表盘完整解析
AI Maestro 是一款免费开源的 AI Agent 编排仪表盘,定位为"AI 优先组织的操作系统(The OS for AI-first organizations)"。它把 Claude Code、Codex、Grok Build 等各类 AI Agent 汇聚到一个网页面板里,提供多机点对点组网(Peer Mesh)、Agent 间消息协议(AMP)、持久化记忆、代码图谱和看板协作等能力,让一个人也能像 CEO 一样指挥 80+ 个 AI Agent 跨多台电脑协同工作。
为什么需要 AI Maestro:AI Agent 管理痛点
AI Maestro 的作者最初只给 AI Agent 派了一个真实工程任务,结果它真的查代码、读日志、查数据库并给出了答案。一周之内,他的终端里跑起了 35 个 Agent——它们各自高产,却彼此不会说话,作者本人成了"人肉邮差":从 A 终端复制上下文,粘贴进 B 终端,一天重复几十次。
于是 AI Maestro 诞生了:一个仪表盘看清所有机器上的所有 Agent,谁在干活、谁在等你、谁被卡住,一目了然。Agent 之间可以直接发消息,你只负责管大局。
快速上手:AI Maestro 最快安装步骤
环境要求:macOS / Linux / Windows(WSL2),Node.js 18+,tmux 3.0+,构建时约需 4 GB 内存(构建完成后运行时仅几百 MB)。
方式一:一键安装(推荐,5-10 分钟)
curl -fsSL https://raw.githubusercontent.com/23blocks-OS/ai-maestro/main/scripts/remote-install.sh | bash
这条命令会装好仪表盘服务、AMP 消息系统,以及包含 14 个 Skills 的 Claude Code 插件。
方式二:手动安装(可参考 docs/QUICKSTART.md)
git clone https://gitcode.com/gh_mirrors/ai/ai-maestro
cd ai-maestro
yarn install
yarn dev
启动后在浏览器打开 http://localhost:23000,即可看到主仪表盘。安装器还会注册 ai-maestro 命令(ai-maestro open / start / stop / status),macOS 上可拖到 Dock 一键启动。
一个仪表盘:所有 AI Agent 一屏掌控
在 AI Maestro 里,Agent 更像"员工"而不是"任务":它有名字、头像、角色、记忆和收件箱,并且拥有某些东西——一个仓库、一个产品、一项流程。
核心体验包括:
- 自动发现:tmux 会话、Docker 容器、云端部署的 Agent 都会被自动识别,无需手动注册;
- 智能命名:
project-backend-api会自动变成三级树并自动配色,方便快速定位"我在哪个 Agent"; - 状态一瞥可知:Working / Needs you / Ready / Offline 四种状态用颜色和图标区分;
- 四种部署模式:tmux(本地)、Docker(容器)、AWS EC2(专属实例)、AWS ECS Fargate(无服务器),云端 Agent 由 Terraform 管理,一条命令部署。
多机组网:让 AI Agent 跑在任何电脑上
AI Maestro 采用 Peer Mesh 对等组网架构——没有中心服务器,每台机器都是平等的节点:
- Mac 负责 iOS 构建,Linux 跑 Docker,云服务器啃重计算;
- 加一台机器它就自动入网,任意节点打开仪表盘都能看到全部 Agent;
- 工作机可以
yarn headless无头运行(完整 API + Agent 运行时,仅约 100 MB 内存)——你坐在哪就开哪的仪表盘,Agent 跑在有算力的地方。
架构细节可阅读 docs/CONCEPTS.md,多机搭建教程见 docs/SETUP-TUTORIAL.md。
AMP 消息协议:AI Agent 之间直接对话
这是 AI Maestro 区别于普通终端管理器的杀手锏:Agent Messaging Protocol(AMP) 让 Agent 拥有"邮箱"——带优先级、消息类型、加密签名和推送通知的邮件式通信。
以前:你在 50 次/天地在终端之间复制粘贴研究结论。 现在:一句话"研究 Agent,把你的发现发给写作 Agent",完成。
消息指南见 docs/AGENT-MESSAGING-GUIDE.md。
持久记忆与代码图谱:AI Agent 越用越聪明
"每天早上,我的 Agent 都失忆醒来"——AI Maestro 的长期记忆技能解决了这个问题:
- 每晚每个 Agent 的对话会沉淀成记忆:学到的要点 + 出处原文 + 实体关系图谱(
runs on、depends on、deploys to); - 即使 Claude Code 删除了 30 天前的会话记录,AI Maestro 也能从消息索引重建历史,数月的工作变成记忆;
- 配合 Code Graph(全代码库交互式图谱 + 增量索引)与自动生成的可搜索文档,Agent 在特定领域会随时间持续变强。
记忆原理详见 docs/LONG-TERM-MEMORY.md。
团队协作:看板、会议与 Attention 页面
- 团队与会议:把 Agent 编成团队,在分屏"作战室"里开站会,旁边是一块共享 Kanban 看板(5 个状态列、拖拽、依赖关系),跨机器团队同样流畅;
- 卡片系统:每张卡片可带截止日期、多个负责人、类型(任务/想法/Bug/调研)和来源,任何框架的 Agent 都能通过
agent-tasks技能往里投递; - Matrix / Attention / Org 三个辅助页:艾森豪威尔四象限看全局卡片;Attention 页专门汇总"需要你处理的事"——逾期卡片、等你审批的卡片、正在提问的 Agent。
Skills 系统:给 AI Agent 的"超能力"
AI Maestro 插件携带 14 个遵循开放 Agent Skills 标准的技能,Agent 的任务匹配到技能描述时自动加载:
| 技能 | 作用 |
|---|---|
memory-search |
搜索 Agent 过去学到的内容与实体依赖 |
graph-query |
从代码图谱查调用方、依赖与影响面 |
docs-search |
在自动生成的文档中查签名和 API |
agent-messaging |
Agent 间签名消息(AMP) |
agent-tasks |
Agent 自己的任务看板 |
aim-secret-management |
使用凭据而从不"看见"它 |
agentic-sql |
只读 SQL;写操作需人工逐条审批 |
其中 Secrets 机制值得一提:Agent 按名字引用密钥,值保存在本地保险库(macOS Keychain / Linux libsecret),聊天里以掩码卡片填写,命令输出自动脱敏——模型永远看不到明文。详见 docs/SECRETS.md。
谁适合用 AI Maestro?
- 独自运营 Agent 集群的个人开发者:3 个以上 Agent 就在终端间来回切换、人肉传话,它就是你需要的;
- AI 优先组织的创始人:你当 CEO,Agent 是团队,从 1 个 Agent 起步逐步扩编;
- 多机团队协作:多位开发者、多个 Agent、多台机器,一个仪表盘收口。
AI Maestro 采用 MIT 协议,完全免费(含商用),无账号、无遥测、无席位费,代码和 Agent 都留在你自己的机器上。各 Agent 支持程度见 docs/AGENT-PROGRAMS.md。
相关资料导航
- 快速开始:docs/QUICKSTART.md
- 核心概念:docs/CONCEPTS.md
- 真实使用场景:docs/USE-CASES.md
- 聊天架构(消息如何到达 Agent):docs/CHAT-ARCHITECTURE.md
- 生态与协议(AMP / AID / AAP / AFP):docs/ECOSYSTEM.md
- 插件开发:plugin/
- 项目总览:README.md





