Providers

Moonshot AI

Moonshot cung cấp API Kimi với các endpoint tương thích OpenAI. Đặt mô hình mặc định thành moonshot/kimi-k2.6 cho Moonshot Open Platform hoặc kimi/kimi-for-coding cho Kimi Coding.

Danh mục mô hình tích hợp sẵn

Tham chiếu mô hình Tên Suy luận Đầu vào Ngữ cảnh Đầu ra tối đa
moonshot/kimi-k2.6 Kimi K2.6 Không văn bản, ảnh 262,144 262,144
moonshot/kimi-k2.7-code Kimi K2.7 Code Luôn bật văn bản, ảnh 262,144 262,144
moonshot/kimi-k2.5 Kimi K2.5 Không văn bản, ảnh 262,144 262,144
moonshot/kimi-k2-thinking Kimi K2 Thinking văn bản 262,144 262,144
moonshot/kimi-k2-thinking-turbo Kimi K2 Thinking Turbo văn bản 262,144 262,144
moonshot/kimi-k2-turbo Kimi K2 Turbo Không văn bản 256,000 16,384

Ước tính chi phí trong danh mục sử dụng mức giá trả theo mức sử dụng do Moonshot công bố: Kimi K2.7 Code có giá $0.19/MTok khi trúng bộ nhớ đệm, $0.95/MTok đầu vào, $4.00/MTok đầu ra; Kimi K2.6 có giá $0.16/MTok khi trúng bộ nhớ đệm, $0.95/MTok đầu vào, $4.00/MTok đầu ra; Kimi K2.5 có giá $0.10/MTok khi trúng bộ nhớ đệm, $0.60/MTok đầu vào, $3.00/MTok đầu ra. Các mục khác trong danh mục giữ giá trị giữ chỗ bằng không, trừ khi bạn ghi đè chúng trong cấu hình.

Kimi K2.7 Code luôn sử dụng chế độ suy luận nguyên bản. OpenClaw chỉ cung cấp trạng thái suy luận on cho mô hình này và loại bỏ các trường thinkingreasoning_effort trong yêu cầu gửi đi, theo yêu cầu của Moonshot. OpenClaw cũng loại bỏ các giá trị ghi đè cho việc lấy mẫu (temperature, top_p, n, presence_penalty, frequency_penalty) vì K2.7 cố định chúng theo giá trị mặc định của nhà cung cấp. Kimi K2.6 vẫn là mô hình mặc định khi thiết lập ban đầu.

Bắt đầu

Cả Moonshot và Kimi Coding đều là các plugin bên ngoài — hãy cài đặt một plugin trước khi thiết lập ban đầu.

Moonshot API

Phù hợp nhất cho: Các mô hình Kimi K2 thông qua Moonshot Open Platform.

  • Cài đặt plugin

    bash
    openclaw plugins install @openclaw/moonshot-provideropenclaw gateway restart
  • Chọn khu vực endpoint

    Lựa chọn xác thực Endpoint Khu vực
    moonshot-api-key https://api.moonshot.ai/v1 Quốc tế
    moonshot-api-key-cn https://api.moonshot.cn/v1 Trung Quốc
  • Chạy thiết lập ban đầu

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

    Hoặc với endpoint Trung Quốc:

    bash
    openclaw onboard --auth-choice moonshot-api-key-cn
  • Đặt mô hình mặc định

    json5
    {  agents: {    defaults: {      model: { primary: "moonshot/kimi-k2.6" },    },  },}
  • Xác minh các mô hình khả dụng

    bash
    openclaw models list --provider moonshot
  • Chạy kiểm thử nhanh trực tiếp

    Sử dụng thư mục trạng thái biệt lập khi bạn muốn xác minh quyền truy cập mô hình và việc theo dõi chi phí mà không ảnh hưởng đến các phiên thông thường:

    bash
    OPENCLAW_CONFIG_PATH=/tmp/openclaw-kimi/openclaw.json \OPENCLAW_STATE_DIR=/tmp/openclaw-kimi \openclaw agent --local \  --session-id live-kimi-cost \  --message 'Reply exactly: KIMI_LIVE_OK' \  --thinking off \  --json

    Phản hồi JSON phải báo cáo provider: "moonshot"model: "kimi-k2.6". Mục bản ghi hội thoại của trợ lý lưu mức sử dụng token đã chuẩn hóa cùng chi phí ước tính trong usage.cost khi Moonshot trả về siêu dữ liệu sử dụng.

  • Ví dụ cấu hình

    json5
    {  env: { MOONSHOT_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "moonshot/kimi-k2.6" },      models: {        // moonshot-kimi-k2-aliases:start        "moonshot/kimi-k2.6": { alias: "Kimi K2.6" },        "moonshot/kimi-k2.7-code": { alias: "Kimi K2.7 Code" },        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },        "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" },        "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" },        "moonshot/kimi-k2-turbo": { alias: "Kimi K2 Turbo" },        // moonshot-kimi-k2-aliases:end      },    },  },  models: {    mode: "merge",    providers: {      moonshot: {        baseUrl: "https://api.moonshot.ai/v1",        apiKey: "${MOONSHOT_API_KEY}",        api: "openai-completions",        models: [          // moonshot-kimi-k2-models:start          {            id: "kimi-k2.6",            name: "Kimi K2.6",            reasoning: false,            input: ["text", "image"],            cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 },            contextWindow: 262144,            maxTokens: 262144,          },          {            id: "kimi-k2.7-code",            name: "Kimi K2.7 Code",            reasoning: true,            input: ["text", "image"],            cost: { input: 0.95, output: 4, cacheRead: 0.19, cacheWrite: 0 },            contextWindow: 262144,            maxTokens: 262144,          },          {            id: "kimi-k2.5",            name: "Kimi K2.5",            reasoning: false,            input: ["text", "image"],            cost: { input: 0.6, output: 3, cacheRead: 0.1, cacheWrite: 0 },            contextWindow: 262144,            maxTokens: 262144,          },          {            id: "kimi-k2-thinking",            name: "Kimi K2 Thinking",            reasoning: true,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 262144,            maxTokens: 262144,          },          {            id: "kimi-k2-thinking-turbo",            name: "Kimi K2 Thinking Turbo",            reasoning: true,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 262144,            maxTokens: 262144,          },          {            id: "kimi-k2-turbo",            name: "Kimi K2 Turbo",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 256000,            maxTokens: 16384,          },          // moonshot-kimi-k2-models:end        ],      },    },  },}

    Kimi Coding

    Phù hợp nhất cho: các tác vụ tập trung vào mã nguồn thông qua endpoint Kimi Coding.

  • Cài đặt plugin

    bash
    openclaw plugins install @openclaw/kimi-provideropenclaw gateway restart
  • Chạy thiết lập ban đầu

    bash
    openclaw onboard --auth-choice kimi-code-api-key
  • Đặt mô hình mặc định

    json5
    {  agents: {    defaults: {      model: { primary: "kimi/kimi-for-coding" },    },  },}
  • Xác minh mô hình khả dụng

    bash
    openclaw models list --provider kimi
  • Ví dụ cấu hình

    json5
    {  env: { KIMI_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "kimi/kimi-for-coding" },      models: {        "kimi/kimi-for-coding": { alias: "Kimi" },      },    },  },}

    Tìm kiếm web bằng Kimi

    Plugin Moonshot cũng đăng ký Kimi làm nhà cung cấp web_search, sử dụng dịch vụ tìm kiếm web của Moonshot.

  • Chạy thiết lập tìm kiếm web tương tác

    bash
    openclaw configure --section web

    Chọn Kimi trong phần tìm kiếm web để lưu plugins.entries.moonshot.config.webSearch.*.

  • Cấu hình khu vực và mô hình tìm kiếm web

    Thiết lập tương tác sẽ yêu cầu:

    Cài đặt Tùy chọn
    Khu vực API https://api.moonshot.ai/v1 (quốc tế) hoặc https://api.moonshot.cn/v1 (Trung Quốc)
    Mô hình tìm kiếm web Mặc định là kimi-k2.6
  • Cấu hình nằm trong plugins.entries.moonshot.config.webSearch:

    json5
    {  plugins: {    entries: {      moonshot: {        config: {          webSearch: {            apiKey: "sk-...", // or use KIMI_API_KEY / MOONSHOT_API_KEY            baseUrl: "https://api.moonshot.ai/v1",            model: "kimi-k2.6",          },        },      },    },  },  tools: {    web: {      search: {        provider: "kimi",      },    },  },}

    Cấu hình nâng cao

    Chế độ suy luận nguyên bản

    Kimi K2.7 Code luôn sử dụng chế độ suy luận nguyên bản. Moonshot yêu cầu ứng dụng khách loại bỏ trường thinking đối với mô hình này, vì vậy OpenClaw chỉ cung cấp on và bỏ qua các cài đặt off đã lỗi thời. K2.7 cũng cố định temperature, top_p, n, presence_penaltyfrequency_penalty; OpenClaw loại bỏ các giá trị ghi đè đã cấu hình cho những trường đó.

    Các mô hình Moonshot Kimi khác hỗ trợ chế độ suy luận nguyên bản nhị phân:

    • thinking: { type: "enabled" }
    • thinking: { type: "disabled" }

    Cấu hình riêng cho từng mô hình qua agents.defaults.models.<provider/model>.params:

    json5
    {  agents: {    defaults: {      models: {        "moonshot/kimi-k2.6": {          params: {            thinking: { type: "disabled" },          },        },      },    },  },}

    OpenClaw ánh xạ các mức /think khi chạy cho những mô hình đó:

    Mức /think Hành vi của Moonshot
    /think off thinking.type=disabled
    Bất kỳ mức nào khác off thinking.type=enabled

    Kimi K2.6 cũng chấp nhận trường thinking.keep tùy chọn để kiểm soát việc duy trì reasoning_content qua nhiều lượt. Đặt thành "all" để giữ lại toàn bộ quá trình suy luận qua các lượt; bỏ qua trường này (hoặc để là null) để sử dụng chiến lược mặc định của máy chủ. OpenClaw chỉ chuyển tiếp thinking.keep cho moonshot/kimi-k2.6 và loại bỏ trường này khỏi các mô hình khác. Kimi K2.7 Code mặc định giữ lại toàn bộ lịch sử suy luận, còn OpenClaw bỏ qua toàn bộ trường thinking.

    json5
    {  agents: {    defaults: {      models: {        "moonshot/kimi-k2.6": {          params: {            thinking: { type: "enabled", keep: "all" },          },        },      },    },  },}
    Làm sạch mã định danh lệnh gọi công cụ

    Moonshot Kimi cung cấp các mã định danh tool_call gốc có dạng functions.<name>:<index>. OpenClaw giữ nguyên lần xuất hiện đầu tiên của mỗi mã định danh Kimi gốc và viết lại các bản trùng lặp sau đó thành mã định danh call_* theo kiểu OpenAI một cách xác định. Các kết quả công cụ tương ứng được ánh xạ lại bằng cùng mã định danh để dữ liệu phát lại vẫn duy nhất mà không loại bỏ mã định danh gốc đầu tiên của Kimi. Hành vi này được tích hợp vào nhà cung cấp Moonshot đi kèm và không phải là cài đặt mà người dùng có thể cấu hình.

    Khả năng tương thích về mức sử dụng khi truyền phát

    Các điểm cuối Moonshot gốc (https://api.moonshot.ai/v1https://api.moonshot.cn/v1) công bố khả năng tương thích về mức sử dụng khi truyền phát. OpenClaw xác định điều này dựa trên máy chủ của điểm cuối, không phải mã định danh nhà cung cấp, vì vậy một mã định danh nhà cung cấp tùy chỉnh trỏ đến cùng máy chủ Moonshot gốc sẽ kế thừa cùng hành vi về mức sử dụng khi truyền phát.

    Với mức giá K2.6 trong danh mục, mức sử dụng được truyền phát bao gồm token đầu vào, đầu ra và đọc bộ nhớ đệm cũng được chuyển đổi thành chi phí USD ước tính cục bộ cho /status, /usage full, /usage cost và việc hạch toán phiên dựa trên bản ghi hội thoại.

    Tham chiếu điểm cuối và tham chiếu mô hình
    Nhà cung cấp Tiền tố tham chiếu mô hình Điểm cuối Biến môi trường xác thực
    Moonshot moonshot/ https://api.moonshot.ai/v1 MOONSHOT_API_KEY
    Moonshot CN moonshot/ https://api.moonshot.cn/v1 MOONSHOT_API_KEY
    Kimi Coding kimi/ Điểm cuối Kimi Coding KIMI_API_KEY
    Tìm kiếm web Không áp dụng Giống khu vực API Moonshot KIMI_API_KEY hoặc MOONSHOT_API_KEY
    • Tìm kiếm web của Kimi sử dụng KIMI_API_KEY hoặc MOONSHOT_API_KEY, và mặc định dùng https://api.moonshot.ai/v1 với mô hình kimi-k2.6.
    • Ghi đè mức giá và siêu dữ liệu ngữ cảnh trong models.providers nếu cần.
    • Nếu Moonshot công bố giới hạn ngữ cảnh khác cho một mô hình, hãy điều chỉnh contextWindow tương ứng.

    Liên quan

    Was this useful?
    On this page

    On this page