如何本地部署 Eigent：多智能体 Cowork 桌面应用完整指南-育师

如何本地部署 Eigent：多智能体 Cowork 桌面应用完整指南

【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent

月底要出一份开发报告，还得刷三个网页找数据、顺手把桌面文件理一遍——这种活你不想自己干，Eigent 就能帮你干。它是一支跑在你电脑本地的 AI 智能体团队，浏览器、终端、文件读写这些工具都由智能体自己调用，不需要你盯着。

当重复工作开始吃掉你的一天 🎬

月度开发报告。让智能体回顾一个月提交的 PR，生成 Word 摘要，再顺手把 Slack 发布文案写出来。你只在最后看一眼结果。

网页数据整理。派一个 Browser Agent 打开页面、截图、填表单，把散落的信息收进一个 Excel，终端命令它自己敲。

定时跑批。配一个触发器，到点自动执行，人不在电脑前活儿也继续推进。

说白了，Eigent 就是把"开网页、敲命令、写文件"变成智能体自己的动作，你只负责派活和验收。

核心能力速览 📦

单智能体模式：一个专注的 Agent 处理明确的单任务
多智能体协作：多个专业 Agent 拆任务、并行执行、汇总结果
定时触发器：周期性工作流到点自动跑
内置浏览器与终端工具包：不用额外装插件就能操作网页和命令行
MCP 集成：通过 MCP 协议把外部工具服务器接进来
模型无关：云 API、企业网关、本地模型随便换
本地优先：文件、凭据、对话数据都留在你机器上

实战演练：三步在本地跑通 Eigent 🛠️

第一步：克隆仓库并安装前端依赖

前提只有一个：Node.js 18~22。克隆代码后装一下依赖，前端就是标准的 Vite + React + Electron 工程：

git clone https://gitcode.com/GitHub_Trending/ei/eigent cd eigent npm install

第二步：启动本地后端服务

官方推荐用 Docker 起本地后端，账号、模型配置、聊天历史全存在本机 PostgreSQL 里，不碰云端。数据库迁移会在容器启动时自动执行：

cd server cp .env.example .env docker-compose up --build -d

起完后 API 跑在3001端口，浏览器打开http://localhost:3001/docs能看到 Swagger 文档，说明服务活着。

第三步：启动前端并发起第一个任务

在项目根目录的.env.development里把前端代理指向本地后端，然后启动，配置好任意一个模型提供商，就能开始派活：

VITE_BASE_URL=/api VITE_USE_LOCAL_PROXY=true VITE_PROXY_URL=http://localhost:3001

npm run dev

机制深挖：智能体的工具是怎么装配的 💡

最值得关注的是工具装配这件事，代码都在 backend/app/agent/factory/ 目录里。

工具不是固定的，是按任务现装的。每次请求进来，工厂根据任务类型从 40 多种工具包里挑需要的挂上去，目录在 backend/app/agent/toolkit/。浏览器工具还会从一个端口池里领一个独占 CDP 端口，任务结束归还，多个智能体同时上网互不干扰。工具包既能原生挂载，也能通过 MCP 协议接入外部服务器，所以理论上能力上限是几百个工具。

委派有深度限制。智能体可以派子任务，但depth < max_depth才允许继续往下委派，默认最大深度是 1。子智能体手里不会再挂"再派智能体"的工具，防止无限套娃把 token 烧穿。

避坑指南：排查部署失败的 4 个方向 💣

现象：前端页面拉不到数据。原因：代理没指向本地后端。解决：确认.env.development里VITE_PROXY_URL=http://localhost:3001，改完重启前端。
现象：智能体第一步就卡住不动。原因：模型提供商没配好，或 API key 过期。解决：先在模型页把 Provider 跑通，再发任务。
现象：触发器收不到回调。原因：外部服务访问不了你的 localhost。解决：按 server/ 目录的部署文档用 ngrok 或正式域名把 3001 端口暴露出去。
现象：浏览器工具一直卡住。原因：CDP 端口被上次没退干净的进程占着。解决：杀掉残留浏览器进程，或重启任务重新领端口。

接下来你可以做的两件事 🏁

Eigent 的核心价值就一句话：本地优先的多智能体工作台，把重复劳动交给智能体团队，数据和文件留在你自己手里。

去把上面的三步完整跑一遍，再翻一翻 backend/app/agent/factory/ 里 browser、developer、document 这些工厂函数，看看哪些工具包是为你的工作流准备的。

【免费下载链接】eigentEigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex项目地址: https://gitcode.com/GitHub_Trending/ei/eigent

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考