Bỏ qua tới nội dung
Ông T.vn

Rakazo: trợ lý AI tự host, tự chọn model và sandbox — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

Bài này là một góc nhìn khác về elie222/rakazo — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Rakazo: trợ lý AI tự host, chọn model và sandbox riêng — hướng dẫn cài đặt và dùng →

Rakazo: trợ lý AI tự host, tự chọn model và sandbox — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

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.

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.

Ứng dụng

elie222/rakazo

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.

★ 8.2kTypeScriptApache-2.0
Xem repo trên GitHub

I.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).

II.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.

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

  1. Chuẩn bị DockerCài Docker Engine, plugin Compose, curl và OpenSSL
  2. Chạy script càiTải và chạy install-images.sh trong thư mục rakazo
  3. Mở trình duyệtVào http://127.0.0.1:5173 và tạo tài khoản
  4. Kết nối modelChọn nhà cung cấp model và dán khoá của bạn
  5. Tạo bot đầu tiênTạo bot, giao việc thử

A.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.

B.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:

Terminal
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.

C.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.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:

Terminal
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.

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

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

Terminal
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:

Terminal
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ỉ.

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í.

F.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.

IV.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.

V.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.

A.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.

B.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

C.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.

D.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.

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

A.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.

B.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.

C.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.

D.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:

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

E.Đổ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.

VII.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.

4.3/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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.

Chuyển nhanh tới mục

  1. I.Rakazo làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chuẩn bị Docker
    2. B.Chạy script cài
    3. C.Mở trình duyệt và tạo tài khoản
    4. D.Dùng sandbox từ xa hoặc chạy trên server (tuỳ chọn)
    5. E.Chạy từ mã nguồn (dành cho dev)
    6. F.Cài app desktop (tuỳ chọn)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop theo dõi hộp thư và báo cáo mỗi sáng
    2. B.Nhân viên văn phòng nhờ bot dựng dashboard chia sẻ
    3. C.Dev giao việc cho nhóm bot
    4. D.Chạy tác vụ khi có webhook hoặc email
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Chạy script cài báo lỗi hoặc không tải được
    2. B.Trang 127.0.0.1:5173 không mở được
    3. C.Dùng Node không đúng phiên bản khi chạy từ mã nguồn
    4. D.Lỗi libfuse.so.2 khi mở app desktop trên Linux
    5. E.Đổi mật khẩu Postgres mà dữ liệu cũ vẫn dùng mật khẩu cũ
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.