Providers

Moonshot AI

Moonshot cung cấp Kimi API với các endpoint tương thích với OpenAI. Cấu hình nhà cung cấp và đặt mô hình mặc định thành moonshot/kimi-k2.6, hoặc dùng Kimi Coding với kimi/kimi-code.

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, hình ảnh 262,144 262,144
moonshot/kimi-k2.5 Kimi K2.5 Không văn bản, hình ả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ác ước tính chi phí đi kèm cho các mô hình K2 hiện tại được Moonshot lưu trữ sử dụng mức giá trả theo mức dùng do Moonshot công bố: Kimi K2.6 là $0.16/MTok khi trúng bộ nhớ đệm, $0.95/MTok đầu vào và $4.00/MTok đầu ra; Kimi K2.5 là $0.10/MTok khi trúng bộ nhớ đệm, $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.

Bắt đầu

Chọn nhà cung cấp của bạn và làm theo các bước thiết lập.

Moonshot API

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

  • Choose your endpoint region

    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
  • Run onboarding

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

    Hoặc cho endpoint Trung Quốc:

    openclaw onboard --auth-choice moonshot-api-key-cn
    
  • Set a default model

    {
      agents: {
        defaults: {
          model: { primary: "moonshot/kimi-k2.6" },
        },
      },
    }
    
  • Verify models are available

    openclaw models list --provider moonshot
    
  • Run a live smoke test

    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 mô hình 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"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 dưới usage.cost khi Moonshot trả về siêu dữ liệu 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.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.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ã thông qua endpoint Kimi Coding.

  • Run onboarding

    openclaw onboard --auth-choice kimi-code-api-key
    
  • Set a default model

    {
      agents: {
        defaults: {
          model: { primary: "kimi/kimi-code" },
        },
      },
    }
    
  • Verify the model is available

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

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

    Tìm kiếm web Kimi

    OpenClaw cũng cung cấp Kimi dưới dạng nhà cung cấp web_search, được hỗ trợ bởi tìm kiếm web của Moonshot.

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

    openclaw configure --section web
    

    Chọn Kimi trong mục 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ẽ nhắc nhập:

    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:

    {
      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

    Moonshot Kimi hỗ trợ suy luận nguyên bản nhị phân:

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

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

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

    OpenClaw cũng ánh xạ các mức /think trong thời gian chạy cho Moonshot:

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

    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ộ phần suy luận qua các lượt; bỏ qua trường này (hoặc để là 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.

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

    Moonshot Kimi cung cấp các id tool_call có dạng functions.<name>:<index>. OpenClaw giữ nguyên chúng không thay đổi để các lệnh gọi công cụ nhiều lượt tiếp tục hoạt động.

    Để buộc làm sạch nghiêm ngặt trên một nhà cung cấp tùy chỉnh tương thích với OpenAI, hãy đặt sanitizeToolCallIds: true:

    {
      models: {
        providers: {
          "my-kimi-proxy": {
            api: "openai-completions",
            sanitizeToolCallIds: true,
          },
        },
      },
    }
    
    Tương thích mức sử dụng khi phát trực tuyến

    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 phát trực tuyến trên phương thức truyền tải openai-completions dùng chung. OpenClaw xác định điều đó dựa trên năng lực của điểm cuối, vì vậy các id nhà cung cấp tùy chỉnh tương thích trỏ tới cùng các máy chủ Moonshot gốc sẽ kế thừa cùng hành vi mức sử dụng khi phát trực tuyến.

    Với giá K2.6 đi kèm, mức sử dụng được phát trực tuyến bao gồm token đầu vào, đầu ra và đọc từ 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à phần hạch toán phiên dựa trên bản ghi hội thoại.

    Tham chiếu endpoint và model ref
    Nhà cung cấp Tiền tố model ref Endpoint 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/ endpoint Kimi Coding KIMI_API_KEY
    Tìm kiếm web N/A Giống vùng Moonshot API KIMI_API_KEY hoặc MOONSHOT_API_KEY
    • Tìm kiếm web Kimi dùng KIMI_API_KEY hoặc MOONSHOT_API_KEY, và mặc định là https://api.moonshot.ai/v1 với model kimi-k2.6.
    • Ghi đè siêu dữ liệu về giá và 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 model, hãy điều chỉnh contextWindow tương ứng.

    Liên quan