Rakazo: trợ lý AI tự host, tự chọn model và sandbox — hướng dẫn cài đặt và dùng
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 →

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.
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.
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/amd64và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_KEYhoặ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
- Chuẩn bị DockerCài Docker Engine, plugin Compose, curl và OpenSSL
- Chạy script càiTải và chạy install-images.sh trong thư mục rakazo
- Mở trình duyệtVào http://127.0.0.1:5173 và tạo tài khoản
- Kết nối modelChọn nhà cung cấp model và dán khoá của bạn
- 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:
mkdir -p rakazo && cd rakazo &&
curl -fsSLO https://raw.githubusercontent.com/elie222/rakazo/main/infra/compose/install-images.sh &&
bash install-images.shTheo 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:
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.shLệ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:
git clone https://github.com/elie222/rakazo.git
cd rakazo
cp .env.example .envSau đó đ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:
pnpm install
pnpm sandbox:build
pnpm devpnpm 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ờ:
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:
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:
@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:
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:
chmod +x Rakazo-*.AppImage
./Rakazo-*.AppImage --appimage-extract-and-runE.Đổ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.
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.


