Providers

Moonshot AI

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

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

Model ref	Назва	Міркування	Вхід	Контекст	Макс. вивід
`moonshot/kimi-k2.6`	Kimi K2.6	Ні	text, image	262,144	262,144
`moonshot/kimi-k2.5`	Kimi K2.5	Ні	text, 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 з оплатою за використання: 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 за вивід. Для інших застарілих записів каталогу залишаються нульові заповнювачі вартості, якщо ви не перевизначите їх у config.

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

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

Moonshot API

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

Choose your endpoint region

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

Run onboarding

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

Або для endpoint Китаю:

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

Set a default model

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

Verify models are available

openclaw models list --provider moonshot

Run a live smoke test

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

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

Приклад config

{
  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.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.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

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

Run onboarding

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

Set a default model

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

Verify the model is available

openclaw models list --provider kimi

Приклад config

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

Вебпошук Kimi

OpenClaw також постачається з Kimi як provider web_search, що працює на базі вебпошуку Moonshot.

Run interactive web search setup

openclaw configure --section web

Виберіть Kimi у розділі вебпошуку, щоб зберегти plugins.entries.moonshot.config.webSearch.*.

Configure the web search region and model

Інтерактивне налаштування запитує:

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

Config зберігається в plugins.entries.moonshot.config.webSearch:

{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // або використовуйте KIMI_API_KEY / MOONSHOT_API_KEY
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

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

Рідний режим thinking

Moonshot Kimi підтримує двійковий рідний режим 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 також відображає рівні /think під час виконання для Moonshot:

Рівень `/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 і видаляє його з інших моделей.

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

Очищення id викликів інструментів

Moonshot Kimi обслуговує id tool_call у форматі functions.<name>:<index>. OpenClaw зберігає їх без змін, щоб багатокрокові виклики інструментів продовжували працювати.

Щоб примусово ввімкнути суворе очищення для користувацького provider, сумісного з OpenAI, встановіть sanitizeToolCallIds: true:

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

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

Власні endpoint Moonshot (https://api.moonshot.ai/v1 і https://api.moonshot.cn/v1) декларують сумісність потокового використання на спільному транспорті openai-completions. OpenClaw визначає це за можливостями endpoint, тому сумісні користувацькі id provider, націлені на ті самі власні хости Moonshot, успадковують таку саму поведінку потокового використання.

Завдяки вбудованому тарифу K2.6 потокове використання, яке містить токени введення, виведення та cache-read, також перетворюється на локально оцінену вартість у USD для /status, /usage full, /usage cost і обліку сесій на основі стенограм.

Довідник endpoint і model ref

Provider	Префікс model ref	Endpoint	Змінна середовища для auth
Moonshot	`moonshot/`	`https://api.moonshot.ai/v1`	`MOONSHOT_API_KEY`
Moonshot CN	`moonshot/`	`https://api.moonshot.cn/v1`	`MOONSHOT_API_KEY`
Kimi Coding	`kimi/`	endpoint Kimi Coding	`KIMI_API_KEY`
Вебпошук	N/A	Те саме, що й регіон 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.

Пов’язане

Вибір моделі

Вибір provider, model ref і поведінки failover.

Вебпошук

Налаштування provider вебпошуку, зокрема Kimi.

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

Повна схема config для provider, моделей і plugin.

Moonshot Open Platform

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

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

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

Moonshot API

Choose your endpoint region

Run onboarding

Set a default model

Verify models are available

Run a live smoke test

# Приклад config

Kimi Coding

Run onboarding

Set a default model

Verify the model is available

# Приклад config

# Вебпошук Kimi

Run interactive web search setup

Configure the web search region and model

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

# Пов’язане

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

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

Приклад config

Приклад config

Вебпошук Kimi

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

Пов’язане