Chuyển đến nội dung chính
Vercel AI Gateway cung cấp một API hợp nhất để truy cập hàng trăm mô hình thông qua một endpoint duy nhất.
Thuộc tínhGiá trị
Nhà cung cấpvercel-ai-gateway
Gói@openclaw/vercel-ai-gateway-provider
Xác thựcAI_GATEWAY_API_KEY
APItương thích với Anthropic Messages
Danh mục mô hìnhTự động phát hiện qua /v1/models
OpenClaw tự động phát hiện danh mục Gateway /v1/models, vì vậy /models vercel-ai-gateway bao gồm các tham chiếu mô hình hiện tại như vercel-ai-gateway/openai/gpt-5.5vercel-ai-gateway/moonshotai/kimi-k2.6.

Bắt đầu

1

Cài đặt plugin

openclaw plugins install @openclaw/vercel-ai-gateway-provider
2

Đặt khóa API

Chạy quá trình onboarding và chọn tùy chọn xác thực AI Gateway:
openclaw onboard --auth-choice ai-gateway-api-key
3

Đặt mô hình mặc định

Thêm mô hình vào cấu hình OpenClaw của bạn:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
4

Xác minh mô hình có sẵn

openclaw models list --provider vercel-ai-gateway

Ví dụ không tương tác

Đối với thiết lập bằng script hoặc CI, hãy truyền tất cả giá trị trên dòng lệnh:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

Cách viết tắt ID mô hình

OpenClaw chấp nhận các tham chiếu mô hình viết tắt Vercel Claude và chuẩn hóa chúng trong runtime:
Đầu vào viết tắtTham chiếu mô hình đã chuẩn hóa
vercel-ai-gateway/claude-opus-4.6vercel-ai-gateway/anthropic/claude-opus-4.6
vercel-ai-gateway/opus-4.6vercel-ai-gateway/anthropic/claude-opus-4-6
Bạn có thể dùng tham chiếu mô hình dạng viết tắt hoặc dạng đầy đủ trong cấu hình của mình. OpenClaw tự động phân giải về dạng chính tắc.

Cấu hình nâng cao

Nếu OpenClaw Gateway chạy dưới dạng daemon (launchd/systemd), hãy đảm bảo AI_GATEWAY_API_KEY có sẵn cho tiến trình đó.
Khóa chỉ được export trong shell tương tác sẽ không hiển thị với daemon launchd/systemd trừ khi môi trường đó được nhập một cách rõ ràng. Đặt khóa trong ~/.openclaw/.env hoặc qua env.shellEnv để đảm bảo tiến trình gateway có thể đọc được.
Vercel AI Gateway định tuyến yêu cầu đến nhà cung cấp upstream dựa trên tiền tố tham chiếu mô hình. Ví dụ, vercel-ai-gateway/anthropic/claude-opus-4.6 định tuyến qua Anthropic, trong khi vercel-ai-gateway/openai/gpt-5.5 định tuyến qua OpenAI và vercel-ai-gateway/moonshotai/kimi-k2.6 định tuyến qua MoonshotAI. Một AI_GATEWAY_API_KEY duy nhất của bạn xử lý xác thực cho tất cả nhà cung cấp upstream.
Các tùy chọn /think tuân theo tiền tố mô hình upstream đáng tin cậy khi OpenClaw biết hợp đồng của nhà cung cấp upstream. vercel-ai-gateway/anthropic/... dùng hồ sơ thinking của Claude, bao gồm các mặc định thích ứng cho mô hình Claude 4.6. vercel-ai-gateway/openai/gpt-5.4, gpt-5.5 và các tham chiếu kiểu Codex cung cấp /think xhigh giống như các nhà cung cấp OpenAI/OpenAI Codex trực tiếp. Các tham chiếu có namespace khác giữ các mức reasoning thông thường trừ khi metadata danh mục của chúng khai báo thêm.

Liên quan

Chọn mô hình

Chọn nhà cung cấp, tham chiếu mô hình và hành vi failover.

Khắc phục sự cố

Khắc phục sự cố chung và FAQ.