Để dùng Gemma 4 trên OpenClaw với 9Router, bạn thêm Gemma 4 làm model của provider Gemini trong 9Router, rồi khai báo 9Router là Custom Provider tương thích OpenAI trong OpenClaw. Gemma 4 qua Gemini API thuộc gói miễn phí của Google, có giới hạn tốc độ, nên đây là cách hợp để thử nghiệm OpenClaw với chi phí model thấp.
Bài này thuộc nhóm hướng dẫn model của OpenClaw; các cách khác để đưa model vào OpenClaw nằm ở bài dùng nhiều model AI trên OpenClaw. Cùng Tino đi qua từng bước cài 9Router trên VPS, thêm Gemma 4 và tạo combo luân phiên.
Tổng quan về 9Router
9Router là gì?
9Router là proxy AI mã nguồn mở (giấy phép MIT) chạy trên máy của bạn, kết nối các công cụ như Cursor, Claude Code, Cline, Codex, OpenClaw với hơn 40 nhà cung cấp AI qua một endpoint localhost:20128/v1 (github.com/decolua/9router).
Thay vì OpenClaw chỉ gọi một nguồn API, 9Router đứng ở giữa: nhận yêu cầu từ OpenClaw, chọn nhà cung cấp còn hạn mức hoặc nguồn dự phòng khi nguồn chính lỗi, rồi trả kết quả về.
Giao diện Web UI mở sau khi cài để thêm provider, chọn model và tạo combo. Phân tích đầy đủ, kèm rủi ro điều khoản và bảo mật, có trong bài 9Router là gì.
Các tính năng nổi bật của 9Router
- Kết nối nhiều nhà cung cấp: hơn 40 provider, từ Claude, Gemini, OpenAI đến GLM, Kimi, Qwen, MiniMax.
- Tận dụng gói đang có: kết nối Claude Code, Codex, GitHub Copilot, Cursor qua OAuth. Chính 9Router cảnh báo dùng gói thuê bao qua proxy có thể khiến tài khoản bị hạn chế, nên đọc điều khoản của từng hãng trước.
- Tier miễn phí: theo README ngày 24/10/2026 gồm Kiro AI (khoảng 50 credit/tháng), OpenCode Free và credit Vertex AI cho tài khoản Google Cloud mới. Tier miễn phí của iFlow, Qwen Code và Gemini CLI đã ngừng trong năm 2026.
- Tự chuyển dự phòng: nguồn hết hạn mức hoặc lỗi thì chuyển sang nguồn khác.
- Combo model: gom nhiều model dưới một tên với chiến lược Fallback, Round Robin hoặc Fusion.
- Dashboard thống kê: xem từng yêu cầu, provider được gọi, hạn mức còn lại và chi phí ước tính.
Đôi nét về Gemma 4
Gemma 4 là dòng model trọng số mở (open weights) của Google, cho phép dùng thương mại có trách nhiệm theo giấy phép Gemma 4 (Google: Gemma 4). Theo tài liệu Google ngày 24/10/2026, dòng này có năm cỡ: E2B, E4B (cỡ hiệu dụng 2B, 4B, chạy được trên thiết bị biên), 12B, 26B A4B (Mixture-of-Experts) và 31B (dense).
Mọi bản nhận văn bản và ảnh; E2B, E4B, 12B nhận thêm âm thanh. Bản nhỏ có context 128K, bản cỡ vừa 256K. Thông tin chi tiết hơn xem bài Gemma 4 là gì.
Trên Gemini API, Gemma 4 chỉ có ở gói miễn phí; theo trang giá Google cập nhật 22/10/2026, dữ liệu gửi qua gói miễn phí được dùng để cải thiện sản phẩm (Gemini API pricing). Không gửi dữ liệu khách hàng hay tài liệu nội bộ qua đường này.
Hướng dẫn sử dụng Gemma 4 trên OpenClaw với 9Router
Ảnh chụp thực hiện 04/2026 với 9Router 0.3.83 và OpenClaw bản cùng thời điểm; giao diện bản mới có thể khác vài chi tiết, các bước vẫn tương tự.
Nếu chỉ cần Gemma 4 mà không cần combo, OpenClaw có sẵn provider Google: chạy openclaw onboard --auth-choice gemini-api-key rồi openclaw models set google/gemma-4-26b-a4b-it (OpenClaw: Google provider). Các bước dưới đây dùng 9Router để có thêm combo luân phiên nhiều model.
Cách sử dụng Gemma 4 trên OpenClaw
Bước 1: Khởi tạo 9Router trên VPS
Truy cập VPS qua SSH, rồi cài và khởi chạy 9Router:
npm install -g 9router
9router
Khi menu cấu hình xuất hiện, dùng phím điều hướng chọn Hide to Tray (Background) để 9Router chạy nền trên máy chủ. Trên VPS, đặt mật khẩu dashboard riêng ngay (mặc định là 123456 khi chưa đặt).
Bước 2: Mở SSH Tunnel để truy cập Web UI
Để vào giao diện quản trị 9Router an toàn từ máy tính cá nhân, mở đường hầm chuyển tiếp cổng. Mở terminal trên máy cá nhân (không phải VPS), ví dụ Windows PowerShell, và chạy:
ssh -N -L 20128:127.0.0.1:20128 root@ip-vps
Nhập mật khẩu VPS khi được hỏi. Lệnh này ánh xạ cổng 20128 của VPS về máy bạn. Giữ cửa sổ này mở trong lúc dùng dashboard; đóng cửa sổ chỉ ngắt dashboard trên máy bạn, OpenClaw trên VPS vẫn gọi 9Router bình thường.
Bước 3: Khởi tạo API Key cho OpenClaw
Mở trình duyệt, vào http://localhost:20128. Tại trang Endpoint, mục API Keys, nhấn + Create Key.
Khi hệ thống cấp key mới, nhấn Copy.
Lưu key này cùng API Endpoint http://localhost:20128/v1; đây là thông tin để khai báo vào OpenClaw. Nên bật luôn công tắc Require API key (mặc định tắt) để 9Router từ chối yêu cầu không có key.
Bước 4: Tích hợp Gemini (Gemma 4) vào 9Router
Trên menu trái của 9Router, chọn Providers, tìm nhóm Free Tier Providers và chọn Gemini.
Ảnh chụp 04/2026 còn hiện Qwen Code, Gemini CLI, iFlow AI trong nhóm miễn phí; theo README 9Router ngày 24/10/2026, các tier miễn phí này đã ngừng.
Nhấn + Add Connection để khai báo kết nối mới.
Nhập tên nhận diện, dán API key Gemini (tạo ở Google AI Studio) vào ô tương ứng và lưu lại.
Bước 5: Bổ sung định danh model Gemma 4
Vẫn trong 9Router, kéo xuống Available Models và nhấn + Add Model.
Vào Google AI Studio để lấy định danh chuẩn của model. Ví dụ: gemma-4-26b-a4b-it.
Nhấn Test để kiểm tra. Khi thấy dòng xanh Model is reachable, nhấn Add Model.
Bước 6: Thiết lập cấu hình trên cửa sổ lệnh OpenClaw
Trở lại terminal đang điều khiển OpenClaw trên VPS và mở trình cấu hình:
openclaw config(hoặcopenclaw config --section model): khi cài OpenClaw trực tiếp../scripts/docker/setup.sh: khi OpenClaw chạy bằng Docker từ kho mã.
Trong danh sách nhà cung cấp, chọn Custom Provider.
OpenClaw hỏi API Base URL. Nhập địa chỉ mà OpenClaw truy cập được 9Router:
- OpenClaw cài trực tiếp trên cùng VPS:
http://127.0.0.1:20128/v1. - OpenClaw chạy trong Docker: dùng địa chỉ của host trên mạng Docker nội bộ, vì
localhosttrong container là chính container.
Lưu ý an toàn: ảnh minh hoạ nhập IP công khai của VPS. Cách đó chạy được nhưng để lộ 9Router ra Internet, ai biết địa chỉ cũng gọi được model bằng tài khoản của bạn. Nếu buộc phải dùng, bật Require API key và chặn cổng 20128 bằng tường lửa, chỉ cho phép nguồn cần thiết.
Ở bước xác thực, chọn Paste API key now và dán key đã tạo ở bước 3.
Chọn chuẩn tương thích OpenAI-compatible.
Tại Model ID, gõ chính xác gemini/gemma-4-26b-a4b-it rồi nhấn Enter.
Ở Endpoint ID, đặt tên đơn giản, ví dụ 9router-openclaw.
Nhấn Enter, OpenClaw đã liên kết với Gemma 4 qua 9Router.
Bước 7: Tùy chỉnh tham số trên Web Control OpenClaw
Sau khi khai báo, vào giao diện quản trị web của OpenClaw để kiểm tra. Mở AI & Agents ở menu trái, chuyển sang thẻ Models; provider 9router-openclaw hiện trong danh sách.
Kéo xuống Context Window. Giá trị này phải khớp giới hạn thật của model: theo Google AI Studio, Gemma 4 26B A4B và 31B có context 256K, nên đặt tối đa 256000 (ảnh minh hoạ đặt 200000). Đặt lớn hơn context thật không làm model nhận nhiều hơn, chỉ khiến yêu cầu bị từ chối khi vượt giới hạn.
Nhấn Save ở góc trên để lưu. Nếu vẫn lỗi, khởi động lại Gateway trên VPS:
docker compose restart openclaw-gateway # cài bằng Docker
openclaw gateway restart # cài trực tiếpChuyển sang khung Chat của OpenClaw, ở menu chọn model, chọn gemini/gemma-4-26b-a4b-it · 9router-openclaw.
Giờ bạn có thể chat trực tiếp trên web hoặc qua kênh như Telegram để kiểm tra:
Cách dùng tính năng Combo chạy luân phiên các model
Combo trên 9Router gom nhiều model vào một tên gọi, tự điều phối yêu cầu để tránh dồn vào một nguồn.
Bước 1: Khởi tạo nhóm Combo mới
Quay lại 9Router, chuyển sang thẻ Combos, nhấn + Create Combo. Đặt tên ngắn, ví dụ tino-openclaw.
Nhấn + Add Model để thêm Gemma 4 và các model khác vào nhóm, rồi nhấn Create.
Bước 2: Kích hoạt cơ chế luân phiên
Trong danh sách Combos, bật công tắc Round Robin. 9Router sẽ chia lần lượt yêu cầu từ OpenClaw sang các model trong nhóm. Round Robin chỉ chia tải giữa các nguồn bạn được phép dùng; không dùng để luân phiên nhiều tài khoản nhằm vượt hạn mức miễn phí.
Bước 3: Khai báo Combo trên giao diện lệnh OpenClaw
- Mở lại trình cấu hình OpenClaw.
- Làm lại bước khai báo Custom Provider như Bước 6 ở trên (API Base URL, dán API key, chọn OpenAI-compatible).
- Khác biệt duy nhất là Model ID: nhập tên combo
tino-openclawthay vì định danh một model.
Sau đó OpenClaw gửi mọi truy vấn qua 9Router và combo tự luân phiên giữa các model.
Cấu hình 9Router cho OpenClaw chi tiết hơn, kèm cấu hình thủ công và bảng lỗi, xem bài cách dùng 9Router cho OpenClaw.
Các bài viết liên quan:
- Cấu hình tối thiểu để chạy OpenClaw trên VPS là bao nhiêu?
- Hướng dẫn cách lấy API Token Slack để kết nối với OpenClaw
- Hướng dẫn cài đặt OpenClaw trên VPS bằng Docker
- Hướng dẫn cách lấy API Token Telegram để kết nối với OpenClaw
- Cài OpenClaw trên VPS có phức tạp không?
- Phân biệt Skills và Plugin trong OpenClaw
- Hướng dẫn cài đặt OpenClaw Skills trên ClawHub
- Hướng dẫn tạo Custom Skills cho OpenClaw
- Hướng dẫn kết nối Codex (ChatGPT OAuth) với OpenClaw
- Hướng dẫn kết nối Discord với OpenClaw
Kết luận
Kết hợp OpenClaw với 9Router cho phép dùng Gemma 4 trên VPS và gom thêm model khác vào combo luân phiên. Gemma 4 qua Gemini API có giới hạn tốc độ của gói miễn phí; hãy giữ 9Router ở mạng nội bộ, bật Require API key và đặt Context Window đúng với model.
Muốn chạy OpenClaw 24/7 mà không tự cài? VPS OpenClaw của Tino cài sẵn OpenClaw trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.
Những câu hỏi thường gặp
9Router đóng vai trò gì trong hệ thống này?
9Router là trung tâm điều phối: OpenClaw chỉ gọi một endpoint, còn 9Router chọn model hoặc combo phía sau và tự chuyển nguồn khi lỗi. Nếu chỉ cần Gemma 4, OpenClaw cũng gọi trực tiếp được qua provider Google mà không cần 9Router.
Tôi có thể tắt PowerShell trên máy tính sau khi cài đặt xong không?
Được. Cửa sổ PowerShell chỉ giữ đường hầm SSH để bạn mở dashboard 9Router trên máy mình. Đóng cửa sổ thì không vào được dashboard nữa, nhưng OpenClaw trên VPS vẫn gọi 9Router bình thường.
Tính năng Round Robin mang lại lợi ích gì?
Round Robin chia đều yêu cầu từ OpenClaw sang lần lượt từng model trong combo, giúp không dồn tải vào một nguồn. Mỗi yêu cầu vẫn tính vào hạn mức của nguồn tương ứng.
Chức năng Hide to Tray (Background) có bắt buộc không?
Không bắt buộc nhưng nên dùng: chế độ này giữ 9Router chạy nền khi bạn thoát phiên SSH. Trên VPS dùng lâu dài, có thể chạy 9Router bằng PM2 hoặc Docker theo README của dự án.
Có thể thay đổi model trong Combo khi đang chạy không?
Có. Vào Combos trên 9Router để thêm, bớt model, đổi thứ tự hoặc bật tắt Round Robin; thay đổi áp dụng cho các yêu cầu tiếp theo từ OpenClaw mà không cần sửa cấu hình OpenClaw.
