Ekko Studio 多 Agent 本地工作台
📌 适用场景：安装 Studio 并接入 Agent 运行时 → 在统一工作台里建会话/群聊/工作流 → 用审批门与执行历史编排多 Agent 协同
本地优先的多 Agent AI 工作台：一个桌面端同时管理 Hermes、Ekko、Claude Code、Codex、Pi、Grok、OpenCode、DSH 八种运行时——共享会话、群聊 @提及路由、可视化工作流（审批门/循环/失败分支）、10 平台通道、Web 终端。BSL-1.1。
📋 完整步骤
- 1
安装 Studio 并接入 Agent 运行时
下载桌面版（Win/macOS/Linux）或 npm 全局装 hermes-web-ui，或 Docker Compose 单容器部署；首次启动自动初始化数据目录、内置技能与 Agent 桥。
- 2
在统一工作台里建会话、群聊与可视化工作流
单聊经 Socket.IO 流式分发到任一运行时；群聊用 @提及路由触发指定 Agent；Vue Flow 画布连节点、加审批门、设成功/失败路由与循环，跑预算与截止时间可控的执行。
- 3
用审批门与执行历史编排多 Agent 协同
工作流里插人工审批门，冻结运行快照、回放节点对话与边决策；会话/任务/Kanban 与用量统计沉淀在同一本地状态库里。
这是什么？适合谁？
Ekko Studio（原名 Hermes Studio / Hermes Web UI，npm 包名仍为 hermes-web-ui）是一个本地优先的多 Agent AI 工作台：一个桌面应用（Windows/macOS/Linux）、一个 npm CLI 或一个 Docker 容器，把八种 Agent 运行时——Hermes、Ekko、Claude Code、Codex、Pi、Grok、OpenCode、DeepSeek Harness（DSH）——装进同一个带 UI 的工作区。
它不是又一个聊天壳子。核心价值在跨运行时的共享层：单聊（流式 + 工具调用展开 + 生成文件预览）、群聊房间（@提及哪个 Agent 哪个就接话，超长历史自动压缩摘要）、可视化工作流（Vue Flow 画布，节点可挂文件附件，支持条件边、成功/失败路由、循环、人工审批门、运行预算与截止时间）、Kanban、定时任务、用量统计（token 分解 + 估算成本 + 缓存命中率）。Agent 各自的控制面（Hermes 的 profiles/providers/skills/memory、编码 Agent 的安装与代理配置）留在各自模块里，Studio 只管共享的部分——README 里的架构表把这个边界写得非常清楚（/api/studio/* 与 /api/hermes/* 分立）。
v0.7.18 截图、v0.7.22 版本（2026-09-16 发布）、★11,107 / 🔱1,353，Telegram/Discord/Slack/WhatsApp/Matrix/飞书/钉钉/QQ/微信/企业微信 10 个平台通道统一配置页管理。Vue 3 + Koa 2 + SQLite + node-pty 技术栈，BSL-1.1 许可（源码可用，非 OSI 开源）。
适合谁：
- 同时用多个 Agent CLI（Claude Code + Codex + 其他）的开发者，想要一个统一桌面端管理安装、会话、代理配置与文件差异
- 需要多 Agent 群聊协同（@提及路由 + 上下文压缩）或带人工审批门的工作流的小团队/个人
- Hermes 用户想要图形化的 profiles/模型/技能/记忆/Kanban/cron 管理面
不适合谁：要求 OSI 开源许可的团队（BSL-1.1 有使用限制条款，商用前读 LICENSE）；只想要单一模型网页聊天的轻度用户；需要多用户 SaaS 平台的团队（定位是本地单机工作台，账号体系仅为多 profile 访问控制）。
使用前提：Win/macOS/Linux 桌面（或 Docker 24+）；要真正跑起来至少一个 Agent 运行时与对应 API Key；桌面默认端口 8648。
准备工作
- 安装（三选一）：
- 桌面版（推荐）：GitHub Releases 下载对应平台安装包，装完命令行出现
ekko-studio/ekko-studio-mcp命令 - npm：
npm install -g hermes-web-ui && hermes-web-ui start，开 http://localhost:8648 - Docker：
git clone https://github.com/EKKOLearnAI/hermes-studio.git && cd hermes-studio && WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d，开 http://localhost:6060
- 桌面版（推荐）：GitHub Releases 下载对应平台安装包，装完命令行出现
- 成本：软件本身免费下载；AI 侧成本 = 你给各运行时配的 provider 计费（Studio 内置用量统计与成本估算）
- 时间：安装 10 分钟；接入第一个 Agent 运行时 + 跑通单聊 15 分钟；工作流画布上手 30-60 分钟
- 前置知识：会用命令行与 Docker（选容器路径时）；理解「Agent 运行时 / profile / provider」概念
- 安全：默认引导账号
admin/123456，首次登录后立即改掉；公网暴露端口前设置AUTH_TOKEN并收紧BIND_HOST
3 步核心流程
第一步：安装 Studio 并接入 Agent 运行时
以桌面版为例：装完启动，Studio 自动初始化数据目录（~/.hermes-web-ui）、本地 SQLite、内置技能，并启动 Hermes Agent 桥。Hermes 运行时自动发现（源码 checkout → pip 安装的 hermes 命令 → 系统 Python 三级回退）；编码 Agent（Claude Code/Codex/Pi/Grok/OpenCode/DSH）从 Agent Manager 页面安装、配置代理与 API 模式。
# npm 路径验证启动状态
hermes-web-ui status
预期产出：浏览器打开 http://localhost:8648，聊天页模型选择器里能看到已授权 profile 的可用模型。
第二步：在统一工作台里建会话、群聊与可视化工作流
单聊直接选运行时开聊；群聊建房后把多个 Agent 拉进房间，@Claude 帮我看下这个报错 即触发对应 Agent 的上下文回复，历史超 token 阈值自动压缩。工作流进 Workflows 页：Vue Flow 画布上拖节点（八种运行时任选）、连有向边、给每条边设条件与成功/失败路由，需要人拍板的地方拖一个审批门节点，再给整个运行设预算与截止时间。
预期产出：一个可重复执行的 .workflow 定义（支持导入/导出移植），以及一次带完整证据链的运行记录。
第三步：用审批门与执行历史编排多 Agent 协同
工作流跑到审批门会挂起等你确认；执行历史里每个运行是冻结快照——节点对话、边决策、产出文件都能在画布上回放。配合定时任务（cron 表达式快捷预设）和 Kanban 看板，把「研究 → 编码 → 人工审查 → 发布」这类循环固化成可审计的流水线。
预期产出：跨 Agent 的任务从「群里喊人」变成「画布上跑流程」，每一步可追溯。
常见踩坑
-
症状：npm 装完
hermes-web-ui start后聊天报桥接失败。 原因：Hermes Agent 桥没起来——Studio 找不到含run_agent.py的源码 checkout，也没装hermes包。 解决：确认hermes命令可用（pip install hermes-agent）或设HERMES_AGENT_ROOT指向源码目录；桥超时默认 120 秒（HERMES_AGENT_BRIDGE_STARTUP_TIMEOUT_MS）。 -
症状：默认账号 admin/123456 登录提示锁定。 原因：多次失败登录触发 IP 锁记录。 解决：
hermes-web-ui clear-login-locks --restart清锁并重启。 -
症状：Docker 部署后 LAN 二维码连不上。 原因：从
localhost:6060访问时 Studio 不知道宿主机 LAN 地址。 解决：设HERMES_LAN_ADVERTISE_URL=http://<宿主LAN IP>:6060。 -
症状：桌面版升级后旧
hermes-studio命令失效。 原因：新命令是ekko-studio，升级时旧 shim 被移除且不保留兼容别名（README 明示）。 解决：改用ekko-studio/ekko-studio cli/ekko-studio web。 -
症状：自动更新失败。 原因：Cloudflare 更新源不可达。 解决：更新器自动回退 GitHub Releases；再不行手动从 Releases 下载覆盖（Windows 升级会尝试先关闭在跑的 Studio 进程）。
-
症状：重启后 MCP 工具名变了。 原因：工具前缀从
hermes_studio_*迁移到ekko_studio_*（旧名保持兼容但管理服务器配置已迁移到ekko-studio-*）。 解决：重启 MCP 客户端发现新工具名。 -
症状：DSH 原生插件装不上。 原因：插件安装要求 Studio 后端所在机器 PATH 上有
pnpm。 解决：npm i -g pnpm后重试（详见 docs/dsh-management.md）。
常见问题 FAQ
Q1: Ekko Studio、Hermes Studio、hermes-web-ui 是三个东西吗？
A: 一个。Ekko Studio 是现名，Hermes Studio/Hermes Web UI 是曾用名；GitHub 仓库名 EKKOLearnAI/hermes-studio 与 npm 包名 hermes-web-ui 因兼容沿用未改，clone 和安装命令用旧名，桌面命令用新名 ekko-studio。
Q2: 收费吗？许可是什么？
A: 软件免费；BSL-1.1（源码可用，非 MIT 类宽松许可，商用限制条款读仓库 LICENSE 文件）。AI 调用费用走你自配的 provider。
Q3: 八种运行时都必须装吗？
A: 不用，按需装。只想要 Hermes 图形界面就只跑 Hermes；要编码 Agent 协同再从 Agent Manager 装对应运行时。
Q4: 数据存哪？隐私如何？
A: 本地优先：Studio 状态默认 ~/.hermes-web-ui（可用 HERMES_WEB_UI_HOME 改），Hermes 数据在 ~/.hermes，两者分离；Docker 路径持久化在 ./hermes_data。语音 Key 与克隆音频只存服务端，浏览器仅见掩码状态。
Q5: 想把它当 MCP 服务器用行不行？
A: 行。ekko-studio-mcp [api|browser|devices|use] 四个工具集按需选，浏览器工具集带隔离 profile、截图、无障碍快照与控制租约。
小技巧
- 模块边界自查：出问题先分清是 Studio 层（
/api/studio/*：会话/工作流/文件/语音）还是 Agent 层（/api/hermes/*：profiles/模型/技能），日志页按 agent/server/error 分流过滤。 - 用量省钱：用量分析页有缓存命中率与模型分布图，把高频低难任务切到便宜模型再回主模型。
- 工作流可移植：导入/导出功能让定义在 profile 间搬——先在小 profile 调通再上主力。
- 移动端：已发布移动 App 走集中兼容层，LAN 配对二维码在设置页。
免责声明
本文基于该仓库 README（2026-09-17 抓取全文 535 行）与 GitHub API 实时数据（★11,107 / 🔱1,353，v0.7.22）独立整理，AI 辅助生成。本站未实际部署该工作台；多运行时桥接稳定性、群聊压缩效果、审批门体验以实际使用为准。BSL-1.1 许可条款以仓库 LICENSE 原文为准。
参考链接
📊 评分与标签
评分说明
总分 8.7/10 · P_优选
📊 可观测社区指标（采集日期：2026-09-17）
- GitHub: EKKOLearnAI/hermes-studio ★11,107, 🔱1,353（GitHub API 实时核验，2026-09-17）
- 仓库创建 2026-04-11（5 个月）；最近 push 2026-09-16；最新 release v0.7.22（2026-09-16 发布，节奏密集）；open issues 394
- License: BSL-1.1（源码可用，非 OSI 开源）；TypeScript（Vue 3 + Koa 2 + SQLite + node-pty）
- 组织账号 EKKOLearnAI；分发三通道：桌面安装包（Win/macOS/Linux）+ npm
hermes-web-ui+ Docker 镜像
评分依据可追溯至公开来源，每项分数均有明确理由和数据支撑。
📋 流程完整性 2.6/3.0
- 三阶段工作流（接入运行时 → 会话/群聊/工作流 → 审批门与执行历史编排）全部有真实产品功能支撑：Agent Manager 管八种运行时安装配置；Socket.IO
/chat-run流式分发；群聊 @提及路由 + 超阈值自动压缩；Vue Flow 画布支持条件边、成功/失败路由、循环、人工审批门、运行预算与截止时间；执行历史是冻结快照，节点对话与边决策可在画布回放 - 端到端可装配：三条部署路径（桌面/npm/Docker Compose）首启自动初始化数据目录、SQLite、内置技能与 Agent 桥
- 竞品对比 1（单个 Agent 自带 WebUI，如 Open WebUI）：多运行时共享工作区与审批门是本工作流独有层
- 竞品对比 2（n8n 类通用编排）：无 LLM 运行时管理；本工作流 Agent 安装/代理/会话一体化
- 补充：CLI 维护命令齐全（clear-login-locks / reset-default-login / update），故障路径有出口
🔄 可复用性 1.9/2.5
- 工作流定义支持导入/导出，跨 profile 可移植；群聊房间、定时任务、Kanban 三种复用载体并存；10 平台通道（Telegram/Discord/Slack/WhatsApp/Matrix/飞书/钉钉/QQ/微信/企业微信）让同一编排多入口触发
- 竞品对比 1（脚本化 multi-agent 框架）：定义即代码可版本化；本工作流图形定义可导出但生态绑定 Studio
- 竞品对比 2（ChatHub 类多模型并聊）：仅并排问答；本工作流有状态与执行历史
- 限制：工作流运行时是 Studio 自有引擎（Vue Flow + 后端调度），不能脱离 Studio 执行；BSL-1.1 限制商用再分发场景；394 个 open issues 说明边角问题仍多
📖 文档清晰度 1.9/2.0
- README 535 行范本级：曾用名与包名关系一段讲透 → v0.7.18 实拍截图 → 能力矩阵表 → Agent/平台边界表（含
/api/studio/*vs/api/hermes/*API 归属）→ 每个功能面独立小节 → Quick Start 三路径 → 40+ 环境变量全量表（含默认值与语义） → CLI 命令表 → 架构图与模块归属规则 → 技术栈- 来源：GitHub README（2026-09-17 抓取全文 535 行）
- 另有 DEVELOPMENT.md / ARCHITECTURE.md / docs/dsh-management.md / docs/docker.md / docs/voice-dialogue.md 专题文档
- 竞品对比 1（多数开源 dashboard 项目）：环境变量散落代码里；本 README 表格化全列
- 竞品对比 2（SaaS 帮助中心）：黑盒；本 README 把模块边界与所有权树写成可执行规则
🔧 工具集成 1.4/1.5
- 八种运行时接入（Hermes/Ekko/Claude Code/Codex/Pi/Grok/OpenCode/DSH）+ MCP 生态（
ekko-studio-mcp四工具集：api/browser/devices/use，浏览器集带隔离 profile 与控制租约）+ TTS 10 适配器 / STT 8 适配器 + 文件浏览器支持 local/Docker/SSH/Singularity 四后端 - Hermes 运行时三级自动发现（源码 checkout → pip 包 → 系统 Python）
- 竞品对比 1（单 Agent 桌面端）：集成面窄一个量级
- 竞品对比 2（LangGraph 等代码编排）：工具靠自写胶水；本工作台配置即接
💡 创新性 0.9/1.0
- 「跨运行时共享层 + 各 Agent 保留自有控制面」的所有权架构是同类产品少见的显式设计（README 直接写成 API 归属规则与模块依赖规则）；冻结快照 + 画布证据回放的执行历史把「工作流可审计」做成了产品特性
- 竞品对比 1（Open WebUI 等）：单引擎多模型；本工作台是真正的 multi-runtime 工作区
- 竞品对比 2（LobeChat 插件生态）：插件在聊天层；本工作台把 Kanban/cron/工作流/群聊沉到共享层
- 限制：多 Agent 桌面工作台赛道拥挤（较新的同类产品不断出现），先发架构优势需持续迭代维持
🏷️ 标签说明
- 本地部署: 数据默认落
~/.hermes-web-ui与~/.hermes，桌面/npm/Docker 三路径均本地优先，无云依赖。来源：GitHub README Quick Start - 多Agent协作: 八种运行时共享单聊/群聊/工作流，@提及路由 + 审批门编排多 Agent 协同。来源：GitHub README Core Capabilities
- 可视化工作流: Vue Flow 画布，条件边/循环/审批门/运行预算，执行快照可回放。来源：GitHub README Visual Workflows
- 桌面应用: Electron 原生壳 Win/macOS/Linux，自动更新（Cloudflare 源 + GitHub Releases 回退）。来源：GitHub README Desktop App & Updates
📋 来源核实
- ✅ 已核验: GitHub 仓库 EKKOLearnAI/hermes-studio — 2026-09-17 GitHub API 实时核验：★11,107、🔱1,353、创建 2026-04-11、pushed_at 2026-09-16、BSL-1.1（NOASSERTION 为 GitHub 对非标准 license 的显示方式，仓库 LICENSE 文件自述 BSL-1.1）、TypeScript、open issues 394、topics（agent/hermes/ekko-studio/chat-ui 等）
- ✅ 已核验: README 英文全文 — 2026-09-17 抓取 535 行：曾用名说明、八运行时能力矩阵、Agent/平台边界表、10 平台通道表、40+ 环境变量表、CLI 命令表、架构图、BSL-1.1 声明
- ✅ 已核验: 最新 release v0.7.22（2026-09-16T02:15:57Z 发布，GitHub Releases API）
- ⚠️ 未实测：本站未实际部署该工作台；桥接稳定性、群聊压缩质量、审批门交互、桌面自动更新体验以实际使用为准；BSL-1.1 商用限制条款未逐条核读，商用前自查 LICENSE 原文