> ## 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 AI

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

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

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

[//]: # "moonshot-kimi-k2-ids:start"

| Ссылка на модель | Название | Рассуждение | Входные данные | Контекст | Макс. вывод |
| - | - | - | - | - | - |
| `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-ids:end"

Оценки стоимости в каталоге используют опубликованные 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 поставляются как внешние плагины — установите нужный плагин перед
первоначальной настройкой.

> [tab] API Moonshot
>
> **Лучше всего подходит для:** моделей Kimi K2 через Moonshot Open Platform.
>
> **1. Установите плагин**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw plugins install @openclaw/moonshot-provider
> openclaw gateway restart
> ```
>
> **2. Выберите регион конечной точки**
>
> | Вариант аутентификации | Конечная точка | Регион |
> | - | - | - |
> | `moonshot-api-key` | `https://api.moonshot.ai/v1` | Международный |
> | `moonshot-api-key-cn` | `https://api.moonshot.cn/v1` | Китай |
>
> **3. Запустите первоначальную настройку**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice moonshot-api-key
> ```
>
> Для конечной точки в Китае:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice moonshot-api-key-cn
> ```
>
> **4. Установите модель по умолчанию**
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       model: { primary: "moonshot/kimi-k2.6" },
>     },
>   },
> }
> ```
>
> **5. Проверьте доступность моделей**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw models list --provider moonshot
> ```
>
> **6. Выполните оперативную дымовую проверку**
>
> Используйте изолированный каталог состояния, если хотите проверить доступ к модели и
> учёт стоимости, не затрагивая обычные сеансы:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> 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`.
>
> ### Пример конфигурации
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   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
>         ],
>       },
>     },
>   },
> }
> ```

> [tab] Kimi Coding
>
> **Лучше всего подходит для:** задач, связанных с кодом, через конечную точку Kimi Coding.
>
> > [!NOTE]
> >
> > Kimi Coding использует другой ключ API и префикс провайдера (`kimi/...`), чем Moonshot (`moonshot/...`). Стабильная ссылка на модель — `kimi/kimi-for-coding`; устаревшие ссылки `kimi/kimi-code` и `kimi/k2p5` по-прежнему принимаются и нормализуются в этот идентификатор модели.
>
> **1. Установите плагин**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw plugins install @openclaw/kimi-provider
> openclaw gateway restart
> ```
>
> **2. Запустите первоначальную настройку**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --auth-choice kimi-code-api-key
> ```
>
> **3. Установите модель по умолчанию**
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       model: { primary: "kimi/kimi-for-coding" },
>     },
>   },
> }
> ```
>
> **4. Проверьте доступность модели**
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw models list --provider kimi
> ```
>
> ### Пример конфигурации
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   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.

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw configure --section web
```

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

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

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

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

Конфигурация находится в `plugins.entries.moonshot.config.webSearch`:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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",
      },
    },
  },
}
```

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

> [accordion] Встроенный режим рассуждения
>
> 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`:
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       models: {
>         "moonshot/kimi-k2.6": {
>           params: {
>             thinking: { type: "disabled" },
>           },
>         },
>       },
>     },
>   },
> }
> ```
>
> OpenClaw сопоставляет уровни `/think` среды выполнения для этих моделей:
>
> | Уровень `/think` | Поведение Moonshot |
> | - | - |
> | `/think off` | `thinking.type=disabled` |
> | Любой уровень, кроме off | `thinking.type=enabled` |
>
> > [!WARNING]
> >
> > Когда режим рассуждения 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`.
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       models: {
>         "moonshot/kimi-k2.6": {
>           params: {
>             thinking: { type: "enabled", keep: "all" },
>           },
>         },
>       },
>     },
>   },
> }
> ```

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

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

> [accordion] Справочник конечных точек и ссылок на модели
>
> | Провайдер | Префикс ссылки на модель | Конечная точка | Переменная окружения аутентификации |
> | - | - | - | - |
> | 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`.

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

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Веб-поиск](https://docs2.openclaw.ai/ru/tools/web.md)
>
> Настройка провайдеров веб-поиска, включая Kimi.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/configuration-reference.md)
>
> Полная схема конфигурации провайдеров, моделей и плагинов.

> [card] [Открытая платформа Moonshot](https://platform.moonshot.ai)
>
> Управление ключами API Moonshot и документация.