openclaw/translation/vietnamese/docs/concepts/model-failover.vi.md

summary	read_when
Cách Moltbot luân chuyển các hồ sơ xác thực và dự phòng lỗi giữa các mô hình AI	Bạn muốn chẩn đoán lỗi luân chuyển hồ sơ, thời gian chờ hoặc hành vi dự phòng của mô hình

Dự phòng lỗi mô hình (Failover)

Moltbot xử lý các lỗi xảy ra theo hai giai đoạn:

1. Luân chuyển hồ sơ xác thực: Thử các tài khoản/khóa API khác nhau trong cùng một nhà cung cấp.
2. Dự phòng mô hình: Chuyển sang mô hình tiếp theo trong danh sách fallbacks nếu nhà cung cấp hiện tại gặp sự cố hoàn toàn.

Hồ sơ xác thực (Auth Profiles)

Moltbot sử dụng các hồ sơ xác thực cho cả khóa API và token OAuth.

• Các bí mật được lưu tại ~/.clawdbot/agents/<agentId>/agent/auth-profiles.json.
• Các loại định danh: api_key (Khóa API) và oauth (Đăng nhập qua Google/Github/v.v.).

Thứ tự luân chuyển

Khi một nhà cung cấp có nhiều hồ sơ xác thực, Moltbot sẽ chọn theo thứ tự:

1. Theo cấu hình cụ thể: Tham số auth.order.
2. Loại hồ sơ: Luôn ưu tiên OAuth trước Khóa API.
3. Thống kê sử dụng: Hồ sơ nào lâu chưa dùng nhất sẽ được ưu tiên đưa lên đầu.
4. Hồ sơ bị lỗi/vô hiệu hóa sẽ bị đẩy xuống cuối danh sách.

Thời gian chờ (Cooldowns)

Khi một hồ sơ bị lỗi (lỗi xác thực, giới hạn băng thông - rate limit), Moltbot sẽ đưa nó vào trạng thái chờ và chuyển sang hồ sơ tiếp theo. Thời gian chờ sẽ tăng dần theo lũy kế (1 phút, 5 phút, 25 phút, tối đa 1 giờ).

Vô hiệu hóa do thanh toán

Nếu gặp lỗi liên quan đến tài chính (như "hết tiền trong tài khoản" - insufficient credits), Moltbot sẽ coi đây là lỗi nghiêm trọng. Thay vì chỉ chờ một lát, hồ sơ đó sẽ bị vô hiệu hóa trong một khoảng thời gian dài (mặc định bắt đầu từ 5 giờ) trước khi hệ thống thử lại.

---

Tài liệu liên quan: Xác thực OAuth, Quản lý mô hình.