tools.* — ключи конфигурации и настройка пользовательского провайдера / базового URL. О ключах верхнего уровня для агентов, каналов и других компонентов см. в справочнике по конфигурации.
Инструменты
Профили инструментов
tools.profile задаёт базовый список разрешений перед tools.allow/tools.deny:
При локальной первоначальной настройке для новых локальных конфигураций по умолчанию используется
tools.profile: "coding", если значение не задано (существующие явно заданные профили сохраняются).coding и messaging также неявно разрешают bundle-mcp (настроенные серверы MCP).
Группы инструментов
spawn_task позволяет агенту программирования предложить подтверждаемую последующую работу, не начиная её. Control UI отображает заголовок и сводку в виде интерактивной плашки; TUI, работающий через Gateway, показывает эквивалентный интерактивный запрос. Принятие предложения в любом из интерфейсов создаёт новый сеанс с управляемым рабочим деревом и отправляет туда полный запрос, пока текущий ход продолжается. dismiss_task отзывает ещё не принятое предложение по эфемерному task_id, возвращённому из spawn_task.
Инструменты предоставляются только тогда, когда операторский интерфейс, инициирующий работу, может получать и обрабатывать события предложений задач Gateway. Сеансы каналов и локальные/встроенные сеансы TUI их не получают; чтобы безопасно поддерживать этот процесс, транспорту канала требуется переносимое типизированное действие задачи. Предложения локальны для процесса и исчезают при перезапуске Gateway. Оба инструмента остаются в профиле coding и group:sessions, поэтому стандартная политика tools.allow и tools.deny настраивает их автоматически, если интерфейс их поддерживает.
Инструменты MCP и плагинов в политике инструментов песочницы
Настроенные серверы MCP предоставляются как инструменты плагина с идентификаторомbundle-mcp. Обычные профили инструментов могут разрешать их, но для сеансов в песочнице tools.sandbox.tools служит дополнительным ограничителем. Если режим песочницы — "all" или "non-main", добавьте одну из следующих записей в список разрешённых инструментов песочницы, чтобы инструменты MCP/плагинов были доступны:
bundle-mcpдля серверов MCP под управлением OpenClaw изmcp.servers- идентификатор конкретного нативного плагина
group:pluginsдля всех инструментов, принадлежащих загруженным плагинам- точные имена инструментов сервера MCP или шаблоны серверов, например
outlook__send_mailилиoutlook__*, если нужен только один сервер
mcp.servers. Символы, не соответствующие [A-Za-z0-9_-], заменяются на -; к именам, которые не начинаются с буквы, добавляется префикс mcp-; длинные или повторяющиеся префиксы могут быть сокращены или дополнены суффиксом. Например, для mcp.servers["Outlook Graph"] используется шаблон вида outlook-graph__*.
openclaw doctor, чтобы выявлять такую конфигурацию для серверов под управлением OpenClaw в mcp.servers. Серверы MCP, загруженные из манифестов встроенных плагинов или Claude .mcp.json, проходят через тот же ограничитель песочницы, однако эта диагностика пока не перечисляет такие источники. Если их инструменты исчезают в ходах, выполняемых в песочнице, используйте те же записи списка разрешений.
tools.codeMode
tools.codeMode включает универсальный интерфейс режима кода OpenClaw. Когда он включён
для запуска с инструментами, обычные инструменты OpenClaw перемещаются за внутрипесочничный
мост каталога tools.*, а инструменты MCP становятся доступны через созданное
пространство имён MCP. Обычно модель видит exec и wait;
такие инструменты, как computer, структурированные результаты которых нельзя передать
через мост, поддерживающий только JSON, остаются непосредственными.
API.list("mcp") и
API.read("mcp/<server>.d.ts"), чтобы просматривать сигнатуры в стиле TypeScript перед
вызовом MCP.<server>.<tool>(). Контракт среды выполнения, ограничения и порядок отладки
описаны в разделе Режим кода.
tools.allow / tools.deny
Глобальная политика разрешения/запрета инструментов (запрет имеет приоритет). Регистр не учитывается, поддерживаются подстановочные знаки *. Применяется, даже если песочница Docker отключена.
write и apply_patch — разные идентификаторы инструментов. allow: ["write"] также включает apply_patch для совместимых моделей, но deny: ["write"] не запрещает apply_patch. Чтобы заблокировать все изменения файлов, запретите group:fs или явно перечислите каждый инструмент, изменяющий файлы:
allow и alsoAllow нельзя одновременно задать в одной области (tools, tools.byProvider.<id>, agents.list[].tools) — проверка конфигурации отклонит её. Объедините записи alsoAllow с allow либо удалите allow и вместо него используйте profile + alsoAllow.tools.byProvider
Дополнительно ограничивает инструменты для определённых провайдеров или моделей. Порядок: базовый профиль → профиль провайдера → разрешение/запрет.
tools.toolsBySender
Ограничивает инструменты для конкретной идентификационной сущности отправителя запроса. Это дополнительный уровень защиты поверх контроля доступа к каналу; значения отправителя должны поступать от адаптера канала, а не из текста сообщения.
channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> или "*". Идентификаторы каналов представляют собой канонические идентификаторы OpenClaw; такие псевдонимы, как teams, нормализуются в msteams. Устаревшие ключи без префикса принимаются только как id:. Порядок сопоставления: канал+идентификатор, идентификатор, e164, имя пользователя, имя, затем подстановочный знак.
Значение agents.list[].tools.toolsBySender для конкретного агента переопределяет глобальное сопоставление отправителя при совпадении, даже если политика {} пуста.
tools.elevated
Управляет расширенным доступом к выполнению команд вне песочницы:
- Переопределение для отдельного агента (
agents.list[].tools.elevated) может только дополнительно ограничивать. /elevated on|off|ask|fullхранит состояние отдельно для каждого сеанса; встроенные директивы применяются к одному сообщению.- Повышенный режим
execобходит песочницу и использует настроенный путь выхода (gatewayпо умолчанию илиnode, когда целью выполнения являетсяnode).
tools.exec
applyPatch.allowModels (по умолчанию пусто/не задано, то есть apply_patch может использовать любая совместимая модель). approvalRunningNoticeMs выводит уведомление о продолжающемся выполнении, если выполнение с подтверждением занимает много времени; 0 отключает его.
tools.loopDetection
Проверки безопасности цикла инструментов по умолчанию отключены. Чтобы включить обнаружение, задайте enabled: true. Параметры можно определить глобально в tools.loopDetection и переопределить для отдельного агента в agents.list[].tools.loopDetection.
number
Максимальное количество вызовов инструментов в истории, сохраняемой для анализа циклов.
number
Порог повторяющегося шаблона без прогресса для выдачи предупреждений.
number
После указанного количества неудач блокирует повторные вызовы инструмента с тем же недоступным или неизвестным именем.
number
Повышенный порог повторений для блокировки критических циклов.
number
Порог полной остановки любого выполнения без прогресса.
boolean
Предупреждать о повторных вызовах того же инструмента с теми же аргументами.
boolean
Предупреждать или блокировать известные инструменты опроса (
process.poll, command_status и т. д.).boolean
Предупреждать или блокировать чередующиеся парные шаблоны без прогресса.
number
Количество попыток после автоматической Compaction, в течение которых защита остаётся активной; выполнение прерывается, если агент повторяет ту же комбинацию (инструмент, аргументы, результат) в пределах этого окна.
tools.web
provider и userAgent. Значение maxResponseBytes ограничивается диапазоном 32000–10000000; значение maxChars ограничивается значением maxCharsCap (увеличьте maxCharsCap, чтобы разрешить ответы большего размера).
tools.media
Настраивает распознавание входящих медиафайлов (изображений, аудио и видео):
concurrency (по умолчанию 2), audio.maxBytes (по умолчанию 20 MB) и video.maxBytes (по умолчанию 50 MB) показаны со значениями по умолчанию; значение image.maxBytes по умолчанию равно 10 MB. Тайм-ауты запросов по умолчанию для отдельных возможностей: изображения и аудио — 60 с, видео — 120 с.
Поля записи модели для медиафайлов
Поля записи модели для медиафайлов
Запись провайдера (
type: "provider" или не указано):provider: идентификатор API-провайдера (openai,anthropic,google/gemini,groqи т. д.)model: переопределение идентификатора моделиprofile/preferredProfile: выбор профиляauth-profiles.json
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
tools.sessions
Определяет, к каким сеансам могут обращаться инструменты сеансов (sessions_list, sessions_history, sessions_send).
По умолчанию: tree (текущий сеанс и созданные им сеансы, например субагенты).
Области видимости
Области видимости
self: только ключ текущего сеанса.tree: текущий сеанс и созданные им сеансы (субагенты).agent: любой сеанс, принадлежащий текущему идентификатору агента (может включать других пользователей, если сеансы отдельных отправителей выполняются с одним идентификатором агента).all: любой сеанс. Для обращения к другому агенту по-прежнему требуетсяtools.agentToAgent.- Ограничение песочницы: если текущий сеанс выполняется в песочнице и
agents.defaults.sandbox.sessionToolsVisibility="spawned"(значение по умолчанию), видимость принудительно устанавливается вtree, даже еслиtools.sessions.visibility="all". - Если значение не равно
all,sessions_listсодержит компактное полеvisibility, описывающее фактический режим и предупреждающее, что некоторые сеансы за пределами текущей области могут быть опущены.
tools.sessions_spawn
Управляет поддержкой встроенных вложений для sessions_spawn.
Примечания о вложениях
Примечания о вложениях
- Для вложений требуется
enabled: true. - Вложения субагента размещаются в дочернем рабочем пространстве по пути
.openclaw/attachments/<uuid>/вместе с.manifest.json. - Вложения ACP могут содержать только изображения и передаются встроенными в среду выполнения ACP после проверки тех же ограничений на количество файлов, размер отдельного файла и общий размер.
- Содержимое вложений автоматически редактируется при сохранении расшифровки.
- Входные данные Base64 проверяются на строгое соответствие алфавиту и заполнению, а также на размер до декодирования.
- Для каталогов вложений субагента устанавливаются разрешения
0700, а для файлов —0600. - Очистка субагента выполняется согласно политике
cleanup:deleteвсегда удаляет вложения;keepсохраняет их только приretainOnSessionKeep: true.
tools.experimental
Экспериментальные флаги встроенных инструментов. По умолчанию отключены, если не применяется правило автоматического включения для GPT-5 в строгом агентном режиме.
planTool: включает структурированный инструментupdate_planдля отслеживания нетривиальной многоэтапной работы.- По умолчанию:
false, если толькоagents.defaults.embeddedAgent.executionContract(или переопределение для отдельного агента) не задано как"strict-agentic"для выполнения через провайдераopenaiс идентификатором модели семейства GPT-5 (это также относится к запускам OpenAI Codex CLI, поскольку маршрутизация аутентификации и моделей Codex выполняется через провайдераopenai). Задайтеtrue, чтобы принудительно включить инструмент вне этой области, илиfalse, чтобы оставить его отключённым даже для запусков GPT-5 в строгом агентном режиме. - Когда инструмент включён, в системную подсказку также добавляются рекомендации по использованию, чтобы модель применяла его только для существенной работы и поддерживала не более одного шага
in_progress.
agents.defaults.subagents
model: модель по умолчанию для создаваемых субагентов. Если параметр не указан, субагенты наследуют модель вызывающего агента.allowAgents: список разрешённых по умолчанию идентификаторов настроенных целевых агентов дляsessions_spawn, когда запрашивающий агент не задаёт собственныйsubagents.allowAgents(["*"]= любой настроенный целевой агент; по умолчанию: только тот же агент). Устаревшие записи, конфигурация агента для которых была удалена, отклоняются командойsessions_spawnи не включаются в выводagents_list; выполнитеopenclaw doctor --fix, чтобы удалить их.maxConcurrent: максимальное количество одновременно выполняющихся субагентов. По умолчанию:8.runTimeoutSeconds: тайм-аут (в секундах) дляsessions_spawn, когда вызывающая сторона не передаёт собственное переопределение. По умолчанию:0(без тайм-аута); указанное выше значение900часто задаётся явно, но не является встроенным значением по умолчанию.announceTimeoutMs: тайм-аут каждого вызова (в миллисекундах) для попыток доставки объявленияagentчерез Gateway. По умолчанию:120000. Из-за повторных попыток после временных сбоев общее ожидание объявления может превышать один настроенный тайм-аут.archiveAfterMinutes: количество минут после завершения сеанса субагента до его автоматического архивирования. По умолчанию:60;0отключает автоматическое архивирование.- Политика инструментов для каждого субагента:
tools.subagents.tools.allow/tools.subagents.tools.deny.
Пользовательские провайдеры и базовые URL-адреса
Плагины провайдеров публикуют собственные строки каталога моделей. Добавляйте пользовательских провайдеров черезmodels.providers в конфигурации или ~/.openclaw/agents/<agentId>/agent/models.json.
Настройка baseUrl пользовательского или локального провайдера также является узким решением о сетевом доверии для HTTP-запросов к моделям: OpenClaw разрешает именно источник scheme://host:port через защищённый путь получения данных, не добавляя отдельный параметр конфигурации и не доверяя другим частным источникам.
Аутентификация и приоритет объединения
Аутентификация и приоритет объединения
- Для нестандартных требований к аутентификации используйте
authHeader: true+headers. - Переопределите корневой каталог конфигурации агента с помощью
OPENCLAW_AGENT_DIR. - Приоритет объединения для совпадающих идентификаторов провайдеров:
- Непустые значения
baseUrlвmodels.jsonагента имеют приоритет. - Непустые значения
apiKeyагента имеют приоритет, только если этот провайдер не управляется через SecretRef в текущем контексте конфигурации или профиля аутентификации. - Значения
apiKeyпровайдера, управляемого через SecretRef, обновляются из маркеров источника (ENV_VAR_NAMEдля ссылок на переменные среды,secretref-managedдля ссылок на файл или команду) вместо сохранения разрешённых секретов. - Значения заголовков провайдера, управляемого через SecretRef, обновляются из маркеров источника (
secretref-env:ENV_VAR_NAMEдля ссылок на переменные среды,secretref-managedдля ссылок на файл или команду). - Пустые или отсутствующие значения
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,openai-chatgpt-responses,anthropic-messages,google-generative-ai,google-vertex,github-copilot,bedrock-converse-stream,ollama,azure-openai-responses). Для самостоятельно размещённых серверных систем/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, разрешить HTTP-запросам к провайдеру моделей обращаться к частным диапазонам, диапазонам CGNAT и аналогичным диапазонам через защиту HTTP-запросов провайдера. Базовые URL-адреса пользовательских или локальных провайдеров уже обеспечивают доверие точно настроенному источнику, кроме источников метаданных и локальных адресов канала, которые остаются заблокированными без явного разрешения. Установите значениеfalse, чтобы отказаться от доверия точному источнику. WebSocket использует тот жеrequestдля заголовков и TLS, но не использует эту защиту получения данных от SSRF. По умолчанию: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: необязательная подсказка о полезной нагрузке рассуждений. Используйте"together"дляreasoning.enabledв стиле Together,"qwen"дляenable_thinkingверхнего уровня или"qwen-chat-template"дляchat_template_kwargs.enable_thinkingна совместимых с OpenAI серверах семейства Qwen, которые поддерживают аргументы шаблона чата на уровне запроса, например vLLM. Настроенные модели Qwen в vLLM предоставляют двоичный выбор/think(off,on) для этих форматов.models.providers.*.models.*.compat.requiresReasoningContentOnAssistantMessages: необязательная подсказка совместимости для серверных систем Chat Completions в стиле DeepSeek, которым требуется сохранятьreasoning_contentв предыдущих сообщениях ассистента при повторном воспроизведении. Если заданоtrue, OpenClaw сохраняет это поле в исходящих сообщениях ассистента. Используйте этот параметр при подключении пользовательского прокси, совместимого с DeepSeek, который отклоняет запросы после удаления рассуждений. По умолчанию:false.
Обнаружение Amazon Bedrock
Обнаружение 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: резервное максимальное количество выходных токенов для обнаруженных моделей.
o1/o3/o4, Claude, Gemini, любые идентификаторы с суффиксом -vl (Qwen-VL и аналогичные), а также такие именованные семейства, как LLaVA, Pixtral, InternVL, Mllama, MiniCPM-V и GLM-4V; для известных семейств, поддерживающих только текст (Llama, DeepSeek, Mistral/Mixtral, Kimi/Moonshot, Codestral, Devstral, Phi, QwQ, CodeLlama и идентификаторы Qwen без суффикса vl/vision), дополнительный вопрос пропускается. Для неизвестных идентификаторов моделей по-прежнему выводится запрос о поддержке изображений. При неинтерактивной настройке используется та же логика определения; передайте --custom-image-input, чтобы принудительно задать метаданные с поддержкой изображений, или --custom-text-input, чтобы принудительно задать метаданные только для текста.
Примеры провайдеров
Cerebras (GLM 4.7 / GPT OSS)
Cerebras (GLM 4.7 / GPT OSS)
Официальный внешний плагин провайдера Используйте
cerebras может настроить это через openclaw onboard --auth-choice cerebras-api-key. Явную конфигурацию провайдера следует использовать только для переопределения значений по умолчанию.cerebras/zai-glm-4.7 для Cerebras; zai/glm-4.7 — для прямого подключения к Z.AI.Kimi Coding
Kimi Coding
openclaw onboard --auth-choice kimi-code-api-key.Локальные модели (LM Studio)
Локальные модели (LM Studio)
См. Локальные модели. Кратко: запускайте крупную локальную модель через LM Studio Responses API на достаточно мощном оборудовании; сохраняйте объединённую конфигурацию размещённых моделей для резервного переключения.
MiniMax M3 (напрямую)
MiniMax M3 (напрямую)
MINIMAX_API_KEY. Быстрая настройка: openclaw onboard --auth-choice minimax-global-api или openclaw onboard --auth-choice minimax-cn-api. В каталоге моделей по умолчанию используется M3, также в него входят варианты M2.7. При потоковой передаче по пути, совместимому с Anthropic, OpenClaw по умолчанию отключает режим рассуждений MiniMax M2.x, если вы сами явно не зададите thinking; MiniMax-M3 (и M3.x) по умолчанию остаётся на пути провайдера с отсутствующим или адаптивным режимом рассуждений. /fast on или params.fastMode: true заменяет MiniMax-M2.7 на MiniMax-M2.7-highspeed.Moonshot AI (Kimi)
Moonshot AI (Kimi)
baseUrl: "https://api.moonshot.cn/v1" или openclaw onboard --auth-choice moonshot-api-key-cn.Собственные конечные точки Moonshot заявляют совместимость со статистикой использования при потоковой передаче через общий транспорт openai-completions, и OpenClaw определяет её по возможностям конечной точки, а не только по идентификатору встроенного провайдера.OpenCode
OpenCode
OPENCODE_API_KEY (или OPENCODE_ZEN_API_KEY). Используйте ссылки opencode/... для каталога Zen или ссылки opencode-go/... для каталога Go. Быстрая настройка: openclaw onboard --auth-choice opencode-zen или openclaw onboard --auth-choice opencode-go.Synthetic (совместимый с Anthropic)
Synthetic (совместимый с Anthropic)
/v1 (клиент Anthropic добавляет его самостоятельно). Быстрая настройка: openclaw onboard --auth-choice synthetic-api-key.Z.AI (GLM-4.7)
Z.AI (GLM-4.7)
ZAI_API_KEY. В ссылках на модели используется канонический идентификатор провайдера zai/*. Быстрая настройка: openclaw onboard --auth-choice zai-api-key.- Общая конечная точка:
https://api.z.ai/api/paas/v4 - Конечная точка для программирования:
https://api.z.ai/api/coding/paas/v4 - Вариант аутентификации
zai-api-key, используемый по умолчанию, проверяет ваш ключ и автоматически определяет, к какой конечной точке он относится (если результат неоднозначен, выводится запрос с вариантом Global по умолчанию). Для явного выбора также доступны отдельные варианты аутентификации CN и Coding-Plan. - Для общей конечной точки определите пользовательского провайдера с переопределением базового URL.
Связанные разделы
- Конфигурация — агенты
- Конфигурация — каналы
- Справочник по конфигурации — другие ключи верхнего уровня
- Инструменты и плагины