Eigent 开源 Cowork 桌面端教程：4 个智能体如何跑通你的自动化工作流-港品优选

Eigent 开源 Cowork 桌面端教程：4 个智能体如何跑通你的自动化工作流

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

Eigent 是一个开源的 Cowork 桌面应用：把复杂工作流拆给一组可编排的 AI 智能体并行处理，本地部署、免费，定位是 Claude Cowork 和 Codex 的本地替代方案。

图1：npm run dev启动后浏览器中打开的桌面端开发页面（E2E 测试截图），正式界面会在此基础上展示会话、项目与智能体面板

认识 Eigent：一个能替你跑流程的桌面工作台

先说结论：Eigent 解决的是"一个人干一堆跨工具脏活"的问题。比如既要查资料、又要改文件、还要在网页上填表单，这类任务在 Eigent 里不是一个聊天框，而是分给不同智能体执行：

Browser Agent：操作内置浏览器，搜索、采集、填表单
Terminal Agent：在本机执行命令、跑脚本
Document Agent：读写文档、生成报告
File Manager Agent：整理本地文件目录

智能体工厂和工具包的实现在 backend/app/agent/，工具集（浏览器、终端、搜索、文档等）集中在 backend/app/agent/toolkit/。

图2：Eigent 首页背景中的四大智能体分工示意——浏览器、终端、文档、文件管理各自负责一类工具能力

它适合谁？需要把"查资料→处理数据→出文档"这类流程重复执行的人，尤其是希望数据和凭据留在本机、不想接云账号的开发者。技术栈是 Electron + React + TypeScript 前端（src/）、FastAPI 后端（backend/ 和 server/），多智能体框架基于 CAMEL。

5分钟启动步骤：两条路径任选其一

Eigent 有两条启动路径，先看懂再动手：

路径	前置要求	说明
快速体验（连云后端）	Node.js 18–22、npm	3 条命令跑起来，需要注册云账号
本地部署（推荐）	Docker Desktop、Python 3.12、Node.js 18+	数据全部存本机，无云账号

路径一：快速体验（连云后端）

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

启动后会自动打开默认浏览器。注意：这条路径连接 Eigent 云服务，首次使用需要注册账号。

路径二：本地部署（推荐，完全离线可控）

完整指南在 server/README_EN.md，核心步骤：

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

后端 API 起在3001端口，PostgreSQL 用5432，数据库迁移由 Alembic 在容器启动时自动执行。然后在前端项目根目录创建.env.development指向本地后端：

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

再回根目录执行npm install && npm run dev。此时注册、模型配置、聊天记录全部落在本地 Postgres 里，不经过任何云。

功能精读：3 个值得上手的核心能力

单智能体与 Workforce 多智能体协作

能做什么：单智能体模式用一个"元智能体"处理聚焦任务（写代码、调试、查资料）；Workforce 模式把任务拆给多个专业智能体并行执行，走完整的多步工作流。前端流程编辑器在 src/components/WorkFlow/，多智能体调度后端在 backend/app/agent/factory/。

怎么操作：会话面板里有会话模式切换（src/components/Session/ 下的 SingleAgent / Workforce 两个入口）。单智能体直接对话；Workforce 模式用 Add Worker 挑选参与的智能体（src/components/AddWorker/），然后描述任务。

预期看到什么：单智能体下你会看到一条连续的思考—工具调用—结果链路；Workforce 模式下多个智能体卡片各自展开，分头执行、结果汇总到同一个会话里。

内置浏览器与终端工具集

能做什么：不用自己搭环境，智能体直接驱动内置浏览器（搜索、采集网页、填表单）和本机终端（跑命令、装依赖）。这是 Eigent 区别于纯聊天机器人的关键——它是"有手的"。

怎么操作：正常对话即可触发，例如让智能体"访问某文档站并整理 API 列表"，它会调起浏览器智能体；需要装依赖、跑脚本时走终端智能体。工具集源码在 backend/app/agent/toolkit/，浏览器类工具有 crawl4ai、hybrid_browser 等多个实现可选。

预期看到什么：浏览器任务里能看到页面快照和操作步骤，终端任务能看到命令输出，两者都以消息流形式挂在对应智能体卡片下。

Automation：定时触发器

能做什么：把工作流排成定时任务，让智能体在你离开时继续干活。前端在 src/components/Trigger/，后端定时执行逻辑在 server/app/domains/trigger/。

怎么操作：进入 Triggers 页签，新建触发器、设置执行计划（SchedulePicker 组件支持可视化选时间）和任务指令，保存后按状态开关启停。

预期看到什么：触发器列表里能看到状态、上次执行时间和 token 消耗；执行完成后在 Execution Logs 面板里回看每次运行的日志和异常。

实战指南：3 个可以马上复现的任务

任务一：验证本地后端是否真正跑起来了

按上面路径二启动 Docker 服务
浏览器打开http://localhost:3001/docs，能看到 Swagger UI 即后端就绪
在 Swagger 里对/register用"邮箱 + 密码"注册一个账号，再调/login拿本地签发的 token

能拿到 token，说明整套本地数据链路（注册、登录、存储）已在你机器上闭环，可以关掉云服务。

任务二：配一个本地模型，跑第一个文档任务

在应用内注册并登录（本地模式下账号存本地库）
进入 Settings > Models，选择本地推理后端（Ollama、vLLM、LM Studio 均可），填入模型地址
新建会话，用单智能体模式发送指令："读取当前项目 README，总结它的安装步骤和端口配置"
验证点：智能体应通过文件工具读到 README 内容，并在回复中列出端口 3001/5432 等关键信息，而不是复述你已知的常识

任务三：建一个每日定时触发器

打开 Triggers 页签，点新建
填写任务指令（如"汇总今日聊天记录中的待办事项并写入 summary.md"），选择每天固定时间执行
保存后先手动触发一次，到 Execution Logs 里确认日志无报错，再等一个周期看自动执行记录

⚠️ 如果触发器需要外部系统通过 webhook 回调进来，本地回环地址是够不到的，这一点后面避坑指南会展开。

避坑指南：5 个真实会踩的坑

坑1：npm run dev报版本相关错误→ 原因：前端要求 Node.js 18–22，版本过新或过旧都可能出问题。 → 解决：node -v检查，不在区间内就换版本再重装 node_modules。

坑2：uv run uvicorn main:api一直卡住不动→ 原因：uv 的锁文件残留（uv_installing.lock/uv_installed.lock）。 → 解决：删掉这两个锁文件重试，或直接用.venv/bin/python main.py绕过 uv（backend/README.md 有完整备选命令）。

坑3：本地后端起来了，界面却还在连云服务→ 原因：前端默认指向云后端，本地模式必须显式开启。 → 解决：项目根目录建.env.development，写入VITE_USE_LOCAL_PROXY=true等三个变量后重启 dev server。

坑4：触发器 webhook 永远不触发→ 原因：入站 webhook 需要外部服务能通过 HTTPS 回调你的服务器，本地局域网地址不可达。 → 解决：本地开发用 ngrok 暴露端口，生产环境用公网域名 + SSL。

坑5：端口被占，Docker 服务起不来→ 原因：API 占3001、PostgreSQL 占5432，与本机已有服务冲突。 → 解决：改server/.env中的端口映射，改完docker compose down && docker-compose up --build -d重建。

💡 进阶玩法一句话带过：想跑完全离线环境，只配置本地模型和本地 MCP 服务器，不要填任何外部 Provider 和远程 MCP 地址（server/README_EN.md 末尾有说明）。

资源与下一步

关键入口

本地部署完整指南：server/README_EN.md
后端（智能体、工具集）：backend/app/agent/
本地服务（账号、模型、MCP、触发器域）：server/app/domains/
前端（会话、触发器、工作流）：src/components/
贡献规范：CONTRIBUTING.md

三步马上能做的事

用路径一（4 条命令）把应用跑起来，先熟悉单智能体对话的节奏
按任务二配置一个本地模型（Ollama 最省心），验证数据不出本机
把"整理桌面文件"或"生成周报"这类你每周都做的活，写成一个定时触发器，观察它连续几天自动执行的结果

Eigent 的价值不在某一个智能体有多强，而在于浏览器、终端、文档、文件四类能力被塞进了同一台桌面应用里，让"多步跨工具"的任务第一次可以整段交给系统。跑通第一个触发器之后，你会自然知道下一个想自动化的流程是什么。

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

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

企业官网建设流程全解析