OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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

bash
openclaw plugins install @openclaw/kilocode-provideropenclaw gateway restart

Thiết lập

  • 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.

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

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

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

    bash
    export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret

  • Xác minh mô hình khả dụng

    bash
    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

    json5
    {  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.

    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.
    Was this useful?
    On this page

    On this page