Đổi provider, model và API key trong OpenClaw đúng cách
Phân biệt nhà cung cấp, model và khóa truy cập; thêm credential, chọn lại model và xác minh cấu hình bằng Control UI hoặc CLI.

Đổi model, đổi provider và thay API key là ba thao tác có liên quan nhưng độc lập. Thêm một khóa mới chỉ cấp quyền truy cập; bạn vẫn cần chọn model muốn dùng. Hướng dẫn dưới đây dùng Control UI và CLI chuẩn của OpenClaw để áp dụng trên các cách cài đặt khác nhau.
Bạn thường cần các thao tác này khi khóa cũ hết hạn, muốn thay đổi chi phí/tốc độ hoặc chuyển sang nhà cung cấp dự phòng. Nếu chưa có khóa, bắt đầu từ các nền tảng cấp API key; với tài khoản ChatGPT, xem kết nối Codex bằng OAuth.
Phân biệt Provider, model và API Key trong OpenClaw

Provider: công ty cung cấp AI
Provider là bên cung cấp endpoint và thông tin xác thực cho model. Đó có thể là hãng phát triển model hoặc nền tảng trung gian tổng hợp nhiều hãng. Các ví dụ quen thuộc gồm:
- Anthropic cung cấp các model Claude.
- OpenAI cung cấp các model thuộc hệ sinh thái OpenAI.
- Google cung cấp Gemini API.
- OpenRouter tổng hợp model từ nhiều nhà cung cấp.
OpenClaw định danh provider bằng mã như openai, anthropic, google, openrouter hoặc ollama. Đừng dùng tên hiển thị của model làm mã provider; kiểm tra danh mục provider nếu chưa rõ.
Model: phiên bản AI cụ thể
Model là lựa chọn cụ thể nằm sau provider. Mỗi model có khả năng, tốc độ, độ dài ngữ cảnh và chi phí riêng; cùng một hãng có thể phục vụ nhiều nhóm công việc.
- Claude có nhiều dòng model với mức cân bằng tốc độ và năng lực khác nhau.
- Quyền dùng model OpenAI phụ thuộc route xác thực và tài khoản/project.
- Gemini API có các model phù hợp những yêu cầu xử lý khác nhau; model khả dụng cần kiểm tra trên tài khoản.
Không cố định tên model theo một ảnh chụp cũ. Dùng openclaw models list hoặc danh sách trong Control UI và chọn một ref mà tài khoản hiện tại có quyền truy cập.
API Key: chìa khoá truy cập
API key là bí mật do provider cấp cho tài khoản hoặc project. OpenClaw gửi thông tin đó khi gọi API, còn provider quyết định quyền, quota và cách tính phí.
Bảo vệ key như mật khẩu: giữ ở auth store hoặc cấu hình bí mật phía máy chủ, tách key theo ứng dụng và thu hồi ngay khi nghi bị lộ. Thiết lập cảnh báo chi tiêu, đồng thời kiểm tra giới hạn nào là giới hạn cứng thực sự của provider.
Thay model trên Control UI
Mở Settings → Models trên Control UI và chọn đúng agent/tài khoản cần cấu hình. Bảng điều khiển của đơn vị hosting có thể bọc thêm giao diện riêng; các khái niệm model và credential vẫn cần được tách rõ.
Tên model trong các ví dụ chỉ minh họa cú pháp. Sau khi cập nhật OpenClaw, hãy đối chiếu catalog hiện tại thay vì dùng lại một tên không còn được provider phục vụ.
Cách đổi model AI
Bước 1: Vào Models, xem model và account đang được chọn. Ghi lại cấu hình hiện tại để có phương án quay lại khi thử model khác.
Bước 2: Trong cùng provider/account, chọn model khác từ catalog mà tài khoản được phép sử dụng.
Bước 3: Dùng Test & use nếu giao diện hỗ trợ để thử một phản hồi rồi áp dụng lựa chọn. Cấu hình agent hoặc mặc định và lựa chọn chỉ cho phiên chat là hai phạm vi khác nhau.
Bước 4: Kiểm tra lại model đang áp dụng và gửi một yêu cầu ngắn. Nếu bị từ chối truy cập, xem model/account chứ không chỉ kiểm tên provider.
Với lựa chọn mặc định của agent, bạn cũng có thể dùng openclaw models set với ref đúng định dạng provider/model. Việc thêm credential không thay thao tác chọn model này.
Bước 5: Kiểm tra trạng thái bằng openclaw models status và /status trong cuộc chat. Nội dung agent tự giới thiệu tên model có thể sai, nên không dùng câu trả lời đó làm bằng chứng duy nhất.
Cách đổi Provider
Khi chuyển hãng hoặc endpoint, cần có credential phù hợp cho provider đích trước khi đổi model:
- Mở kết nối provider trong Settings → Models và thêm tài khoản hoặc API key theo đúng phương thức provider hỗ trợ.
- Chọn một model thuộc provider đó, kiểm tra quyền truy cập rồi thử một request nhỏ trước khi dùng cho workflow quan trọng.
Áp dụng model sau khi kiểm tra. Nếu agent gặp lỗi, đọc status/log để phân biệt thiếu auth, sai model, hết quota hoặc endpoint không hỗ trợ tác vụ.
Cách thêm Provider mới và cập nhật API Key
Bước 1: Tạo khóa mới trên trang chính thức của provider; không dùng khóa người khác chia sẻ công khai.
Bước 2: Mở Settings → Models, chọn đúng account/provider và thao tác đặt hoặc thay API key.
Bước 3: Dán khóa ở ô nhập bí mật, lưu rồi kiểm tra kết nối. CLI cũng có lệnh paste-api-key để nhận giá trị qua prompt bảo vệ, tránh đưa key thẳng vào lịch sử lệnh.
Bước 4: Gửi một request thử bằng credential mới. Khi đã xác minh, thu hồi key cũ trên dashboard provider và cập nhật các nơi vẫn dùng key đó.
Nếu bạn dùng nhiều profile của cùng provider, kiểm tra đang thay đúng profile và đúng agent. Thay một profile không có nghĩa mọi account hoặc mọi ứng dụng đã chuyển sang khóa mới.
Đổi provider, model và API key khi tự cài OpenClaw
CLI cần chạy trên máy sở hữu cài đặt OpenClaw muốn chỉnh. Các lệnh tham khảo bên dưới giúp kiểm catalog, đăng nhập, chọn model và đọc trạng thái. Thay phần ref minh họa bằng giá trị thực trong catalog:
openclaw models list
openclaw models auth login --provider anthropic
openclaw models set PROVIDER/MODEL_ID
openclaw models statusTheo models CLI, models auth list liệt kê profile mà không in bí mật. Control UI quản lý kết nối ở Settings → Models; /model trong chat có thể chọn model theo phạm vi cuộc trò chuyện. Đọc thông báo CLI về Gateway đang chạy trước khi dùng tùy chọn chỉ dành cho thao tác offline.
Muốn dùng hạn mức tài khoản ChatGPT, chọn route OAuth được hỗ trợ thay vì dán API key: xem kết nối Codex/ChatGPT. Nếu muốn một endpoint cho nhiều hãng, đọc nền tảng tổng hợp API model.
Các bài viết liên quan:
Kết luận
Hãy tách quy trình thành thêm quyền truy cập, chọn model rồi xác minh bằng trạng thái và một lượt gọi thật. Cách làm này giúp tránh tình huống đã lưu key nhưng agent vẫn dùng model hoặc account cũ.
Những câu hỏi thường gặp
Thêm API key mới có làm OpenClaw tự chuyển sang provider đó không?
Thông thường không. Lưu credential giúp provider khả dụng, còn model chính vẫn phải được chọn riêng. Một số cờ thiết lập có thể đổi mặc định, vì vậy đọc thông báo trước khi xác nhận.
Model phải nhập theo định dạng nào?
Dùng ref dạng provider/model theo catalog OpenClaw. Tên hiển thị trên dashboard của hãng có thể khác model ID mà API yêu cầu.
Đổi model giữa chừng có mất lịch sử trò chuyện không?
Đổi model trong một phiên thường không xóa lịch sử đã lưu, nhưng model mới có thể có giới hạn ngữ cảnh, công cụ hoặc định dạng khác. Kiểm tra khả năng tương thích trước khi đổi giữa một tác vụ dài.
Làm sao biết OpenClaw đang dùng model nào?
Xem model/account trên Control UI, chạy openclaw models status hoặc dùng /status trong chat. Kết hợp thêm log của request khi cần phân biệt model khai báo với route thực tế.