QuotaCheap Playbook

OpenClaw Model Providers: chọn model, auth, fallback và gateway cost visibility

Hướng dẫn OpenClaw Model Providers cho production: provider/model refs, auth profiles, API key rotation, fallback policy, runtime split, CLI runtimes, prov…

Model provider không chỉ là API key. Trong OpenClaw, nó là provider/model ref, auth profile, plugin-owned behavior, runtime split, key rotation, fallback policy và usage visibility.

Playbook tiếng Việt về OpenClaw Model Providers: provider/model refs, official provider plugins, auth profiles, API key rotation, model fallback, session override rules, OpenAI provider/runtime split, CLI runtimes, custom provider scenarios và QuotaCheap cost visibility.

Trong app chat bình thường, “model” thường chỉ là dropdown.

Trong OpenClaw production, model provider là cả một lớp vận hành: provider/model ref, auth profile, plugin owned behavior, runtime split, key rotation, fallback chain, session override, cron primary, cooldown probe, usage reporting.

Nói gọn: model không chỉ là não.

Model là tuyến cung cấp năng lượng cho agent.

Nếu tuyến này chập chờn, agent chậm, fail, hoặc tự nhảy sang model khác.

Nếu tuyến này đắt mà không đo, agent vẫn trả lời vui vẻ — hóa đơn thì không vui lắm.

Bài này gom lại cách nghĩ thực dụng về OpenClaw Model Providers: chọn provider, set model, auth, rotation, failover, runtime split, plugin owned provider logic và QuotaCheap cost visibility.

Model provider không phải chat channel OpenClaw docs nhấn mạnh model providers là LLM/model backends, không phải chat channels như Telegram, WhatsApp, Discord, Slack.

Channel đưa message vào OpenClaw.

Model provider tạo assistant response.

Hai lớp này khác nhau: Một bot Telegram có thể dùng OpenAI.

Một Discord agent có thể dùng Anthropic.

Một cron job có thể dùng model khác chat session.

Đừng gắn “channel nào” với “model nào” trong đầu; OpenClaw tách hai thứ này ra.

Model refs dùng provider/model Quick rule từ docs: Ví dụ: Set default model trong config dạng: CLI helpers docs nêu: Production rule: ghi rõ model ref đầy đủ trong docs/runbooks.

“Dùng GPT” hoặc “dùng Claude” không đủ để debug provider issue.

Adding provider auth không tự đổi primary model Docs có một rule rất đáng nhớ: thêm auth provider không tự đổi primary model hiện tại.

openclaw configure preserve agents.defaults.model.primary khi thêm/reauth provider.

openclaw models auth login cũng vậy, trừ khi pass set default.

Muốn đổi default model, dùng: Hoặc: Điểm này tránh tai nạn production: bạn thêm provider mới để test, nhưng agent live không tự nhiên chuyển não giữa đường.

Muốn đổi thì đổi explicit.

Provider plugins sở hữu rất nhiều behavior Docs nói phần lớn provider specific logic nằm trong provider plugins qua registerProvider ...

, còn OpenClaw giữ generic inference loop.

Provider plugins có thể sở hữu: onboarding; model catalogs; auth env var mapping; transport/config normalization; tool schema cleanup; failover classification; OAuth refresh; usage reporting; thinking/reasoning profiles; request/stream wrapping.