# Rakazo: đồng đội AI tự host, chọn model và sandbox riêng — hướng dẫn cài đặt và dùng

> Rakazo là ứng dụng mã nguồn mở (Apache-2.0) để chạy các bot AI bền vững trên máy hoặc server của bạn, có trí nhớ, routine theo lịch và một máy tính riêng cho mỗi bot. Bạn tự chọn model và nơi chạy sandbox (Docker, đám mây hoặc máy bạn). Cài bằng một script, cần Docker, nên người mới làm được nếu quen mở terminal.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-02 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/rakazo-tro-ly-ai-tu-host-chon-model-va-sandbox

Rakazo là một ứng dụng mã nguồn mở, tự host, đóng vai bản thay thế cho Grok Bot. Mỗi bot trong Rakazo giống một đồng đội AI lâu dài: có trí nhớ riêng, có lịch làm việc (routine), có ứng dụng kết nối và có cả một máy tính riêng để mở trình duyệt, gõ lệnh, làm việc với tệp. Bạn chạy nó trên máy của mình, với model của mình.

Nếu bạn đang dùng các chatbot trả lời một lần rồi quên, Rakazo đi theo hướng khác. Bạn giao việc, bot nhớ bối cảnh, chạy theo lịch hoặc khi có email, có webhook, và báo kết quả lại. Dân văn phòng, chủ shop thích tự động hoá, và lập trình viên mới muốn thử một hệ agent hoàn chỉnh đều có thể dùng.

Điểm đáng giá nhất là bạn giữ quyền kiểm soát. Bạn chọn model bằng khoá API của chính mình, chọn nơi chạy sandbox, và dữ liệu nằm trên server do bạn dựng. Hiện repo có khoảng 8111 sao và 1476 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong vài tháng gần đây.

```repo
- repo | elie222/rakazo
- kind | Ứng dụng
- desc | Rakazo là bản mã nguồn mở, tự host của Grok Bot: bot AI có trí nhớ, lịch chạy và máy tính riêng, dùng model và khoá API của chính bạn.
- stars | 8.1k
- lang | TypeScript
- license | Apache-2.0
```

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

Dưới đây là các tính năng chính theo README, kèm lợi ích thực tế.

- **Mỗi bot có một máy tính riêng.** Bot có trình duyệt, terminal, tệp và cả màn hình desktop đầy đủ. Bạn xem nó làm việc, có thể nhận quyền điều khiển để tự đăng nhập một trang nào đó, rồi trả lại cho bot. Nhờ vậy bot làm được cả những việc không có API.
- **Bot làm việc theo nhóm.** Bạn đưa nhiều bot vào một nhóm chat và @nhắc tên. Chúng chia việc, kiểm tra chéo và báo cáo lại. README cũng nhắc tới ủy quyền và subagent.
- **Routine.** Bạn cho một bot chạy theo lịch, khi có email, hoặc khi có webhook, và xem lại được từng lần chạy. Đây là phần hợp với việc lặp lại hằng ngày.
- **Pages.** Bot tạo bảng điều khiển (dashboard) và tài liệu sống. Bạn mở toàn màn hình, chia sẻ bằng liên kết và hỏi thêm về nội dung đó.
- **Ứng dụng kết nối.** Gmail, Slack, GitHub, Notion, Linear và hàng nghìn ứng dụng khác, cộng với MCP server và công cụ OpenAPI của riêng bạn.
- **Bộ nhớ.** Bot nhớ bối cảnh giữa các lần trò chuyện.
- **Chat giọng nói và cuộc gọi.**
- **Chọn model tuỳ ý bằng khoá của bạn.** Không bị khoá vào một nhà cung cấp.
- **Sandbox linh hoạt.** Chạy trong Docker, trên đám mây hoặc ngay trên máy bạn. README liệt kê các nhà cung cấp tuỳ chọn: e2b, novita, daytona, createos, boat, boxd, instabox, railway.
- **Dùng trên mọi thiết bị.** Web, desktop, iPhone, iPad và Android đều nói chuyện với cùng một server.

Giao diện web hỗ trợ nhiều ngôn ngữ (trong README có English, Deutsch, 日本語, Español, Français và một số ngôn ngữ khác). README không liệt kê tiếng Việt, nên bạn nên dùng giao diện tiếng Anh. Bạn vẫn có thể trò chuyện với bot bằng tiếng Việt, tuỳ model bạn chọn.

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

Có hai đường cài, và mỗi đường cần thứ khác nhau.

**Cách nhanh (dùng image đã build sẵn):**

- Docker Engine và plugin Compose.
- curl và OpenSSL.
- Không cần clone repo, không cần cài Node.

**Cách chạy từ mã nguồn (dành cho người muốn sửa code):**

- Node.js 24.15.0 trở lên trong dòng 24.x, hoặc Node.js 26 trở lên. Node.js 25.x không được hỗ trợ.
- pnpm 12.
- Docker.

Bạn cũng cần một model để bot làm việc. Bạn có thể kết nối nhà cung cấp model được hỗ trợ ngay trong lúc làm quen ban đầu (onboarding), hoặc đặt `OPENROUTER_API_KEY` khi chạy từ mã nguồn. Khoá API là của bạn và thường tính phí theo nhà cung cấp.

README không nói rõ yêu cầu cấu hình phần cứng tối thiểu hay hệ điều hành nào được kiểm chứng cho cách cài nhanh. Phần ứng dụng desktop có nhắc macOS/Windows/Linux gián tiếp (Docker Desktop, OrbStack, AppImage trên Linux). Nếu cần chắc chắn, bạn xem self-hosting guide trong thư mục docs của repo.

```note
Khoá API model và khoá của nhà cung cấp sandbox đều có thể phát sinh chi phí. Đừng dán khoá vào ảnh chụp màn hình hay gửi cho người khác. Mỗi dịch vụ đám mây tuỳ chọn như Railway cũng tính phí theo mức dùng, README ghi rõ là sandbox Railway được tính theo mức sử dụng.
```

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

```steps
- Kiểm tra công cụ | Chắc là máy đã có Docker, Compose, curl và OpenSSL
- Chạy installer | Tải file cấu hình, tạo .env với khoá ngẫu nhiên và khởi động Rakazo
- Mở giao diện web | Vào địa chỉ 127.0.0.1:5173, tạo tài khoản, kết nối model
- Tạo bot đầu tiên | Giao việc thử cho bot
- (Tuỳ chọn) Chạy trên server | Dùng cùng installer trên VPS để bot chạy liên tục
```

### Kiểm tra công cụ cần có

Mở terminal (PowerShell hoặc Terminal trên máy bạn, hoặc terminal trên VPS) và kiểm tra bốn công cụ. Các lệnh này là lệnh phổ thông, không nằm trong README, nhưng chỉ để xem phiên bản.

```bash
docker --version
docker compose version
curl --version
openssl version
```

Nếu lệnh nào báo không tìm thấy, bạn cài công cụ đó trước. Người mới hay vấp ở chỗ đã cài Docker Desktop nhưng chưa mở nó lên, nên các lệnh Docker sẽ báo lỗi kết nối. Hãy mở Docker và đợi nó chạy hẳn.

### Chạy installer

README ghi đúng một khối lệnh. Lệnh này tạo thư mục `rakazo`, vào trong đó, tải script cài và chạy nó:

```bash
mkdir -p rakazo && cd rakazo &&
curl -fsSLO https://raw.githubusercontent.com/elie222/rakazo/main/infra/compose/install-images.sh &&
bash install-images.sh
```

Script này tải các file Compose, tạo file `.env` với các khoá bí mật ngẫu nhiên, rồi khởi động Rakazo. Nếu bạn chạy lại, nó giữ nguyên file `.env` đang có, nên không lo bị mất cấu hình.

Lưu ý: lệnh `bash` cần môi trường giống Linux/macOS. Trên Windows, bạn nên chạy trong Git Bash hoặc WSL, README không hướng dẫn riêng cho PowerShell ở phần này. Image mặc định có tag `edge` (bản build từ nhánh main, cho `linux/amd64` và `linux/arm64`).

Nếu mạng của bạn bị hạn chế, README nhắc ba cách: đặt biến `RAKAZO_DOWNLOAD_BASE` để đổi nguồn tải, dùng `--local` hoặc `RAKAZO_DOWNLOAD_SKIP_EXISTING` để bỏ qua file Compose đã có, hoặc tự mirror URL của script. Chi tiết nằm ở mục Restricted networks / mirror downloads trong tài liệu repo.

README còn có file SETUP_PROMPT.md cho kiểu cài có agent hỗ trợ. Bạn mở file đó trong repo nếu muốn thử.

### Mở giao diện web và kết nối model

Mở trình duyệt vào `http://127.0.0.1:5173`, tạo tài khoản, rồi kết nối một model. Máy tính Docker cục bộ được bật sẵn theo mặc định, nên bot có thể có máy tính riêng ngay mà không cần tài khoản đám mây.

Chỗ dễ vấp: tài khoản bạn tạo ở đây là tài khoản trên server của chính bạn, không phải tài khoản trên dịch vụ của bên thứ ba.

### Tạo bot đầu tiên

Sau khi kết nối model, bạn tạo bot đầu tiên theo giao diện. README chỉ nói đến bước này ngắn gọn ở cuối phần chạy từ mã nguồn (tạo bot đầu tiên sau khi tạo tài khoản và kết nối model), không mô tả chi tiết từng nút. Bạn cứ làm theo màn hình.

### Chạy trên server (tuỳ chọn)

Muốn bot chạy 24/7, bạn đặt backend trên một VPS. Dùng cùng installer, nhưng chia làm hai lần:

```bash
bash install-images.sh --prepare-only
# edit .env: SANDBOX_PROVIDER=boat (or e2b / daytona / createos) with its API key, RAKAZO_HOST=your.domain
bash install-images.sh
```

Lần đầu với `--prepare-only` chỉ chuẩn bị file. Bạn mở `.env` sửa `SANDBOX_PROVIDER` (boat, e2b, daytona hoặc createos) cùng khoá API tương ứng, và `RAKAZO_HOST` thành tên miền của bạn. Sau đó chạy lần hai.

Hãy đặt HTTPS phía trước cổng 5173. Tài liệu `docs/self-host-production.md` trong repo hướng dẫn cấu hình Caddy và gia cố máy chủ. Ở ứng dụng desktop, bạn chọn **Existing instance** và nhập địa chỉ `https://`. README cũng có đường triển khai trên Railway bằng template.

### Chạy từ mã nguồn (cho người muốn sửa code)

Chỉ làm bước này nếu bạn là lập trình viên. Đầu tiên:

```bash
git clone https://github.com/elie222/rakazo.git
cd rakazo
cp .env.example .env
```

Rồi bạn điền `.env` theo README: đặt `POSTGRES_PASSWORD` và `POSTGRES_APP_PASSWORD` bằng hai giá trị từ `openssl rand -hex 16`, rồi ghi chúng vào `DATABASE_MIGRATION_URL` và `DATABASE_URL`. Đặt `BETTER_AUTH_SECRET`, `ENCRYPTION_KEY` và `SCREEN_PROXY_SECRET` thành các chuỗi ngẫu nhiên dài và độc lập. Sandbox Docker cần thêm `SANDBOX_SUPERVISOR_TOKEN` riêng. Nếu dùng Docker Desktop khi phát triển trên máy, đặt `SANDBOX_CONTROL_VIA_LOOPBACK=true`.

Sau đó chạy ba lệnh:

```bash
pnpm install
pnpm sandbox:build
pnpm dev
```

`pnpm install` cài thư viện. `pnpm sandbox:build` dựng image sandbox. `pnpm dev` khởi động bản dev; nếu chưa có Postgres kết nối được qua `DATABASE_URL`, nó tự dựng một container Postgres cục bộ bằng Docker, áp dụng migration rồi chạy. Khi cổng mặc định bị chiếm, nó chuyển sang cổng trống kế tiếp và in ra địa chỉ để bạn mở.

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

Dấu hiệu thành công theo README rất đơn giản: bạn mở được `http://127.0.0.1:5173`, tạo được tài khoản, kết nối được model và tạo được bot đầu tiên. Với `pnpm dev`, địa chỉ được in ra ở terminal, nên bạn mở đúng địa chỉ đó.

Ngoài ra, bạn có thể xem container bằng lệnh phổ thông này:

```bash
docker ps
```

Nếu thấy các container của Rakazo đang chạy thì phần nền đã lên. README không ghi tên container cho bản cài nhanh, nên bạn chỉ cần thấy có container mới xuất hiện sau khi cài là được. Một lời nhắn thử cho bot, ví dụ chào hỏi, cho bạn biết model đã kết nối đúng hay chưa.

Với bản dev, repo có sẵn các lệnh kiểm tra cho người đóng góp: `pnpm lint`, `pnpm check`, `pnpm test`. Người dùng bình thường không cần chạy.

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

Các tình huống dưới đây dựa trên khả năng README mô tả. Câu lệnh mẫu là gợi ý để bạn giao việc; kết quả cụ thể tuỳ model và ứng dụng bạn đã kết nối.

### Chủ shop: bot báo cáo đầu ngày

Bạn bán hàng online và muốn mỗi sáng có bản tóm tắt. Trong Rakazo, bạn tạo một routine chạy theo lịch cho một bot và kết nối Gmail hoặc Slack trong phần **Integrations**. Bạn có thể giao việc bằng một câu như:

```text
Mỗi sáng, đọc các email mới về đơn hàng, liệt kê đơn cần xử lý gấp và gửi bản tóm tắt vào Slack.
```

Bot chạy theo lịch, và bạn xem lại được từng lần chạy để biết nó đã làm gì. Nếu thấy sai, bạn sửa lại lời giao việc.

> Bot không quên, không nghỉ, và mỗi lần chạy đều để lại dấu vết cho bạn kiểm tra.
>
> — Ông T

### Nhân viên văn phòng: nhóm bot soạn và kiểm tra tài liệu

Bạn cần soạn một bản đề xuất. Tạo một nhóm chat, đưa hai bot vào: một bot viết nháp, một bot rà soát. Bạn @nhắc tên từng bot:

```text
@bot-soan hãy viết nháp đề xuất triển khai quy trình duyệt chi phí mới.
@bot-ra-soat hãy kiểm tra bản nháp, chỉ ra chỗ thiếu số liệu hoặc chưa rõ ràng.
```

README nói các bot trong nhóm chia việc, kiểm tra nhau và báo lại. Bạn nhận bản tốt hơn một lượt hỏi đáp đơn lẻ, và có thể nhờ bot dựng thành một Page để chia sẻ bằng liên kết.

### Người làm vận hành: bot dùng trình duyệt thay bạn

Có việc phải vào một trang web không có API, ví dụ tra cứu rồi nhập liệu. Bạn giao cho bot, bot dùng trình duyệt trong máy tính riêng của nó. Khi cần đăng nhập, bạn nhận quyền điều khiển để tự nhập mật khẩu, rồi trả lại cho bot.

```text
Vào trang quản trị nhà cung cấp, lấy danh sách đơn nhập tuần này và ghi vào một bảng.
```

Bạn xem được bot làm trực tiếp, nên dễ dừng lại nếu nó đi sai hướng. Hãy tự nhập mật khẩu ở bước đăng nhập, đừng gửi mật khẩu cho bot qua chat.

### Lập trình viên mới: nối công cụ riêng bằng MCP

Bạn đã có một MCP server hoặc một tài liệu OpenAPI JSON của hệ thống nội bộ. Trong **Integrations**, bạn có thể thêm một MCP server HTTPS hoặc tài liệu OpenAPI mà không cần bật catalog quản lý nào (Composio hay Pipedream). Sau đó bot gọi được công cụ đó khi làm việc. README cho biết thông tin kết nối được mã hoá trên server và API không trả lại chúng.

Phù hợp khi bạn muốn thử một agent có công cụ riêng mà không phải tự viết giao diện.

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

### Docker chưa chạy hoặc chưa cài

Triệu chứng: installer báo không kết nối được Docker. Cách xử lý: mở Docker Desktop (hoặc Docker Engine) và đợi nó chạy xong, rồi chạy lại `bash install-images.sh`. Installer giữ nguyên `.env` cũ nên chạy lại an toàn. Với ứng dụng desktop, README nói nó có thể mở sẵn Docker app đã cài nhưng chưa chạy và tự tiếp tục khi Docker trả lời. Nó chỉ tìm lệnh `docker`, không nhận Podman; nếu muốn thử CLI khác tương thích, đặt `RAKAZO_DOCKER_BINARY` trỏ tới đường dẫn của nó.

### Dùng sai phiên bản Node khi chạy từ mã nguồn

README ghi rõ Node.js 25.x không được hỗ trợ; bạn cần 24.15.0 trở lên trong dòng 24.x hoặc Node.js 26 trở lên. Hãy kiểm tra bằng `node --version` và đổi phiên bản nếu cần trước khi chạy `pnpm install`.

### Mật khẩu Postgres lỗi hoặc không khớp

README dặn dùng mật khẩu an toàn cho URI (tạo bằng `openssl rand -hex 16`). Một điểm khó chịu: volume `pgdata` đã có sẽ giữ nguyên user, mật khẩu và tên database từ lần khởi tạo đầu. Nếu bạn đổi mật khẩu trong `.env` sau đó, kết nối sẽ không khớp. Hãy giữ giá trị cũ trong `.env`, hoặc đổi tại chỗ bằng `ALTER ROLE`. Chỉ tạo lại volume sau khi sao lưu hoặc khi dữ liệu có thể bỏ đi, vì lệnh `docker compose down -v` xoá toàn bộ dữ liệu Postgres.

### Tải script cài bị chặn hoặc chậm

Nếu mạng bị hạn chế, dùng `RAKAZO_DOWNLOAD_BASE` để đổi nguồn tải, hoặc `--local` / `RAKAZO_DOWNLOAD_SKIP_EXISTING` để bỏ qua các file Compose đã có. Xem mục Restricted networks / mirror downloads trong docs của repo.

### AppImage trên Linux báo thiếu libfuse.so.2

Triệu chứng: `dlopen(): error loading libfuse.so.2`. Nguyên nhân là bản Linux của desktop app cần FUSE 2. README đưa hai cách: cài thư viện FUSE 2 (`fuse-libs` trên Fedora, `libfuse2t64` trên Ubuntu 24.04, `libfuse2` trên Ubuntu và Debian cũ), hoặc chạy không cần FUSE:

```bash
chmod +x Rakazo-*.AppImage
./Rakazo-*.AppImage --appimage-extract-and-run
```

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

**Điểm mạnh.** Rakazo cho bạn một hệ bot có trí nhớ, routine, máy tính riêng và nhiều ứng dụng kết nối, mà bạn tự chủ. Bạn chọn model bằng khoá của mình, chọn nơi chạy sandbox, và dùng được trên web, desktop, iPhone và Android. Giấy phép Apache-2.0 và cài nhanh bằng một script là điểm cộng cho người mới.

**Giới hạn.** Bạn phải tự vận hành: Docker, cập nhật, sao lưu, gia cố server nếu mở ra internet. README chưa nói rõ cấu hình phần cứng tối thiểu. Giao diện chưa liệt kê tiếng Việt. Chi phí model và sandbox đám mây là của bạn. Một số tính năng như dịch vụ dữ liệu trả phí hay catalog ứng dụng quản lý (Composio, Pipedream) là tuỳ chọn và cần khoá riêng.

**Khi nên chọn cách khác.** Nếu bạn chỉ cần hỏi đáp thỉnh thoảng, một chatbot có sẵn đơn giản hơn nhiều. Nếu bạn không muốn đụng tới Docker hay server, hãy cân nhắc dịch vụ trả phí đã host sẵn. README có nhắc bản web trên app.rakazo.com, nhưng không nói rõ về điều khoản dữ liệu hay giá của dịch vụ đó, nên bạn cần tự tìm hiểu thêm. Còn nếu bạn muốn giữ dữ liệu và quyền kiểm soát, đồng thời sẵn sàng bỏ chút thời gian dựng, Rakazo là lựa chọn đáng thử.

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

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

Mã nguồn mở theo giấy phép Apache-2.0, nên bạn tải và tự host được. Tuy vậy, bạn tự trả chi phí model qua khoá API của mình và chi phí sandbox đám mây nếu dùng (README ghi sandbox Railway tính theo mức dùng). Chưa có thông tin về giá của bản host sẵn.

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

README không nhắc yêu cầu GPU. Bạn kết nối model qua nhà cung cấp bằng khoá API của mình, nên phần tính toán model không nhất thiết chạy trên máy bạn. README cũng chưa nêu cấu hình phần cứng tối thiểu.

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

Ứng dụng desktop hỗ trợ cài bản chạy cục bộ bằng Docker Desktop, OrbStack hoặc Docker Engine. Script cài nhanh là file bash nên bạn cần môi trường chạy được bash. README không có hướng dẫn riêng cho Windows ở phần đó, nên hãy xem self-hosting guide trong thư mục docs.

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

Bạn tự host nên dữ liệu nằm trên server của bạn. README cho biết thông tin kết nối ứng dụng được mã hoá trên server và API không trả lại. Khi mở ra internet, bạn nên đặt HTTPS phía trước và đọc hướng dẫn gia cố trong docs/self-host-production.md. Repo cũng có file SECURITY.md để báo lỗ hổng bảo mật.

### Rakazo khác gì Grok Bot hay các công cụ tương tự?

README định vị Rakazo là bản mã nguồn mở, tự host thay cho Grok Bot, và cũng là lựa chọn thay thế cho Meta Muse, OpenAI Dots, Instinct, OpenClaw, Hermes Agent và Claude Duet. Điểm khác chính được nêu là bạn chọn model và sandbox của riêng mình. Trang chủ dự án có các bài so sánh chi tiết.

### Tôi có thể dùng model nào?

README nói bạn dùng model nào cũng được, với khoá của chính bạn. Bạn kết nối nhà cung cấp được hỗ trợ trong lúc làm quen ban đầu, hoặc đặt OPENROUTER_API_KEY khi chạy từ mã nguồn. Danh sách model cụ thể nằm trong tài liệu Models của repo.

### Có ứng dụng cho điện thoại không?

Có. README cho biết bạn dùng được trên web, desktop, iPhone, iPad và Android, tất cả nói chuyện với cùng một server. Ứng dụng desktop và mobile là client của cùng API với bản web. Hướng dẫn build mobile nằm trong docs/mobile-release.md.
