Gateway

Конфігурація — інструменти та користувацькі провайдери

tools.* ключі конфігурації та налаштування власного провайдера / базової URL-адреси. Для агентів, каналів та інших ключів конфігурації верхнього рівня див. довідник конфігурації.

Інструменти

Профілі інструментів

tools.profile задає базовий список дозволеного перед tools.allow/tools.deny:

Профіль	Містить
`minimal`	лише `session_status`
`coding`	`group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `video_generate`
`messaging`	`group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status`
`full`	Без обмежень (те саме, що й не задано)

Групи інструментів

Група	Інструменти
`group:runtime`	`exec`, `process`, `code_execution` (`bash` приймається як псевдонім для `exec`)
`group:fs`	`read`, `write`, `edit`, `apply_patch`
`group:sessions`	`sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status`
`group:memory`	`memory_search`, `memory_get`
`group:web`	`web_search`, `x_search`, `web_fetch`
`group:ui`	`browser`, `canvas`
`group:automation`	`heartbeat_respond`, `cron`, `gateway`
`group:messaging`	`message`
`group:nodes`	`nodes`
`group:agents`	`agents_list`, `update_plan`
`group:media`	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`
`group:openclaw`	Усі вбудовані інструменти (не включає Plugin провайдерів)

`tools.allow` / `tools.deny`

Глобальна політика дозволу/заборони інструментів (заборона має пріоритет). Не чутлива до регістру, підтримує символи-замінники *. Застосовується навіть тоді, коли пісочницю Docker вимкнено.

json5

{  tools: { deny: ["browser", "canvas"] },}

write і apply_patch — окремі ідентифікатори інструментів. allow: ["write"] також вмикає apply_patch для сумісних моделей, але deny: ["write"] не забороняє apply_patch. Щоб заблокувати всі зміни файлів, забороніть group:fs або явно перелічіть кожен інструмент, що вносить зміни:

json5

{  tools: { deny: ["write", "edit", "apply_patch"] },}

`tools.byProvider`

Додатково обмежує інструменти для конкретних провайдерів або моделей. Порядок: базовий профіль → профіль провайдера → дозволити/заборонити.

json5

{  tools: {    profile: "coding",    byProvider: {      "google-antigravity": { profile: "minimal" },      "openai/gpt-5.4": { allow: ["group:fs", "sessions_list"] },    },  },}

`tools.toolsBySender`

Обмежує інструменти для конкретної ідентичності запитувача. Це додатковий рівень захисту поверх контролю доступу каналу; значення відправника мають надходити з адаптера каналу, а не з тексту повідомлення.

json5

{  tools: {    toolsBySender: {      "channel:discord:1234567890123": { alsoAllow: ["group:fs"] },      "id:guest-user-id": { deny: ["group:runtime", "group:fs"] },      "*": { deny: ["exec", "process", "write", "edit", "apply_patch"] },    },  },}

Ключі використовують явні префікси: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> або "*". Ідентифікатори каналів — канонічні ідентифікатори OpenClaw; псевдоніми на кшталт teams нормалізуються до msteams. Застарілі ключі без префікса приймаються лише як id:. Порядок зіставлення: channel+id, id, e164, username, name, потім символ-замінник.

agents.list[].tools.toolsBySender на рівні агента перевизначає глобальне зіставлення відправника, коли збігається, навіть із порожньою політикою {}.

`tools.elevated`

Керує підвищеним доступом exec поза пісочницею:

json5

{  tools: {    elevated: {      enabled: true,      allowFrom: {        whatsapp: ["+15555550123"],        discord: ["1234567890123", "987654321098765432"],      },    },  },}

Перевизначення на рівні агента (agents.list[].tools.elevated) може лише додатково обмежувати.
/elevated on|off|ask|full зберігає стан для кожної сесії; вбудовані директиви застосовуються до одного повідомлення.
Підвищений exec обходить пісочницю та використовує налаштований шлях виходу (gateway за замовчуванням або node, коли ціль exec — node).

`tools.exec`

json5

{  tools: {    exec: {      backgroundMs: 10000,      timeoutSec: 1800,      cleanupMs: 1800000,      notifyOnExit: true,      notifyOnExitEmptySuccess: false,      commandHighlighting: false,      applyPatch: {        enabled: false,        allowModels: ["gpt-5.5"],      },    },  },}

`tools.loopDetection`

Перевірки безпеки циклів інструментів вимкнені за замовчуванням. Установіть enabled: true, щоб активувати виявлення. Налаштування можна визначити глобально в tools.loopDetection і перевизначити для кожного агента в agents.list[].tools.loopDetection.

json5

{  tools: {    loopDetection: {      enabled: true,      historySize: 30,      warningThreshold: 10,      criticalThreshold: 20,      globalCircuitBreakerThreshold: 30,      detectors: {        genericRepeat: true,        knownPollNoProgress: true,        pingPong: true,      },    },  },}

historySizenumber

Максимальна історія викликів інструментів, що зберігається для аналізу циклів.

warningThresholdnumber

Поріг повторюваного шаблону без прогресу для попереджень.

criticalThresholdnumber

Вищий поріг повторення для блокування критичних циклів.

globalCircuitBreakerThresholdnumber

Поріг жорсткої зупинки для будь-якого виконання без прогресу.

detectors.genericRepeatboolean

Попереджати про повторні виклики того самого інструмента з тими самими аргументами.

detectors.knownPollNoProgressboolean

Попереджати/блокувати відомі інструменти опитування (process.poll, command_status тощо).

detectors.pingPongboolean

Попереджати/блокувати почергові парні шаблони без прогресу.

`tools.web`

json5

{  tools: {    web: {      search: {        enabled: true,        apiKey: "brave_api_key", // or BRAVE_API_KEY env        maxResults: 5,        timeoutSeconds: 30,        cacheTtlMinutes: 15,      },      fetch: {        enabled: true,        provider: "firecrawl", // optional; omit for auto-detect        maxChars: 50000,        maxCharsCap: 50000,        maxResponseBytes: 2000000,        timeoutSeconds: 30,        cacheTtlMinutes: 15,        maxRedirects: 3,        readability: true,        userAgent: "custom-ua",      },    },  },}

`tools.media`

Налаштовує розуміння вхідних медіа (зображення/аудіо/відео):

json5

{  tools: {    media: {      concurrency: 2,      asyncCompletion: {        directSend: false, // deprecated: completions stay agent-mediated      },      audio: {        enabled: true,        maxBytes: 20971520,        scope: {          default: "deny",          rules: [{ action: "allow", match: { chatType: "direct" } }],        },        models: [          { provider: "openai", model: "gpt-4o-mini-transcribe" },          { type: "cli", command: "whisper", args: ["--model", "base", "{{MediaPath}}"] },        ],      },      image: {        enabled: true,        timeoutSeconds: 180,        models: [{ provider: "ollama", model: "gemma4:26b", timeoutSeconds: 300 }],      },      video: {        enabled: true,        maxBytes: 52428800,        models: [{ provider: "google", model: "gemini-3-flash-preview" }],      },    },  },}

Поля запису медіамоделі

Запис провайдера (type: "provider" або пропущено):

provider: ідентифікатор API-провайдера (openai, anthropic, google/gemini, groq тощо)
model: перевизначення ідентифікатора моделі
profile / preferredProfile: вибір профілю auth-profiles.json

Запис CLI (type: "cli"):

command: виконуваний файл для запуску
args: шаблонні аргументи (підтримує {{MediaPath}}, {{Prompt}}, {{MaxChars}} тощо; openclaw doctor --fix переносить застарілі заповнювачі {input} до {{MediaPath}})

Спільні поля:

capabilities: необов’язковий список (image, audio, video). Значення за замовчуванням: openai/anthropic/minimax → зображення, google → зображення+аудіо+відео, groq → аудіо.
prompt, maxChars, maxBytes, timeoutSeconds, language: перевизначення для окремого запису.
tools.media.image.timeoutSeconds і відповідні записи timeoutSeconds моделей зображень також застосовуються, коли агент викликає явний інструмент image.
У разі збоїв виконується перехід до наступного запису.

Автентифікація провайдера дотримується стандартного порядку: auth-profiles.json → змінні середовища → models.providers.*.apiKey.

Поля асинхронного завершення:

asyncCompletion.directSend: застарілий прапорець сумісності. Завершені асинхронні медіазавдання залишаються опосередкованими сеансом запитувача, щоб агент отримав результат, вирішив, як повідомити користувача, і використав інструмент повідомлень, коли цього вимагає доставлення з джерела.

`tools.agentToAgent`

json5

{  tools: {    agentToAgent: {      enabled: false,      allow: ["home", "work"],    },  },}

`tools.sessions`

Керує тим, на які сеанси можуть націлюватися інструменти сеансів (sessions_list, sessions_history, sessions_send).

За замовчуванням: tree (поточний сеанс + сеанси, породжені ним, наприклад підагенти).

json5

{  tools: {    sessions: {      // "self" | "tree" | "agent" | "all"      visibility: "tree",    },  },}

Області видимості

self: лише ключ поточного сеансу.
tree: поточний сеанс + сеанси, породжені поточним сеансом (підагенти).
agent: будь-який сеанс, що належить поточному ідентифікатору агента (може включати інших користувачів, якщо ви запускаєте сеанси для кожного відправника з тим самим ідентифікатором агента).
all: будь-який сеанс. Націлювання між агентами все одно потребує tools.agentToAgent.
Обмеження пісочниці: коли поточний сеанс ізольовано в пісочниці й agents.defaults.sandbox.sessionToolsVisibility="spawned", видимість примусово встановлюється на tree, навіть якщо tools.sessions.visibility="all".

`tools.sessions_spawn`

Керує підтримкою вбудованих вкладень для sessions_spawn.

json5

{  tools: {    sessions_spawn: {      attachments: {        enabled: false, // opt-in: set true to allow inline file attachments        maxTotalBytes: 5242880, // 5 MB total across all files        maxFiles: 50,        maxFileBytes: 1048576, // 1 MB per file        retainOnSessionKeep: false, // keep attachments when cleanup="keep"      },    },  },}

Примітки щодо вкладень

Вкладення підтримуються лише для runtime: "subagent". Середовище виконання ACP їх відхиляє.
Файли матеріалізуються в дочірній робочій області за шляхом .openclaw/attachments/<uuid>/ з файлом .manifest.json.
Вміст вкладень автоматично редагується збереженням транскрипту.
Вхідні дані Base64 перевіряються суворими перевірками алфавіту/доповнення та захистом розміру перед декодуванням.
Дозволи файлів: 0700 для каталогів і 0600 для файлів.
Очищення відповідає політиці cleanup: delete завжди видаляє вкладення; keep зберігає їх лише коли retainOnSessionKeep: true.

`tools.experimental`

Експериментальні прапорці вбудованих інструментів. Типово вимкнено, якщо не застосовується правило суворого агентного автоматичного ввімкнення GPT-5.

json5

{  tools: {    experimental: {      planTool: true, // enable experimental update_plan    },  },}

planTool: вмикає структурований інструмент update_plan для відстеження нетривіальної багатоетапної роботи.
Типово: false, якщо agents.defaults.embeddedPi.executionContract (або перевизначення для окремого агента) не встановлено в "strict-agentic" для запуску OpenAI або OpenAI Codex сімейства GPT-5. Установіть true, щоб примусово ввімкнути інструмент поза цією областю, або false, щоб залишити його вимкненим навіть для суворих агентних запусків GPT-5.
Коли ввімкнено, системний промпт також додає рекомендації з використання, щоб модель застосовувала його лише для суттєвої роботи й мала щонайбільше один крок in_progress.

`agents.defaults.subagents`

json5

{  agents: {    defaults: {      subagents: {        allowAgents: ["research"],        model: "minimax/MiniMax-M2.7",        maxConcurrent: 8,        runTimeoutSeconds: 900,        announceTimeoutMs: 120000,        archiveAfterMinutes: 60,      },    },  },}

model: типова модель для породжених субагентів. Якщо пропущено, субагенти успадковують модель викликача.
allowAgents: типовий список дозволених ідентифікаторів цільових агентів для sessions_spawn, коли агент-запитувач не задає власний subagents.allowAgents (["*"] = будь-який; типово: лише той самий агент).
runTimeoutSeconds: типовий тайм-аут (у секундах) для sessions_spawn, коли виклик інструмента пропускає runTimeoutSeconds. 0 означає без тайм-ауту.
announceTimeoutMs: тайм-аут для кожного виклику (у мілісекундах) для спроб доставки оголошення agent через Gateway. Типово: 120000. Тимчасові повторні спроби можуть зробити загальне очікування оголошення довшим за один налаштований тайм-аут.
Політика інструментів для кожного субагента: tools.subagents.tools.allow / tools.subagents.tools.deny.

Користувацькі провайдери та базові URL

OpenClaw використовує вбудований каталог моделей. Додавайте користувацьких провайдерів через models.providers у конфігурації або ~/.openclaw/agents/<agentId>/agent/models.json.

json5

{  models: {    mode: "merge", // merge (default) | replace    providers: {      "custom-proxy": {        baseUrl: "http://localhost:4000/v1",        apiKey: "LITELLM_KEY",        api: "openai-completions", // openai-completions | openai-responses | anthropic-messages | google-generative-ai        models: [          {            id: "llama-3.1-8b",            name: "Llama 3.1 8B",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 128000,            contextTokens: 96000,            maxTokens: 32000,          },        ],      },    },  },}

Автентифікація та пріоритет злиття

Використовуйте authHeader: true + headers для користувацьких потреб автентифікації.
Перевизначте корінь конфігурації агента за допомогою OPENCLAW_AGENT_DIR (або PI_CODING_AGENT_DIR, застарілого псевдоніма змінної середовища).
Пріоритет злиття для збіжних ідентифікаторів провайдерів:
- Непорожні значення baseUrl з агентського models.json мають перевагу.
- Непорожні значення apiKey агента мають перевагу лише коли цей провайдер не керується SecretRef у поточному контексті конфігурації/профілю автентифікації.
- Значення apiKey провайдера, керованого SecretRef, оновлюються з маркерів джерела (ENV_VAR_NAME для посилань на змінні середовища, secretref-managed для посилань на файл/exec) замість збереження розв’язаних секретів.
- Значення заголовків провайдера, керованого SecretRef, оновлюються з маркерів джерела (secretref-env:ENV_VAR_NAME для посилань на змінні середовища, secretref-managed для посилань на файл/exec).
- Порожні або відсутні apiKey/baseUrl агента повертаються до models.providers у конфігурації.
- Збіжні contextWindow/maxTokens моделі використовують вище значення між явною конфігурацією та неявними значеннями каталогу.
- Збіжний contextTokens моделі зберігає явне обмеження середовища виконання, коли воно є; використовуйте його, щоб обмежити ефективний контекст без зміни нативних метаданих моделі.
- Використовуйте models.mode: "replace", коли потрібно, щоб конфігурація повністю перезаписувала models.json.
- Збереження маркерів є авторитетним щодо джерела: маркери записуються з активного знімка конфігурації джерела (до розв’язання), а не з розв’язаних секретних значень часу виконання.

Деталі полів провайдера

Каталог верхнього рівня

models.mode: поведінка каталогу провайдерів (merge або replace).
models.providers: мапа користувацьких провайдерів, ключована ідентифікатором провайдера.
- Безпечні редагування: використовуйте openclaw config set models.providers.<id> '<json>' --strict-json --merge або openclaw config set models.providers.<id>.models '<json-array>' --strict-json --merge для адитивних оновлень. config set відмовляється від руйнівних замін, якщо не передати --replace.

Підключення провайдера та автентифікація

models.providers.*.api: адаптер запитів (openai-completions, openai-responses, anthropic-messages, google-generative-ai тощо). Для самостійно розгорнутих бекендів /v1/chat/completions, таких як MLX, vLLM, SGLang і більшість локальних серверів, сумісних з OpenAI, використовуйте openai-completions. Користувацький провайдер із baseUrl, але без api, типово використовує openai-completions; установлюйте openai-responses лише коли бекенд підтримує /v1/responses.
models.providers.*.apiKey: облікові дані провайдера (надавайте перевагу підстановці SecretRef/змінних середовища).
models.providers.*.auth: стратегія автентифікації (api-key, token, oauth, aws-sdk).
models.providers.*.contextWindow: типове нативне контекстне вікно для моделей цього провайдера, коли запис моделі не задає contextWindow.
models.providers.*.contextTokens: типове ефективне обмеження контексту часу виконання для моделей цього провайдера, коли запис моделі не задає contextTokens.
models.providers.*.maxTokens: типове обмеження вихідних токенів для моделей цього провайдера, коли запис моделі не задає maxTokens.
models.providers.*.timeoutSeconds: необов’язковий тайм-аут HTTP-запиту моделі для кожного провайдера в секундах, включно з підключенням, заголовками, тілом і обробкою переривання всього запиту.
models.providers.*.injectNumCtxForOpenAICompat: для Ollama + openai-completions, впроваджувати options.num_ctx у запити (типово: true).
models.providers.*.authHeader: примусово передавати облікові дані в заголовку Authorization, коли це потрібно.
models.providers.*.baseUrl: базовий URL висхідного API.
models.providers.*.headers: додаткові статичні заголовки для маршрутизації проксі/орендаря.

Перевизначення транспорту запитів

models.providers.*.request: перевизначення транспорту для HTTP-запитів провайдера моделей.

request.headers: додаткові заголовки (об’єднуються з типовими значеннями провайдера). Значення приймають SecretRef.
request.auth: перевизначення стратегії автентифікації. Режими: "provider-default" (використовувати вбудовану автентифікацію провайдера), "authorization-bearer" (з token), "header" (з headerName, value, необов’язковим prefix).
request.proxy: перевизначення HTTP-проксі. Режими: "env-proxy" (використовувати змінні середовища HTTP_PROXY/HTTPS_PROXY), "explicit-proxy" (з url). Обидва режими приймають необов’язковий підоб’єкт tls.
request.tls: перевизначення TLS для прямих підключень. Поля: ca, cert, key, passphrase (усі приймають SecretRef), serverName, insecureSkipVerify.
request.allowPrivateNetwork: коли true, дозволяє HTTPS до baseUrl, коли DNS розв’язується у приватні, CGNAT або подібні діапазони, через захист HTTP fetch провайдера (операторська явна згода для довірених самостійно розгорнутих кінцевих точок, сумісних з OpenAI). Потокові URL провайдера моделей local loopback, такі як localhost, 127.0.0.1 і [::1], дозволені автоматично, якщо це явно не встановлено в false; хости LAN, tailnet і приватного DNS усе ще потребують явної згоди. WebSocket використовує той самий request для заголовків/TLS, але не цей SSRF-шлюз fetch. Типово false.

Записи каталогу моделей

models.providers.*.models: явні записи каталогу моделей провайдера.
models.providers.*.models.*.input: модальності введення моделі. Використовуйте ["text"] для моделей лише з текстом і ["text", "image"] для нативних моделей із зображеннями/комп’ютерним зором. Вкладення зображень впроваджуються в ходи агента лише коли вибрану модель позначено як здатну працювати із зображеннями.
models.providers.*.models.*.contextWindow: метадані нативного контекстного вікна моделі. Це перевизначає contextWindow рівня провайдера для цієї моделі.
models.providers.*.models.*.contextTokens: необов’язкове обмеження контексту часу виконання. Це перевизначає contextTokens рівня провайдера; використовуйте його, коли потрібен менший ефективний бюджет контексту, ніж нативний contextWindow моделі; openclaw models list показує обидва значення, коли вони відрізняються.
models.providers.*.models.*.compat.supportsDeveloperRole: необов’язкова підказка сумісності. Для api: "openai-completions" з непорожнім ненативним baseUrl (хост не api.openai.com) OpenClaw примусово встановлює це в false під час виконання. Порожній/пропущений baseUrl зберігає типову поведінку OpenAI.
models.providers.*.models.*.compat.requiresStringContent: необов’язкова підказка сумісності для чат-ендпоїнтів, сумісних з OpenAI, які підтримують лише рядки. Коли true, OpenClaw сплощує масиви суто текстового messages[].content у прості рядки перед надсиланням запиту.
models.providers.*.models.*.compat.strictMessageKeys: необов’язкова підказка сумісності для суворих чат-ендпоїнтів, сумісних з OpenAI. Коли true, OpenClaw обрізає вихідні об’єкти повідомлень Chat Completions до role і content перед надсиланням запиту.
models.providers.*.models.*.compat.thinkingFormat: необов’язкова підказка формату корисного навантаження мислення. Використовуйте "qwen" для верхньорівневого enable_thinking або "qwen-chat-template" для chat_template_kwargs.enable_thinking на серверах Qwen-сімейства, сумісних з OpenAI, які підтримують kwargs чат-шаблону на рівні запиту, таких як vLLM.

Виявлення Amazon Bedrock

plugins.entries.amazon-bedrock.config.discovery: корінь налаштувань автовиявлення Bedrock.
plugins.entries.amazon-bedrock.config.discovery.enabled: увімкнути/вимкнути неявне виявлення.
plugins.entries.amazon-bedrock.config.discovery.region: регіон AWS для виявлення.
plugins.entries.amazon-bedrock.config.discovery.providerFilter: необов’язковий фільтр ідентифікатора провайдера для цільового виявлення.
plugins.entries.amazon-bedrock.config.discovery.refreshInterval: інтервал опитування для оновлення виявлення.
plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow: резервне контекстне вікно для виявлених моделей.
plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens: резервна максимальна кількість вихідних токенів для виявлених моделей.

Інтерактивний онбординг користувацького провайдера визначає введення зображень для поширених ідентифікаторів моделей із підтримкою зору, як-от GPT-4o, Claude, Gemini, Qwen-VL, LLaVA, Pixtral, InternVL, Mllama, MiniCPM-V і GLM-4V, та пропускає додаткове запитання для відомих сімейств лише для тексту. Для невідомих ідентифікаторів моделей усе ще з’являється запит щодо підтримки зображень. Неінтерактивний онбординг використовує те саме визначення; передайте --custom-image-input, щоб примусово встановити метадані з підтримкою зображень, або --custom-text-input, щоб примусово встановити метадані лише для тексту.

Приклади провайдерів

Cerebras (GLM 4.7 / GPT OSS)

Вбудований Plugin провайдера cerebras може налаштувати це через openclaw onboard --auth-choice cerebras-api-key. Використовуйте явну конфігурацію провайдера лише тоді, коли перевизначаєте стандартні значення.

json5

{  env: { CEREBRAS_API_KEY: "sk-..." },  agents: {    defaults: {      model: {        primary: "cerebras/zai-glm-4.7",        fallbacks: ["cerebras/gpt-oss-120b"],      },      models: {        "cerebras/zai-glm-4.7": { alias: "GLM 4.7 (Cerebras)" },        "cerebras/gpt-oss-120b": { alias: "GPT OSS 120B (Cerebras)" },      },    },  },  models: {    mode: "merge",    providers: {      cerebras: {        baseUrl: "https://api.cerebras.ai/v1",        apiKey: "${CEREBRAS_API_KEY}",        api: "openai-completions",        models: [          { id: "zai-glm-4.7", name: "GLM 4.7 (Cerebras)" },          { id: "gpt-oss-120b", name: "GPT OSS 120B (Cerebras)" },        ],      },    },  },}

Використовуйте cerebras/zai-glm-4.7 для Cerebras; zai/glm-4.7 для прямого Z.AI.

Kimi Coding

json5

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

Сумісний з Anthropic, вбудований провайдер. Скорочення: openclaw onboard --auth-choice kimi-code-api-key.

Local models (LM Studio)

Див. Локальні моделі. TL;DR: запускайте велику локальну модель через LM Studio Responses API на потужному обладнанні; залишайте розміщені моделі об’єднаними для резервного варіанта.

MiniMax M2.7 (direct)

json5

{  agents: {    defaults: {      model: { primary: "minimax/MiniMax-M2.7" },      models: {        "minimax/MiniMax-M2.7": { alias: "Minimax" },      },    },  },  models: {    mode: "merge",    providers: {      minimax: {        baseUrl: "https://api.minimax.io/anthropic",        apiKey: "${MINIMAX_API_KEY}",        api: "anthropic-messages",        models: [          {            id: "MiniMax-M2.7",            name: "MiniMax M2.7",            reasoning: true,            input: ["text"],            cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },            contextWindow: 204800,            maxTokens: 131072,          },        ],      },    },  },}

Установіть MINIMAX_API_KEY. Скорочення: openclaw onboard --auth-choice minimax-global-api або openclaw onboard --auth-choice minimax-cn-api. Каталог моделей за замовчуванням містить лише M2.7. На Anthropic-сумісному шляху потокового передавання OpenClaw стандартно вимикає мислення MiniMax, якщо ви явно не встановите thinking самостійно. /fast on або params.fastMode: true переписує MiniMax-M2.7 на MiniMax-M2.7-highspeed.

Moonshot AI (Kimi)

json5

{  env: { MOONSHOT_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "moonshot/kimi-k2.6" },      models: { "moonshot/kimi-k2.6": { alias: "Kimi K2.6" } },    },  },  models: {    mode: "merge",    providers: {      moonshot: {        baseUrl: "https://api.moonshot.ai/v1",        apiKey: "${MOONSHOT_API_KEY}",        api: "openai-completions",        models: [          {            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,          },        ],      },    },  },}

Для китайського endpoint: baseUrl: "https://api.moonshot.cn/v1" або openclaw onboard --auth-choice moonshot-api-key-cn.

Нативні endpoint Moonshot оголошують сумісність використання потокового передавання на спільному транспорті openai-completions, а OpenClaw прив’язує це до можливостей endpoint, а не лише до ідентифікатора вбудованого провайдера.

OpenCode

json5

{  agents: {    defaults: {      model: { primary: "opencode/claude-opus-4-6" },      models: { "opencode/claude-opus-4-6": { alias: "Opus" } },    },  },}

Установіть OPENCODE_API_KEY (або OPENCODE_ZEN_API_KEY). Використовуйте refs opencode/... для каталогу Zen або refs opencode-go/... для каталогу Go. Скорочення: openclaw onboard --auth-choice opencode-zen або openclaw onboard --auth-choice opencode-go.

Synthetic (Anthropic-compatible)

json5

{  env: { SYNTHETIC_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" },      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.5": { alias: "MiniMax M2.5" } },    },  },  models: {    mode: "merge",    providers: {      synthetic: {        baseUrl: "https://api.synthetic.new/anthropic",        apiKey: "${SYNTHETIC_API_KEY}",        api: "anthropic-messages",        models: [          {            id: "hf:MiniMaxAI/MiniMax-M2.5",            name: "MiniMax M2.5",            reasoning: true,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 192000,            maxTokens: 65536,          },        ],      },    },  },}

Базовий URL має не містити /v1 (клієнт Anthropic додає його). Скорочення: openclaw onboard --auth-choice synthetic-api-key.

Z.AI (GLM-4.7)

json5

{  agents: {    defaults: {      model: { primary: "zai/glm-4.7" },      models: { "zai/glm-4.7": {} },    },  },}

Установіть ZAI_API_KEY. z.ai/* і z-ai/* приймаються як псевдоніми. Скорочення: openclaw onboard --auth-choice zai-api-key.

Загальний endpoint: https://api.z.ai/api/paas/v4
Endpoint для кодування (за замовчуванням): https://api.z.ai/api/coding/paas/v4
Для загального endpoint визначте користувацького провайдера з перевизначенням базового URL.

Пов’язане

Конфігурація — агенти
Конфігурація — канали
Довідник конфігурації — інші ключі верхнього рівня
Інструменти та plugins

Was this useful?

Інструменти

Профілі інструментів

Групи інструментів

tools.allow / tools.deny

tools.byProvider

tools.toolsBySender

tools.elevated

tools.exec

tools.loopDetection

tools.web

tools.media

tools.agentToAgent

tools.sessions

tools.sessions_spawn

tools.experimental

agents.defaults.subagents

Користувацькі провайдери та базові URL

Деталі полів провайдера

Приклади провайдерів

Пов’язане

`tools.allow` / `tools.deny`

`tools.byProvider`

`tools.toolsBySender`

`tools.elevated`

`tools.exec`

`tools.loopDetection`

`tools.web`

`tools.media`

`tools.agentToAgent`

`tools.sessions`

`tools.sessions_spawn`

`tools.experimental`

`agents.defaults.subagents`