Перейти до основного вмісту

​
Moonshot AI (Kimi)

Moonshot надає API Kimi із сумісними з OpenAI ендпойнтами. Налаштуйте провайдера та встановіть модель за замовчуванням moonshot/kimi-k2.5, або використовуйте Kimi Coding з kimi/kimi-code.
Moonshot і Kimi Coding — окремі провайдери. Ключі не є взаємозамінними, ендпойнти відрізняються, і посилання на моделі також відрізняються (moonshot/... vs kimi/...).

​
Вбудований каталог моделей

Model refНазваМіркуванняВхідКонтекстМакс. вивід
moonshot/kimi-k2.5Kimi K2.5Ніtext, image262,144262,144
moonshot/kimi-k2-thinkingKimi K2 ThinkingТакtext262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking TurboТакtext262,144262,144
moonshot/kimi-k2-turboKimi K2 TurboНіtext256,00016,384

​
Початок роботи

Оберіть свого провайдера та виконайте кроки налаштування.
Найкраще для: моделей Kimi K2 через Moonshot Open Platform.
1

Оберіть регіон ендпойнта

Вибір автентифікаціїEndpointРегіон
moonshot-api-keyhttps://api.moonshot.ai/v1Міжнародний
moonshot-api-key-cnhttps://api.moonshot.cn/v1Китай
2

Запустіть онбординг

openclaw onboard --auth-choice moonshot-api-key
Або для китайського ендпойнта:
openclaw onboard --auth-choice moonshot-api-key-cn
3

Установіть модель за замовчуванням

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

Перевірте, що моделі доступні

openclaw models list --provider moonshot

​
Приклад конфігурації

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.5" },
      models: {
        // moonshot-kimi-k2-aliases:start
        "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.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, 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

OpenClaw також постачається з Kimi як провайдером web_search, що працює на основі вебпошуку Moonshot.
1

Запустіть інтерактивне налаштування вебпошуку

openclaw configure --section web
Виберіть Kimi в розділі вебпошуку, щоб зберегти plugins.entries.moonshot.config.webSearch.*.
2

Налаштуйте регіон вебпошуку та модель

Інтерактивне налаштування запропонує:
НалаштуванняВаріанти
API regionhttps://api.moonshot.ai/v1 (міжнародний) або https://api.moonshot.cn/v1 (Китай)
Web search modelЗа замовчуванням kimi-k2.5
Конфігурація зберігається в plugins.entries.moonshot.config.webSearch: 
{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // або використовуйте KIMI_API_KEY / MOONSHOT_API_KEY
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.5",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

​
Додатково

Moonshot Kimi підтримує двійковий нативний thinking:
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
Налаштуйте це для кожної моделі через agents.defaults.models.<provider/model>.params:
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.5": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
OpenClaw також зіставляє рівні /think під час виконання для Moonshot:
Рівень /thinkПоведінка Moonshot
/think offthinking.type=disabled
Будь-який рівень, окрім offthinking.type=enabled
Коли thinking у Moonshot увімкнено, tool_choice має бути auto або none. OpenClaw нормалізує несумісні значення tool_choice до auto для сумісності.
Нативні ендпойнти Moonshot (https://api.moonshot.ai/v1 і https://api.moonshot.cn/v1) декларують сумісність streaming usage у спільному транспорті openai-completions. OpenClaw визначає це за можливостями ендпойнта, тому сумісні користувацькі ідентифікатори провайдерів, націлені на ті самі нативні хости Moonshot, успадковують таку саму поведінку streaming usage.
ПровайдерПрефікс посилання на модельEndpointЗмінна середовища для автентифікації
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/Ендпойнт Kimi CodingKIMI_API_KEY
ВебпошукN/AТакий самий, як регіон Moonshot APIKIMI_API_KEY або MOONSHOT_API_KEY
  • Вебпошук Kimi використовує KIMI_API_KEY або MOONSHOT_API_KEY і за замовчуванням працює з https://api.moonshot.ai/v1 та моделлю kimi-k2.5.
  • За потреби перевизначте метадані ціноутворення та контексту в models.providers.
  • Якщо Moonshot публікує інші ліміти контексту для моделі, відповідно скоригуйте contextWindow.

​
Пов’язане

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки failover.

Вебпошук

Налаштування провайдерів вебпошуку, зокрема Kimi.

Довідник із конфігурації

Повна схема конфігурації для провайдерів, моделей і plugins.

Moonshot Open Platform

Керування API-ключами Moonshot і документація.