9Router là phần mềm mã nguồn mở (giấy phép MIT) chạy ngay trên máy của bạn như một cổng trung gian cho model AI: các công cụ như Claude Code, Codex, Cursor hay OpenClaw gửi yêu cầu vào một địa chỉ http://localhost:20128/v1, 9Router chọn nhà cung cấp, đổi định dạng API và tự chuyển sang model khác khi nguồn đang dùng lỗi hoặc hết hạn mức.
9Router là dự án bên thứ ba của tác giả decolua trên GitHub, không thuộc OpenAI, Anthropic hay OpenClaw. Phần mềm không thu phí, nhưng model phía sau vẫn tính tiền hoặc có hạn mức riêng. Nếu bạn đang dùng OpenClaw, bức tranh chung về các cách đưa model vào OpenClaw nằm ở bài dùng nhiều model AI trên OpenClaw.
Bài viết đi qua: 9Router là gì, nó hoạt động ra sao, rủi ro điều khoản và bảo mật cần biết, rồi cài đặt và dùng 9Router từng bước trên máy tính cá nhân.
Tổng quan về 9Router
9Router là gì?
9Router là một LLM gateway (local proxy router) viết bằng Node.js, mã nguồn công khai tại github.com/decolua/9router. Thay vì mỗi công cụ AI gọi thẳng đến một nhà cung cấp, bạn trỏ tất cả về endpoint của 9Router; 9Router giữ danh sách tài khoản, API key và combo model, rồi quyết định yêu cầu nào đi đến đâu.
Thông tin Chi tiết (kiểm ngày 24/10/2026) Tác giả, kho mã decolua và cộng đồng, github.com/decolua/9routerGiấy phép MIT Ngày tạo kho mã 05/01/2026 (GitHub API) Lượt sao GitHub Khoảng 31.300 Bản npm mới nhất 0.5.109, phát hành 23/10/2026 Yêu cầu Node.js 18 trở lên Endpoint mặc định http://localhost:20128/v1 (tương thích OpenAI API), dashboard ở /dashboardNơi lưu dữ liệu Thư mục ~/.9router (SQLite db/data.sqlite), đổi bằng biến DATA_DIRCách cài npm ( npm install -g 9router), Docker image decolua/9router, hoặc build từ mã nguồn
Số phiên bản và số sao thay đổi rất nhanh vì dự án cập nhật gần như hằng ngày. Hãy xem trang GitHub khi cài để biết bản hiện hành.
9Router hoạt động như thế nào?
9Router hoạt động như một bộ chuyển mạch đứng giữa công cụ AI và nhà cung cấp model. Mỗi yêu cầu đi qua ba bước: công cụ gửi yêu cầu chuẩn OpenAI vào localhost:20128/v1 kèm API key nội bộ; 9Router tra combo hoặc model được gọi; sau đó dịch yêu cầu sang định dạng của provider đích (OpenAI, Claude, Gemini…) và trả kết quả về.
Điểm cần nhớ: mọi token OAuth và API key bạn kết nối đều nằm trên máy chạy 9Router, nên máy đó phải được bảo vệ kỹ như một kho mật khẩu. Cách khai báo provider và API key trực tiếp trong OpenClaw, không qua trung gian, xem ở bài đổi provider, model và API key trong OpenClaw.
9Router giải quyết vấn đề gì?
9Router giải quyết ba việc mà người dùng nhiều công cụ AI hay gặp:
- Hết hạn mức giữa chừng: mỗi gói có giới hạn riêng (theo phiên, theo tuần hoặc theo tháng). Khi một nguồn báo lỗi giới hạn, 9Router chuyển sang model kế tiếp trong combo thay vì bắt bạn đổi cấu hình bằng tay.
- Quá nhiều endpoint và key: mỗi công cụ chỉ cần một base URL và một API key nội bộ của 9Router.
- Khó theo dõi lượng dùng: dashboard thống kê token theo provider, theo model và hiển thị chi phí ước tính.
Nhà phát triển còn tích hợp bộ nén đầu ra công cụ (RTK) và công bố mức tiết kiệm khoảng 20–40% token; đây là số liệu do dự án tự công bố, kết quả thực tế phụ thuộc vào loại tác vụ.
Kiến trúc 3 tầng của 9Router
9Router đề xuất xếp model theo ba tầng ưu tiên trong combo. Đây là gợi ý cấu hình, không phải cơ chế bắt buộc:
- Tầng 1, gói thuê bao bạn đã trả tiền: Claude Code, Codex, GitHub Copilot, Cursor… kết nối qua OAuth. 9Router dùng hạn mức này trước.
- Tầng 2, provider giá thấp: API key trả theo lượng dùng của các nhà cung cấp rẻ hơn, hoặc gateway như OpenRouter, dùng khi tầng 1 hết hạn mức.
- Tầng 3, tier miễn phí: theo README ngày 24/10/2026 gồm Kiro AI (khoảng 50 credit mỗi tháng, tài khoản mới có thêm credit dùng thử 30 ngày), OpenCode Free (danh sách model thay đổi theo thời gian) và credit 300 USD cho tài khoản Google Cloud mới qua Vertex AI.
README cũng ghi các tier miễn phí của iFlow, Qwen Code và Gemini CLI đã ngừng trong năm 2026. Hướng dẫn cũ trên mạng nhắc tới các nguồn này đều đã lỗi thời. Tier miễn phí luôn có trần sử dụng, nên một combo “toàn miễn phí” chỉ chạy được đến khi các trần đó cạn. Danh sách nhà cung cấp có API key miễn phí kèm giới hạn từng nơi nằm trong bài LLM lấy API key miễn phí cho AI Agent.
9Router có miễn phí không?
9Router miễn phí về phần mềm: không có hệ thống thanh toán, không lưu thẻ của bạn. Chi phí thật nằm ở các nhà cung cấp phía sau: gói thuê bao bạn đang trả, API key tính theo token, còn tier miễn phí thì có hạn mức. Không có cách hợp lệ nào để dùng model trả phí mà không trả tiền hoặc không chịu hạn mức khi đi qua 9Router.
Con số “chi phí” trên dashboard 9Router chỉ là ước tính theo giá API công khai, dùng để so sánh. Theo README, 9Router không tự tính tiền bạn; hoá đơn thật đến từ nhà cung cấp mà yêu cầu đã đi qua.
Dùng 9Router có an toàn không? Điều khoản và bảo mật
9Router an toàn ở mức phần mềm mã nguồn mở chạy cục bộ, nhưng có hai nhóm rủi ro bạn phải tự quản: điều khoản của nhà cung cấp model và việc giữ an toàn cho token, key mà 9Router nắm.
Rủi ro điều khoản khi dùng gói thuê bao qua proxy
Chính 9Router hiển thị cảnh báo ngay trên trang kết nối provider OAuth: phiên thuê bao/OAuth không được cấp phép chính thức cho việc dùng qua proxy hoặc router, tài khoản có thể bị hạn chế hoặc khoá, người dùng tự chịu rủi ro.
- Điều khoản sử dụng của OpenAI (bản áp dụng ngoài EEA, hiệu lực 01/01/2026) cấm chia sẻ thông tin đăng nhập, cho người khác dùng tài khoản và lách giới hạn tốc độ (OpenAI Terms of Use).
- Điều khoản người dùng của Anthropic (hiệu lực 08/10/2025) cấm truy cập dịch vụ bằng bot, script hoặc phương tiện tự động, trừ khi dùng API key hoặc được Anthropic cho phép rõ (Anthropic Consumer Terms).
- Riêng OpenClaw, tài liệu chính thức ghi OpenAI hỗ trợ dùng OAuth của gói ChatGPT/Codex trong OpenClaw (OpenClaw: OpenAI provider). Nếu chỉ cần Codex cho OpenClaw, kết nối trực tiếp theo bài kết nối Codex (ChatGPT OAuth) với OpenClaw ít rủi ro hơn đi qua proxy.
Nguyên tắc an toàn: mỗi tài khoản chỉ một người dùng, không gom nhiều tài khoản để luân phiên vượt hạn mức, không dùng chung combo cho người khác, và với việc tự động hoá chạy thường xuyên thì ưu tiên API key trả theo dùng.
Rủi ro bảo mật khi đưa API key và token cho 9Router
| Điểm rủi ro | Cách giảm rủi ro |
|---|---|
Mật khẩu dashboard mặc định 123456 khi chưa đặt mật khẩu | Đổi mật khẩu ngay lần đăng nhập đầu; khi chạy trên VPS đặt biến INITIAL_PASSWORD trước khi khởi động |
Tuỳ chọn Require API key mặc định tắt (REQUIRE_API_KEY=false) | Bật tuỳ chọn này trong Endpoint & Key, nhất là khi 9Router không chỉ nghe trên localhost |
| Cổng 20128 mở ra Internet: ai biết địa chỉ cũng gọi được model bằng tài khoản của bạn | Giữ 9Router ở 127.0.0.1; truy cập từ xa qua đường hầm SSH hoặc mạng riêng như Tailscale |
Token OAuth và API key lưu trong ~/.9router | Phân quyền thư mục, không sao lưu thư mục này lên nơi công khai, xoá kết nối không còn dùng |
| Cloud Sync đồng bộ provider, combo, cài đặt lên máy chủ 9router.com | Chỉ bật khi bạn chấp nhận gửi cấu hình ra dịch vụ của bên thứ ba |
Ghi log đầy đủ request/response (ENABLE_REQUEST_LOGS) | Chỉ bật khi gỡ lỗi, xoá log sau đó vì log có thể chứa dữ liệu nhạy cảm |
| Bản fork, image Docker không chính chủ | Chỉ cài gói npm 9router hoặc image decolua/9router liên kết từ kho mã gốc |
Khi chạy 9Router cạnh AI Agent trên VPS, áp dụng thêm các lớp bảo vệ chung trong bài cách ly sandbox cho AI Agent trên VPS và bảo mật VPS chạy AI Agent bằng Tailscale. Các rủi ro riêng của OpenClaw được tổng hợp trong bài rủi ro bảo mật khi dùng OpenClaw.
Hướng dẫn cài đặt và sử dụng 9Router
Các công cụ kết nối được với 9Router gồm Claude Code, Codex, Cursor và OpenClaw. Hướng dẫn dưới đây thực hiện trên máy tính cá nhân chạy Windows. Trên macOS hoặc Linux, các lệnh giống hệt, chỉ khác là mở Terminal thay cho PowerShell. Giao diện trong ảnh là 9Router 0.5.45 (05/2026); bản mới có thể khác vài chi tiết nhỏ.
Cách cài đặt 9Router trên máy tính cá nhân
Chuẩn bị trước:
- Node.js 18 trở lên, kiểm tra bằng lệnh
node --version. - Kết nối Internet để tải gói từ npm.
- Ít nhất một nguồn model: API key của một nhà cung cấp, gói thuê bao bạn đang dùng, hoặc tier miễn phí như Kiro AI.
Bước 1: Mở PowerShell (Windows) hoặc Terminal (macOS/Linux) và cài 9Router:
npm install -g 9router
Bước 2: Khởi động 9Router:
9router
Màn hình Choose Interface hiện ra. Chọn Web UI (Open in Browser) và nhấn Enter, dashboard mở tại http://localhost:20128.
Một số tuỳ chọn khi khởi động:
9router --port 8080 # dùng cổng khác
9router --no-browser # không tự mở trình duyệt
9router --skip-update # bỏ qua kiểm tra cập nhậtBước 3: Truy cập http://localhost:20128/dashboard và đăng nhập. Khi chưa đặt mật khẩu, mật khẩu mặc định là 123456; hãy vào Settings đổi mật khẩu ngay sau lần đăng nhập đầu.
Dashboard là nơi quản lý mọi thứ: kết nối provider, tạo combo, tạo API key cho công cụ, xem thống kê token và chi phí ước tính.
Bước 4: Quay lại cửa sổ terminal, chọn Hide to Tray (Background) và nhấn Enter.
9Router tiếp tục chạy nền, bạn có thể đóng terminal và tab dashboard rồi mở lại khi cần. Sau khi tắt hoặc khởi động lại máy, chạy lại lệnh 9router.
Kết nối Codex với 9Router
Ví dụ này kết nối gói ChatGPT có Codex qua OAuth. Trước khi làm, đọc lại mục rủi ro điều khoản ở trên; nếu chỉ dùng Codex cho OpenClaw, kết nối trực tiếp trong OpenClaw là lựa chọn đơn giản hơn.
Bước 1: Trong dashboard, vào Providers và tìm OpenAI Codex trong nhóm OAuth Providers.
Bước 2: Nhấn Add Connection. Trang này có dòng Risk Notice như ảnh ở mục rủi ro.
Bước 3: Cửa sổ OAuth mở ra (callback ở cổng 1455), chọn tài khoản OpenAI có quyền dùng Codex.
Thông thường 9Router tự nhận kết quả sau khi bạn đăng nhập. Nếu không, sao chép toàn bộ URL callback trên thanh địa chỉ và dán vào ô trong 9Router.
Kết nối thành công:
Danh sách model Codex của tài khoản hiện trong mục Available Models.
9Router lưu token và tự làm mới trước khi hết hạn. Hạn mức Codex của gói ChatGPT có chu kỳ theo phiên và theo tuần; bạn theo dõi trong mục Quota Tracker.
Kết nối 9Router với các công cụ hoặc AI Agent
Bước 1: Vào mục Endpoint, nhấn Create Key.
Bước 2: Đặt tên cho API key và nhấn Create.
Bước 3: Sao chép key vừa tạo; đây là key bạn điền vào công cụ của mình. 9Router chỉ hiện key một lần.
Thông tin còn lại là API Endpoint dạng http://localhost:20128/v1.
Bước 4: Nhấn CLI Tools để xem danh sách công cụ 9Router hỗ trợ cấu hình nhanh.
Mỗi công cụ cấu hình hơi khác nhau, nhưng luôn cần ba thông tin: endpoint, API key của 9Router và tên model (hoặc tên combo) trên 9Router. Nhấn Manual Config để xem cấu hình thủ công. Ví dụ với OpenClaw:
Cấu hình chi tiết từng bước trong OpenClaw, kèm cách kiểm tra và xử lý lỗi, xem bài cách dùng 9Router cho OpenClaw.
Tạo Combo: chiến lược chuyển model tự động
Combo trong 9Router là một nhóm model có thứ tự ưu tiên, được gọi bằng một tên chung. Khi model đầu lỗi hoặc hết hạn mức, 9Router chuyển sang model kế tiếp mà không cần bạn sửa cấu hình công cụ.
Bước 1: Vào Combos, chọn Create Combo.
Bước 2: Đặt tên combo rồi nhấn Add Model.
Chọn các model muốn đưa vào combo.
Số model hiển thị tuỳ provider bạn đã kết nối. Trong ví dụ, Tino chỉ kết nối Codex nên chỉ thấy model của OpenAI.
Bước 3: Sắp xếp thứ tự ưu tiên rồi nhấn Create.
Sau khi tạo, chọn chiến lược cho combo:
- Fallback: thử model theo thứ tự, lỗi thì sang model kế tiếp. Dễ đoán chi phí và hợp với tác vụ dài.
- Round Robin: luân phiên model giữa các yêu cầu để chia tải.
- Fusion: gửi cùng yêu cầu tới nhiều model rồi dùng một model “giám khảo” tổng hợp; tốn token hơn cả vì mỗi yêu cầu bị tính ở mọi model.
- Capacity auto-switch: chuyển yêu cầu có ảnh, PDF, âm thanh sang model hỗ trợ loại dữ liệu đó trước.
Round Robin chỉ nên dùng để 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 của một nhà cung cấp.
Theo dõi hạn mức và chi phí trên 9Router
Dashboard 9Router có hai trang theo dõi chính. Quota Tracker hiển thị hạn mức còn lại và thời điểm đặt lại của từng tài khoản đã kết nối.
Usage & Analytics thống kê số yêu cầu, token đầu vào, token cache, token đầu ra theo provider và model, kèm chi phí ước tính (ghi rõ “Estimated, not actual billing”).
Khi nào không nên dùng 9Router?
9Router không bắt buộc. Kết nối thẳng nhà cung cấp thường hợp hơn khi:
- Bạn chỉ dùng một model cố định và không cần chuyển dự phòng.
- Công việc là tự động hoá chạy liên tục hoặc phục vụ khách hàng: dùng API key chính thức để điều khoản và hoá đơn rõ ràng.
- Công cụ đã hỗ trợ sẵn provider bạn cần, ví dụ OpenClaw có sẵn OpenAI, Anthropic, Google Gemini, OpenRouter, Ollama.
- Bạn không muốn thêm một nơi lưu token và key cần bảo vệ.
- Tổ chức có quy định cấm định tuyến dữ liệu qua phần mềm trung gian chưa được duyệt.
Kết luận
9Router là công cụ tiện cho người dùng nhiều trợ lý lập trình AI: một endpoint, nhiều provider, combo tự chuyển model và dashboard theo dõi token. Phần mềm miễn phí, còn model thì không; tier miễn phí có trần và gói thuê bao có điều khoản riêng. Hãy bắt đầu với API key hoặc gói của chính bạn, giữ 9Router ở localhost, bật Require API key và đổi mật khẩu mặc định trước khi dùng thật.
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 có miễn phí không?
9Router miễn phí về phần mềm (giấy phép MIT) và không có hệ thống thanh toán. Bạn vẫn trả tiền cho gói thuê bao hoặc API key của nhà cung cấp; tier miễn phí như Kiro AI có hạn mức hằng tháng.
Dashboard 9Router hiện chi phí vài trăm đô, tôi có bị tính tiền không?
Không. Theo README, con số đó là chi phí ước tính nếu bạn gọi API trả phí trực tiếp, dùng để tham khảo. Hoá đơn thật đến từ nhà cung cấp bạn kết nối, không phải từ 9Router.
9Router dùng được với những công cụ nào?
Mọi công cụ cho phép đặt endpoint tương thích OpenAI đều kết nối được. Trang CLI Tools của 9Router có cấu hình sẵn cho Claude Code, Codex CLI, OpenClaw, Cursor, Cline, Continue, Roo, Kilo Code, OpenCode, Hermes Agent và một số công cụ khác.
Khi 9Router chuyển model giữa chừng, ngữ cảnh có bị mất không?
Lịch sử hội thoại vẫn nằm trong phiên của công cụ bạn dùng. Model mới có thể trả lời khác phong cách hoặc độ chính xác. Với tác vụ dài cần nhất quán, đặt model chính còn đủ hạn mức ở đầu combo Fallback.
Có nên cài 9Router trên VPS không?
Được, README có hướng dẫn chạy bằng Docker hoặc PM2. Khi chạy trên VPS, giữ cổng 20128 không mở ra Internet, bật Require API key, đặt mật khẩu dashboard riêng và truy cập dashboard qua đường hầm SSH hoặc Tailscale.
