Chuyển đến nội dung chính
Moonshot cung cấp Kimi API với các endpoint tương thích OpenAI. Cấu hình provider và đặt model mặc định thành moonshot/kimi-k2.6, hoặc dùng Kimi Coding với kimi/kimi-for-coding.
Moonshot và Kimi Coding là các provider riêng biệt. Khóa không thể dùng thay thế cho nhau, endpoint khác nhau, và model ref cũng khác nhau (moonshot/... so với kimi/...).

​
Danh mục model tích hợp sẵn

Model refTênSuy luậnĐầu vàoNgữ cảnhĐầu ra tối đa
moonshot/kimi-k2.6Kimi K2.6Khôngvăn bản, hình ảnh262,144262,144
moonshot/kimi-k2.7-codeKimi K2.7 CodeLuôn bậtvăn bản, hình ảnh262,144262,144
moonshot/kimi-k2.5Kimi K2.5Khôngvăn bản, hình ảnh262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingCóvăn bản262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboCóvăn bản262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboKhôngvăn bản256,00016,384
Ước tính chi phí trong danh mục cho các model K2 hiện tại do Moonshot lưu trữ dùng mức giá trả theo mức sử dụng mà Moonshot đã công bố: Kimi K2.7 Code là 0.19/MTokkhicachehit,0.19/MTok khi cache hit, 0.95/MTok đầu vào, và 4.00/MTokđa^ˋura;KimiK2.6laˋ4.00/MTok đầu ra; Kimi K2.6 là 0.16/MTok khi cache hit, 0.95/MTokđa^ˋuvaˋo,vaˋ0.95/MTok đầu vào, và 4.00/MTok đầu ra; Kimi K2.5 là 0.10/MTokkhicachehit,0.10/MTok khi cache hit, 0.60/MTok đầu vào, và $3.00/MTok đầu ra. Các mục danh mục cũ khác giữ placeholder chi phí bằng không trừ khi bạn ghi đè chúng trong cấu hình. Kimi K2.7 Code luôn dùng thinking gốc. OpenClaw chỉ hiển thị trạng thái thinking on cho model này và bỏ qua các điều khiển gửi đi thinking và reasoning_effort, theo yêu cầu của Moonshot. OpenClaw cũng bỏ qua các ghi đè sampling mà K2.7 cố định theo mặc định của provider. Kimi K2.6 vẫn là mặc định khi onboarding.

​
Bắt đầu

Chọn provider của bạn và làm theo các bước thiết lập.
Phù hợp nhất cho: các model Kimi K2 qua Moonshot Open Platform.
1

Chọn vùng endpoint của bạn

Lựa chọn xác thựcEndpointVùng
moonshot-api-keyhttps://api.moonshot.ai/v1Quốc tế
moonshot-api-key-cnhttps://api.moonshot.cn/v1Trung Quốc
2

Chạy onboarding

openclaw onboard --auth-choice moonshot-api-key
Hoặc cho endpoint Trung Quốc:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Đặt model mặc định

{
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
    },
  },
}
4

Xác minh model có sẵn

openclaw models list --provider moonshot
5

Chạy smoke test trực tiếp

Dùng thư mục trạng thái tách biệt khi bạn muốn xác minh quyền truy cập model và theo dõi chi phí mà không chạm vào các phiên thông thường của bạn:
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 nên báo cáo provider: "moonshot" và model: "kimi-k2.6". Mục transcript 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ề metadata sử dụng.

​
Ví dụ cấu hình

{
  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
        ],
      },
    },
  },
}

​
Tìm kiếm web Kimi

Plugin Moonshot cũng đăng ký Kimi làm provider web_search, dựa trên tìm kiếm web Moonshot.
1

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

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

Cấu hình vùng và model tìm kiếm web

Thiết lập tương tác sẽ nhắc nhập:
Thiết lậpTùy chọn
Vùng APIhttps://api.moonshot.ai/v1 (quốc tế) hoặc https://api.moonshot.cn/v1 (Trung Quốc)
Model tìm kiếm webMặc định là kimi-k2.6
Cấu hình nằm trong plugins.entries.moonshot.config.webSearch: 
{
  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

Kimi K2.7 Code luôn dùng thinking gốc. Moonshot yêu cầu client bỏ qua trường thinking cho model này, vì vậy OpenClaw chỉ hiển thị on và bỏ qua các thiết lập off cũ. K2.7 cũng cố định temperature, top_p, n, presence_penalty, và frequency_penalty; OpenClaw bỏ qua các ghi đè đã cấu hình cho những trường đó.Các model Moonshot Kimi khác hỗ trợ thinking gốc dạng nhị phân:
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
Cấu hình theo từng model qua agents.defaults.models.<provider/model>.params:
{
  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 model đó:
Mức /thinkHành vi của Moonshot
/think offthinking.type=disabled
Bất kỳ mức không-offthinking.type=enabled
Khi thinking của Moonshot được bật, tool_choice phải là auto hoặc none. OpenClaw chuẩn hóa các giá trị không tương thích thành auto. Điều này bao gồm Kimi K2.7 Code, model có chế độ thinking không thể tắt để giữ nguyên một lựa chọn công cụ đã ghim.
Kimi K2.6 cũng chấp nhận trường tùy chọn thinking.keep để kiểm soát việc giữ lại reasoning_content qua nhiều lượt. Đặt thành "all" để giữ toàn bộ reasoning qua các lượt; bỏ qua trường này (hoặc để null) để 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ữ toàn bộ lịch sử reasoning, trong khi OpenClaw bỏ qua toàn bộ trường thinking.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
Moonshot Kimi cung cấp các id tool_call gốc có dạng functions.<name>:<index>. Đối với transport OpenAI-completions, OpenClaw giữ nguyên lần xuất hiện đầu tiên của mỗi id Kimi gốc và viết lại các bản trùng lặp sau đó thành id call_* kiểu OpenAI có tính xác định. Các kết quả công cụ tương ứng được ánh xạ lại với cùng id đó để việc phát lại vẫn duy nhất mà không loại bỏ id gốc đầu tiên của Kimi.Để buộc chuẩn hóa nghiêm ngặt trên một nhà cung cấp tùy chỉnh tương thích OpenAI, hãy đặt sanitizeToolCallIds: true:
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
Các endpoint Moonshot gốc (https://api.moonshot.ai/v1 và https://api.moonshot.cn/v1) công bố khả năng tương thích mức sử dụng khi streaming trên transport openai-completions dùng chung. OpenClaw xác định điều đó dựa trên khả năng của endpoint, nên các id nhà cung cấp tùy chỉnh tương thích nhắm đến cùng các máy chủ Moonshot gốc sẽ kế thừa cùng hành vi streaming-usage.Với giá K2.6 trong catalog, mức sử dụng được stream bao gồm token đầu vào, đầu ra và đọc từ cache cũng được chuyển đổi thành chi phí USD ước tính cục bộ cho /status, /usage full, /usage cost, và hạch toán phiên dựa trên bản ghi hội thoại.
Nhà cung cấpTiền tố model refEndpointBiến môi trường xác thực
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/endpoint Kimi CodingKIMI_API_KEY
Tìm kiếm webN/AGiống vùng Moonshot APIKIMI_API_KEY hoặc MOONSHOT_API_KEY
  • Tìm kiếm web của Kimi dùng KIMI_API_KEY hoặc MOONSHOT_API_KEY, và mặc định là https://api.moonshot.ai/v1 với mô hình kimi-k2.6.
  • Ghi đè 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

Lựa chọn mô hình

Chọn nhà cung cấp, model ref và hành vi chuyển đổi dự phòng.

Tìm kiếm web

Cấu hình nhà cung cấp tìm kiếm web, bao gồm Kimi.

Tham chiếu cấu hình

Schema cấu hình đầy đủ cho nhà cung cấp, mô hình và Plugin.

Moonshot Open Platform

Quản lý khóa Moonshot API và tài liệu.