Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
Moonshot và Kimi Coding là các nhà cung cấp riêng biệt. Khóa không thể dùng thay thế cho nhau, endpoint khác nhau, và tham chiếu mô hình cũng khác nhau (moonshot/... so với kimi/...).

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

Tham chiếu mô hìnhTê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.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á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/MTokkhitruˊngbộnhớđệm,0.16/MTok khi trúng bộ nhớ đệm, 0.95/MTok đầu vào và 4.00/MTokđa^ˋura;KimiK2.5laˋ4.00/MTok đầu ra; Kimi K2.5 là 0.10/MTok khi trúng bộ nhớ đệm, 0.60/MTokđa^ˋuvaˋovaˋ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.
Phù hợp nhất cho: các mô hình Kimi K2 thông qua Moonshot Open Platform.
1

Choose your endpoint region

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

Run onboarding

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

Set a default model

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

Verify models are available

openclaw models list --provider moonshot
5

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" và 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
        ],
      },
    },
  },
}

​
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.
1

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.*.
2

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 đặtTùy chọn
Khu vực APIhttps://api.moonshot.ai/v1 (quốc tế) hoặc https://api.moonshot.cn/v1 (Trung Quốc)
Mô hình 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

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 /thinkHành vi của Moonshot
/think offthinking.type=disabled
Bất kỳ mức nào không phải offthinking.type=enabled
Khi suy luận của Moonshot được bật, tool_choice phải là auto hoặc none. OpenClaw chuẩn hóa các giá trị tool_choice không tương thích thành auto để đảm bảo tương thích.
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" },
          },
        },
      },
    },
  },
}
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,
      },
    },
  },
}
Các điểm cuối Moonshot gốc (https://api.moonshot.ai/v1 và https://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.
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 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

Chọn model

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

Lược đồ cấu hình đầy đủ cho nhà cung cấp, model và Plugin.

Moonshot Open Platform

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