# Rakazo: trợ lý AI tự host, tự chọn model và sandbox — 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 "đồng đội AI" có bộ nhớ, routine và máy tính riêng trên máy hoặc server của bạn, với model do bạn chọn. Cách nhanh nhất là chạy một script cài bằng Docker, không cần clone repo hay cài Node. Cài không quá khó nếu bạn đã quen Docker và terminal.

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

Rakazo là một ứng dụng mã nguồn mở, tự host, đóng vai trò bản thay thế cho Grok Bot. Nó cho bạn tạo các bot AI "ở lại" lâu dài: mỗi bot có trí nhớ, lịch làm việc, ứng dụng và cả một máy tính riêng (trình duyệt, terminal, tệp, màn hình desktop). Bạn chạy nó trên máy mình hoặc server mình, và dùng model AI với khoá của chính bạn.

Repo hợp với người muốn có trợ lý AI làm việc liên tục (gửi báo cáo định kỳ, theo dõi hộp thư, làm dashboard) mà không muốn giao hết dữ liệu cho một dịch vụ đóng. Nó cũng hợp với dev muốn một nền tảng agent có sẵn web, desktop và app điện thoại. Hiện repo có khoảng 8.178 sao và 1.482 fork, được cập nhật trong vài tháng gần đây.

Điểm đáng giá nhất: bạn tự chọn model và nơi chạy sandbox (Docker trên máy, hoặc dịch vụ đám mây). Cài bằng một script là xong, không cần clone mã nguồn.

```repo
- repo | elie222/rakazo
- kind | Ứng dụng
- desc | Rakazo là bản mã nguồn mở, tự host thay thế Grok Bot: bot AI có trí nhớ, lịch chạy và máy tính riêng, dùng model và khoá 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, nói 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, tệp và desktop đầy đủ. Bạn xem nó làm việc, có thể tự nắm quyền để đăng nhập một trang nào đó, rồi trả lại cho bot.
- **Routine (tác vụ định kỳ).** Cho bot chạy theo lịch, khi có email tới, hoặc khi có webhook. Bạn xem lại được từng lần chạy.
- **Trí nhớ.** Bot nhớ ngữ cảnh, nên bạn không phải giải thích lại từ đầu mỗi lần.
- **Chat nhóm và giao việc.** Đặt nhiều bot vào một nhóm rồi @nhắc tên. Theo README, các bot chia việc, kiểm tra chéo nhau và báo cáo lại. Ngoài ra còn có subagent.
- **Pages.** Bot dựng dashboard hoặc tài liệu sống, bạn mở toàn màn hình, chia sẻ bằng link 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 hoặc công cụ OpenAPI của riêng bạn.
- **Mọi thiết bị.** Web, desktop, iPhone, iPad, Android, đều nói chuyện với cùng một server.
- **Chọn model tuỳ ý.** Dùng khoá của bạn. Cũng có chat giọng nói và cuộc gọi.
- **Sandbox linh hoạt.** Docker trên máy, hoặc nhà cung cấp từ xa như e2b, novita, daytona, createos, boat, boxd, instabox, railway (cần API key tương ứng).

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

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

**Cài nhanh bằng image đã build (khuyên dùng cho người mới):**

- Docker Engine và plugin Compose.
- curl và OpenSSL.
- Không cần clone repo, không cần cài Node.
- Image mặc định có tag `edge`, hỗ trợ `linux/amd64` và `linux/arm64`.

**Chạy từ mã nguồn (dành cho dev):**

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

**Khác:**

- Một model AI để kết nối khi onboarding. README nhắc bạn có thể đặt `OPENROUTER_API_KEY` hoặc chọn nhà cung cấp được hỗ trợ ngay trong lúc làm quen.
- Nếu dùng sandbox từ xa, cần API key của nhà cung cấp đó.
- README không ghi rõ yêu cầu RAM/CPU, và cũng không nói rõ script cài chạy được trên Windows hay không. Script là `bash`, nên trên Windows bạn nên thử trong môi trường có bash (ví dụ WSL) cùng Docker, và tự kiểm tra lại. Phần này mình chưa có thông tin xác nhận.

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

```steps
- Chuẩn bị Docker | Cài Docker Engine, plugin Compose, curl và OpenSSL
- Chạy script cài | Tải và chạy install-images.sh trong thư mục rakazo
- Mở trình duyệt | 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 và dán khoá của bạn
- Tạo bot đầu tiên | Tạo bot, giao việc thử
```

### Chuẩn bị Docker

Bạn cần Docker đang chạy trước khi làm gì khác. Mở terminal (trên Windows nên là một cửa sổ có bash) và kiểm tra Docker, curl, OpenSSL đã có chưa. Nếu chưa, cài Docker Desktop hoặc Docker Engine theo hướng dẫn của Docker.

### Chạy script cài

Đây là lệnh trong README. Nó tạo thư mục `rakazo`, tải script cài về rồi chạy:

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

Theo README, 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 `.env` cũ. Chỗ dễ vấp: lệnh phải chạy từ một terminal có `bash` và `curl`, không phải CMD thường.

Trước khi chạy một script tải từ mạng, bạn nên mở link raw đó ra đọc qua nếu muốn yên tâm.

### Mở trình duyệt và tạo tài khoản

Mở địa chỉ `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ó sandbox ngay mà không cần thêm gì.

### Dùng sandbox từ xa hoặc chạy trên server (tuỳ chọn)

Nếu muốn bot luôn bật, chạy backend trên VPS bằng cùng script. README hướng dẫ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ệnh đầu chỉ chuẩn bị file, sau đó bạn sửa `.env` rồi chạy lại. README dặn đặt HTTPS phía trước cổng 5173 và nói `docs/self-host-production.md` có hướng dẫn Caddy và gia cố máy chủ. Trong app desktop, chọn **Existing instance** rồi nhập địa chỉ `https://`. README cũng có mẫu triển khai trên Railway.

### Chạy từ mã nguồn (dành cho dev)

Clone và tạo file cấu hình:

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

Sau đó điền `.env` theo README: đặt `POSTGRES_PASSWORD` và `POSTGRES_APP_PASSWORD` bằng hai giá trị từ `openssl rand -hex 16`, rồi đưa vào `DATABASE_MIGRATION_URL` và `DATABASE_URL`. Đặt `BETTER_AUTH_SECRET`, `ENCRYPTION_KEY` và `SCREEN_PROXY_SECRET` là các chuỗi ngẫu nhiên dài, độc lập nhau. Sandbox Docker cần thêm `SANDBOX_SUPERVISOR_TOKEN`. Nếu dùng Docker Desktop khi dev, đặt `SANDBOX_CONTROL_VIA_LOOPBACK=true`.

Rồi chạy:

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

`pnpm dev` dùng Postgres trong `DATABASE_URL` nếu kết nối được, nếu không nó tự bật một container `rakazo-dev-postgres`. Nó cũng áp migration và sinh Prisma client trước khi khởi động. 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ỉ.

```note
Các khoá như BETTER_AUTH_SECRET, ENCRYPTION_KEY, API key của model hay của nhà cung cấp sandbox đều là bí mật. Đừng dán vào chat, đừng đẩy file .env lên GitHub. Sandbox từ xa như Railway tính phí theo mức dùng, và gọi model bằng khoá của bạn cũng tốn tiền, nên hãy theo dõi chi phí.
```

### Cài app desktop (tuỳ chọn)

App desktop tải ở trang chủ dự án. Khi chạy lần đầu, app hỏi bạn muốn chạy Rakazo trên máy này hay kết nối tới server có sẵn. README ghi chế độ không cần Docker chỉ áp dụng cho Mac chip Apple silicon với macOS 26 trở lên (khi bản build có kèm server). Các bản và nền tảng khác dùng Docker Compose, nên cần Docker Desktop, OrbStack hoặc Docker Engine.

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

Cách thử đơn giản nhất theo README: mở `http://127.0.0.1:5173` (hoặc địa chỉ mà `pnpm dev` in ra). Nếu thấy trang đăng ký, bạn tạo được tài khoản, kết nối model và tạo được bot đầu tiên thì cài đặt đã thành công.

Nếu trang không mở, kiểm tra Docker còn chạy không. README không đưa ra lệnh kiểm tra riêng cho bản cài bằng image, nên bạn có thể xem tình trạng container bằng công cụ Docker của bạn.

Với bản mã nguồn, README liệt kê các lệnh kiểm tra chất lượng: `pnpm lint`, `pnpm check`, `pnpm test`, `pnpm test:integration`, `pnpm test:e2e`. Người dùng thường không cần chạy mấy lệnh này.

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

Các tình huống dưới đây bám đúng tính năng README nêu. Câu lệnh mẫu chỉ là ví dụ cách bạn có thể nhờ bot, không phải cú pháp bắt buộc.

### Chủ shop theo dõi hộp thư và báo cáo mỗi sáng

Bạn bán hàng online, mỗi sáng phải mở email xem đơn và câu hỏi khách. Kết nối Gmail trong mục **Integrations** (hoặc qua catalog ứng dụng đã bật), rồi tạo một routine chạy theo lịch. Bạn có thể nhờ:

```text
Mỗi sáng, đọc email mới trong hộp thư, tóm tắt những mail hỏi về đơn hàng và báo giá, rồi gửi cho mình.
```

Kết quả: mỗi lần chạy đều được ghi lại, bạn xem lại được bot đã làm gì. Lưu ý README không nói bot tự làm đúng theo ý bạn 100%, nên hãy đọc kỹ báo cáo những lần đầu.

### Nhân viên văn phòng nhờ bot dựng dashboard chia sẻ

Bạn cần một trang tổng hợp số liệu cho cuộc họp. Nhờ bot tạo một Page, tức dashboard hoặc tài liệu bạn mở toàn màn hình rồi chia sẻ qua link:

```text
Dựng cho mình một trang tổng hợp công việc tuần này từ Notion và Slack, để mình gửi link cho cả nhóm.
```

Kết quả: một trang bạn có thể gửi cho đồng nghiệp và hỏi thêm ngay trên đó. Việc đọc được Notion hay Slack tuỳ bạn đã kết nối ứng dụng đó hay chưa.

> Bot không chỉ trả lời, nó có máy tính riêng để làm việc và bạn xem được nó làm.
>
> — Ông T

### Dev giao việc cho nhóm bot

Bạn làm lập trình và có một repo GitHub cần kiểm tra. Tạo nhóm chat gồm hai bot, ví dụ một bot viết, một bot soát lại, rồi @nhắc từng bot:

```text
@bot-viet đọc issue mới nhất trên GitHub và đề xuất cách sửa, @bot-soat kiểm tra lại đề xuất đó rồi báo kết quả.
```

Kết quả theo README: các bot chia việc, soát chéo và báo cáo lại trong nhóm. Với việc cần đăng nhập, bạn có thể chiếm quyền màn hình của bot để đăng nhập rồi trả lại.

### Chạy tác vụ khi có webhook hoặc email

Bạn muốn bot phản ứng khi có sự kiện từ hệ thống khác. Tạo routine kích hoạt bằng webhook hoặc email, rồi nhờ bot xử lý nội dung nhận được:

```text
Khi có webhook mới, ghi nội dung vào một Page và nhắn mình trên Slack.
```

Kết quả: mỗi lần kích hoạt là một lần chạy bạn có thể xem lại. Chi tiết cách tạo webhook nằm trong tài liệu của repo, README chưa nêu từng bước.

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

### Chạy script cài báo lỗi hoặc không tải được

Hay gặp khi mạng bị chặn. README có nhắc đến mạng hạn chế: có thể đổi nơi tải bằng `RAKAZO_DOWNLOAD_BASE`, bỏ qua file Compose đã có bằng `--local` hoặc `RAKAZO_DOWNLOAD_SKIP_EXISTING`, hoặc dùng bản sao (mirror) của script. Chi tiết xem phần "Restricted networks / mirror downloads" trong tài liệu repo.

### Trang 127.0.0.1:5173 không mở được

Kiểm tra Docker đã chạy chưa và script cài đã chạy xong chưa. Nếu bạn chạy `pnpm dev` và cổng mặc định bị chiếm (ví dụ do thư mục git khác), nó sẽ chuyển sang cổng khác. Hãy đọc địa chỉ trong terminal thay vì gõ cổng cũ. Bạn cũng có thể đặt `WEB_PORT` và `API_PORT` để tự chọn cổng.

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

Repo yêu cầu Node ^24.15.0 hoặc từ 26 trở lên, và README nói rõ Node 25.x không được hỗ trợ. Kiểm tra bằng `node -v` và đổi phiên bản trước khi `pnpm install`.

### Lỗi `libfuse.so.2` khi mở app desktop trên Linux

Bản AppImage cần FUSE 2. README hướng dẫn cài thư viện FUSE 2 (`fuse-libs` trên Fedora, `libfuse2t64` trên Ubuntu 24.04, `libfuse2` trên Ubuntu/Debian cũ), hoặc chạy không cần FUSE:

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

### Đổi mật khẩu Postgres mà dữ liệu cũ vẫn dùng mật khẩu cũ

Theo README, volume `pgdata` đã có sẽ giữ nguyên user, mật khẩu và tên database từ lần khởi tạo đầu. Vì vậy hãy giữ đúng các giá trị đó trong `.env`. Đừng chạy `docker compose down -v` nếu chưa sao lưu, vì lệnh này xoá toàn bộ dữ liệu Postgres.

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

**Điểm mạnh:** mã nguồn mở theo giấy phép Apache-2.0, tự host nên bạn kiểm soát dữ liệu và chọn model của mình. Cài nhanh bằng một script Docker, có sẵn web, desktop và app điện thoại. Có nhiều tính năng cho việc thật: routine, trí nhớ, nhóm bot, Pages, kết nối ứng dụng, MCP. Giao diện hỗ trợ nhiều ngôn ngữ, nhưng README không liệt kê tiếng Việt trong danh sách đó, nên giao diện có thể chủ yếu là tiếng Anh.

**Giới hạn:** đây là hệ thống khá lớn (có database, server, worker, sandbox), nên không phải công cụ "cài rồi quên" cho người chưa từng dùng Docker. Nếu bạn dùng sandbox từ xa hay model trả phí thì có chi phí. README chưa nói rõ yêu cầu phần cứng, và việc chạy trên Windows bạn nên tự thử. Dùng bot có quyền truy cập email, Slack, GitHub nghĩa là bạn phải cẩn thận về quyền cấp cho nó.

**Khi nên chọn cách khác:** nếu bạn chỉ cần hỏi đáp nhanh, một ứng dụng chat AI có sẵn sẽ đơn giản hơn. Nếu bạn không muốn tự quản server và sao lưu, hãy cân nhắc dịch vụ gốc của dự án (README có nhắc web app và các app điện thoại), nhưng mình chưa có thông tin chi tiết về gói và giá. Nếu bạn là dev muốn đóng góp, hãy đọc CONTRIBUTING.md trong repo trước khi gửi pull request.

## 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 nên bạn tải và tự host được. Tuy nhiên model AI bạn kết nối bằng khoá của mình và một số nhà cung cấp sandbox từ xa (ví dụ Railway) tính phí theo mức dùng. README không đưa ra bảng giá cụ thể.

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

README không nhắc yêu cầu GPU hay cấu hình phần cứng. Model được kết nối qua nhà cung cấp bằng khoá của bạn, còn bot chạy trong sandbox Docker hoặc nhà cung cấp từ xa. Muốn biết chính xác cấu hình tối thiểu, bạn xem thêm tài liệu trong thư mục docs của repo.

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

README chưa nói rõ về script cài trên Windows. Script cài là bash và cần Docker, curl, OpenSSL, nên bạn nên thử trong môi trường có bash như WSL. Nếu dùng được với Docker Desktop thì app desktop cũng có đường chạy qua Docker Compose, nhưng bạn cần tự kiểm tra trên máy mình.

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

Vì tự host nên dữ liệu nằm trên máy hoặc server của bạn. README cho biết thông tin đăng nhập của các kết nối ứng dụng được mã hoá trên server và API không trả lại chúng. Bạn vẫn phải giữ kín các khoá trong .env và chỉ cấp cho bot những quyền cần thiết.

### 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 có thể đặt OPENROUTER_API_KEY hoặc kết nối một nhà cung cấp được hỗ trợ trong lúc onboarding. Danh sách đầy đủ nằm ở tài liệu Models trong repo.

### 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 thế Grok Bot, cho phép bạn tự chọn model và sandbox. Nó cũng nêu các lựa chọn thay thế khác như Meta Muse, OpenAI Dots, OpenClaw, Hermes Agent. Trang chủ dự án có các trang so sánh riêng, mình chưa có nội dung chi tiết của chúng.

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

Có. README ghi có app iPhone, iPad và Android, đều là client của cùng một server Rakazo. Bạn cần có server chạy trước (trên máy hoặc VPS) rồi kết nối app tới đó. Hướng dẫn build và phát hành app điện thoại nằm ở docs/mobile-release.md.
