Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code

Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code

Агент установлен, ключ вписан в конфиг — а агент отвечает, что провайдера не существует. Или, что обиднее, вместо выполнения команды аккуратно печатает её текстом в чат. Оба случая выглядят как поломка модели, а упираются в одно: у Kimi два разных продукта с похожими названиями, и ключ от одного не работает во втором. Разберём оба маршрута — в OpenClaw и в Hermes Agent — с точными командами и именами переменных. Проверено 25 августа 2026 года по официальным страницам.

Коротко о главном:

  • У Kimi два независимых продукта: план Kimi Code и открытая платформа Moonshot. Разные ключи, разные адреса, разные имена моделей.
  • В OpenClaw это два отдельных плагина, а не один с переключателем.
  • В Hermes провайдер называется kimi-coding, а адрес по умолчанию ведёт на открытую платформу — при работе по плану его задают явно.
  • Агент печатает вызов инструмента текстом — вы на старой закреплённой сборке, а не на плохом ключе.
  • Kimi Code есть только на платных уровнях, младший — $19 в месяц. Продажи новых подписок пока закрыты.

Чем Kimi Code отличается от открытой платформы Moonshot

Это два разных продукта одной компании: план с фиксированной месячной оплатой и оплата по факту за токены. Разница не косметическая — на ней и спотыкаются.

План Kimi Code. Ключи создаются в консоли Kimi Code, до пяти штук, каждый показывается ровно один раз. Адрес в протоколе OpenAI — https://api.kimi.com/coding/v1, в протоколе Anthropic — https://api.kimi.com/coding/.

Открытая платформа Moonshot. Ключ создаётся в консоли платформы Kimi. Адрес в протоколе OpenAI — https://api.moonshot.ai/v1, в протоколе Anthropic — https://api.moonshot.ai/anthropic.

Документация OpenClaw формулирует это в рамке-предупреждении: Moonshot и Kimi Coding — раздельные провайдеры, каждый поставляется отдельным внешним плагином, ключи не взаимозаменяемы, адреса различаются, и ссылки на модели различаются тоже — moonshot/... против kimi/....

Посмотрите, откуда у вас ключ, до того как что-то настраивать: половина сообщений «провайдер не найден» лечится именно здесь.

Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code

Два продукта Kimi различаются ключом, адресом и префиксом в имени модели

Что подготовить до подключения

Нужен активный платный уровень и ключ из нужной консоли. Kimi Code CLI необязателен, но с ним удобно проверить ключ до того, как лезть в конфиги агента.

На Linux и macOS:

curl -LsSf https://code.kimi.com/install.sh | bash

На Windows в PowerShell:

Invoke-RestMethod https://code.kimi.com/install.ps1 | Invoke-Expression

Поддерживается Python с 3.12 по 3.14, рекомендуется 3.13. Дальше — команда kimi в папке проекта, затем /login: при выборе площадки Kimi Code авторизация проходит через браузер сама. Настройки лягут в ~/.kimi/config.toml, проверка — kimi --version.

Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code

CLI и агент независимы: работающий kimi подтверждает, что ключ живой, но ничего не настраивает ни в OpenClaw, ни в Hermes.

Как подключить Kimi к OpenClaw?

Провайдер приезжает отдельным плагином, после чего перезапускается шлюз и проходится онбординг. Три команды и одна проверка.

Для плана Kimi Code:

openclaw plugins install @openclaw/kimi-provider openclaw gateway restart openclaw onboard --auth-choice kimi-code-api-key

Ключ агент возьмёт из переменной KIMI_API_KEY. Имена моделей — kimi/kimi-for-coding, kimi/k3 и kimi/k3-256k.

Для открытой платформы всё то же самое, но плагин и онбординг другие:

openclaw plugins install @openclaw/moonshot-provider openclaw onboard --auth-choice moonshot-api-key

Переменная здесь MOONSHOT_API_KEY, модели называются moonshot/kimi-k3, moonshot/kimi-k2.7-code и moonshot/kimi-k2.7-code-highspeed. По каталогу в документации у moonshot/kimi-k3 контекст и максимальный ответ — 1 048 576 токенов, у обеих сборок K2.7 Code — 262 144.

Проверить провайдера и выбрать модель по умолчанию:

openclaw models list --provider kimi openclaw models set kimi/kimi-for-coding
Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code

Значение переменной окружения перекрывает запись в конфиге. Правите конфиг, а поведение не меняется — мешает переменная, оставшаяся с прошлых экспериментов.

Как подключить Kimi к Hermes Agent?

Hermes ставится одной строкой, ключ кладётся в файл окружения, провайдер называется kimi-coding.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Ключ Hermes ищет в файле ~/.hermes/.env, переменная KIMI_API_KEY; принимается и синоним KIMI_CODING_API_KEY. Разовый запуск — hermes chat --provider kimi-coding --model kimi-for-coding. Чтобы не повторять это каждый раз, пропишите в конфиге:

model: provider: "kimi" default: "kimi-for-coding"
Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code

Свой адрес задаётся блоком providers: с полями api, key_env и transport. Для протокола Anthropic ставится transport: anthropic_messages, для протокола OpenAI — chat_completions.

Здесь главная ловушка. Адрес по умолчанию для этого провайдера ведёт на открытую платформу, а не на план Kimi Code. Если ключ от плана, адрес нужно задать явно — иначе запросы уйдут не туда и ключ будет отвергнут, хотя он рабочий.

Вторая ловушка — из обращения 43982 в репозитории Hermes. При выборе провайдера командой hermes model агент пробует адрес на наличие списка моделей и переписывает адрес прямо в конфиге на тот вариант, который ответил, — даже когда протокол Anthropic задан явно. Обходной путь оттуда же: сразу писать адрес так, чтобы он заканчивался на /v1, тогда переписывать нечего. Обращение открыто 11 июня 2026 года и закрыто исправлением, но сверять конфиг после переключения модели по-прежнему полезно.

Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code

Агент печатает вызов инструмента текстом вместо того, чтобы его выполнить

Симптом узнаваемый: вместо выполнения агент выводит в чат строку вида exec({"command": "whoami"}). Дело не в ключе и не в модели — дело в сборке агента.

Проверяется за полминуты. Попросите агента выполнить любую безобидную команду. Напечатал вызов, а файловая система не тронута — вы поймали именно этот случай.

История такая. Изменение 909f26a в сборке 2026.3.7 включило перевод описания инструментов в чужой формат на отправке, тогда как разбор ответа остался в исходном: инструменты уезжали в одном виде, возвращались в другом, и агент принимал их за обычный текст. По обращению 61270, сборки с 2026.3.7 по 2026.4.2 ведут себя так, а 2026.3.13 работает верно. Обращение закрыто 5 апреля 2026 года с пометкой «выполнено».

Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code

Последняя сборка OpenClaw — 2026.7.1-2 от 4 августа 2026 года, на ней проблемы нет. Ловят её те, кто закрепил старую версию и не обновлялся, — в командах это обычное дело. Лечение соответствующее: обновить агента и повторить тот же тест. Менять ключ, провайдера и модель бесполезно, они ни при чём.

Сколько стоит доступ

Четыре платных уровня и один бесплатный. Kimi Code включён во все платные и отсутствует на бесплатном.

Помесячно уровни стоят $19, $39, $99 и $199. При годовой оплате в пересчёте на месяц — $15, $31, $79 и $159; на странице тарифов указано, что годовая оплата экономит до $480 в год. Бесплатный уровень называется Adagio и стоит $0, но Kimi Code на нём недоступен.

Кредиты агента в месяц растут по уровням: 60, 150, 360 и 720.

Два ограничения меняют выбор уровня. Первое: у Kimi Code свой отдельный лимит — пятичасовое окно и недельная квота, они не пересекаются с лимитами остальных возможностей, и работа в чате не съедает то, что вы отвели на код. Второе: длинный контекст до 1 млн токенов включён только на двух старших уровнях — $99 и $199, и младшие его не дадут, сколько бы кредитов ни оставалось.

Как подключить Kimi к OpenClaw и Hermes Agent через Kimi Code
Лестница уровней: цена, кредиты агента и уровни с длинным контекстом
Лестница уровней: цена, кредиты агента и уровни с длинным контекстом

Что делать, если план не продаётся

С 19–20 июля 2026 года продажа новых подписок приостановлена: спрос упёрся в мощности. На странице тарифов у всех четырёх уровней вместо покупки стоит кнопка записи в лист ожидания.

Действующих подписчиков это не затронуло, места обещали открывать партиями, конкретной даты не называли. Заодно предложение разделили надвое: членство для веба и приложения и отдельное — для разработки.

Если подписка уже есть, всё описанное выше работает. Если её нет, путей два: записаться в лист ожидания либо идти через открытую платформу Moonshot с оплатой по факту. Второй путь доступен всегда и настраивается теми же командами. Статус уровней перед покупкой стоит перепроверить: партии открывают без объявления.

Как оплатить из России

Своя зарубежная карта не понадобится: подписку оплачивают за вас, а вы платите привычным способом в рублях.

Российские карты сервис не принимает — это факт, с которым приходится работать. Обходится он двумя способами. Основной: вы оставляете заявку, переводите рубли на российский счёт, оператор оплачивает подписку иностранной картой; вся операция занимает 10–15 минут. Второй вариант — предоплаченная карта VISA или Mastercard, если продлевать хотите сами.

Доступ к вашему рабочему окружению никто не запрашивает: оплачивается подписка, а ключи вы выпускаете сами в своей консоли. Действует гарантия возврата, если оплата не прошла, и гарантия низкой цены.

Когда эта связка не подойдёт

Не подойдёт при рваной нагрузке: план — фиксированная сумма плюс лимиты, и в тихий месяц вы платите столько же, сколько в горячий. Оплата по факту в такой ситуации честнее.

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

Частые вопросы

Можно ли использовать один ключ и в OpenClaw, и в Hermes?

Да, если это ключ от одного продукта. Ключ плана Kimi Code спокойно живёт одновременно в переменной KIMI_API_KEY у обоих агентов. Учтите только, что лимиты у плана общие: два агента расходуют одну квоту.

Чем `kimi/kimi-for-coding` отличается от `moonshot/kimi-k3`?

Это модели из разных каталогов: первая относится к плану Kimi Code и оплачивается подпиской, вторая — к открытой платформе и оплачивается по токенам.

Нужно ли ставить Kimi Code CLI, чтобы подключить Kimi к агенту?

Нет, агенты обращаются к сервису напрямую. Ставить его стоит по другой причине: это самый быстрый способ убедиться, что ключ живой и уровень активен.

Почему адрес в конфиге Hermes меняется сам?

При выборе провайдера агент пробует адрес на наличие списка моделей и записывает в конфиг тот вариант, который ответил. Поведение описано в обращении 43982 и уже исправлено; на старых версиях помогает адрес, сразу заканчивающийся на /v1.

Что делать, если агент отвечает, что провайдер не найден?

Проверьте, что плагин установлен и шлюз перезапущен: без плагина имена моделей не распознаются. Затем сверьте префикс модели с плагином — kimi/... работает только с одним, moonshot/... только с другим.

С чего начать

Соберите связку по порядку. Сначала посмотрите, откуда у вас ключ, и определите маршрут — план или открытая платформа. Затем поставьте нужный плагин или пропишите провайдера, перезапустите агента и проверьте список моделей. Третьим шагом задайте модель по умолчанию и попросите агента выполнить простую команду: это разом покажет и что ключ принят, и что сборка не из проблемного диапазона. И только после этого переносите на связку реальные задачи.

Если подписки ещё нет, а покупка закрыта — настройте маршрут через открытую платформу сейчас, а место в плане займите, когда откроется партия.