Open Swarm 智能体集群控制台
本地运行的并行编码智能体编排台,把一群 agent 放进一块可缩放画布上统一调度与审批。
- Star 数
- ★ 826
- 最近更新
- 2 天前
- License
- NOASSERTION
- 主语言
- JavaScript
- FA 评分
- 证据不足
30 秒速览
- 可在哪里用
- 平台专用Claude APIClaude Code(部分支持)
- 开始前需要
- 典型场景
- 同时推进多条功能分支的开发者:为每个功能开一个 agent,各自在独立 git worktree 中工作,用一块画布统一盯进度。
- 主要局限
- 核心执行依赖 claude-agent-sdk 与 Anthropic 模型/API 密钥,换用其它模型供应商需要自己写适配层,没有多供应商路径。
- 官网
- openswarm.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-18最新版本 v1.8.0(2026-10-11)
这个 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 可用工具。
- 要在会话中途改变方向的用户:编辑更早的消息分叉出新分支,在多个方案之间来回比较而不丢失上下文。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 端口
8324·3000- 环境变量
GOOGLE_OAUTH_CLIENT_IDGOOGLE_OAUTH_CLIENT_SECRETBACKEND_PORT- 配置文件
backend/.env.examplebackend/.env- 运行环境
- Python 3.13 · Node.js 18+
- 安装说明涉及
- Windows · macOS · Linux
如何安装或部署这个 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 智能体集群控制台 当前 | 证据不足 | — | ★ 826 | 2 天前 | JavaScript | Claude API |
| DeterminFlow | 73 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 979 | 2 个月前 | Python | — |
| Neuron AI — PHP 智能体框架 | 69 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 2.2k | 1 天前 | PHP | OpenAI API · Claude API |
| Synapse AI 多智能体编排平台 | 58 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 343 | 3 天前 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
- 源码中未见:最小权限约束只授予完成任务所需的权限:用专用账号或只读令牌,并限定可访问的目录和仓库。
- 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
- 源码中未见:数据流向说明运行时观察它连接了哪些外部服务(代理或防火墙日志);弄清数据去向之前不要输入敏感数据。
- 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- 源码中未见:外部影响披露先弄清它会写入、发送或修改哪些外部系统,用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 源码中未见:来源归属可核验从官方仓库或包源安装,核对发布者和仓库地址,避免同名仿冒包。
- 当前材料只足以确认这是一个保存签名构建的仓库;未提供 Agent 的主要源代码、行为或运行说明,因此本次无法评价其实际能力与风险。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
1.8.1-exp.5: Your work carries on through more kinds of trouble, and drafts, chats and the board hold steady. New - A reply that never starts, or goes quiet partway, is caught and carries on by itself on every provider. One chat's trouble no longer spills into your other chats. - Messages between agents wait their turn and are never lost or sent twice, and a chat that is waiting on another chat no longer shows as done: the status pill says it is waiting on a chat. …在 GitHub 查看 ↗ -
v1.8.0 1.8.0
-
v1.7.11 OpenSwarm 1.7.11
常见问题
Open Swarm 智能体集群控制台 官网是什么?
Open Swarm 智能体集群控制台 开源吗?
Open Swarm 智能体集群控制台 还在维护吗?
Open Swarm 智能体集群控制台 是谁开发的?
谢谢反馈,我们会据此改进页面。