Lobe Chat：开源多模型 AI 聊天框架部署指南

LobeHub（原 Lobe Chat，仓库地址为 lobehub/lobe-chat）是大模型生态中备受关注的开源项目，GitHub Star 数约 8.3 万。项目定位是「首席 Agent 运营官」：把你专属的 AI Agent 组织成 7×24 小时不打烊的高效队伍，自动为你招募适配的 AI 队友、调度任务排班、汇总生成工作报告，而你始终掌控全局，无需时刻在线盯守。项目团队是一群充满热情的设计工程师，希望为 AIGC 提供现代化的设计组件和工具，并以开源的方式分享；同时通过 Bootstrap 自举的方式，为开发者和用户提供更加开放、透明友好的产品生态。项目最初以「Lobe Chat」开源聊天框架起家，支持多模型接入与一键部署私人聊天应用，随着多 Agent 能力的演进，现已升级为面向多 Agent 协作的「LobeHub」平台，仓库也随之更名为 lobehub/lobehub，但保留了原有的自托管部署与插件体系。需要注意的是，本项目采用 LobeHub Community License 而非传统 MIT/Apache 协议，二次分发与商用前请仔细阅读许可文件中的条款。本文基于官方 README 完整整理，从项目背景、核心特性、安装部署、环境配置到生态插件进行全面说明，帮助开发者快速完成本地或云端部署。

一、项目官方信息

二、官方图片

项目 README 顶部提供了产品 Banner 与多张功能截图（Agent 运营面板、Agent Builder、协作 Pages、个人记忆等界面），本文封面采用官方仓库图。部署完成后，可在工作台中看到与 README 截图一致的多 Agent 管理界面。

三、项目背景与核心特性

现有 Agent 大多是一次性、以任务为驱动的工具：它们缺乏上下文，孤立运行，需要在不同窗口和模型之间手动交接；即使有记忆，也往往是全局、浅层且缺乏个性的。在这种模式下，用户被迫在分散的对话之间来回切换，难以形成结构化的生产流程。LobeHub 把 Agent 视为工作单元，提供一个让人类与 Agent 共同进化的基础设施，核心特性分为四大板块：

1. 运营：你制定策略，我们负责运行 Agent。 平台统一雇用、排程并汇报整个 AI 团队的工作。你可以把所有 Agent 集中在一个平台上，用更少的工具获得更高生产力；同时通过 IM 网关把 Agent 连接到你每天使用的技能与通讯工具，让 Agent 在后台持续运转而不打扰你的工作节奏。

2. 创建：以 Agent 为工作单元。 构建个性化 AI 团队从 Agent Builder 开始：你只需用自然语言描述一次需求，Agent 配置即可立即启动并自动应用，马上投入使用。它提供统一智能，可以无缝访问任何模型与任何模态，全部由你掌控；并内置超过 10,000 个工具与 MCP 兼容插件，把 Agent 连接到你每天使用的技能。

3. 协作：扩展新型协作网络。 LobeHub 引入 Agent Groups，让你像对待真实队友一样与 Agent 协同工作，系统会为任务自动组装合适的 Agent，支持并行协作与迭代改进。具体包括：Pages（在同一位置与多个 Agent 共同撰写和润色内容，共享上下文）、Schedule（安排定时运行，让 Agent 在合适的时间完成工作，即使你不在场也能继续执行）、Project（按项目组织工作，保持一切结构化且易于跟踪）、Workspace（供团队与 Agent 协作的共享空间，确保明确的所有权和组织内可见性）。这一设计的目标是把过去散落在各个对话窗口里的 Agent 收拢为一支有组织、有分工的团队，你负责制定策略与验收结果，运行与排程交给平台。

4. 进化：人类与 Agent 的共生进化。 最好的 AI 是能深入理解你的那一种。LobeHub 提供构建清晰用户理解的个人记忆（Personal Memory）：Agent 会从你的工作方式中持续学习，调整其行为以在恰当时刻采取行动；同时采用白盒记忆设计——记忆是结构化、可编辑的，你完全掌控 Agent 记住了什么，随时可以查看、修改或删除。

面向的用户既包括普通用户，也包括专业开发者。LobeHub 目前处于积极开发阶段，官方建议在 GitHub 上「收藏项目」，即可无延迟地接收所有发布通知；项目已在 Product Hunt 上线，并长期维护 Star History、贡献者墙等社区数据，欢迎通过 Issues 反馈需求或问题。

四、环境要求与前置准备

部署 LobeHub 之前需要准备：

• OpenAI API Key（必填）：在 OpenAI 平台申请。注册需使用国际手机号与非大陆邮箱；新账户一般有 5 美元免费额度，但有效期仅三个月，长期使用需绑定支付的外币信用卡。
• 部署环境：云端一键部署无需本地开发环境；Docker 部署需本机安装 Docker 与 Docker Compose；本地源码开发需安装 Node.js、pnpm 与可选的 Bun。
• 网络：Vercel 分配的域名 DNS 在部分区域可能被污染，建议绑定自定义域名直连；Zeabur 提供的域名在大多数地区可直接访问。

获取 OpenAI API Key 的两种方式

方式 A：通过 OpenAI 官方渠道。 注册一个 OpenAI 账户，完成后前往 API Keys 页面，点击「Create new secret key」创建新密钥，复制后填写到 LobeHub 的 API Key 配置中即可开始使用。注册后一般有 5 美元免费额度，有效期三个月；长期使用需要完成信用卡绑定，由于 OpenAI 只支持外币信用卡，需自行准备合适的支付渠道。

方式 B：通过第三方代理商。 如果注册 OpenAI 账户或绑定外币信用卡比较麻烦，可以借助知名的 OpenAI 第三方代理商获取 API Key，这能有效降低门槛；但使用三方服务需要自行承担潜在风险。以 AIHubMix 为例，其使用 OpenAI 企业接口，全站模型价格为官方约 86 折，代理地址为 https://aihubmix.com/v1，在 LobeHub 中通过 OPENAI_PROXY_URL 环境变量指向即可。官方 README 特别声明：对第三方 API Key 的有效性和安全性不负责，购买与使用风险请自行承担。

五、部署步骤

方式 A：Vercel / Zeabur / Sealos / 阿里云计算巢一键部署

1. 准备好你的 OpenAI API Key；
2. 在 Vercel、Zeabur、Sealos 或阿里云计算巢上点击对应部署按钮，直接用 GitHub 账号登录即可；
3. 在环境变量页填入 OPENAI_API_KEY（必填），部署完毕即可开始使用；
4. 可选：绑定自定义域名解决 DNS 污染问题。

注意：如果通过 Fork 方式部署，请只保留「upstream sync」Action 并禁用其他 Action；Vercel 默认创建新项目而非 Fork，可能导致无法准确检测更新，建议按官方文档自动同步更新一节重新部署。

方式 B：Docker 部署

官方提供了可在私有设备上自托管的 Docker 镜像（lobehub/lobehub），三步启动：

$ mkdir lobehub-db && cd lobehub-db
$ bash <(curl -fsSL https://lobe.li/setup.sh) -l zh_CN
$ docker compose up -d

详细说明见官方文档使用 Docker 部署。

方式 C：本地源码开发

$ git clone https://github.com/lobehub/lobehub.git
$ cd lobehub
$ pnpm install
$ pnpm run dev          # 全栈开发（Next.js + Vite SPA）
$ bun run dev:spa       # 仅 SPA 前端（端口 9876）

运行 dev:spa 后终端会输出代理 URL（形如 https://app.lobehub.com/_dangerous_local_dev_proxy?debug-host=...），打开此链接即可在线上环境中加载本地开发服务器并支持 HMR 热更新。也可以直接使用 GitHub Codespaces 在线开发。完整教程见构建属于自己的 LobeHub。

部署完成后，首次进入工作台需要在设置页填入模型服务商提供的 API Key；之后即可通过 Agent Builder 用自然语言描述需求来创建专属 Agent，把常用工具和 MCP 插件挂载给 Agent，再通过 Pages、Schedule、Project 等功能把多个 Agent 组织成协作小组。定时任务（Schedule）让你即使关闭电脑，Agent 也能在约定时间继续执行工作并汇报结果。对于团队用户，还可以在 Workspace 中为不同成员分配角色与权限，让 Agent 的产出在团队内共享可见，避免每个人各自维护一套孤立的提示词与对话历史。

六、使用方法与配置

环境变量

自托管时通过环境变量进行额外配置：

完整环境变量清单见官方环境变量文档。

插件体系

插件用于扩展 LobeHub 的 Function Calling 能力，可以引入新的函数调用方式，甚至新的消息结果渲染方式。相关仓库包括：插件索引仓库 lobe-chat-plugins（插件列表从该仓库的 index.json 获取并展示给用户）、插件开发模板 chat-plugin-template（可通过模板快速新建插件项目）、插件 SDK @lobehub/chat-plugin-sdk（帮助你创建出色的 LobeHub 插件），以及基于 Vercel Edge Function 部署的插件网关 @lobehub/chat-plugins-gateway（主要 API POST /api/v1/runner 部署为 Edge Function）。插件系统已完成三期建设：一期实现插件与主体分离、拆分为独立仓库维护并支持动态加载；二期完善插件安全性与使用稳定性、更精准地呈现异常状态；三期提供更高阶的自定义能力，支持插件鉴权与示例。

生态系统

LobeHub 团队还维护了一系列开源前端组件库： @lobehub/ui （源码，构建 AIGC 网页应用的开源 UI 组件库）、 @lobehub/icons （源码，主流 AI / LLM 模型和公司的 SVG Logo 与 Icon 合集）、 @lobehub/tts （源码，AI 语音合成 / 识别 React Hooks 库）、 @lobehub/lint （源码，统一的 ESLint、Stylelint、Commitlint、Prettier、Remark 与 Semantic Release 规范）。此外团队还出品了 Stable Diffusion WebUI 现代主题 Lobe SD Theme、Midjourney WebUI Lobe Midjourney、ChatGPT 驱动的国际化翻译工具 Lobe i18n 以及基于 Gitmoji 的提交信息 CLI Lobe Commit。

七、常见问题（FAQ）

Q：部署后一直提示「有可用更新」是怎么回事？ A：Vercel 默认创建新项目而非 Fork 上游仓库，导致无法准确检测更新。建议按官方文档的自动同步更新步骤重新部署。

Q：在国内无法直接访问 Vercel 分配的域名怎么办？ A：为实例绑定自定义域名即可直连；Zeabur 提供的域名在多数地区目前可直接访问。也可以改用 Docker 部署在自己的服务器上。

Q：没有外币信用卡，如何获得 API Key？ A：可以借助知名第三方模型代理商获取，代理地址填到 OPENAI_PROXY_URL 环境变量即可。但第三方服务的有效性与安全性需自行承担风险，官方 README 对此不做担保。

Q：如何开发自己的插件？ A：从插件开发模板新建项目，配合插件 SDK开发，完成后提交到插件索引仓库即可被其他用户发现。详细指引见官方插件开发文档。

Q：如何参与贡献？ A：项目欢迎各种形式的贡献，可在 Issues 与 Projects 中挑选任务；官方希望打造一个促进知识共享、想法交流、彼此鼓励的技术分享型社区。组织维护者为 @arvinxx 与 @canisminor1990。

Q：团队如何维持开源项目？ A：项目通过 Bootstrap 自举方式运营，并在 Open Collective 接受社区赞助；官方表示每一分支持都会用于项目的持续开发。如果你是模型服务商，认为自己的服务足够稳定且价格实惠，也可以通过 Issue 联系官方，在体验测试后有机会被推荐到第三方代理商列表中。

Q：LobeHub 与传统一次性对话式 AI 工具有什么本质区别？ A：传统工具以单次任务为驱动，Agent 之间没有上下文、需要人工在不同窗口间交接；LobeHub 把 Agent 当作长期工作单元，通过 Agent Groups、Pages、Schedule、Project、Workspace 等机制让多个 Agent 协同工作，并辅以可编辑的个人记忆，使 Agent 随时间越来越理解你的工作方式，从而真正实现「7×24 不打烊」的自动化运营。

八、跳转链接

• 官方仓库：github.com/lobehub/lobe-chat
• 官方文档：lobehub.com/zh/docs
• 自托管教程：构建属于自己的 LobeHub
• Docker 镜像：hub.docker.com/r/lobehub/lobehub
• 插件开发指引：官方 Wiki
• 更新日志：lobehub.com/changelog
• 官方博客：lobehub.com/zh/blog
• 社区讨论：Discord