# LibreChat: chat với mọi mô hình AI trong một giao diện tự host — hướng dẫn cài đặt và dùng

> LibreChat là ứng dụng web chat AI mã nguồn mở (giấy phép MIT) giao diện giống ChatGPT, bạn tự cài trên máy hoặc máy chủ của mình. Một giao diện dùng được nhiều nhà cung cấp AI như Anthropic, OpenAI, Google, Azure, Ollama, kèm Agent, MCP, Code Interpreter và đăng nhập nhiều người. Repo có sẵn file Docker Compose nên người mới cài khá thuận lợi, nhưng README chưa ghi lệnh cài từng bước, bạn cần xem thêm tài liệu chính thức.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-11 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/librechat-chatgpt-ma-nguon-tu-host-nhieu-mo-hinh-ai

LibreChat là một ứng dụng chat AI mã nguồn mở, giao diện lấy cảm hứng từ ChatGPT, và bạn tự cài nó trên máy hoặc máy chủ của mình. Thay vì mở mỗi hãng một trang, bạn gom Claude, OpenAI, Gemini, Mistral, DeepSeek, Ollama… vào cùng một chỗ, đổi mô hình ngay giữa cuộc trò chuyện.

Repo này hợp với ba nhóm người. Thứ nhất là doanh nghiệp nhỏ muốn cho cả team dùng AI mà vẫn kiểm soát dữ liệu và tài khoản. Thứ hai là người đang trả tiền cho nhiều dịch vụ AI và muốn một giao diện chung. Thứ ba là lập trình viên muốn dựng trợ lý riêng (Agent) có công cụ, có MCP, có chạy code.

Điểm đáng giá nhất: nó không chỉ là khung chat. LibreChat có Agent không cần code, Skills, Code Interpreter, tìm kiếm tin nhắn, đăng nhập nhiều người dùng và một Admin Panel để quản lý. Hiện repo có khoảng 47.077 sao và 9.686 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.

```repo
- repo | LibreChat-AI/LibreChat
- kind | Ứng dụng
- desc | LibreChat là nền tảng chat AI mã nguồn mở, tự host, giao diện giống ChatGPT, gộp Claude, OpenAI, Gemini, Ollama… vào một nơi, có Agent, MCP và nhiều người dùng.
- stars | 47k
- lang | TypeScript
- license | MIT
```

## LibreChat làm được gì

### Một giao diện cho nhiều nhà cung cấp AI

LibreChat hỗ trợ Anthropic (Claude), AWS Bedrock, OpenAI, Azure OpenAI, Google, Vertex AI và OpenAI Responses API. Ngoài ra có Custom Endpoints: nếu một dịch vụ tương thích API kiểu OpenAI thì bạn nối vào được mà không cần dựng proxy. README liệt kê thêm các nguồn như Ollama, groq, Cohere, Mistral AI, OpenRouter, Perplexity, Deepseek, Qwen. Lợi ích thực tế: bạn so sánh câu trả lời giữa các mô hình mà không phải đổi trang.

### Agent, Skills và MCP

Agent là trợ lý tùy chỉnh dựng bằng giao diện, không cần viết code. Bạn có thể chia sẻ Agent cho từng người hoặc nhóm cụ thể, và gắn thêm công cụ như MCP server, tìm kiếm file, chạy code. Skills là các gói hướng dẫn `SKILL.md` dùng lại được. README còn nhắc Subagents (giao việc cho Agent con có ngữ cảnh riêng) và Agent Management API (bản beta) để tự động hóa việc quản lý Agent.

### Code Interpreter và Artifacts

Code Interpreter chạy code trong môi trường cô lập, hỗ trợ Python, Node.js, Go, C/C++, Java, PHP, Rust, Fortran. Bạn tải file lên, xử lý, rồi tải kết quả về. Artifacts cho phép AI tạo nội dung React, HTML hoặc sơ đồ Mermaid ngay trong khung chat và xem trước toàn màn hình.

### Tìm web, tạo ảnh, giọng nói

LibreChat có tìm kiếm web, tạo và chỉnh sửa ảnh (ví dụ GPT-Image-1, Stable Diffusion, Flux), và Speech-to-Text/Text-to-Speech với OpenAI, Azure OpenAI, Elevenlabs. Giao diện có tiếng Việt.

### Quản lý hội thoại

Bạn lưu Preset, chuyển endpoint giữa chừng, sửa và gửi lại tin nhắn, rẽ nhánh hội thoại, tìm kiếm toàn bộ tin nhắn. Có thể nhập hội thoại từ ChatGPT hoặc Chatbot UI, xuất ra markdown, text, json. Từ bản v0.8.8 còn có nén ngữ cảnh thủ công khi hội thoại quá dài.

### Nhiều người dùng và quản trị

Đăng nhập bằng OAuth2, LDAP hoặc email, có công cụ kiểm duyệt và theo dõi chi phí token. Admin Panel trên trình duyệt để quản lý người dùng, nhóm, vai trò, và sửa cấu hình mà không cần triển khai lại.

## Cần chuẩn bị gì

Tư liệu README không ghi yêu cầu hệ điều hành hay phiên bản Node cụ thể. Những gì suy ra được từ repo:

- Repo có `Dockerfile`, `docker-compose.yml` và `package.json`, nên có hai hướng chạy: dùng Docker, hoặc chạy bằng Node.
- File `.env.example` có biến `MONGO_URI`, nghĩa là ứng dụng cần một cơ sở dữ liệu MongoDB để kết nối.
- Để chat được, bạn cần ít nhất một nguồn AI. Ví dụ với Claude thì file mẫu có biến `ANTHROPIC_API_KEY`. Key này do nhà cung cấp cấp, thường tính phí theo lượng dùng.
- Muốn dùng mô hình chạy trên máy (như Ollama) thì README nói LibreChat tương thích, nhưng chưa nói cấu hình phần cứng cần thiết.

```note
API key là chìa khóa tính tiền. Đừng dán key vào tin nhắn, ảnh chụp màn hình hay commit lên GitHub. Chỉ để key trong file .env trên máy của bạn.
```

## Cài đặt từng bước

Lưu ý trung thực: README chưa ghi lệnh cài đặt từng bước. Phần hướng dẫn nằm ở tài liệu chính thức tại librechat.ai/docs và các file trong thư mục `docs/` của repo. Các lệnh dưới đây là cách làm phổ thông dựa trên các file có thật trong repo (`docker-compose.yml`, `.env.example`). Bạn nên đối chiếu với tài liệu chính thức trước khi chạy.

```steps
- Cài Docker | Chuẩn bị Docker (có Docker Compose) trên máy
- Tải mã nguồn | Clone repo về và vào thư mục
- Tạo file .env | Sao chép .env.example thành .env
- Điền key | Mở .env, điền thông tin nhà cung cấp AI
- Chạy | Khởi động bằng docker-compose.yml
```

### Cài Docker

README nói các bộ Docker Compose đi kèm cho phép cài bằng một lệnh. Vì vậy hãy cài Docker Desktop (Windows/macOS) hoặc Docker Engine (Linux) theo hướng dẫn của Docker. Phần này README không hướng dẫn.

### Tải mã nguồn

Mở terminal (PowerShell trên Windows, Terminal trên macOS/Linux) ở thư mục bạn muốn đặt dự án, rồi chạy:

```bash
git clone https://github.com/LibreChat-AI/LibreChat.git
cd LibreChat
```

Lệnh đầu tải mã nguồn, lệnh sau đi vào thư mục vừa tải. Người mới hay quên bước `cd`, dẫn tới các lệnh sau báo không tìm thấy file.

### Tạo file .env

Repo có sẵn file mẫu `.env.example`. Bạn sao chép nó thành `.env` để điền cấu hình của mình.

```bash
cp .env.example .env
```

Trên PowerShell, lệnh tương đương:

```powershell
Copy-Item .env.example .env
```

### Điền key và cấu hình

Mở `.env` bằng trình soạn thảo bất kỳ. Các biến có thật trong file mẫu gồm `HOST`, `PORT`, `MONGO_URI`, `DOMAIN_CLIENT`, `DOMAIN_SERVER` và `ANTHROPIC_API_KEY`. Nếu dùng Claude, điền key vào dòng `ANTHROPIC_API_KEY`. Với các nhà cung cấp khác, xem tên biến trong tài liệu chính thức, vì danh sách tôi có chỉ liệt kê một phần.

Cũng có file `librechat.example.yaml` để cấu hình nâng cao như Custom Endpoints. Bạn chưa cần động tới nó ở lần chạy đầu.

### Chạy ứng dụng

Repo có `docker-compose.yml`. Với Docker Compose, lệnh khởi động thông dụng là:

```bash
docker compose up -d
```

Cờ `-d` cho chạy nền. README không ghi lệnh này, nên nếu gặp lỗi hãy xem hướng dẫn Docker trong tài liệu chính thức. Ngoài ra repo còn có `package.json` (tên gói `LibreChat`) cho cách chạy trực tiếp bằng Node, nhưng README chưa ghi các lệnh đó. Hãy xem trong `package.json` mục scripts và trong tài liệu.

## Kiểm tra đã chạy được chưa

Tư liệu không nêu địa chỉ hay màn hình cụ thể sau khi cài. Cách kiểm tra hợp lý:

- Chạy `docker compose ps` để xem các container có ở trạng thái đang chạy không.
- Mở trình duyệt vào địa chỉ khớp với `HOST`, `PORT` hoặc `DOMAIN_CLIENT` bạn đã đặt trong `.env`.
- Nếu thấy trang đăng nhập hoặc đăng ký, tạo tài khoản, chọn một mô hình rồi gửi thử câu "xin chào". Có câu trả lời nghĩa là key và kết nối đã ổn.

Nếu trang không mở, xem log bằng `docker compose logs`. Đây là lệnh Docker phổ thông.

## Dùng vào việc thật

### Chủ shop muốn một trợ lý viết nội dung cho cả team

Bạn là chủ cửa hàng online, có ba nhân viên cần viết mô tả sản phẩm và trả lời khách. Bạn cài LibreChat trên một máy chủ, tạo tài khoản cho từng người, rồi tạo một Agent tên "Viết mô tả sản phẩm" với hướng dẫn về giọng văn của shop. Bạn chia sẻ Agent cho cả nhóm. Mọi người dùng chung một trợ lý nhất quán, còn bạn theo dõi chi phí token qua công cụ có sẵn.

> Một giao diện, nhiều mô hình: bạn chọn thứ hợp việc, không phải bị hãng nào đó chọn thay.
>
> — Ông T

### Nhân viên văn phòng so sánh câu trả lời giữa các mô hình

Bạn cần soạn một email khó. Bạn hỏi cùng một câu bằng Claude, rồi chuyển sang mô hình khác ngay trong hội thoại để xem cách diễn đạt nào hợp hơn. Sau đó dùng tính năng sao chép tin nhắn dạng rich text để dán vào email hoặc tài liệu, giữ nguyên định dạng. Cuối tuần, bạn tìm lại nội dung cũ bằng ô tìm kiếm tin nhắn.

### Người làm báo cáo cần xử lý file

Bạn có một file dữ liệu và cần tính toán nhanh. Bạn tải file lên, bật Code Interpreter rồi gõ prompt mẫu: "Đọc file này, tổng hợp theo tháng và vẽ biểu đồ cột". Công cụ chạy code Python trong môi trường cô lập và trả kết quả để bạn tải về. Khả năng này README ghi là có, nhưng cần thiết lập dịch vụ code interpreter theo tài liệu.

### Lập trình viên nối công cụ qua MCP

Bạn là dev, đã có một MCP server dùng cho việc nội bộ. Bạn tạo Agent trong LibreChat, gắn MCP server vào làm công cụ, và thêm một Skill bằng file `SKILL.md` mô tả quy trình làm việc. Cả team gọi Agent này từ trình duyệt mà không phải cài gì trên máy cá nhân.

## Lỗi hay gặp và cách xử lý

### Không kết nối được cơ sở dữ liệu

Ứng dụng cần MongoDB qua biến `MONGO_URI`. Nếu log báo lỗi kết nối, kiểm tra container MongoDB đã chạy chưa và giá trị `MONGO_URI` trong `.env` có đúng không. Nếu dùng Docker Compose của repo, hãy giữ nguyên cấu hình mặc định trước khi chỉnh.

### Gửi tin nhắn nhưng không có phản hồi hoặc báo lỗi key

Thường do key sai, thiếu, hoặc tài khoản nhà cung cấp hết hạn mức. Mở lại `.env`, kiểm tra không có khoảng trắng hay dấu ngoặc thừa quanh key. Sau khi sửa `.env`, khởi động lại ứng dụng để nó đọc giá trị mới.

### Cổng bị chiếm hoặc không mở được trang

Nếu một chương trình khác đang dùng cùng cổng, ứng dụng sẽ không lên. Đổi `PORT` trong `.env` sang số khác rồi chạy lại. Kiểm tra `DOMAIN_CLIENT` và `DOMAIN_SERVER` cho khớp với địa chỉ bạn thực sự truy cập.

### Cập nhật xong thì hỏng

README cảnh báo: trước khi cập nhật, hãy đọc changelog để biết thay đổi phá vỡ tương thích. Repo cũng có file `UPGRADING.md`. Hãy sao lưu dữ liệu và file `.env` trước khi nâng cấp.

### Lộ ứng dụng ra Internet mà chưa bảo vệ

Nếu bạn đưa LibreChat lên máy chủ công khai, ai cũng có thể thử đăng ký. Hãy xem phần xác thực và quyền truy cập trong tài liệu, và đừng chia sẻ địa chỉ rộng rãi khi chưa cấu hình xong. Các tính năng thử nghiệm như Attached workspaces (cho Agent chạy lệnh) README gọi là rất thử nghiệm, nên đừng bật trên hệ thống quan trọng.

## Có nên dùng không

**Điểm mạnh:** miễn phí phần mềm (MIT), tự host nên bạn nắm cấu hình và nơi lưu dữ liệu, hỗ trợ rất nhiều nhà cung cấp, có Agent, MCP, Code Interpreter, đa người dùng và Admin Panel. Giao diện có tiếng Việt. Dự án đông người dùng và vẫn được cập nhật.

**Giới hạn:** README không có hướng dẫn cài từng bước, nên người mới phải đọc thêm tài liệu. Bạn vẫn phải tự trả tiền API cho các nhà cung cấp, và tự lo máy chủ, MongoDB, sao lưu, cập nhật. Một số tính năng mới (Agent Management API, Attached workspaces) còn ở dạng beta hoặc rất thử nghiệm.

**Khi nào chọn cách khác:** nếu bạn chỉ dùng một dịch vụ AI cho cá nhân và không muốn bảo trì gì, dùng thẳng web hoặc app của hãng đó sẽ nhẹ nhàng hơn. LibreChat đáng cài khi bạn cần gom nhiều mô hình, chia sẻ cho nhiều người, hoặc muốn kiểm soát hạ tầng của mình.

## Câu hỏi thường gặp

### LibreChat có miễn phí không?

Phần mềm là mã nguồn mở với giấy phép MIT nên dùng không mất tiền bản quyền. Tuy nhiên, khi nối với các dịch vụ AI như Anthropic hay OpenAI bạn cần API key và phải trả phí theo nhà cung cấp. Chi phí máy chủ nếu bạn tự host cũng do bạn chịu.

### LibreChat có cần GPU không?

Tư liệu không nêu yêu cầu GPU. Nếu bạn gọi mô hình qua API của các hãng thì máy bạn chỉ cần chạy ứng dụng web. Còn chạy mô hình cục bộ qua Ollama thì README chỉ nói là tương thích, chưa có thông tin về cấu hình phần cứng.

### Chạy được trên Windows không?

README không ghi rõ danh sách hệ điều hành. Repo có Dockerfile và docker-compose.yml, nên hướng phổ biến là cài Docker rồi chạy. Bạn nên xem tài liệu chính thức tại librechat.ai/docs để biết hướng dẫn cho Windows.

### Dữ liệu của tôi có an toàn không?

LibreChat là nền tảng tự host, nên dữ liệu hội thoại nằm trên hệ thống do bạn quản lý. README nói Code Interpreter chạy trong môi trường cô lập và có xác thực đa người dùng (OAuth2, LDAP, email). Tuy vậy nội dung bạn gửi tới nhà cung cấp AI vẫn đi qua dịch vụ của họ, và mức độ an toàn còn phụ thuộc cách bạn cấu hình.

### LibreChat khác gì ChatGPT?

Giao diện lấy cảm hứng từ ChatGPT, nhưng LibreChat gom nhiều nhà cung cấp (Claude, OpenAI, Gemini, Ollama…) vào một nơi và bạn tự host. Nó có thêm Agent, MCP, Skills, Preset, Admin Panel và đăng nhập nhiều người. Đổi lại bạn phải tự cài đặt và vận hành.

### Có dùng được MCP và Agent không?

Có. README ghi LibreChat hỗ trợ Model Context Protocol cho công cụ, và có Agent không cần code, có thể chia sẻ cho người dùng hoặc nhóm. Cũng có Skills dạng SKILL.md và Subagents. Chi tiết cấu hình nằm trong tài liệu chính thức.

### Có giao diện tiếng Việt không?

Có. Danh sách ngôn ngữ giao diện trong README có Tiếng Việt cùng nhiều ngôn ngữ khác.
