> ## Documentation Index
> Fetch the complete documentation index at: https://openclawhub.vn/llms.txt
> Use this file to discover all available pages before exploring further.

# Hướng Dẫn Ngữ Nghĩa Chứng Thực Credential

# Ngữ Nghĩa Chứng Thực Credential

Tài liệu này định nghĩa ngữ nghĩa chuẩn về điều kiện và cách giải quyết credential được sử dụng trong:

* `resolveAuthProfileOrder`
* `resolveApiKeyForProfile`
* `models status --probe`
* `doctor-auth`

Mục tiêu là giữ cho hành vi khi chọn và khi chạy đồng nhất.

## Mã Lý Do Ổn Định

* `ok`
* `missing_credential`
* `invalid_expires`
* `expired`
* `unresolved_ref`

## Credential Token

Credential token (`type: "token"`) hỗ trợ `token` và/hoặc `tokenRef` trực tiếp.

### Quy tắc điều kiện

1. Hồ sơ token không đủ điều kiện khi cả `token` và `tokenRef` đều không có.
2. `expires` là tùy chọn.
3. Nếu có `expires`, nó phải là một số hữu hạn lớn hơn `0`.
4. Nếu `expires` không hợp lệ (`NaN`, `0`, âm, không hữu hạn, hoặc sai kiểu), hồ sơ không đủ điều kiện với `invalid_expires`.
5. Nếu `expires` đã qua, hồ sơ không đủ điều kiện với `expired`.
6. `tokenRef` không bỏ qua việc kiểm tra `expires`.

### Quy tắc giải quyết

1. Ngữ nghĩa của bộ giải quyết khớp với ngữ nghĩa điều kiện cho `expires`.
2. Đối với các hồ sơ đủ điều kiện, token có thể được giải quyết từ giá trị trực tiếp hoặc `tokenRef`.
3. Các tham chiếu không thể giải quyết sẽ tạo ra `unresolved_ref` trong kết quả `models status --probe`.

## Thông Điệp Tương Thích Với Legacy

Để tương thích với script, các lỗi probe giữ nguyên dòng đầu tiên này:

`Auth profile credentials are missing or expired.`

Chi tiết thân thiện với người dùng và mã lý do ổn định có thể được thêm vào các dòng tiếp theo.
