# Rakazo: trợ lý 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) để tạo các "đồng đội AI" chạy lâu dài, có trí nhớ, routine và một máy tính riêng (trình duyệt, terminal, desktop). Bạn tự host trên máy hoặc VPS và dùng model của chính mình. Cài bằng một script Docker khá gọn, không cần clone code hay cài Node.

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

Rakazo là một ứng dụng mã nguồn mở, tự host, đóng vai "phiên bản thay thế" cho Grok Bot. Nó cho bạn tạo các bot AI chạy lâu dài: mỗi bot có trí nhớ riêng, có lịch chạy việc, có ứng dụng kết nối và có cả một máy tính riêng để làm việc. Bạn chạy nó trên máy của mình, với model do bạn chọn.

Repo này hợp với ai? Nếu bạn muốn một trợ lý AI làm việc thay mình (đọc mail, chạy báo cáo theo giờ, lên trình duyệt thao tác) nhưng không muốn dữ liệu nằm hết trên dịch vụ của người khác, thì đây là hướng đáng xem. Dân văn phòng, chủ shop nhỏ có người biết chút kỹ thuật, và lập trình viên mới đều thử được, vì đường cài nhanh chỉ cần Docker.

Điểm đáng giá nhất: bạn tự chọn model (dùng key của mình) và tự chọn nơi bot "làm việc" (sandbox trong Docker, trên cloud, hoặc ngay máy bạn). Repo hiện có khoảng 8178 sao và 1482 fork, vẫn được cập nhật trong 3 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: các bot AI có trí nhớ, lịch chạy và máy tính riêng, chạy bằng model và key của bạn.
- stars | 8.2k
- lang | TypeScript
- license | Apache-2.0
```

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

Dưới đây là các tính năng chính, giải thích theo 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, file và cả desktop đầy đủ. Bạn xem được bot đang làm gì, có thể tự tay đăng nhập một trang nào đó rồi trả quyền lại cho bot. Rất tiện khi trang yêu cầu mã xác thực mà bạn không muốn đưa cho AI.
- **Routine (việc chạy theo lịch).** Bạn cho bot chạy theo giờ, theo email gửi tới hoặc theo webhook, và xem lại từng lần chạy. Ví dụ: sáng nào cũng tổng hợp đơn hàng.
- **Trí nhớ.** Bot nhớ thông tin giữa các cuộc trò chuyện, nên bạn không phải giải thích lại bối cảnh mỗi lần.
- **Nhóm bot làm việc cùng nhau.** Bạn cho nhiều bot vào một group chat, gọi tên bằng @. Chúng chia việc, kiểm tra chéo và báo lại. README cũng nhắc tới ủy quyền (delegation) và subagent.
- **Pages.** Bot dựng dashboard và tài liệu sống, bạn mở toàn màn hình, chia sẻ bằng link và hỏi tiếp về nội dung đó.
- **Kết nối ứng dụng.** Gmail, Slack, GitHub, Notion, Linear và nhiều ứng dụng khác, cộng với MCP server hoặc công cụ OpenAPI của riêng bạn. Danh mục ứng dụng có sẵn là tùy chọn (qua Composio hoặc Pipedream Connect), bạn vẫn tự thêm được MCP/OpenAPI mà không cần chúng.
- **Chọn model tùy ý, dùng key của bạn.** Không bị khóa vào một nhà cung cấp.
- **Chat thoại và gọi thoại.**
- **Dùng trên mọi thiết bị.** Web, máy tính (Electron), iPhone, iPad và Android, tất cả nói chuyện với cùng một server.
- **Đa ngôn ngữ giao diện.** Giao diện web hỗ trợ khoảng 15 ngôn ngữ trong Settings → Language. README không liệt kê tiếng Việt trong danh sách này, bạn nên biết trước để không bất ngờ.

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

Có hai đường cài, và yêu cầu khác nhau.

**Đường nhanh (dùng image đã build sẵn)** — README ghi bạn cần:

- Docker Engine và Compose plugin
- curl
- OpenSSL

Không cần clone repo, không cần cài Node.

**Đường phát triển (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+. Node.js 25.x không được hỗ trợ.
- pnpm 12
- Docker

Ngoài ra:

- **Một model AI.** Bạn kết nối một nhà cung cấp model được hỗ trợ ngay khi onboarding, hoặc đặt `OPENROUTER_API_KEY`. Key này bạn tự lấy từ nhà cung cấp.
- **Máy ảo cho bot (tùy chọn).** Mặc định bot dùng máy Docker cục bộ. Muốn dùng nhà cung cấp từ xa thì cần API key tương ứng: `e2b`, `novita`, `daytona`, `createos`, `boat`, `boxd`, `instabox` hoặc `railway`.
- **Máy tính để chạy.** README không nêu yêu cầu RAM/GPU. Phần ứng dụng desktop có ghi một đường chạy không cần Docker, nhưng chỉ cho máy Mac chip Apple silicon với macOS 26 trở lên.

```note
Key model và key nhà cung cấp sandbox đều có thể phát sinh chi phí theo mức bạn dùng. Với Railway, README ghi rõ phần sandbox được tính tiền theo mức sử dụng. Hãy đặt giới hạn chi tiêu ở phía nhà cung cấp trước khi cho bot chạy tự động.
```

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

```steps
- Kiểm tra công cụ | Đảm bảo máy có Docker, Compose plugin, curl và OpenSSL
- Chạy script cài | Tạo thư mục rakazo, tải và chạy install-images.sh
- Mở giao diện web | Vào http://127.0.0.1:5173 và tạo tài khoản
- Kết nối model | Chọn nhà cung cấp model hoặc nhập key
- Tạo bot đầu tiên | Tạo bot và thử giao việc
```

### Kiểm tra Docker và các công cụ cần thiết

Trước khi cài, hãy chắc Docker đang chạy. Người mới hay quên bước này: cài Docker Desktop xong nhưng chưa mở ứng dụng thì lệnh phía sau sẽ lỗi. Bạn có thể tự kiểm tra bằng các lệnh phổ thông:

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

Cả bốn lệnh phải in ra số phiên bản. Lệnh nào báo "not found" thì cài công cụ đó trước.

### Chạy script cài đặt

Mở terminal (trên Windows nên dùng một terminal chạy được lệnh kiểu bash, ví dụ Git Bash hoặc WSL). Rồi dán nguyên khối lệnh sau từ README:

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

Ba lệnh này nối nhau bằng `&&`: tạo thư mục `rakazo` và vào trong đó, tải script `install-images.sh`, rồi chạy script. Theo README, script sẽ tải các file Compose, tạo file `.env` với các khóa bí mật ngẫu nhiên và khởi động Rakazo. Nếu bạn chạy lại, nó giữ nguyên file `.env` cũ, nên không lo mất cấu hình.

Bản image mặc định có tag `edge` (build từ nhánh main, cho cả `linux/amd64` và `linux/arm64`).

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

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

```text
http://127.0.0.1:5173
```

Tạo tài khoản, rồi kết nối một model. Máy Docker cục bộ được bật sẵn nên bạn chưa cần làm gì thêm để bot có "máy tính" riêng. Muốn dùng nhà cung cấp từ xa thì phải điền API key tương ứng, xem bước chạy trên server bên dưới.

### Nếu mạng bị hạn chế

Nếu mạng của bạn chặn tải trực tiếp, README nhắc tới các tùy chọn: biến `RAKAZO_DOWNLOAD_BASE` để đổi nơi tải, cờ `--local` hoặc biến `RAKAZO_DOWNLOAD_SKIP_EXISTING` để bỏ qua file Compose đã có, hoặc tự đặt gương (mirror) cho script. Chi tiết nằm trong tài liệu "Restricted networks / mirror downloads" trong thư mục `docs/` của repo.

### Chạy trên server (VPS) để bot luôn bật

Muốn bot chạy 24/7 thì đặt backend trên server. Dùng cùng script cài:

```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ệnh đầu chỉ chuẩn bị file, chưa chạy. Bạn mở file `.env`, đặt `SANDBOX_PROVIDER` và API key của nhà cung cấp, đặt `RAKAZO_HOST` là tên miền của bạn. Sau đó chạy lại lệnh cài. README dặn phải đặt HTTPS phía trước cổng 5173; hướng dẫn Caddy và gia cố máy chủ nằm trong `docs/self-host-production.md`. Trong app desktop, chọn **Existing instance** và nhập địa chỉ `https://` của bạn. README cũng có nút triển khai lên Railway.

### Cài 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 lấy code và tạo file cấu hình:

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

Sau đó mở `.env` và điền các giá trị theo README:

- `POSTGRES_PASSWORD` và `POSTGRES_APP_PASSWORD`: hai giá trị khác nhau, tạo bằng `openssl rand -hex 16`. Rồi đưa chúng vào `DATABASE_MIGRATION_URL` và `DATABASE_URL`.
- `BETTER_AUTH_SECRET`, `ENCRYPTION_KEY`, `SCREEN_PROXY_SECRET`: ba chuỗi ngẫu nhiên dài, độc lập với nhau.
- `SANDBOX_SUPERVISOR_TOKEN`: cần riêng nếu dùng sandbox Docker.
- Tùy chọn: `OPENROUTER_API_KEY`, hoặc kết nối model ngay lúc onboarding.
- Nếu dùng Docker Desktop để phát triển trên máy, đặt `SANDBOX_CONTROL_VIA_LOOPBACK=true`.

Rồi chạy:

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

`pnpm install` cài thư viện. `pnpm sandbox:build` dựng image cho máy của bot. `pnpm dev` khởi động hệ thống. Theo README, nếu chưa có Postgres thì nó tự bật một container `rakazo-dev-postgres` bằng Docker, tự áp migration và sinh Prisma client. Nếu cổng mặc định đã bị chiếm, nó chuyển sang cổng trống kế tiếp và in ra URL; bạn cũng có thể tự chọn bằng `WEB_PORT` và `API_PORT`.

### Cài app desktop (tùy chọn)

Khi bộ dev đang chạy, bạn mở app Electron bằng:

```bash
pnpm --filter @rakazo/desktop dev
```

Lần đầu app hỏi bạn chạy Rakazo trên máy này hay kết nối tới server có sẵn. Nếu bạn đang chạy `pnpm dev`, hãy chọn **Existing instance** với địa chỉ `http://127.0.0.1:5173`. Hướng dẫn build app mobile nằm trong `docs/mobile-release.md`.

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

Với đường cài nhanh, dấu hiệu thành công theo README rất đơn giản:

1. Script chạy xong và trong thư mục `rakazo` có file `.env` mới.
2. Mở `http://127.0.0.1:5173` thấy giao diện Rakazo, tạo được tài khoản.
3. Sau khi kết nối model, bạn tạo được bot đầu tiên và nhắn tin với nó.

Bạn có thể xem thêm các container đang chạy bằng lệnh phổ thông:

```bash
docker ps
```

Với đường từ mã nguồn, `pnpm dev` sẽ in ra URL để mở (mặc định là `http://127.0.0.1:5173`). Muốn kiểm tra kỹ hơn, README liệt kê các lệnh `pnpm lint`, `pnpm check`, `pnpm test`.

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

Các tình huống dưới đây bám đúng khả năng README mô tả. Cách đặt câu lệnh là gợi ý của mình, bạn chỉnh theo thực tế.

### Chủ shop: bot tổng hợp đơn hàng mỗi sáng

Bạn có một chủ shop online, mỗi sáng phải mở mail và bảng tính để xem đơn mới. Với Routine, bạn tạo một bot chạy theo lịch hằng ngày, kết nối Gmail (qua phần Integrations), rồi giao việc bằng một câu như:

```text
Mỗi sáng, đọc các email đặt hàng mới và tóm tắt thành danh sách: tên khách, sản phẩm, số lượng. Báo cho mình những đơn có ghi chú đặc biệt.
```

Kết quả: mỗi lần chạy đều được lưu lại để bạn xem, và bạn không phải mở từng mail.

> Bot không chỉ trả lời, nó có máy tính riêng để tự làm việc rồi báo kết quả cho bạn.
>
> — Ông T

### Nhân viên văn phòng: bot thao tác trên trình duyệt

Bạn cần lấy số liệu từ một trang web nội bộ phải đăng nhập. Bạn mở máy tính của bot, tự đăng nhập ở trang đó (README gọi là "take control to sign in"), rồi trả quyền lại. Sau đó giao việc:

```text
Vào trang báo cáo bán hàng, lấy số liệu tuần này và dựng thành một trang dashboard để mình gửi link cho sếp.
```

Kết quả: bot dùng trình duyệt trên máy của nó và tạo một Page dạng dashboard mà bạn mở toàn màn hình hoặc chia sẻ bằng link. Mật khẩu bạn tự gõ, không phải đưa cho AI.

### Nhóm nhỏ: hai bot chia việc và kiểm tra chéo

Bạn làm nội dung cho cửa hàng. Tạo một group chat, thêm một bot soạn bài và một bot kiểm tra, rồi gọi tên bằng @:

```text
@bot-soan-bai viết 3 mô tả sản phẩm từ danh sách này. @bot-kiem-tra rà lại lỗi chính tả và chỗ nào nói quá.
```

Kết quả: theo README, các bot chia việc, kiểm tra lẫn nhau rồi báo kết quả về nhóm. Tên bot ở trên chỉ là ví dụ, bạn đặt tên tùy ý.

### Lập trình viên: bot nhận việc từ webhook

Bạn muốn mỗi lần có một sự kiện (ví dụ mail báo lỗi) thì bot tự xem xét. Routine hỗ trợ chạy từ email hoặc webhook. Bạn thêm công cụ của mình qua MCP server hoặc tài liệu OpenAPI JSON ở mục **Integrations**, rồi giao bot xử lý. Kết quả: mỗi lần chạy đều xem lại được trong lịch sử. Nếu bạn muốn nghịch xa hơn, README cũng có phần "Bots that manage bots" trong thư mục docs.

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

### Lệnh cài báo lỗi Docker không chạy

Nguyên nhân thường là Docker Desktop chưa mở, hoặc chưa cài Compose plugin. Mở Docker, chờ nó báo sẵn sàng rồi chạy lại `bash install-images.sh`. Script giữ nguyên `.env` cũ nên chạy lại là an toàn.

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

Với đường từ mã nguồn, `pnpm dev` tự chuyển sang cổng trống và in URL ra màn hình, hãy mở đúng URL đó. Bạn cũng có thể đặt `WEB_PORT` và `API_PORT` để tự chọn.

### Sai phiên bản Node khi cài từ mã nguồn

README yêu cầu Node 24.15.0 trở lên trong dòng 24.x hoặc 26+, và ghi rõ 25.x không được hỗ trợ. Chạy `node --version` để kiểm tra, và đổi phiên bản nếu cần.

### Mất dữ liệu hoặc đăng nhập Postgres lỗi sau khi đổi mật khẩu

README cảnh báo: volume `pgdata` có sẵn 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 `POSTGRES_PASSWORD` trong `.env` sau đó, kết nối sẽ không khớp. Hãy giữ giá trị cũ, hoặc đổi trong database bằng `ALTER ROLE`. Chỉ tạo lại volume sau khi đã sao lưu, vì `docker compose down -v` xóa toàn bộ dữ liệu Postgres.

### App desktop trên Linux báo lỗi libfuse.so.2

AppImage cần FUSE 2. Nếu thấy thông báo `dlopen(): error loading libfuse.so.2`, cài thư viện FUSE 2 (`libfuse2t64` trên Ubuntu 24.04, `libfuse2` trên Ubuntu/Debian cũ hơn, `fuse-libs` trên Fedora), 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.** Bạn kiểm soát được model, key và nơi bot chạy. Giấy phép Apache-2.0 khá thoáng. Đường cài nhanh chỉ cần Docker và một script, không phải đụng tới Node. Một hệ thống chạy được trên web, desktop và điện thoại, với routine, trí nhớ và máy tính riêng cho từng bot, là bộ tính năng đầy đủ so với nhiều công cụ cùng loại.

**Giới hạn.** Đây là hệ thống khá lớn (server, database, worker, sandbox), nên không nhẹ như một công cụ dòng lệnh đơn lẻ. Bạn phải tự quản lý khóa bí mật, sao lưu và nâng cấp; README có tài liệu riêng cho các việc này nhưng bạn vẫn là người chịu trách nhiệm. Giao diện web chưa thấy tiếng Việt trong danh sách ngôn ngữ README. Bot có quyền thao tác máy tính và ứng dụng kết nối, nên hãy cấp quyền thận trọng và chỉ nối những tài khoản bạn thực sự cần.

**Khi nào nên chọn cách khác.** Nếu bạn chỉ cần hỏi đáp thỉnh thoảng, một ứng dụng chat AI thông thường là đủ và đỡ tốn công. Nếu không muốn tự vận hành máy chủ, bạn nên cân nhắc bản dùng sẵn trên web mà dự án giới thiệu. Còn nếu bạn muốn tự chủ dữ liệu và có người đủ kỹ thuật để lo phần vận hành, Rakazo đáng để thử.

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

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

Mã nguồn dùng giấy phép Apache-2.0, bạn tự host và dùng được. Tuy nhiên model AI và một số nhà cung cấp sandbox từ xa cần API key của bạn và có thể tính phí theo mức sử dụng. README nói rõ sandbox Railway được tính tiền theo mức dùng.

### Cài Rakazo có cần clone repo hay cài Node không?

Không, nếu dùng đường nhanh. README ghi bạn chỉ cần Docker Engine, Compose plugin, curl và OpenSSL, rồi chạy script install-images.sh. Chỉ khi chạy từ mã nguồn mới cần Node.js 24.15.0 trở lên (hoặc 26+) và pnpm 12.

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

README không nhắc yêu cầu GPU hay RAM cụ thể. Rakazo dùng model qua key của nhà cung cấp mà bạn kết nối, nên phần tính toán nặng nằm ở phía nhà cung cấp model. Với cấu hình tối thiểu cho máy của bạn, hiện chưa có thông tin rõ ràng trong tư liệu.

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

README không có phần riêng cho Windows. Đường cài nhanh dùng lệnh bash và Docker, nên bạn cần một terminal chạy được bash như Git Bash hoặc WSL cùng Docker. Đường chạy desktop không cần Docker chỉ ghi cho Mac Apple silicon với macOS 26 trở lên.

### 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 máy hoặc server của bạn. README ghi thông tin đăng nhập của các kết nối được mã hóa trên server và không bao giờ được API trả ra lại. Dù vậy, an toàn còn phụ thuộc cách bạn đặt khóa bí mật, HTTPS và quyền cho bot; repo có SECURITY.md để báo lỗ hổng.

### Có dùng được trên điện thoại không?

Có. README nói Rakazo có ứng dụng iPhone, iPad và Android, đều kết nối tới cùng một server. Muốn dùng điện thoại với server riêng, bạn nên đặt server trên VPS có HTTPS để kết nối từ xa.

### Rakazo khác gì Grok Bot?

README định vị Rakazo là bản mã nguồn mở, tự host thay thế Grok Bot, cho phép bạn chọn model và sandbox của riêng mình. Tư liệu cũng nhắc tới các công cụ cùng loại khác và trang so sánh trên website dự án, nhưng chi tiết khác biệt từng điểm thì chưa có trong README.
