OpenAI
OpenAI cung cấp API cho các nhà phát triển để sử dụng mô hình GPT. Codex hỗ trợ đăng nhập ChatGPT cho truy cập đăng ký hoặc đăng nhập bằng API key cho truy cập dựa trên sử dụng. Codex cloud yêu cầu đăng nhập ChatGPT. OpenAI hỗ trợ rõ ràng việc sử dụng OAuth đăng ký trong các công cụ/quy trình bên ngoài như OpenClaw.
Lựa chọn A: API key của OpenAI (Nền tảng OpenAI)
Phù hợp nhất cho: truy cập API trực tiếp và thanh toán dựa trên sử dụng.
Lấy API key từ dashboard của OpenAI.
Thiết lập CLI
openclaw onboard --auth-choice openai-api-key
# hoặc không tương tác
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
Đoạn cấu hình
{
env: { OPENAI_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
}
gpt-5.4 và gpt-5.4-pro cho việc sử dụng API trực tiếp của OpenAI. OpenClaw chuyển tiếp cả hai qua đường dẫn openai/* Responses. OpenClaw cố ý loại bỏ dòng openai/gpt-5.3-codex-spark cũ, vì các cuộc gọi API trực tiếp của OpenAI từ chối nó trong lưu lượng truy cập thực tế.
OpenClaw không hiển thị openai/gpt-5.3-codex-spark trên đường dẫn API trực tiếp của OpenAI. pi-ai vẫn cung cấp một dòng tích hợp cho mô hình đó, nhưng các yêu cầu API trực tiếp của OpenAI hiện tại từ chối nó. Spark được coi là chỉ dành cho Codex trong OpenClaw.
Lựa chọn B: Đăng ký OpenAI Code (Codex)
Phù hợp nhất cho: sử dụng truy cập đăng ký ChatGPT/Codex thay vì API key.
Codex cloud yêu cầu đăng nhập ChatGPT, trong khi Codex CLI hỗ trợ đăng nhập ChatGPT hoặc API key.
Thiết lập CLI (Codex OAuth)
# Chạy Codex OAuth trong wizard
openclaw onboard --auth-choice openai-codex
# Hoặc chạy OAuth trực tiếp
openclaw models auth login --provider openai-codex
Đoạn cấu hình (đăng ký Codex)
{
agents: { defaults: { model: { primary: "openai-codex/gpt-5.4" } } },
}
gpt-5.4 là mô hình Codex hiện tại. OpenClaw ánh xạ điều đó thành openai-codex/gpt-5.4 cho việc sử dụng OAuth ChatGPT/Codex.
Nếu tài khoản Codex của bạn có quyền truy cập Codex Spark, OpenClaw cũng hỗ trợ:
openai-codex/gpt-5.3-codex-spark
OpenClaw coi Codex Spark là chỉ dành cho Codex. Nó không hiển thị đường dẫn API-key trực tiếp openai/gpt-5.3-codex-spark.
OpenClaw cũng giữ lại openai-codex/gpt-5.3-codex-spark khi pi-ai phát hiện ra nó. Hãy coi nó là phụ thuộc vào quyền và thử nghiệm: Codex Spark tách biệt với GPT-5.4 /fast, và khả dụng phụ thuộc vào tài khoản Codex / ChatGPT đã đăng nhập.
Giao thức mặc định
OpenClaw sử dụng pi-ai cho streaming mô hình. Đối với cả openai/* và openai-codex/*, giao thức mặc định là "auto" (ưu tiên WebSocket, sau đó là SSE).
Bạn có thể thiết lập agents.defaults.models.<provider/model>.params.transport:
"sse": buộc dùng SSE"websocket": buộc dùng WebSocket"auto": thử WebSocket, sau đó chuyển sang SSE nếu cần
Đối với openai/* (API Responses), OpenClaw cũng kích hoạt warm-up WebSocket mặc định (openaiWsWarmup: true) khi sử dụng giao thức WebSocket.
Tài liệu liên quan của OpenAI:
{
agents: {
defaults: {
model: { primary: "openai-codex/gpt-5.4" },
models: {
"openai-codex/gpt-5.4": {
params: {
transport: "auto",
},
},
},
},
},
}
Warm-up WebSocket của OpenAI
Tài liệu OpenAI mô tả warm-up là tùy chọn. OpenClaw kích hoạt nó mặc định cho openai/* để giảm độ trễ lượt đầu tiên khi sử dụng giao thức WebSocket.
Tắt warm-up
{
agents: {
defaults: {
models: {
"openai/gpt-5.4": {
params: {
openaiWsWarmup: false,
},
},
},
},
},
}
Kích hoạt warm-up rõ ràng
{
agents: {
defaults: {
models: {
"openai/gpt-5.4": {
params: {
openaiWsWarmup: true,
},
},
},
},
},
}
Xử lý ưu tiên của OpenAI
API của OpenAI cung cấp xử lý ưu tiên qua service_tier=priority. Trong OpenClaw, thiết lập agents.defaults.models["openai/<model>"].params.serviceTier để truyền trường đó qua các yêu cầu Responses trực tiếp openai/*.
{
agents: {
defaults: {
models: {
"openai/gpt-5.4": {
params: {
serviceTier: "priority",
},
},
},
},
},
}
auto, default, flex, và priority.
Chế độ nhanh của OpenAI
OpenClaw cung cấp một công tắc chế độ nhanh chung cho cả phiên openai/* và openai-codex/*:
- Chat/UI:
/fast status|on|off
- Cấu hình:
agents.defaults.models["<provider>/<model>"].params.fastMode
Khi chế độ nhanh được kích hoạt, OpenClaw áp dụng một hồ sơ OpenAI độ trễ thấp:
reasoning.effort = "low" khi payload chưa chỉ định reasoningtext.verbosity = "low" khi payload chưa chỉ định verbosityservice_tier = "priority" cho các cuộc gọi Responses trực tiếp openai/* tới api.openai.com
Ví dụ:
{
agents: {
defaults: {
models: {
"openai/gpt-5.4": {
params: {
fastMode: true,
},
},
"openai-codex/gpt-5.4": {
params: {
fastMode: true,
},
},
},
},
},
}
Nén phía server của OpenAI Responses
Đối với các mô hình OpenAI Responses trực tiếp (openai/* sử dụng api: "openai-responses" với baseUrl trên api.openai.com), OpenClaw hiện tự động kích hoạt gợi ý nén payload phía server của OpenAI:
- Buộc
store: true (trừ khi mô hình tương thích đặt supportsStore: false)
- Chèn
context_management: [{ type: "compaction", compact_threshold: ... }]
Mặc định, compact_threshold là 70% của contextWindow mô hình (hoặc 80000 khi không có sẵn).
Kích hoạt nén phía server rõ ràng
Sử dụng điều này khi bạn muốn buộc chèn context_management trên các mô hình Responses tương thích (ví dụ Azure OpenAI Responses):
{
agents: {
defaults: {
models: {
"azure-openai-responses/gpt-5.4": {
params: {
responsesServerCompaction: true,
},
},
},
},
},
}
Kích hoạt với ngưỡng tùy chỉnh
{
agents: {
defaults: {
models: {
"openai/gpt-5.4": {
params: {
responsesServerCompaction: true,
responsesCompactThreshold: 120000,
},
},
},
},
},
}
Tắt nén phía server
{
agents: {
defaults: {
models: {
"openai/gpt-5.4": {
params: {
responsesServerCompaction: false,
},
},
},
},
},
}
responsesServerCompaction chỉ kiểm soát việc chèn context_management. Các mô hình OpenAI Responses trực tiếp vẫn buộc store: true trừ khi tương thích đặt supportsStore: false.
Ghi chú
Last modified on March 22, 2026
