# LobeHub: đưa trợ lý AI vào nhóm chat và tự host — hướng dẫn cài đặt và dùng

> LobeHub là nền tảng mã nguồn mở để đưa các "super-agent" (trợ lý AI tự nhận việc) vào nhóm chat và quy trình làm việc của bạn. Bạn có thể dùng bản cloud hoặc tự cài bằng Docker Compose, chỉ cần vài lệnh. Cài trên Linux, macOS hoặc Windows (qua WSL 2) đều được, nhưng muốn dùng thật thì bạn cần thêm bước cấu hình nhà cung cấp mô hình AI.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-04 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/lobehub-lobehub-tro-ly-ai-cho-nhom-huong-dan-cai-dat

LobeHub là một nền tảng mã nguồn mở viết bằng TypeScript, cho phép bạn thêm các trợ lý AI (tác giả gọi là "super-agent") vào những cuộc chat mà nhóm bạn đang dùng. Các trợ lý này tự nhận việc, làm song song nhiều việc cùng lúc và theo lời tác giả thì "tốt lên mỗi tuần" khi bạn dùng nhiều hơn. Hiện repo có khoảng 85.000 sao và 16.000 fork, nên đây là một trong những dự án agent được quan tâm nhiều.

Ai nên dùng? Nếu bạn là chủ doanh nghiệp nhỏ, nhân viên văn phòng hay lập trình viên mới và muốn có một nơi chung để chat với AI, giao việc, lưu trí nhớ và nối với Discord, Slack, Telegram… thì LobeHub đáng thử. Bạn có thể dùng bản cloud của họ hoặc tự chạy trên máy mình để giữ dữ liệu ở lại với bạn.

Điểm đáng giá nhất là tính "một chỗ cho tất cả": nhiều mô hình, nhiều agent, chợ agent/MCP/skill có sẵn, và có cả cách tự host bằng Docker Compose rất ngắn. Bạn xem video ngắn bên dưới để thấy giao diện trước khi cài.

```repo
- repo | lobehub/lobehub
- kind | Ứng dụng
- desc | LobeHub là nền tảng mã nguồn mở để tạo và quản lý nhiều trợ lý AI làm việc trong nhóm của bạn, có thể tự cài trên máy hoặc máy chủ riêng bằng Docker.
- stars | 85k
- lang | TypeScript
```

```video
- youtube | https://youtube.com/shorts/GzLqif367hI
- facebook | https://www.facebook.com/reel/1190449916638325
- title | Video giới thiệu lobehub
```

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

README mô tả bốn đặc điểm của một "super-agent". Mình diễn giải lại theo lợi ích thực tế:

- **Truy cập linh hoạt**: bạn nối được ứng dụng nhắn tin, agent hoặc mô hình bạn thích vào cùng một nơi. Bạn không bị khóa vào một hãng AI duy nhất.
- **Làm việc song song**: agent chạy nhiều tác vụ cùng lúc, bạn khỏi phải ngồi theo dõi từng việc.
- **Tự tìm việc**: agent nhận những việc hợp với nó mà không cần ai chuyển lời. Ví dụ README kể một yêu cầu tính năng được đăng trên Discord, chưa ai giao, agent tự nhận, và bạn chỉ vào duyệt kết quả.
- **Càng dùng càng giỏi**: mỗi lần bạn sửa lỗi cho agent, nó giữ lại thành bài học.

Ngoài ra, tài liệu của dự án liệt kê nhiều phần bạn dùng được ngay:

- **Lobe AI**: agent có sẵn, chat, viết, nghiên cứu, viết code mà không cần dựng gì thêm.
- **Agent Team**: nhiều agent phối hợp theo kiểu tuần tự, song song, lặp hoặc tranh luận.
- **Kết nối agent ngoài**: đưa Claude Code, Codex, OpenClaw, Hermes vào, kèm ngữ cảnh dự án và quyền hạn.
- **Tasks**: giao việc, theo dõi trạng thái, bình luận tiếp, chạy một lần hoặc theo lịch.
- **Memory**: các ký ức có cấu trúc để bạn xem, sửa, xóa.
- **Pages** và **Resource Library**: viết tài liệu dài bằng Markdown cùng agent; kho tài liệu, ảnh, bản nháp để agent trả lời dựa trên đó.
- **Channels**: bot riêng của bạn trên Discord, Slack, Telegram, LINE, QQ, WeChat, Feishu và Lark.
- **Tích hợp GitHub**: theo dõi pull request của agent; merge nghĩa là chấp nhận kết quả, kiểm tra lỗi thì quay lại cho agent sửa.
- **Chợ (Marketplace)**: agent, MCP server, skill định dạng `SKILL.md` (README nói chạy được cả trong Claude Code, Codex CLI và ChatGPT) và bộ icon AI.
- **Nhà cung cấp mô hình**: tài liệu có hướng dẫn cho hơn 40 nhà cung cấp, nền tảng suy luận và mô hình chạy local.

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

Theo README, bạn cần:

- **Hệ điều hành**: cách Docker Compose chạy trên Linux và macOS. Trên Windows thì chạy qua WSL 2.
- **Docker** có lệnh `docker compose`: bước cài đặt dùng lệnh này. README chưa ghi phiên bản cụ thể.
- **curl** và **bash**: script cài đặt được tải bằng `curl` rồi chạy bằng `bash`.
- **Khóa API của nhà cung cấp mô hình AI**: để agent trả lời được, bạn cần cấu hình ít nhất một nhà cung cấp. File `.env.example` trong repo có biến `OPENAI_API_KEY`. Danh sách đầy đủ các biến nằm trong tài liệu "Environment Variables" trên trang chủ.
- Nếu chạy bằng Vercel: cần cơ sở dữ liệu PostgreSQL, lưu trữ tương thích S3 và vài khóa bí mật (README nói thế, hướng dẫn chi tiết ở trang tài liệu Vercel).
- Nếu muốn phát triển/sửa code: README dùng `pnpm` và `bun`. README chưa ghi phiên bản Node cụ thể.

README không ghi yêu cầu GPU hay cấu hình RAM, nên mục này chưa có thông tin.

```note
Khóa API (như OPENAI_API_KEY) là thứ có thể bị tính tiền theo lượng dùng. Đừng dán nó vào chat, ảnh chụp màn hình hay đẩy lên GitHub. Nếu cho cả nhóm dùng chung bản tự host, hãy cân nhắc ai được vào và giới hạn chi phí ở phía nhà cung cấp.
```

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

Cách README khuyến nghị là Docker Compose. Mình tóm tắt trước:

```steps
- Chuẩn bị môi trường | Có Docker, curl, bash; trên Windows dùng WSL 2
- Tạo thư mục | Tạo thư mục lobehub và đi vào đó
- Chạy script cài đặt | Tải script setup và chạy với ngôn ngữ tiếng Anh
- Khởi động | Chạy docker compose up -d để bật các dịch vụ
- Mở trình duyệt | Vào http://localhost:3210 và cấu hình mô hình AI
```

### Mở terminal đúng chỗ

Trên Linux hoặc macOS, mở ứng dụng Terminal. Trên Windows, README yêu cầu dùng WSL 2, nghĩa là bạn mở cửa sổ Ubuntu (hoặc bản Linux khác) trong WSL rồi gõ lệnh ở đó, không gõ trong PowerShell thường. Chỗ này người mới hay vấp nhất: lệnh có `bash <(...)` chỉ chạy trong môi trường kiểu Linux.

### Tạo thư mục và chạy script cài

Ba lệnh dưới đây chép đúng từ README:

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

Giải thích:

- `mkdir lobehub && cd lobehub`: tạo thư mục tên `lobehub` rồi đi vào trong. Mọi file cấu hình sẽ nằm ở đây, bạn nên chọn chỗ dễ nhớ.
- `bash <(curl -fsSL https://lobe.li/setup.sh) -l en`: tải script cài đặt và chạy ngay. Phần `-l en` là tùy chọn ngôn ngữ mà README dùng (en là tiếng Anh).
- `docker compose up -d`: bật toàn bộ dịch vụ ở chế độ nền. Theo README, bộ này gồm LobeHub, PostgreSQL, Redis, RustFS (lưu file), SearXNG (tìm kiếm) và agent gateway.

Lần đầu chạy có thể mất một lúc vì Docker phải tải các thành phần về.

### Mở LobeHub

Mở trình duyệt và vào địa chỉ:

```text
http://localhost:3210
```

Cổng, chế độ mạng LAN, chế độ tên miền và cách nâng cấp được nói trong hướng dẫn Docker Compose trên trang tài liệu của dự án. README chưa ghi các bước cấu hình mô hình trong giao diện, bạn xem mục "Model Providers" và "Environment Variables" trong tài liệu.

### Các cách cài khác

- **Triển khai một chạm**: README có nút Vercel, Zeabur, Sealos, RepoCloud và Alibaba Cloud. Riêng Vercel cần PostgreSQL, lưu trữ S3 và vài khóa bí mật trước khi bấm.
- **Chạy để phát triển** (dành cho dev). Các lệnh trong README:

```bash
git clone https://github.com/lobehub/lobehub.git
cd lobehub
pnpm install
bun run dev
bun run dev:spa
```

`bun run dev` chạy bản full-stack (Next.js + Vite SPA). `bun run dev:spa` chỉ chạy phần giao diện (cổng 9876). README còn nói sau khi chạy `dev:spa`, terminal sẽ in một đường dẫn proxy để bạn phát triển giao diện với backend thật. Đó chỉ để tiện phát triển, không phải chỗ để kiểm chứng thay đổi cuối cùng.

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

Cách đơn giản nhất: sau khi `docker compose up -d` chạy xong, mở `http://localhost:3210`. Nếu thấy giao diện LobeHub hiện ra, nghĩa là dịch vụ đã lên. Bạn cũng có thể gõ `docker compose ps` trong thư mục `lobehub` để xem các dịch vụ đang chạy (lệnh Docker phổ thông, không phải lệnh riêng của LobeHub).

Bước thử thật sự là gửi một tin nhắn cho Lobe AI sau khi đã cấu hình khóa API của nhà cung cấp mô hình. Nếu nhận được câu trả lời thì bạn đã xong. README chưa mô tả chi tiết màn hình đầu tiên, nên nếu giao diện khác mô tả của mình, hãy theo tài liệu trên trang chủ.

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

Dưới đây là các tình huống bám đúng những gì README và tài liệu nói. Cách thao tác chi tiết từng nút, bạn xem trong tài liệu chính thức.

> Bắt đầu với một agent, việc nào lặp lại thì mới thêm agent thứ hai.
>
> — Ông T

### Chủ shop nhỏ: trợ lý chung cho cả nhóm bán hàng

Bạn có nhóm chat trên Telegram hoặc Discord và hay hỏi lặp lại cùng một loại câu: soạn mô tả sản phẩm, trả lời khách, tóm tắt đơn. Bạn dùng tính năng Channels để tạo bot riêng trên kênh đó, rồi gắn một agent với vai trò (system role) và mô hình bạn chọn. Nếu có tài liệu giá, chính sách đổi trả, bạn đưa vào Resource Library để agent trả lời dựa trên đó. Kết quả: cả nhóm hỏi một chỗ, câu trả lời bám tài liệu của shop thay vì bịa chung chung.

### Nhân viên văn phòng: giao việc theo lịch

Mỗi tuần bạn phải tổng hợp báo cáo hoặc soạn bản nháp thông báo. Bạn dùng Tasks để giao việc cho agent, theo dõi trạng thái và bình luận thêm khi cần, hoặc đặt chạy một lần hay theo lịch (README nói Tasks hỗ trợ cả hai). Phần viết dài thì dùng Pages để soạn Markdown cùng agent. Kết quả: bạn chỉ còn việc đọc, sửa và duyệt, không phải mở đầu từ trang trống mỗi lần.

### Lập trình viên: để agent làm việc trên GitHub

Bạn dùng Claude Code hoặc Codex và muốn quản lý chúng từ một chỗ. Theo tài liệu, bạn có thể kết nối agent ngoài vào LobeHub kèm ngữ cảnh dự án và quyền hạn. Với tích hợp GitHub, bạn theo dõi pull request của agent: merge là chấp nhận kết quả, còn kiểm tra thất bại sẽ quay lại cho agent xử lý. Kết quả: bạn vẫn là người duyệt cuối, nhưng không phải chuyển lời qua lại.

### Người làm công cụ: đăng MCP server hoặc skill lên chợ

Nếu bạn có một MCP server riêng, README cho hai cách. Cách một là nhờ agent bằng câu lệnh mẫu sau:

```text
Read https://lobehub.com/publish-mcp/skill.md and follow the instructions to publish my MCP server to the LobeHub Marketplace
```

Cách hai là dùng CLI (thay `OWNER/REPOSITORY` bằng repo của bạn):

```bash
npx -y @lobehub/market-cli login
npx -y @lobehub/market-cli plugin submit https://github.com/OWNER/REPOSITORY
```

Với skill, README nói bạn gửi một repo GitHub từ trang Skills marketplace. Kết quả: công cụ của bạn xuất hiện trên chợ để người khác thêm vào workspace.

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

README không có mục xử lý lỗi, nên dưới đây là những lỗi rất dễ gặp với loại công cụ chạy bằng Docker. Chúng là gợi ý chung, không phải nội dung chép từ tài liệu.

### Lệnh `bash <(curl ...)` báo lỗi trên Windows

Nguyên nhân thường gặp: bạn gõ trong PowerShell hoặc CMD. README nói trên Windows cần chạy qua WSL 2. Hãy mở cửa sổ WSL (ví dụ Ubuntu) và gõ lại ba lệnh ở đó.

### `docker compose` không chạy hoặc báo không kết nối được Docker

Thường do Docker chưa được cài hoặc chưa bật. Hãy mở Docker rồi thử lại. Nếu vẫn lỗi, kiểm tra xem lệnh `docker compose` có hoạt động độc lập không.

### Mở `localhost:3210` không thấy gì

Có thể các dịch vụ chưa khởi động xong (lần đầu chạy khá lâu), hoặc cổng đã bị ứng dụng khác dùng. Chờ một lúc rồi tải lại. Cổng và các chế độ truy cập được nói trong hướng dẫn Docker Compose của dự án.

### Vào được giao diện nhưng agent không trả lời

Thường là bạn chưa cấu hình nhà cung cấp mô hình hoặc khóa API sai. Xem mục "Model Providers" và "Environment Variables" trong tài liệu, rồi điền khóa đúng chỗ. Đừng dán khóa vào chat.

### `pnpm install` hoặc `bun run dev` báo không tìm thấy lệnh

Máy bạn chưa cài `pnpm` hoặc `bun`. README dùng cả hai nhưng chưa ghi cách cài, bạn xem hướng dẫn trong Development Guide hoặc trang chủ từng công cụ. Nếu chỉ muốn dùng chứ không sửa code, không cần bước này, cứ dùng Docker Compose.

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

**Điểm mạnh:**

- Cài tự host chỉ với vài lệnh, bộ dịch vụ đi kèm khá đầy đủ (cơ sở dữ liệu, lưu file, tìm kiếm).
- Một nơi cho nhiều thứ: chat, agent, task, trí nhớ, tài liệu, kết nối nhiều ứng dụng nhắn tin.
- Có chợ agent, MCP, skill và hơn 40 nhà cung cấp mô hình được hướng dẫn.
- Dự án còn được cập nhật trong vài tháng gần đây và cộng đồng lớn.

**Giới hạn cần biết:**

- Đây là hệ thống khá lớn (gồm nhiều dịch vụ), nên nặng hơn một công cụ chat đơn giản. README chưa nêu yêu cầu phần cứng.
- Chính README nói dự án "đang được phát triển tích cực", nên giao diện và tính năng có thể thay đổi.
- Bạn vẫn cần tự lo khóa API và chi phí mô hình.
- Về giấy phép: phần cuối README ghi "LobeHub Community License". Nếu bạn dùng cho mục đích thương mại hoặc phân phối lại, hãy đọc kỹ file LICENSE trong repo trước.
- Cách bản cloud xử lý dữ liệu, README chưa mô tả. Muốn dữ liệu ở lại với bạn thì chọn tự host.

**Khi nào nên chọn cách khác:** nếu bạn chỉ cần hỏi đáp nhanh với một mô hình, một ứng dụng chat đơn giản là đủ. Nếu bạn muốn bắt đầu nhẹ nhàng mà không dựng máy chủ, hãy thử bản cloud của LobeHub trước. Khi nhóm đã quen và cần giữ dữ liệu riêng, bạn mới chuyển sang tự host.

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

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

README cho phép tự host và có bản cloud riêng, nhưng không nêu giá. Dù tự host, bạn vẫn có thể phải trả phí cho nhà cung cấp mô hình AI mà bạn dùng. Giấy phép được ghi là LobeHub Community License, bạn nên đọc file LICENSE trước khi dùng thương mại.

### Cài LobeHub có cần GPU không?

README không nêu yêu cầu GPU hay RAM. Cách cài khuyến nghị chạy các dịch vụ bằng Docker Compose và kết nối tới nhà cung cấp mô hình. Nếu bạn muốn chạy mô hình local thì cần xem tài liệu Model Providers.

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

Có, nhưng theo README thì thông qua WSL 2. Docker Compose chạy trên Linux và macOS, còn trên Windows bạn mở môi trường WSL rồi chạy các lệnh cài đặt ở đó. Ngoài ra repo cũng nhắc đến ứng dụng cho macOS, Windows, Linux và mobile trong tài liệu.

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

README nói bạn có thể chạy LobeHub trên hạ tầng của mình và giữ dữ liệu với mình. Chưa có thông tin chi tiết về cách bản cloud lưu trữ hoặc bảo mật dữ liệu. Nếu dữ liệu nhạy cảm, bạn nên chọn tự host và tự quản lý quyền truy cập.

### Chạy lệnh cài xong thì mở ở đâu?

Sau khi chạy docker compose up -d, bạn mở trình duyệt vào http://localhost:3210 theo đúng README. Nếu muốn đổi cổng, chạy ở chế độ LAN hoặc tên miền, bạn xem hướng dẫn Docker Compose trong tài liệu của dự án.

### Tôi cần khóa API nào?

File .env.example trong repo có biến OPENAI_API_KEY, và README nói tài liệu hướng dẫn hơn 40 nhà cung cấp mô hình. Bạn cần cấu hình ít nhất một nhà cung cấp thì agent mới trả lời được. Danh sách đầy đủ các biến nằm trong tài liệu Environment Variables.

### Skill trong LobeHub có dùng được ở công cụ khác không?

README nói skill trên chợ của LobeHub dùng định dạng mở SKILL.md và cũng chạy được trong Claude Code, Codex CLI và ChatGPT. Chi tiết cách tương thích từng công cụ chưa được mô tả trong README, bạn xem trang Skills trên lobehub.com.
