# LobeHub: thêm super-agent vào nhóm chat để tự nhận việc — hướng dẫn cài đặt và dùng

> LobeHub là một ứng dụng mã nguồn mở để tạo và quản lý nhiều AI agent, rồi đưa chúng vào các kênh chat nhóm như Discord, Slack, Telegram. Bạn có thể dùng bản cloud hoặc tự cài trên máy mình bằng Docker Compose. Cách cài chính chỉ vài lệnh, nhưng cần quen với Docker và terminal.

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

LobeHub là một nền tảng mã nguồn mở để bạn tạo, quản lý và giao việc cho các AI agent. Mô tả của chính tác giả là "Super-Agents on Your Team": thêm agent vào những kênh chat nhóm bạn đang dùng, để chúng tự nhận việc và làm tốt hơn theo thời gian. Repo hiện có khoảng 85.166 sao và 16.258 fork, viết chủ yếu bằng TypeScript.

Bạn nên xem repo này nếu làm việc theo nhóm và muốn AI không chỉ ngồi trả lời trong một khung chat riêng. Chủ shop có nhóm Telegram, nhân viên văn phòng dùng Slack, hay dev có cộng đồng trên Discord đều là những người phù hợp. Bạn cũng có thể dùng ngay bản cloud, hoặc tự cài trên máy chủ riêng để giữ dữ liệu ở chỗ của mình.

Điểm đáng giá nhất là cách nó nghĩ về agent như một đồng nghiệp mới: có ngày đầu làm quen, có việc đầu tiên, có đánh giá sau vài tháng, và mỗi lần bạn sửa lỗi thì nó ghi nhớ thành bài học. Bạn có thể 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 để thêm AI agent vào các kênh chat của nhóm, tự nhận việc, chạy song song và tự học dần. Có bản cloud và bản tự cài 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ì

Tư liệu của repo mô tả bốn điều làm nên một "super-agent". Mình diễn giải lại theo lợi ích thực tế.

- **Kết nối linh hoạt.** Bạn nối được nhiều ứng dụng chat, nhiều agent và nhiều model vào cùng một chỗ. Lợi ích: không phải chuyển qua lại giữa các công cụ rời rạc.
- **Làm việc song song.** Agent chạy nhiều việc cùng lúc, bạn không phải ngồi theo dõi từng việc một.
- **Tự tìm việc.** Ví dụ có người đăng một yêu cầu tính năng trong Discord mà chưa ai nhận. Agent có thể nhận việc đó, và bạn chỉ cần vào một lần để duyệt kết quả.
- **Càng dùng càng giỏi.** Mỗi lần bạn sửa sai, nó giữ lại thành bài học để lần sau ít lỗi hơn.

Ngoài bốn ý trên, phần tài liệu liệt kê nhiều mảng cụ thể mà người dùng sẽ gặp:

- **Lobe AI**: agent có sẵn, dùng để chat, viết code, nghiên cứu, viết nội dung mà không cần cấu hình gì.
- **Agent Team**: nhiều agent phối hợp theo kiểu tuần tự, song song, lặp lại hoặc tranh luận.
- **Kết nối agent bên ngoài**: đưa Claude Code, Codex, OpenClaw, Hermes và một số agent khác vào, kèm ngữ cảnh dự án và phân quyền.
- **Tasks**: giao việc, theo dõi trạng thái, trao đổi qua bình luận, chạy một lần hoặc theo lịch.
- **Memory**: các "ký ức" có cấu trúc mà bạn xem, sửa và xóa được.
- **Pages và Resource Library**: viết tài liệu dài bằng Markdown cùng agent, và kho tài liệu, hình ảnh để agent trả lời dựa trên đó.
- **Channels và Messenger**: bot riêng của bạn trên Discord, Slack, Telegram, LINE, QQ, WeChat, Feishu, Lark; hoặc chat với agent qua bot của LobeHub trên Telegram, Slack, Discord, WeChat.
- **Tích hợp GitHub**: theo dõi pull request của agent; merge nghĩa là chấp nhận kết quả, còn check lỗi thì được trả lại cho agent.
- **Chợ (Marketplace)**: agent, MCP server và skill do cộng đồng chia sẻ. Skill dùng định dạng `SKILL.md` mở, README nói chúng cũng chạy được trong Claude Code, Codex CLI và ChatGPT.
- **Nhiều nhà cung cấp model**: 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à model chạy cục bộ.

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

Tư liệu không liệt kê yêu cầu chi tiết cho từng cách dùng. Những gì có thể khẳng định từ README:

- **Cách dễ nhất, không cần cài:** dùng bản LobeHub Cloud trên trang chủ. Bạn không phải chuẩn bị gì thêm ngoài tài khoản.
- **Tự host bằng Docker Compose (cách README khuyên dùng):** chạy được trên Linux và macOS, hoặc trên Windows thông qua WSL 2. Lệnh trong README dùng `docker compose`, nên bạn cần có Docker. README không nêu số phiên bản Docker cụ thể.
- **Bộ phần mềm đi kèm:** bản Docker Compose khởi động LobeHub cùng PostgreSQL, Redis, kho lưu file RustFS, công cụ tìm kiếm SearXNG và agent gateway. Bạn không phải cài từng thứ riêng.
- **Triển khai một cú nhấp:** với Vercel, bạn cần một cơ sở dữ liệu PostgreSQL, kho lưu trữ tương thích S3 và một vài khóa bí mật trước khi deploy.
- **Để chạy phát triển trên máy:** README dùng `pnpm` và `bun`. README không ghi số phiên bản Node, pnpm hay bun, nên bạn xem thêm trong hướng dẫn phát triển của dự án.
- **API key:** để agent trả lời bạn cần một model. Trong file `.env.example` của repo có biến tên `OPENAI_API_KEY`. README không nói chi tiết cách điền khi chạy bằng Docker Compose, nên bạn xem mục Model Providers và Environment Variables trong tài liệu chính thức.
- **Phần cứng:** README không nêu yêu cầu cấu hình cụ thể, cũng không nói có cần GPU hay không.

```note
API key của model là thứ để bạn tiêu tiền. Đừng dán key vào ảnh chụp màn hình, tin nhắn nhóm hay commit lên GitHub. Nếu cho nhiều người cùng dùng, hãy kiểm tra chi phí trên trang quản lý của nhà cung cấp model.
```

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

Mình hướng dẫn cách tự host bằng Docker Compose vì README gọi đó là cách khuyên dùng.

```steps
- Mở terminal | Dùng Linux, macOS hoặc WSL 2 trên Windows
- Tạo thư mục | Tạo thư mục lobehub và đi vào trong đó
- Chạy script cài | Tải và chạy script thiết lập bằng ngôn ngữ tiếng Anh
- Khởi động | Dùng docker compose để bật toàn bộ dịch vụ
- Mở trình duyệt | Vào địa chỉ localhost cổng 3210
```

### Mở terminal đúng chỗ

README nói cách này chạy trên Linux và macOS, hoặc Windows qua WSL 2. Nếu bạn dùng Windows, hãy mở cửa sổ WSL (ví dụ Ubuntu) rồi gõ lệnh ở đó, đừng gõ vào PowerShell thường vì lệnh dưới đây là cú pháp bash. Bạn cũng cần Docker đã chạy sẵn.

### Tạo thư mục làm việc

Lệnh dưới tạo thư mục `lobehub` rồi đi vào trong. Mọi file cấu hình sinh ra sẽ nằm ở đây, nên đừng chạy lệnh ở thư mục lộn xộn.

```bash
mkdir lobehub && cd lobehub
```

### Chạy script thiết lập

Lệnh này tải script từ địa chỉ của dự án và chạy nó. Tham số `-l en` chọn ngôn ngữ tiếng Anh cho quá trình thiết lập.

```bash
bash <(curl -fsSL https://lobe.li/setup.sh) -l en
```

Chỗ người mới hay vấp: dòng này có ký tự `<(`. Nếu bạn gõ sang PowerShell hoặc cmd, nó sẽ báo lỗi cú pháp. Hãy chắc chắn bạn đang ở bash. Ngoài ra, chạy script tải từ mạng về nghĩa là bạn tin nguồn đó; nếu muốn chắc ăn, hãy mở địa chỉ script trong trình duyệt để đọc trước khi chạy.

### Khởi động các dịch vụ

Lệnh này bật toàn bộ dịch vụ ở chế độ nền (`-d`), nên terminal không bị chiếm.

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

Lần đầu Docker phải tải nhiều thành phần nên có thể mất một lúc, tùy tốc độ mạng của bạn.

### Mở trình duyệt

Sau khi xong, mở địa chỉ sau trên cùng máy đang chạy:

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

Về cổng, truy cập qua mạng LAN, dùng tên miền riêng và cách nâng cấp, README chỉ dẫn sang hướng dẫn Docker Compose trong tài liệu chính thức.

### Cách khác: chạy bản phát triển trên máy

Cách này dành cho lập trình viên muốn sửa code. README ghi các lệnh sau (trong README có dấu `$` ở đầu dòng, bạn không gõ dấu đó):

```bash
git clone https://github.com/lobehub/lobehub.git
cd lobehub
pnpm install
bun run dev       # Full-stack (Next.js + Vite SPA)
bun run dev:spa   # Chỉ giao diện SPA (cổng 9876)
```

Chọn một trong hai lệnh `dev` cuối: lệnh đầu chạy cả frontend lẫn backend, lệnh thứ hai chỉ chạy giao diện. Bạn cần có sẵn `pnpm` và `bun`. Ngoài ra README còn nhắc có thể dùng GitHub Codespaces để phát triển trực tuyến.

### Cách khác: deploy một cú nhấp

README có nút deploy cho Vercel, Zeabur, Sealos, RepoCloud và Alibaba Cloud. Riêng Vercel cần chuẩn bị PostgreSQL, kho lưu trữ tương thích S3 và vài khóa bí mật trước. Bạn đọc hướng dẫn Vercel trong tài liệu chính thức để làm từng mục.

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

Theo README, dấu hiệu thành công rất rõ ràng: sau khi chạy `docker compose up -d`, bạn mở được `http://localhost:3210` và thấy giao diện LobeHub.

Nếu trang không lên, hãy kiểm tra theo thứ tự này:

1. Chạy `docker compose ps` trong thư mục `lobehub` để xem các dịch vụ có đang chạy không.
2. Chờ thêm một lúc rồi tải lại trang, vì lần đầu khởi động có thể chậm.
3. Xem log bằng `docker compose logs` nếu có dịch vụ bị dừng.

Tư liệu không mô tả chi tiết màn hình đầu tiên, nên bạn xem phần "Get LobeHub" và "Lobe AI" trong tài liệu chính thức để biết bước tiếp theo.

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

Dưới đây là các tình huống bám theo những tính năng README và tài liệu mô tả. Cách bấm cụ thể trong giao diện bạn xem thêm trong tài liệu từng mục, vì tư liệu mình có không mô tả từng nút.

> Agent tốt không phải cái trả lời nhanh nhất, mà là cái bị sửa một lần thì lần sau không sai nữa.
>
> — Ông T

### Chủ shop có nhóm Telegram chăm sóc khách

Bối cảnh: bạn bán hàng online, nhóm chat có nhân viên và vài khách quen. Bạn muốn một trợ lý đọc lại lịch sử và trả lời câu hỏi lặp đi lặp lại.

Cách làm: dùng mục Channels để tạo bot riêng trên Telegram, gắn với một agent, rồi nạp bảng giá và chính sách đổi trả vào Resource Library để agent trả lời dựa trên đó. Với ngày đầu, bạn có thể nhắn kiểu như sau (câu mẫu của mình):

```text
Hãy đọc lịch sử nhóm, tóm tắt các câu hỏi khách hay hỏi nhất và chào mọi người.
```

Kết quả bạn nhận được: một agent có thể đọc lại lịch sử, chào các thành viên và trả lời theo tài liệu bạn đưa. Mỗi khi nó trả lời sai, bạn sửa lại, và theo README điều chỉnh đó được giữ lại như một bài học.

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

Bối cảnh: mỗi tuần bạn phải tổng hợp báo cáo, soạn nội dung họp, hoặc viết tài liệu dài.

Cách làm: 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. Tài liệu nói rõ việc có thể chạy một lần hoặc theo lịch. Với tài liệu dài, dùng Pages để viết cùng agent bằng Markdown. Câu giao việc mẫu:

```text
Mỗi sáng thứ Hai, tóm tắt các tài liệu mới trong thư viện và soạn bản nháp báo cáo tuần.
```

Kết quả: bạn nhận bản nháp, góp ý bằng bình luận và agent chỉnh lại, thay vì tự soạn từ đầu.

### Lập trình viên dùng agent code kết hợp GitHub

Bối cảnh: bạn có cộng đồng trên Discord, người dùng hay đăng yêu cầu tính năng nhưng không ai nhận.

Cách làm: kết nối agent bên ngoài như Claude Code hoặc Codex qua mục Connect External Agents (có ngữ cảnh dự án và phân quyền), rồi bật tích hợp GitHub. Theo README, bạn theo dõi pull request của agent: merge nghĩa là chấp nhận công việc, còn nếu check lỗi thì kết quả được trả lại cho agent xử lý.

Kết quả: agent làm phần việc lặp lại, còn bạn chỉ duyệt ở bước cuối. Với repo thật, hãy bắt đầu bằng một repo thử trước và giới hạn quyền của agent.

### Người làm công cụ AI chia sẻ skill hoặc MCP server

Bối cảnh: bạn có một MCP server riêng và muốn đưa lên chợ để người khác dùng.

Cách làm: README ghi hai đường. Đường thứ nhất là bảo agent của bạn làm giúp bằng câu lệnh sau:

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

Đường thứ hai là dùng CLI, thay `OWNER/REPOSITORY` bằng repo GitHub của bạn:

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

Kết quả: MCP server của bạn được gửi lên LobeHub Marketplace. Với skill, bạn gửi repo GitHub từ trang Skills của chợ; với agent, bạn gửi từ phần cài đặt của agent trong LobeHub.

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

Tư liệu không có mục xử lý lỗi, nên dưới đây là các lỗi rất dễ xảy ra với loại công cụ này. Với lỗi riêng của LobeHub, hãy xem tài liệu và mục Issues của repo.

**Lệnh `bash <(curl ...)` báo lỗi cú pháp.** Nguyên nhân thường là bạn đang gõ trong PowerShell hoặc cmd. Hãy mở WSL 2 (hoặc terminal Linux/macOS) rồi chạy lại.

**Lệnh `docker compose` không chạy hoặc báo không kết nối được Docker.** Docker chưa được cài hoặc chưa khởi động. Hãy bật Docker trước, đợi nó sẵn sàng, rồi chạy lại `docker compose up -d`.

**Mở `http://localhost:3210` không thấy gì.** Có thể dịch vụ còn đang khởi động, hoặc cổng bị chiếm. Chạy `docker compose ps` để xem trạng thái, và `docker compose logs` để đọc lỗi. Muốn đổi cổng, đọc hướng dẫn Docker Compose của dự án thay vì tự sửa file.

**Agent không trả lời vì chưa có model.** Agent cần một model và thường là API key của nhà cung cấp. Kiểm tra mục Model Providers trong tài liệu và đảm bảo key đúng, còn hạn mức. Tuyệt đối không dán key vào nơi công khai.

**`pnpm install` hoặc `bun run dev` lỗi.** Thường do thiếu công cụ hoặc phiên bản không khớp. README không ghi số phiên bản, nên hãy xem file `package.json` và hướng dẫn phát triển. Nếu chỉ muốn dùng, chạy bằng Docker Compose sẽ ít rắc rối hơn.

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

**Điểm mạnh.** LobeHub gom nhiều thứ vào một chỗ: chat, agent, nhiều model, kênh chat nhóm, giao việc theo lịch, bộ nhớ có thể xem và sửa. Bạn có thể tự host để giữ dữ liệu của mình. Repo có tài liệu rộng, chợ agent và skill, và hiện vẫn được cập nhật trong vài tháng gần đây. Skill dùng định dạng `SKILL.md` mở nên có thể mang sang công cụ khác.

**Giới hạn.** README nói thẳng 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 tự host chạy cả một bộ dịch vụ (cơ sở dữ liệu, Redis, lưu trữ file, tìm kiếm), nghĩa là bạn phải tự lo vận hành, sao lưu và nâng cấp. Phần giấy phép: README ghi "LobeHub Community License", còn thông tin repo không nêu rõ, nên nếu định dùng cho doanh nghiệp, hãy đọc kỹ file LICENSE trước. Nếu bạn dùng agent kết nối với kênh chat thật hoặc repo thật, hãy cấp quyền vừa đủ.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần một khung chat AI đơn giản cho một người, bản cloud hoặc một công cụ chat nhẹ hơn là đủ. Nếu bạn không quen terminal và Docker, hãy bắt đầu bằng LobeHub Cloud thay vì tự cài. Nếu có yêu cầu bảo mật hay tuân thủ nghiêm ngặt, hãy đọc tài liệu tự host và xác thực trước khi đưa dữ liệu thật vào.

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

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

Repo là mã nguồn mở và bạn có thể tự host. README cũng có bản LobeHub Cloud nhưng tư liệu không nêu giá. Khi dùng model bên ngoài, chi phí API key sẽ do nhà cung cấp model tính.

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

README nói cách Docker Compose chạy trên Linux và macOS, hoặc trên Windows thông qua WSL 2. Ngoài ra có ứng dụng cho macOS, Windows, Linux và di động theo mục tài liệu "Get LobeHub". Chi tiết cài từng bản bạn xem trong tài liệu chính thức.

### Có cần GPU để chạy không?

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng. Tài liệu có nhắc hỗ trợ model chạy cục bộ, nhưng chi tiết phần cứng thì chưa có thông tin trong README.

### 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 riêng mình để giữ dữ liệu ở chỗ bạn. Tuy vậy, khi dùng model của bên thứ ba, nội dung bạn gửi sẽ đi qua nhà cung cấp đó, nên hãy xem chính sách của họ. Phần bảo mật chi tiết tư liệu chưa nêu.

### Cài LobeHub có khó không?

Với Docker Compose chỉ cần ba lệnh: tạo thư mục, chạy script thiết lập, rồi docker compose up -d, sau đó mở localhost cổng 3210. Khó nhất là chuẩn bị Docker, WSL 2 nếu dùng Windows, và cấu hình model. Nếu không muốn cài, bạn có thể dùng bản Cloud.

### LobeHub khác gì một khung chat AI thông thường?

Theo README, LobeHub hướng tới agent làm việc trong nhóm: nối với các kênh chat, nhận và theo dõi việc, chạy song song, có bộ nhớ và kết nối agent khác như Claude Code hay Codex. Tư liệu không so sánh trực tiếp với công cụ cụ thể nào.

### Giấy phép của LobeHub là gì?

README ghi "LobeHub Community License", trong khi thông tin repo không nêu rõ giấy phép. Nếu bạn định dùng cho mục đích thương mại, hãy đọc file LICENSE trong repo trước khi triển khai.
