100% 本地运行！手把手教你用 Eigent 搭建你的AI智能体团队

在尝试部署 AI 工具时，很多人都会遇到一个难题：如何既能充分利用它们的强大能力，又不至于把敏感数据暴露在外。

现在大多数平台都依赖云端，看似省心，但一旦涉及客户资料、财务信息或者内部知识产权，隐私和安全问题立刻凸显出来。多智能体系统带来效率和扩展性固然重要，但对开发者来说，数据本地可控、运行过程透明，以及在本机独立部署的能力，才是真正安心的关键。

这也正是 Eigent 的价值所在。

Eigent 是一个 本地优先（local-first）的多智能体桌面应用。它不会把你的数据上传到外部服务器，而是直接在本地运行。你可以完全掌握执行过程，确保文件、凭证和日志始终留在自己的电脑上。可以把它理解为搭建你自己的 “AI 工作团队”。你可以启动不同的智能体，每个都有独特的能力：

• 搜索智能体 （Search Agent）：高效检索网络信息

• 开发智能体 （Developer Agent）：运行和调试代码

• 文档智能体 （Document Agent）：撰写和编辑文件

• 多模态智能体 （Multi-modal Agent）：处理图像、音频等内容

Eigent 会自动为你协调这些智能体，让它们并行工作、任务衔接，最终交付完整结果。

环境准备

在开始之前，请先确保以下条件：

• Node.js (v18 或更高版本) 与 npm：Eigent 基于 Node/Electron 构建。推荐安装 Node.js 18–22。小提示：你可以从官网下载安装，或者使用版本管理工具。

• 内存与硬件：建议至少 8 GB 内存 以保证流畅运行。如果你主要调用外部 API（如 OpenAI、Anthropic），CPU 即可满足需求。但若希望在本地直接运行 大型模型，一块性能良好的 GPU（如 NVIDIA RTX 系列） 会大幅提升速度。

• 操作系统：Eigent 支持在主流系统（Windows、macOS）上本地部署，下文的步骤与操作系统无关。

• Docker：请提前安装并启动 Docker。

1. 克隆仓库并启动 PostgreSQL 后端

首先，将 Eigent 的代码仓库克隆到本地并安装依赖：

这样，你就能在本机获得完整的源代码。接下来，进入 server 目录，使用 Docker 启动服务：

这条命令会根据项目自带的 docker-compose.yml 文件启动两个容器：

• PostgreSQL 数据库（作为 Eigent 的数据存储）

• Eigent API 服务

它们都会在本地运行（例如 API 默认在 localhost:3001 提供服务）。上图演示了 Docker 拉取镜像并启动 eigent_postgres 和 eigent_api 两个容器的过程。

通过 Docker Compose，本地即可同时运行 Postgres 数据库和 API 服务。

默认情况下，Docker 会为 PostgreSQL 创建一个持久化卷，因此所有数据库文件都会保存在你的磁盘上，而不是内存里。

2. 验证本地数据存储

这个时候，所有服务都已经在本地运行了。PostgreSQL 容器（eigent_postgres）负责保存数据库。你可以通过列出 Docker container来确认，或者在container中使用 psql 工具进行检查。Eigent 的所有操作（智能体消息、用户数据、任务日志等）都会写入这个本地的 Postgres 实例。不会有任何数据被发送到你的机器之外。

所有 Eigent 数据都存储在本地 Docker 化的 PostgreSQL 数据库中。

这种方式从设计上就保证了隐私性。正如文档所说，自托管的一大优势就是数据隐私，你可以将敏感数据完全保存在自己的基础设施内。事实上，在这种部署方式下，工作区信息或登录凭证都不会离开你的本地网络。Eigent 默认就是完全本地化运行，你可以随时检查！放心，数据一直都会在你自己的掌控之中。

3. 在 .env.development 中设置本地代理

接下来，我们需要让前端连接到本地后端，而不是云端服务。在项目根目录下（eigent/.env.development），开启本地代理配置。用文本编辑器打开 .env.development 文件，并确认其中包含以下内容：

通过设置 VITE_USE_LOCAL_PROXY=true，并将 VITE_PROXY_URL 指向 http://localhost:3001，你就能让前端把所有 API 请求发送到本地 Docker 后端。下面的截图展示了 .env.development 文件中的相关配置：

编辑 .env.development：将 VITE_PROXY_URL 设为 http://localhost:3001，并启用 VITE_USE_LOCAL_PROXY=true 以开启本地模式。

注意，一定要去掉这些行前面的 # 或注释符号，配置才会生效。完成后，前端应用就会将请求代理到你的本地服务器，而不是外部的 demo API。

4. 启动前端应用

返回仓库根目录，安装 JavaScript 依赖并启动开发服务器：

这一步会在本地启动 Eigent 的前端应用。默认情况下，它会运行在http://localhost:3000。
结合前面对 .env 文件的修改，前端会将所有 API 请求发送到http://localhost:3001，全部都在你的本机内部完成。

这里不需要任何云端凭证，本质上就是一个常规的 Node 本地开发构建。

5. 本地访问 Eigent UI

Eigent 的登录界面会在本地启动。虽然需要登录，但整个过程完全在本机完成，不依赖任何外部服务。

你可以放心，这里的登录仅用于本地应用。所有凭证和数据都会保存到之前启动的本地 Postgres 数据库，而不是云端服务器。换句话说，即使界面上显示的是类似 OAuth 的登录方式，所有认证和用户数据都只存在于你的本机。文档也特别强调了这种本地优先的设计理念：“你的数据始终保存在自己的设备中，从根本上解决隐私与安全问题”。

完成登录后，你会进入主面板，可以创建自定义智能体、定义工作流以及配置工具。

例如，在工具/设置页面，你可以启用或关闭内置的集成（如网页搜索、Google Docs、Slack 等）；在模型选择界面（如下图所示），你可以选择或配置自己偏好的大语言模型。接下来的所有数据，例如智能体消息、工具产出和知识库内容，都会完整地保存在你的PostgreSQL数据库和本地文件系统中，不会外泄，除非你手动导出。

在本地运行的 Eigent UI 里，你可以自由配置集成工具，比如 Slack、网页搜索等。

同时，你也可以在设置中选择想要给智能体使用的模型或 API。

需要注意的是，如果是在本地模式下运行，模型的 API Key 或 Endpoint 需要你自己手动配置。

查看视频版完整教程

如果你更喜欢直观的操作演示，我们准备了一份完整的视频教程。从启动 Docker 到本地登录 Eigent，每一步都有详细讲解。

到这里，你已经能在本地跑起一套 Eigent AI 工作流系统啦，完全自托管，真正属于你自己的 AI 团队～没有云端限制，也不用担心数据泄漏，所有智能体都在你的电脑里，按照你的规则协同工作！

👉 仓库地址：https://github.com/eigent-ai/eigent
自己动手克隆一下试试吧！

也欢迎给我们 GitHub 上顺手点个 ⭐️ 支持一下呀～

如果你在部署过程中遇到问题，有新的功能想法，或者想分享你在 Eigent 上做的项目，都非常欢迎和我们交流。

Discord 社区：https://discord.camel-ai.org
Discord上有CAMEL内部团队成员和国内外的开发者，大家会一起答疑、交流思路，甚至合作探索新的工作流！欢迎大家加入！

您也可以扫码加入我们的微信群，一起讨论更多玩法。