Kilo Gateway

Kilo Gateway định tuyến các yêu cầu đến nhiều mô hình thông qua một endpoint tương thích với OpenAI và một khóa API duy nhất.

Thuộc tính	Giá trị
Nhà cung cấp	kilocode
Xác thực	KILOCODE_API_KEY
API	Tương thích với OpenAI
URL cơ sở	https://api.kilo.ai/api/gateway/

​

Cài đặt plugin

openclaw plugins install @openclaw/kilocode-provider
openclaw gateway restart

​

Thiết lập

1. Tạo tài khoản

   Truy cập app.kilo.ai, đăng nhập hoặc tạo tài khoản, sau đó tạo khóa API.

2. Chạy quy trình thiết lập ban đầu

   openclaw onboard --auth-choice kilocode-api-key
   

   Hoặc đặt trực tiếp biến môi trường:

   export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret
   
3. Xác minh mô hình khả dụng

   openclaw models list --provider kilocode
   

​

Mô hình mặc định và danh mục

Mô hình mặc định là kilocode/kilo-auto/balanced, tầng định tuyến thông minh cân bằng của Kilo Gateway. OpenClaw không công bố ánh xạ từ tác vụ đến mô hình thượng nguồn cho tầng này; việc định tuyến phía sau kilo-auto/balanced do Kilo Gateway quản lý.

Khi khởi động, OpenClaw truy vấn GET https://api.kilo.ai/api/gateway/models và hợp nhất các mô hình được phát hiện trước danh mục dự phòng tĩnh. Danh mục dự phòng tĩnh chỉ chứa kilocode/kilo-auto/balanced (Auto Balanced, input: ["text", "image"], reasoning: true, contextWindow: 1000000, maxTokens: 65536).

Có thể truy cập mọi mô hình trên gateway dưới dạng kilocode/<upstream-id> (ví dụ: kilocode/anthropic/claude-sonnet-4, kilocode/openai/gpt-5.5). Chạy /models kilocode hoặc openclaw models list --provider kilocode để xem toàn bộ danh sách được phát hiện.

​

Ví dụ cấu hình

{
  env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
  agents: {
    defaults: {
      model: { primary: "kilocode/kilo-auto/balanced" },
    },
  },
}

​

Ghi chú về hành vi

Phương thức truyền tải và khả năng tương thích

Kilo Gateway tương thích với OpenRouter, vì vậy nó sử dụng đường dẫn yêu cầu tương thích với OpenAI theo kiểu proxy thay vì định hình yêu cầu OpenAI gốc (không có store, không có payload mức độ suy luận của OpenAI).

• Các tham chiếu Kilo dựa trên Gemini vẫn sử dụng đường dẫn proxy-Gemini: OpenClaw làm sạch các chữ ký suy nghĩ của Gemini tại đó nhưng không bật tính năng xác thực phát lại Gemini gốc hoặc viết lại khởi tạo.
• Các yêu cầu sử dụng token Bearer được tạo từ khóa API của bạn.

Trình bao luồng và suy luận

Trình bao luồng Kilo thêm header yêu cầu X-KILOCODE-FEATURE (mặc định là openclaw, ghi đè bằng biến môi trường KILOCODE_FEATURE) và chuẩn hóa các payload mức độ suy luận cho các mô hình hỗ trợ tính năng này.

Các tham chiếu kilocode/kilo-auto/balanced và x-ai/* bỏ qua việc chèn mức độ suy luận. Hãy sử dụng một tham chiếu mô hình cụ thể như kilocode/anthropic/claude-sonnet-4 nếu bạn cần hỗ trợ suy luận.

Khắc phục sự cố

• Nếu việc phát hiện mô hình thất bại khi khởi động, OpenClaw sẽ chuyển sang danh mục tĩnh chứa kilocode/kilo-auto/balanced.
• Xác nhận khóa API của bạn hợp lệ và tài khoản Kilo đã bật các mô hình mong muốn.
• Khi Gateway chạy dưới dạng daemon, hãy đảm bảo tiến trình đó có thể truy cập KILOCODE_API_KEY (ví dụ trong ~/.openclaw/.env hoặc thông qua env.shellEnv).

​

Nội dung liên quan

Lựa chọn mô hình

Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.

Tham chiếu cấu hình

Tham chiếu cấu hình OpenClaw đầy đủ.

Kilo Gateway

Bảng điều khiển Kilo Gateway, khóa API và quản lý tài khoản.