Providers
Moonshot AI
Moonshot предоставляет API Kimi с конечными точками, совместимыми с OpenAI. Установите
модель по умолчанию на moonshot/kimi-k2.6 для Moonshot Open Platform или
kimi/kimi-for-coding для Kimi Coding.
Встроенный каталог моделей
| Ссылка на модель | Название | Рассуждение | Входные данные | Контекст | Макс. вывод |
|---|---|---|---|---|---|
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 K2 через Moonshot Open Platform.
Установите плагин
openclaw plugins install @openclaw/moonshot-provideropenclaw 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.
Установите плагин
openclaw plugins install @openclaw/kimi-provideropenclaw 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 |
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.
Полная схема конфигурации провайдеров, моделей и плагинов.
Управление ключами API Moonshot и документация.