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

Documentation Index

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

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

Moonshot cung cấp API Kimi với các điểm cuối tương thích với OpenAI. Cấu hình provider và đặt mô hình mặc định thành moonshot/kimi-k2.6, hoặc sử 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, điểm cuối 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ênLập 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 Thinkingvăn bản262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking Turbovăn bản262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboKhôngvăn bản256,00016,384
Ước tính chi phí đi kèm cho các mô hình K2 hiện tại được lưu trữ trên Moonshot sử dụng mức giá trả theo mức dùng do Moonshot công bố: Kimi K2.6 là 0.16/MTokcholượttruˊngbnhớđệm,0.16/MTok cho lượt 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 cho lượt trúng bộ nhớ đệm, 0.60/MTokđa^ˋuvaˋo,vaˋ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 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 mô hình Kimi K2 qua Moonshot Open Platform.
1

Chọn vùng điểm cuối của bạn

Lựa chọn xác thựcĐiểm cuốiVù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 điểm cuối Trung Quốc:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Đặt mô hình mặc định

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

Xác minh các mô hình có sẵn

openclaw models list --provider moonshot
5

Chạy kiểm thử khói trực tiếp

Sử dụng thư mục trạng thái cô lập 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 với 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

{
  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 phần tìm kiếm web để lưu plugins.entries.moonshot.config.webSearch.*.
2

Cấu hình vùng 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
Vùng 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ợ chế độ suy nghĩ gốc 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 chế độ suy nghĩ 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 thinking.keep tùy chọn, trường này 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 lập 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ỏ nó 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 endpoint Moonshot gốc (https://api.moonshot.ai/v1https://api.moonshot.cn/v1) công bố khả năng tương thích sử dụng khi truyền 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 endpoint, vì vậy các id nhà cung cấp tùy chỉnh tương thích nhắm tới cùng các máy chủ Moonshot gốc sẽ kế thừa cùng hành vi sử dụng khi truyền trực tuyến.Với mức giá K2.6 được tích hợp sẵn, dữ liệu sử dụng được truyền 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à kế toán phiên dựa trên bản ghi hội thoại.
Nhà cung cấpTiền tố tham chiếu mô hìnhĐiểm cuốiBiế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/Điểm cuối 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 sử 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 cho phù hợp.

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.

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, mô hình và Plugin.

Moonshot Open Platform

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