Open Swarm 智能体集群控制台
本地运行的并行编码智能体编排台，把一群 agent 放进一块可缩放画布上统一调度与审批。
- Star 数
- ★ 821
- 最近更新
- 3 天前
- License
- AGPL-3.0
- 主语言
- TypeScript
- FA 评分
- 40/100 · 缺口较多
30 秒速览
- 可在哪里用
- 平台专用Claude APIClaude Code（部分支持）
- 开始前需要
- 典型场景
- 同时推进多条功能分支的开发者：为每个功能开一个 agent，各自在独立 git worktree 中工作，用一块画布统一盯进度。
- 主要局限
- 核心执行依赖 claude-agent-sdk 与 Anthropic 模型/API 密钥，换用其它模型供应商需要自己写适配层，没有多供应商路径。
- 源码审查
- 40/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Open Swarm 是一个本地运行的桌面编排工具，用来同时管理多个编码智能体。它由 Electron 外壳、React/TypeScript 前端（端口 3000）和 FastAPI 后端（端口 8324）组成，二者之间通过 REST（/api/*）与 WebSocket（/ws/*）通信。后端内置 Agent Manager，实际会调用 claude-agent-sdk 驱动每个会话，并把状态持久化到 JSON 文件存储中。每个 agent 在自己的 git worktree 与分支里工作，工具调用会先进入人工审批流程，再由用户批准或拒绝。所有数据都留在本机，README 明确说明没有云端中继、遥测或第三方后端，但运行时需要用户自备 Anthropic API 密钥。
前端提供一块无限画布式空间仪表盘，agent 卡片、view 卡片和嵌入式浏览器卡片都能拖放摆放，可为不同工作区建立多块仪表盘。Agent Chat 页面通过 WebSocket 以流式方式输出 token，并实时统计每个会话的美元成本，历史记录在重启后仍然保留。每次工具调用会触发 Human-in-the-Loop 审批：可以逐个批准/拒绝，也可以在仪表盘上批量处理，并按工具配置「总是允许 / 询问 / 拒绝」。会话支持消息分支——编辑历史消息即可分叉出新的对话线，并在分支间自由切换。内置 Agent、Ask、Plan、View Builder、Skill Builder 五种模式，也支持自定义模式及其系统提示词与工具限制，提示词模板可用 / 斜杠命令内联调用。Skills 库同步到 ~/.claude/skills/，可从 Anthropic 技能市场浏览安装；Tools 库用于配置 MCP 服务器（stdio、HTTP、SSE），自动发现工具，并可浏览 MCP 注册表与 Google 目录，还带 Google Workspace OAuth。Views/Outputs 生成在 iframe 中渲染的 HTML/JS/CSS 产物，支持 vibe coding、后端 Python 执行与自动运行。每个 agent 在独立的 git worktree 与分支中工作，Diff Viewer 可直接查看未提交改动，避免并行改动互相冲突。
- 同时推进多条功能分支的开发者：为每个功能开一个 agent，各自在独立 git worktree 中工作，用一块画布统一盯进度。
- 需要严格审批工具调用的团队：所有 agent 的文件写入、命令执行请求集中到一处，用 Shift+A / Shift+D 批量批准或拒绝。
- 做探索性调研的用户：用 Plan / Ask 模式让 agent 先出方案不动代码，确认后再切回 Agent 模式执行。
- 要沉淀可复用工作流的用户：把常见任务写成带结构化输入字段的提示词模板，在聊天框里用
/调用。 - 需要扩展工具能力的技术用户：通过 Tools 库接入 MCP 服务器或 Google Workspace，把 Gmail、Calendar、Drive 纳入 agent 可用工具。
- 要在会话中途改变方向的用户：编辑更早的消息分叉出新分支，在多个方案之间来回比较而不丢失上下文。
如何安装或部署这个 Agent？
方式一，直接下载桌面版（当前仅 macOS）：
https://github.com/openswarm-ai/openswarm/releases从 GitHub Releases 下载最新版本即可，无需自行安装 Python；桌面版打包了独立的 Python 3.13 运行时。Windows 与 Linux 版本官方说明为计划中，尚未提供。
方式二，从源码运行开发环境。前置条件为 Python 3.11+、Node.js 18+ 和 Git：
git clone https://github.com/openswarm-ai/openswarm.git
cd openswarm
bash run.sh该脚本会一起启动后端（8324 端口）、前端（3000 端口）和 Electron 外壳。也可以分别启动：
bash backend/run.sh # API 位于 http://localhost:8324，接口文档在 /docs
bash frontend/run.sh # 应用位于 http://localhost:3000需要复制的配置文件是 backend/.env.example → backend/.env；正常使用不必在里面写 Anthropic API 密钥，密钥在应用内的 Settings 页面填写。
如何使用这个 Agent？
首次启动后，打开应用内的 Settings 页面填入 Anthropic API 密钥，这是必需凭据。
在画布上创建 agent 卡片，给它分配工作区，agent 会在自己的 git worktree 与分支中开始工作。在 Agent Chat 中发送消息，回复会以流式 token 的形式返回，同时显示本次会话的美元花费。
当 agent 想要执行工具时，仪表盘上会弹出待审批请求：
Shift+A 批准全部待处理请求
Shift+D 拒绝全部待处理请求常用键盘快捷键：
D 跳到 Dashboard
T 跳到 Templates
1 – 9 按位置打开对应 agent
? 显示快捷键帮助在聊天输入框键入 / 可以调用提示词模板和技能。要接入外部工具能力，到 Tools 页面配置 MCP 服务器（stdio、HTTP 或 SSE），并填写 Google Workspace OAuth 的 GOOGLE_OAUTH_CLIENT_ID / GOOGLE_OAUTH_CLIENT_SECRET。密钥、端口等可通过 backend/.env 调整，例如 BACKEND_PORT 默认 8324。
这个 Agent 有哪些优点和局限？
- 每个 agent 拥有独立 git worktree 与分支，并行改动不会互相踩踏，Diff Viewer 可在应用内直接审查未提交变更。
- 所有 agent 的工具调用汇入同一处审批队列，支持单个处理与批量的 Shift+A / Shift+D，权限可按工具配置为总是允许、询问或拒绝。
- 完全本地运行，README 明确说明没有云端中继、遥测或第三方后端，会话与花费数据都留在本机。
- 支持消息分支：编辑任意历史消息即可分叉对话，在多个方案间切换而不丢上下文。
- 工具生态直接对接 MCP（stdio / HTTP / SSE）并自动发现工具，还可浏览 MCP 注册表与 Google 目录。
- 桌面版打包了独立 Python 3.13 运行时，终端用户无需自行安装 Python。
- 核心执行依赖 claude-agent-sdk 与 Anthropic 模型/API 密钥，换用其它模型供应商需要自己写适配层，没有多供应商路径。
- 官方发行版目前只提供 macOS，Windows 与 Linux 构建官方明确说明尚未提供，非 macOS 用户只能走源码运行路线。
- 使用需要自备付费的 Anthropic API 密钥，按调用量计费，软件本身免费但不含模型成本。
- 从源码跑需要同时管理 Python 3.11+、Node.js 18+、Git 三套环境，并可能用到 Google OAuth 凭据。
- 项目存在许可证标注不一致的迹象：README 徽章与正文写 MIT，而仓库元数据显示 AGPL-3.0，采用前需要自行确认实际许可。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Open Swarm 智能体集群控制台 当前 | 40 · 缺口较多 | — | ★ 821 | 3 天前 | TypeScript | Claude API |
| Synapse AI 多智能体编排平台 | 70 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 327 | 1 个月前 | Python | OpenAI API · Claude API |
| DeterminFlow | 66 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 760 | 15 天前 | Python | — |
| Neuron AI — PHP 智能体框架 | 45 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 2.1k | 7 天前 | PHP | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 宣称“100% 本地、无遥测”，并描述 HITL 审批、按工具权限（always allow/ask/deny）、git worktree 隔离与 diff 查看器，这些是真实的最小权限与确认机制证据，故 user_confirmation 给 2。但 least_privilege 仅 1：README 同时列出 Google Workspace OAuth、MCP 注册表代理、技能同步到 ~/.claude/skills/、Python 执行器与内嵌浏览器，权限面很宽，且未给出权限清单或沙箱边界。data_flow_transparency 与 sensitive_data_handling 各 1：API key 与 OAuth 密钥的存储、日志与传输路径未说明，仅提到在 Settings 页配置。dependency_security 1：仅见 requirements.txt 与 package-lock 的缓存键，无审计、锁定或漏洞处置说明。external_effects 1：存在自动更新、安装器与注册表代理等外部副作用，但无影响范围或退出机制说明。rollback 1：有 worktree 与分支隔离，但无回滚/恢复流程文档。source_attribution 1：README 徽章写 MIT 而 LICENSE 实为 AGPL-3.0，属自相矛盾，且未标注第三方来源。
self_consistency 1：README 徽章 MIT 与 LICENSE 的 AGPL-3.0 直接冲突，且 README 称仅 macOS 可用，而 CI 工作流只跑 Windows 并注明 macOS 腿已移除，文档与工程现实不一致。dependency_availability 1：README 列出 Python 3.11+/Node 18+ 与打包的 Python 3.13，但无版本锁定或可用性验证证据。failure_messages 1：conftest 与 CI 脚本显示对失败路径有测试（preflight rigs、hostile-env 场景），但产品面向用户的错误信息与恢复指引在给定文件中不可见。
audience_and_scenarios 2：README 明确面向并行运行多个编码 agent 的开发者，并给出桌面版与开发两种路径，场景清晰。capability_boundaries 1：列出五种内置模式与自定义模式，但未系统说明能力边界、不支持项或安全边界。trigger_precision 1：仅描述斜杠命令与键盘快捷键，触发条件与优先级缺乏精确定义。environment_fit 1：README 称 macOS 桌面版，Windows/Linux 计划中，而 CI 仅 Windows，环境适配说明与实现不一致。
information_architecture 2：README 结构清晰，含架构图、项目结构、配置表与快捷键表。install_notes 2：给出 run.sh、分服务启动与前置条件，属可用的安装说明。naming_stability 1：模块与目录命名较一致，但无命名稳定性或兼容性承诺。examples_and_faq 1：有快速开始与快捷键示例，但无 FAQ 或端到端使用示例。known_limitations 1：仅提到 Windows/Linux 未提供，未系统列出已知限制。license 1：LICENSE 文件为完整 AGPL-3.0，但 README 徽章标 MIT，元数据与文件冲突，扣分。versioning_changelog 0：无 CHANGELOG、无版本号或发布说明。maintenance_responsibility 1：有 Contributing 段落与 PR 欢迎徽章，但发布者身份未验证，维护责任与更新路径不明确。
output_usability 2：空间画布、流式聊天、审批、分支、diff 查看与成本追踪等输出面向实际使用，可用性描述具体。marginal_value 1：相对单终端运行 agent 的增量价值有论述，但缺少对比或量化证据。cost_benefit 1：有按会话的 USD 成本追踪，但无总体成本收益分析或资源占用说明。
claim_traceability 1：README 的功能声明多无对应文件或测试引用，仅少数（如 MCP 门控）在测试中有对应。cross_source_corroboration 1：README、CI 工作流与测试之间存在部分交叉印证（如 MCP 门控、worktree），但平台支持等关键声明相互矛盾。fact_inference_separation 1：文档将设计意图与已实现事实混写，未区分已验证与未验证内容。
- 许可证自相矛盾：README 徽章标注 MIT，而 LICENSE 文件为 AGPL-3.0，使用前必须澄清实际许可与合规义务。
- 平台支持声明与 CI 不一致：README 称 macOS 桌面版、Windows/Linux 计划中，而工作流仅运行 Windows 并注明 macOS 腿已移除。
- 权限面较宽：Google Workspace OAuth、MCP 注册表代理、技能写入 ~/.claude/skills/、Python 执行器与内嵌浏览器均存在，但缺少权限清单与沙箱边界说明。
- 密钥与 OAuth 凭据的存储、日志与传输路径未说明，敏感数据处理需自行评估。
- 无 CHANGELOG 与版本号，发布者身份未验证，更新与维护路径不明确。
- 本评估为静态源码审阅，未执行任何构建或运行，测试与确定性结论不在评分范围内。