Việc một model mới xuất hiện trong tài liệu nhưng chưa hiện trong openclaw models list là tình huống khá dễ gặp, nhất là với route OAuth/Codex. Trường hợp GPT-5.5 qua OpenClaw Codex OAuth đang tạo ra đúng một câu hỏi thực tế: làm sao biết lỗi nằm ở máy mình, tài khoản, hay phía provider chưa mở quyền?
Dưới đây là cách mình thường kiểm tra để anh em không mất cả buổi xoá container, đăng nhập lại, rồi vẫn nhận model not allowed.
Đừng coi tài liệu là bằng chứng model đã được cấp quyền
Có ba lớp khác nhau cần tách riêng:
- Tài liệu hoặc changelog nói route có hỗ trợ model.
- OpenClaw client/container của mình đã biết tên model đó.
- Tài khoản OAuth/API phía provider thật sự được phép gọi model đó.
Chỉ cần một lớp chưa khớp là model sẽ không chạy. Vì vậy nếu openclaw models list --provider openai-codex vẫn chỉ hiện GPT-5.4, hoặc gọi GPT-5.5 trả về model not allowed, khả năng cao chưa phải lỗi prompt hay lỗi session.
Checklist kiểm tra nhanh
Anh em có thể đi theo thứ tự này trước khi đụng tới cấu hình sâu hơn.
1. Xác nhận phiên bản và danh sách model hiện tại
Chạy lại các lệnh cơ bản và lưu output:
openclaw --version
openclaw models list --provider openai-codex
Nếu model không xuất hiện trong danh sách provider thì đừng vội ép tạo session bằng tên model đó. OpenClaw có thể chưa nhận metadata mới, hoặc route đó chưa publish model cho tài khoản của mình.
2. Re-auth chỉ là một bước, không phải phép màu
Đăng nhập lại OAuth có ích khi token cũ thiếu scope hoặc đã stale. Nhưng nếu sau khi re-auth và restart mà danh sách model không đổi, lặp lại bước này nhiều lần thường không thêm giá trị.
Một lần re-auth sạch là đủ để loại trừ nhóm lỗi token phổ biến.
3. Phân biệt “không thấy model” và “model not allowed”
Hai tín hiệu này hơi khác nhau:
- Không thấy trong
models list: registry hoặc provider listing chưa trả model đó về cho client. - Thấy tên trong tài liệu nhưng gọi bị
model not allowed: tài khoản, gói đăng ký, region, rollout, hoặc backend policy chưa cấp quyền.
Với model mới, rollout theo đợt là chuyện bình thường. Có thể cùng là Pro subscription nhưng quyền qua web app, API, Codex OAuth route không mở cùng lúc.
4. Thử fallback có kiểm soát
Nếu đang cần làm việc thật, nên giữ GPT-5.4 hoặc model ổn định khác làm default, rồi chỉ test GPT-5.5 trong một session riêng. Tránh đổi toàn bộ automation sang model mới khi quyền truy cập còn chưa rõ.
Một cách an toàn là ghi rõ trong config hoặc runbook:
primary: openai-codex/gpt-5.4
experimental: openai-codex/gpt-5.5, chỉ dùng khi models list đã hiện và smoke test qua
Cách báo lỗi hữu ích hơn cho cộng đồng
Nếu anh em muốn hỏi trong forum hoặc issue, nên đính kèm tối thiểu:
- Phiên bản OpenClaw.
- Provider route đang dùng: ví dụ
openai-codex. - Loại tài khoản: Pro, Team, Enterprise, API key hay OAuth.
- Output đã rút gọn của
openclaw models list --provider openai-codex. - Lỗi chính xác khi tạo session hoặc gọi model.
- Thời điểm test và region nếu có liên quan.
Những thông tin này giúp người khác phân biệt lỗi local với rollout phía provider, thay vì chỉ đoán “chưa support” hoặc “cấu hình sai”.
Kết luận thực tế
Với dấu hiệu hiện tại, mình sẽ xử lý như sau: dùng model ổn định đang hiện trong danh sách để chạy việc hằng ngày, theo dõi changelog hoặc phản hồi từ maintainer, và chỉ chuyển GPT-5.5 thành default sau khi chính models list của tài khoản mình đã thấy model đó và một task nhỏ chạy qua được.
Model mới đáng thử, nhưng trong hệ thống agent, quyền truy cập rõ ràng và khả năng rollback nhanh còn quan trọng hơn việc đổi model sớm vài giờ.
Top comments (0)