Moonshot AI

Moonshot предоставляет API Kimi с конечными точками, совместимыми с OpenAI. Установите модель по умолчанию на moonshot/kimi-k2.6 для Moonshot Open Platform или kimi/kimi-for-coding для Kimi Coding.

Moonshot и Kimi Coding — разные провайдеры, каждый из которых поставляется как отдельный внешний плагин. Ключи не взаимозаменяемы, конечные точки различаются, как и ссылки на модели (moonshot/... и kimi/...).

Встроенный каталог моделей

Ссылка на модель	Название	Рассуждение	Входные данные	Контекст	Макс. вывод
`moonshot/kimi-k2.6`	Kimi K2.6	Нет	текст, изображение	262,144	262,144
`moonshot/kimi-k2.7-code`	Kimi K2.7 Code	Всегда включено	текст, изображение	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	Нет	текст, изображение	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	Да	текст	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	Да	текст	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	Нет	текст	256,000	16,384

Оценки стоимости в каталоге используют опубликованные Moonshot тарифы с оплатой по мере использования: для Kimi K2.7 Code —

0.19/MTok при попадании в кэш,

0.95/MTok за входные данные и

4.00/MTok за вывод; для Kimi K2.6 —

0.16/MTok при попадании в кэш,

0.95/MTok за входные данные и

4.00/MTok за вывод; для Kimi K2.5 —

0.10/MTok при попадании в кэш,

0.60/MTok за входные данные и $3.00/MTok за вывод. Для остальных записей каталога сохраняются заполнители с нулевой стоимостью, если вы не переопределите их в конфигурации. Kimi K2.7 Code всегда использует встроенный режим рассуждения. OpenClaw предоставляет для этой модели только состояние on и не отправляет поля thinking и reasoning_effort, как требует Moonshot. Также не отправляются переопределения параметров выборки (temperature, top_p, n, presence_penalty, frequency_penalty), поскольку K2.7 фиксирует их на значениях провайдера по умолчанию. Kimi K2.6 остаётся моделью по умолчанию при первоначальной настройке.

Начало работы

Moonshot и Kimi Coding поставляются как внешние плагины — установите нужный плагин перед первоначальной настройкой.

API Moonshot
Kimi Coding

Лучше всего подходит для: моделей Kimi K2 через Moonshot Open Platform.

Установите плагин

openclaw plugins install @openclaw/moonshot-provider
openclaw gateway restart

Выберите регион конечной точки

Вариант аутентификации	Конечная точка	Регион
`moonshot-api-key`	`https://api.moonshot.ai/v1`	Международный
`moonshot-api-key-cn`	`https://api.moonshot.cn/v1`	Китай

Запустите первоначальную настройку

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

Для конечной точки в Китае:

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

Установите модель по умолчанию

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

Проверьте доступность моделей

openclaw models list --provider moonshot

Выполните оперативную дымовую проверку

Используйте изолированный каталог состояния, если хотите проверить доступ к модели и учёт стоимости, не затрагивая обычные сеансы:

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

В ответе JSON должны быть указаны provider: "moonshot" и model: "kimi-k2.6". Если Moonshot возвращает метаданные об использовании, запись расшифровки ответа ассистента сохраняет нормализованное использование токенов и оценочную стоимость в usage.cost.

Пример конфигурации

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

Лучше всего подходит для: задач, связанных с кодом, через конечную точку Kimi Coding.

Kimi Coding использует другой ключ API и префикс провайдера (kimi/...), чем Moonshot (moonshot/...). Стабильная ссылка на модель — kimi/kimi-for-coding; устаревшие ссылки kimi/kimi-code и kimi/k2p5 по-прежнему принимаются и нормализуются в этот идентификатор модели.

Установите плагин

openclaw plugins install @openclaw/kimi-provider
openclaw gateway restart

Запустите первоначальную настройку

openclaw onboard --auth-choice kimi-code-api-key

Установите модель по умолчанию

{
  agents: {
    defaults: {
      model: { primary: "kimi/kimi-for-coding" },
    },
  },
}

Проверьте доступность модели

openclaw models list --provider kimi

Пример конфигурации

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

Веб-поиск Kimi

Плагин Moonshot также регистрирует Kimi как провайдера web_search, работающего на базе веб-поиска Moonshot.

Запустите интерактивную настройку веб-поиска

openclaw configure --section web

Выберите Kimi в разделе веб-поиска, чтобы сохранить plugins.entries.moonshot.config.webSearch.*.

Настройте регион и модель веб-поиска

Интерактивная настройка запрашивает следующие параметры:

Параметр	Варианты
Регион API	`https://api.moonshot.ai/v1` (международный) или `https://api.moonshot.cn/v1` (Китай)
Модель веб-поиска	По умолчанию `kimi-k2.6`

Конфигурация находится в 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",
      },
    },
  },
}

Расширенная конфигурация

Встроенный режим рассуждения

Kimi K2.7 Code всегда использует встроенный режим рассуждения. Moonshot требует, чтобы клиенты не отправляли поле thinking для этой модели, поэтому OpenClaw предоставляет только on и игнорирует устаревшие настройки off. K2.7 также фиксирует temperature, top_p, n, presence_penalty и frequency_penalty; OpenClaw не отправляет настроенные переопределения этих полей.Другие модели Moonshot Kimi поддерживают двоичный встроенный режим рассуждения:

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

Настройте его отдельно для каждой модели через agents.defaults.models.<provider/model>.params:

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

OpenClaw сопоставляет уровни /think среды выполнения для этих моделей:

Уровень `/think`	Поведение Moonshot
`/think off`	`thinking.type=disabled`
Любой уровень, кроме off	`thinking.type=enabled`

Когда режим рассуждения Moonshot включён, tool_choice должен иметь значение auto или none. Закреплённый выбор инструмента (type: "tool" или type: "function") вместо этого принудительно возвращает режим рассуждения к disabled, чтобы запрошенный инструмент всё же был выполнен; tool_choice: "required" вместо этого нормализуется в auto. Это относится ко всем моделям Moonshot, кроме Kimi K2.7 Code, режим рассуждения которой нельзя отключить: при несовместимости её tool_choice нормализуется в auto.

Kimi K2.6 также принимает необязательное поле thinking.keep, которое управляет сохранением reasoning_content между несколькими ходами. Установите значение "all", чтобы сохранять полную цепочку рассуждений между ходами; не указывайте его (или оставьте значение null), чтобы использовать стратегию сервера по умолчанию. OpenClaw передаёт thinking.keep только для moonshot/kimi-k2.6 и удаляет его для других моделей. Kimi K2.7 Code по умолчанию сохраняет полную историю рассуждений, а OpenClaw полностью опускает поле thinking.

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

Санитизация идентификаторов вызовов инструментов

Moonshot Kimi предоставляет нативные идентификаторы tool_call вида functions.<name>:<index>. OpenClaw сохраняет первое вхождение каждого нативного идентификатора Kimi, а последующие дубликаты преобразует в детерминированные идентификаторы call_* в стиле OpenAI. Соответствующие результаты инструментов переназначаются на тот же идентификатор, поэтому при повторном воспроизведении сохраняется уникальность без удаления первого нативного идентификатора Kimi. Это поведение встроено в поставляемый в комплекте провайдер Moonshot и не настраивается пользователем.

Совместимость использования при потоковой передаче

Нативные конечные точки Moonshot (https://api.moonshot.ai/v1 и https://api.moonshot.cn/v1) заявляют о совместимости учёта использования при потоковой передаче. OpenClaw определяет это по хосту конечной точки, а не по идентификатору провайдера, поэтому пользовательский идентификатор провайдера, указывающий на тот же нативный хост Moonshot, наследует такое же поведение учёта использования при потоковой передаче.При использовании каталожных тарифов K2.6 данные потокового использования, включающие входные, выходные и прочитанные из кеша токены, также преобразуются в локальную оценочную стоимость в долларах США для /status, /usage full, /usage cost и учёта сеансов на основе транскриптов.

Справочник конечных точек и ссылок на модели

Провайдер	Префикс ссылки на модель	Конечная точка	Переменная окружения аутентификации
Moonshot	`moonshot/`	`https://api.moonshot.ai/v1`	`MOONSHOT_API_KEY`
Moonshot CN	`moonshot/`	`https://api.moonshot.cn/v1`	`MOONSHOT_API_KEY`
Kimi Coding	`kimi/`	Конечная точка Kimi Coding	`KIMI_API_KEY`
Веб-поиск	Н/Д	Совпадает с регионом API Moonshot	`KIMI_API_KEY` или `MOONSHOT_API_KEY`

Веб-поиск Kimi использует KIMI_API_KEY или MOONSHOT_API_KEY, а по умолчанию — https://api.moonshot.ai/v1 с моделью kimi-k2.6.
При необходимости переопределите сведения о ценах и контексте в models.providers.
Если Moonshot опубликует другие ограничения контекста для модели, соответствующим образом скорректируйте contextWindow.

Связанные материалы

Выбор модели

Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

Веб-поиск

Настройка провайдеров веб-поиска, включая Kimi.

Справочник по конфигурации

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

Открытая платформа Moonshot

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

Overview

Concepts and configuration

Providers

Встроенный каталог моделей

Начало работы

Пример конфигурации

Пример конфигурации

Веб-поиск Kimi

Расширенная конфигурация

Связанные материалы

Выбор модели

Веб-поиск

Справочник по конфигурации

Открытая платформа Moonshot

​Встроенный каталог моделей

​Начало работы

​Пример конфигурации

​Пример конфигурации

​Веб-поиск Kimi

​Расширенная конфигурация

​Связанные материалы

Выбор модели

Веб-поиск

Справочник по конфигурации

Открытая платформа Moonshot

Встроенный каталог моделей

Начало работы

Пример конфигурации

Пример конфигурации

Веб-поиск Kimi

Расширенная конфигурация

Связанные материалы