Moonshot AI - OpenClaw

Moonshot надає Kimi API з OpenAI-сумісними кінцевими точками. Налаштуйте provider і задайте модель за замовчуванням як moonshot/kimi-k2.6 або використовуйте Kimi Coding з kimi/kimi-for-coding.

Moonshot і Kimi Coding — це окремі providers. Ключі не є взаємозамінними, кінцеві точки відрізняються, і посилання на моделі відрізняються (moonshot/... проти kimi/...).

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

Посилання на модель	Назва	Міркування	Ввід	Контекст	Макс. вивід
`moonshot/kimi-k2.6`	Kimi K2.6	Ні	текст, image	262,144	262,144
`moonshot/kimi-k2.7-code`	Kimi K2.7 Code	Завжди увімкнено	текст, image	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	Ні	текст, image	262,144	262,144
`moonshot/kimi-k2-thinking`	Kimi K2 Thinking	Так	text	262,144	262,144
`moonshot/kimi-k2-thinking-turbo`	Kimi K2 Thinking Turbo	Так	text	262,144	262,144
`moonshot/kimi-k2-turbo`	Kimi K2 Turbo	Ні	text	256,000	16,384

Оцінки вартості в каталозі для поточних моделей K2, розміщених Moonshot, використовують опубліковані Moonshot тарифи pay-as-you-go: Kimi K2.7 Code —

0.19/MTok за cache hit,

0.95/MTok вводу і

4.00/MTok виводу; Kimi K2.6 —

0.16/MTok за cache hit,

0.95/MTok вводу і

4.00/MTok виводу; Kimi K2.5 —

0.10/MTok за cache hit,

0.60/MTok вводу і $3.00/MTok виводу. Інші застарілі записи каталогу зберігають заповнювачі нульової вартості, якщо ви не перевизначите їх у конфігурації. Kimi K2.7 Code завжди використовує native thinking. OpenClaw відкриває лише стан thinking on для цієї моделі й опускає вихідні елементи керування thinking і reasoning_effort, як вимагає Moonshot. OpenClaw також опускає перевизначення sampling, які K2.7 фіксує до стандартних значень provider. Kimi K2.6 залишається стандартною моделлю onboarding.

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

Виберіть свого provider і виконайте кроки налаштування.

Moonshot API
Kimi Coding

Найкраще для: моделей Kimi K2 через Moonshot Open Platform.

Виберіть регіон кінцевої точки

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

Запустіть onboarding

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

Запустіть live smoke test

Використовуйте ізольований каталог стану, коли потрібно перевірити доступ до моделі та відстеження вартості, не зачіпаючи ваші звичайні sessions:

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". Запис transcript assistant зберігає нормалізоване використання токенів плюс оцінену вартість у usage.cost, коли Moonshot повертає метадані usage.

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

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

Установіть офіційний Plugin, а потім перезапустіть Gateway:

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

Найкраще для: завдань, орієнтованих на код, через кінцеву точку Kimi Coding.

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

Установіть Plugin

openclaw plugins install @openclaw/kimi-provider

Запустіть onboarding

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

Plugin Moonshot також реєструє Kimi як provider 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",
      },
    },
  },
}

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

Режим native thinking

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

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

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

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

OpenClaw зіставляє рівні runtime /think для цих моделей:

Рівень `/think`	Поведінка Moonshot
`/think off`	`thinking.type=disabled`
Будь-який рівень не off	`thinking.type=enabled`

Коли Moonshot thinking увімкнено, tool_choice має бути auto або none. OpenClaw нормалізує несумісні значення до auto. Це включає Kimi K2.7 Code, whose thinking mode cannot be disabled to preserve a pinned tool choice.

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

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

Очищення ідентифікаторів викликів інструментів

Moonshot Kimi надає нативні ідентифікатори tool_call у форматі functions.<name>:<index>. Для транспорту OpenAI-completions OpenClaw зберігає першу появу кожного нативного ідентифікатора Kimi й переписує подальші дублікати в детерміновані ідентифікатори у стилі OpenAI call_*. Відповідні результати інструментів перепризначаються з тим самим ідентифікатором, тож повторне відтворення залишається унікальним без вилучення першого нативного ідентифікатора Kimi.Щоб примусово ввімкнути суворе очищення для власного OpenAI-сумісного провайдера, установіть sanitizeToolCallIds: true:

{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}

Сумісність потокового використання

Нативні кінцеві точки Moonshot (https://api.moonshot.ai/v1 і https://api.moonshot.cn/v1) оголошують сумісність потокового використання в спільному транспорті openai-completions. OpenClaw визначає це за можливостями кінцевої точки, тому сумісні власні ідентифікатори провайдерів, що націлені на ті самі нативні хости Moonshot, успадковують таку саму поведінку потокового використання.З цінами каталогу K2.6 потокове використання, яке включає токени вводу, виводу та читання з кешу, також перетворюється в локальну оцінену вартість у USD для /status, /usage full, /usage cost та обліку сесій на основі транскриптів.

Довідник кінцевих точок і посилань на моделі

Провайдер	Префікс посилання на модель	Кінцева точка	Змінна env автентифікації
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`
Вебпошук	N/A	Та сама, що й регіон Moonshot API	`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.

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

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

Moonshot Open Platform

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

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

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

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

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

​Вебпошук Kimi

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

​Пов’язане

Вибір моделі

Вебпошук

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

Moonshot Open Platform

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

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

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

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

Вебпошук Kimi

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

Пов’язане