9Router là một lớp AI router tương thích OpenAI API, giúp gom nhiều provider và model AI về một endpoint chung. Khi kết nối 9Router với OpenClaw, người dùng có thể để OpenClaw gọi model thông qua một gateway trung gian thay vì cấu hình rời rạc từng API key trong từng công cụ.
Cách làm này đặc biệt hữu ích nếu bạn muốn thử nhiều model như Claude, Gemini, OpenAI, DeepSeek, Groq hoặc các provider rẻ hơn nhưng vẫn giữ một cấu hình ổn định cho OpenClaw. Thay vì đổi endpoint liên tục, bạn chỉ cần trỏ OpenClaw về 9Router, sau đó quản lý provider, fallback và quota ở phía router.
Bài viết này hướng dẫn cách cài 9Router, kiểm tra endpoint local, sau đó kết nối vào OpenClaw theo hướng an toàn. Mục tiêu không phải là dùng càng nhiều model càng tốt, mà là tạo một lớp điều phối dễ kiểm soát, dễ thay đổi và giảm rủi ro khi provider chính bị lỗi hoặc hết quota.
9Router là gì?
9Router là một AI gateway/router tương thích chuẩn OpenAI API. Công cụ này cho phép nhiều ứng dụng AI, CLI hoặc IDE kết nối tới một endpoint chung, thường là http://127.0.0.1:20128/v1, rồi từ đó định tuyến yêu cầu tới nhiều provider khác nhau.
Nói đơn giản, 9Router đóng vai trò “trạm trung chuyển” giữa OpenClaw và các model AI. OpenClaw gửi request tới 9Router bằng giao thức quen thuộc của OpenAI-compatible API. 9Router nhận request, chọn provider/model phù hợp, xử lý fallback nếu cần, rồi trả kết quả về cho OpenClaw.
Điểm quan trọng là 9Router không phải model AI mới. Nó là lớp hạ tầng giúp quản lý model, provider, endpoint, quota và fallback gọn hơn. Với người dùng OpenClaw, đây là cách giảm độ phức tạp khi muốn dùng nhiều nguồn AI khác nhau trong cùng một workflow.
Vì sao nên kết nối 9Router với OpenClaw?
OpenClaw vốn được thiết kế như một AI agent/gateway có thể kết nối với nhiều model và kênh làm việc. Nhưng nếu mỗi provider đều có endpoint, API key, hạn mức và cách cấu hình riêng, người dùng mới rất dễ bị rối.
Khi thêm 9Router vào giữa, bạn có ba lợi ích thực tế.
Thứ nhất, OpenClaw chỉ cần biết một endpoint chung. Nếu sau này bạn đổi model mặc định, thêm provider dự phòng hoặc chuyển từ model rẻ sang model mạnh hơn, phần thay đổi chủ yếu nằm trong 9Router thay vì phải chỉnh nhiều nơi.
Thứ hai, 9Router hỗ trợ tư duy fallback. Khi provider chính lỗi, hết quota hoặc phản hồi chậm, router có thể chuyển sang provider/model khác tùy cấu hình. Điều này quan trọng với các tác vụ chạy định kỳ, chatbot hoặc workflow doanh nghiệp, vì hệ thống không nên “chết” chỉ vì một model tạm thời không dùng được.
Thứ ba, bạn dễ quan sát chi phí hơn. Với một lớp router, việc theo dõi usage, quota hoặc lựa chọn model rẻ cho tác vụ nhẹ trở nên rõ ràng hơn. OpenClaw vẫn là nơi bạn tương tác và tự động hóa, còn 9Router là nơi điều phối model phía sau.
Mô hình kết nối OpenClaw và 9Router
Có thể hình dung mô hình kết nối như sau:
Người dùng gửi yêu cầu qua OpenClaw. OpenClaw nhận tin nhắn từ Web UI, Telegram, Discord hoặc một kênh khác. Thay vì gọi trực tiếp OpenAI, Anthropic hay Gemini, OpenClaw gửi request tới 9Router local endpoint. 9Router chọn model/provider phù hợp rồi trả kết quả về OpenClaw. Cuối cùng, OpenClaw trả lời lại người dùng trên đúng kênh ban đầu.
Mô hình này giúp tách rõ hai phần:
- OpenClaw quản lý trải nghiệm agent, kênh chat, file, automation, skills và workflow.
- 9Router quản lý provider, model, fallback, quota và endpoint OpenAI-compatible.
Với người mới, cách tách này dễ hiểu hơn so với việc trộn tất cả cấu hình vào một nơi. Với người dùng nâng cao, nó cũng linh hoạt hơn khi cần thử model mới hoặc thay đổi chiến lược chi phí.
Cần chuẩn bị gì trước khi cài?
Trước khi bắt đầu, bạn nên chuẩn bị bốn thứ.
Đầu tiên là môi trường chạy Node.js hoặc công cụ cài đặt tương ứng theo tài liệu chính thức của 9Router. Nếu dùng máy cá nhân, Windows, macOS và Linux đều có thể triển khai, miễn là có quyền cài package và mở dịch vụ local.
Thứ hai là OpenClaw đã cài và chạy được. Nếu chưa làm bước này, bạn nên đọc trước bài hướng dẫn cài đặt OpenClaw trên Windows, macOS và Linux, sau đó quay lại bài này để cấu hình model gateway.
Thứ ba là ít nhất một provider AI có thể dùng được. Đó có thể là API key, tài khoản subscription, OAuth hoặc provider miễn phí tùy cách 9Router hỗ trợ ở thời điểm bạn cài đặt.
Thứ tư là hiểu nguyên tắc bảo mật: không đưa API key thật vào bài viết, ảnh chụp màn hình, GitHub public repo hoặc file cấu hình dùng chung. Trong ví dụ bên dưới, mọi token đều được viết dưới dạng placeholder như YOUR_API_KEY hoặc YOUR_9ROUTER_KEY.
Bước 1: Cài 9Router
Theo thông tin công khai từ trang 9Router, cách cài nhanh thường dùng npm:
npm install -g 9router
Sau khi cài xong, bạn có thể khởi động 9Router bằng lệnh tương ứng theo hướng dẫn của công cụ. Tùy phiên bản, lệnh khởi động có thể khác nhau, vì vậy hãy ưu tiên kiểm tra tài liệu chính thức hoặc màn hình dashboard sau khi cài.
Một cách kiểm tra đơn giản là xem dịch vụ có mở endpoint local hay không. Endpoint thường được 9Router dùng là:
http://127.0.0.1:20128/v1
Nếu 9Router chạy trên cùng máy với OpenClaw, nên ưu tiên dùng 127.0.0.1 thay vì IP public. Cách này giảm rủi ro lộ gateway ra ngoài mạng.
Bước 2: Mở dashboard và kết nối provider
Sau khi 9Router chạy, bạn cần vào dashboard để kết nối provider hoặc tài khoản AI đang có. 9Router định vị mình như một router cho nhiều provider và nhiều loại dịch vụ AI, bao gồm chat/LLM, embedding, image generation, vision, TTS, STT và web search.
Với OpenClaw, phần quan trọng nhất lúc đầu là chat/LLM. Bạn nên cấu hình tối thiểu một model mặc định để kiểm tra luồng hoạt động trước. Sau khi đã chạy ổn, mới thêm fallback hoặc routing nâng cao.
Một cấu hình thực tế có thể đi theo thứ tự:
- Model rẻ hoặc miễn phí cho chat hằng ngày.
- Model mạnh hơn cho phân tích dài, viết nội dung hoặc code.
- Model dự phòng để tránh gián đoạn khi provider chính lỗi.
Không nên thêm quá nhiều provider ngay từ đầu. Càng nhiều lựa chọn, càng khó debug nếu OpenClaw không phản hồi đúng.
Bước 3: Kiểm tra 9Router bằng OpenAI-compatible request
Trước khi đưa vào OpenClaw, bạn nên kiểm tra 9Router bằng một request đơn giản. Nếu endpoint local hoạt động, request tới /chat/completions sẽ trả về phản hồi từ model đã cấu hình.
Ví dụ kiểm tra bằng curl:
curl http://127.0.0.1:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_9ROUTER_KEY" \
-d '{
"model": "MODEL_NAME_IN_9ROUTER",
"messages": [
{"role": "user", "content": "Xin chào, hãy trả lời ngắn gọn bằng tiếng Việt."}
]
}'
Nếu request trả về nội dung tiếng Việt, nghĩa là 9Router đã chạy và model có thể phản hồi. Nếu lỗi, bạn nên sửa ở bước này trước khi cấu hình OpenClaw. Đừng vội chỉnh OpenClaw khi bản thân endpoint router chưa hoạt động.
Các lỗi thường gặp gồm sai model name, chưa kết nối provider, token không hợp lệ, port 20128 chưa mở hoặc 9Router chưa chạy.
Bước 4: Trỏ OpenClaw về endpoint của 9Router
Sau khi endpoint 9Router hoạt động, bạn cần cấu hình OpenClaw để gọi model qua endpoint này. Tùy phiên bản OpenClaw, vị trí file cấu hình có thể khác nhau, nhưng về logic thường cần ba thông tin:
- Base URL: `http://127.0.0.1:20128/v1`
- API key/token: token mà 9Router yêu cầu, nếu có
- Model name: tên model hoặc alias đã cấu hình trong 9Router
Ví dụ cấu hình theo hướng OpenAI-compatible:
{
"models": {
"providers": {
"9router": {
"baseUrl": "http://127.0.0.1:20128/v1",
"apiKey": "YOUR_9ROUTER_KEY",
"api": "openai",
"models": [
{
"id": "MODEL_NAME_IN_9ROUTER",
"name": "9Router Default Model",
"input": ["text"],
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
},
"default": "MODEL_NAME_IN_9ROUTER"
}
}
Ví dụ trên cần được điều chỉnh theo schema thực tế của bản OpenClaw bạn đang dùng. Điểm cần giữ là: OpenClaw gọi tới base URL của 9Router, dùng token phù hợp và chọn đúng model alias đã có trong router.
Nếu OpenClaw có giao diện cấu hình model trong dashboard, bạn có thể nhập các thông tin này trực tiếp thay vì chỉnh file JSON bằng tay.
Bước 5: Chạy thử trong OpenClaw
Sau khi lưu cấu hình, hãy khởi động lại OpenClaw hoặc reload phần model provider nếu công cụ hỗ trợ reload. Sau đó gửi một câu hỏi ngắn để kiểm tra.
Ví dụ:
Hãy trả lời bằng tiếng Việt: OpenClaw đang kết nối qua 9Router có lợi ích gì?
Nếu phản hồi trả về bình thường, bạn đã kết nối thành công ở mức cơ bản. Tiếp theo, hãy thử một tác vụ dài hơn, ví dụ tóm tắt một đoạn văn hoặc yêu cầu phân tích một file nhỏ, để kiểm tra độ ổn định.
Trong giai đoạn test, không nên bật ngay các workflow tự động, cron job hoặc channel public. Hãy kiểm tra từng lớp: model trả lời ổn, OpenClaw nhận phản hồi đúng, chi phí không tăng bất thường, rồi mới đưa vào tác vụ thực tế.
Cấu hình model mặc định và fallback sao cho hợp lý
Một sai lầm phổ biến là chọn model mạnh nhất làm mặc định cho mọi tác vụ. Cách này đơn giản nhưng dễ tốn chi phí. Với OpenClaw, bạn nên phân vai model theo loại việc.
Model rẻ hoặc miễn phí có thể xử lý chat thường ngày, tóm tắt ngắn, nhắc việc hoặc phân loại thông tin đơn giản. Model mạnh hơn nên dành cho phân tích dài, viết nội dung quan trọng, debug code, xử lý tài liệu phức tạp hoặc tác vụ có rủi ro cao.
Nếu 9Router hỗ trợ alias hoặc routing, bạn có thể tạo các alias dễ nhớ như:
- `daily` cho tác vụ nhẹ.
- `smart` cho phân tích sâu.
- `coding` cho code.
- `writing` cho nội dung.
- `fallback` cho model dự phòng.
Sau đó trong OpenClaw, bạn dùng alias thay vì tên model dài. Cách này giúp cấu hình dễ đọc và dễ thay đổi hơn.
Bảo mật khi dùng 9Router với OpenClaw
Vì 9Router là gateway đứng giữa OpenClaw và provider AI, bạn cần xem nó như một thành phần hạ tầng quan trọng, không phải tiện ích phụ.
Nếu chỉ dùng trên máy cá nhân, hãy để endpoint chạy local qua 127.0.0.1. Không mở port ra internet nếu chưa có lý do rõ ràng. Nếu cần truy cập từ xa, nên dùng VPN riêng như Tailscale hoặc reverse proxy có HTTPS, authentication và IP allowlist.
Không lưu API key trong file public. Không chụp ảnh màn hình có token. Không copy nguyên cấu hình có key thật vào nhóm chat. Nếu làm việc trong team, hãy phân quyền rõ ai được xem, ai được sửa và ai được rotate key.
Với OpenClaw, cũng cần kiểm soát quyền của agent. Nếu agent có thể đọc file, gọi tool, gửi tin nhắn hoặc chạy automation, việc chọn sai model/provider hoặc lộ gateway có thể tạo rủi ro lớn hơn một chatbot thông thường.
Lỗi thường gặp khi kết nối 9Router với OpenClaw
Lỗi đầu tiên là OpenClaw báo không gọi được model. Khi đó hãy kiểm tra 9Router có đang chạy không, endpoint có đúng port không và request test bằng curl có phản hồi không.
Lỗi thứ hai là sai model name. Nhiều công cụ yêu cầu dùng đúng ID hoặc alias nội bộ. Nếu bạn nhập tên hiển thị thay vì model ID, request có thể lỗi dù provider đã kết nối.
Lỗi thứ ba là token không hợp lệ. Có nơi dùng API key thật của provider, có nơi dùng token do router tạo ra. Hãy kiểm tra 9Router yêu cầu kiểu nào cho endpoint local của bạn.
Lỗi thứ tư là OpenClaw chạy trong container còn 9Router chạy trên máy host. Khi đó 127.0.0.1 bên trong container không phải máy host. Bạn có thể cần dùng host networking, host.docker.internal hoặc IP nội bộ phù hợp.
Lỗi thứ năm là timeout hoặc phản hồi chậm. Hãy thử model nhẹ hơn, kiểm tra provider đang lỗi hay không, giảm độ dài prompt hoặc bật fallback nếu 9Router hỗ trợ.
Khi nào nên dùng 9Router, khi nào chưa cần?
Bạn nên dùng 9Router với OpenClaw nếu có nhu cầu dùng nhiều provider, muốn fallback, muốn quản lý quota tập trung hoặc thường xuyên thử model mới. Đây cũng là lựa chọn hợp lý nếu bạn vận hành OpenClaw cho nhiều loại tác vụ: chat, content, code, automation, phân tích tài liệu và kênh nhắn tin.
Ngược lại, nếu bạn chỉ dùng một model duy nhất, một API key duy nhất và chưa cần fallback, kết nối trực tiếp OpenClaw với provider có thể đơn giản hơn. Thêm 9Router khi chưa có nhu cầu rõ ràng sẽ tạo thêm một lớp cần debug.
Cách thực tế là bắt đầu đơn giản. Chạy OpenClaw với một provider ổn định trước. Khi nhu cầu tăng lên, thêm 9Router để quản lý nhiều model và tối ưu chi phí.
Checklist cài và kết nối nhanh
Trước khi dùng OpenClaw qua 9Router trong công việc thật, hãy kiểm tra các điểm sau:
- 9Router đã cài và chạy được trên máy hoặc server.
- Endpoint local `http://127.0.0.1:20128/v1` phản hồi request test.
- Ít nhất một provider/model đã được kết nối trong 9Router.
- OpenClaw đã trỏ đúng base URL, API key/token và model name.
- Request ngắn trong OpenClaw trả lời bình thường.
- Đã test một tác vụ dài hơn để kiểm tra timeout.
- Không có API key thật trong file public hoặc ảnh chụp màn hình.
- Chưa mở gateway ra internet khi chưa có HTTPS, auth và allowlist.
- Đã có model fallback nếu dùng cho tác vụ quan trọng.
- Đã theo dõi usage/chi phí trong vài ngày đầu.
Kết luận
Kết nối 9Router với OpenClaw là cách hợp lý khi bạn muốn biến OpenClaw thành một AI agent linh hoạt hơn, có thể dùng nhiều model qua một endpoint chung. OpenClaw chịu trách nhiệm phần agent, workflow và kênh làm việc; 9Router chịu trách nhiệm điều phối provider, model, fallback và endpoint OpenAI-compatible.
Điểm mấu chốt là không nên cấu hình theo kiểu “càng nhiều càng tốt”. Hãy bắt đầu với một model mặc định, kiểm tra endpoint local, sau đó mới thêm fallback, alias và routing nâng cao. Khi làm đúng, 9Router giúp OpenClaw dễ vận hành hơn, giảm phụ thuộc vào một provider và giúp người dùng Việt kiểm soát chi phí tốt hơn.
