Средство выполнения — это реализация, предоставляющая среду выполнения агента
(термин в коде). Например, встроенное средство выполнения Codex реализует среду выполнения
codex.
В общедоступной конфигурации используется agentRuntime.id в записях провайдера или модели; ключи
среды выполнения на уровне всего агента устарели и игнорируются. openclaw doctor --fix удаляет старые
закрепления среды выполнения на уровне всего агента и преобразует устаревшие ссылки на модели среды выполнения
в канонические ссылки провайдер/модель, а при необходимости добавляет политику среды выполнения
на уровне модели.
Два семейства сред выполнения:
- Встроенные средства выполнения работают внутри подготовленного цикла агента OpenClaw:
встроенная среда выполнения
openclaw, а также зарегистрированные средства выполнения плагинов, напримерcodexиcopilot. - CLI-бэкенды запускают локальный процесс CLI, сохраняя каноническую
ссылку на модель. Например,
anthropic/claude-opus-4-8с параметромagentRuntime.id: "claude-cli"на уровне модели означает: «выбрать модель Anthropic и выполнить через Claude CLI».claude-cliне является идентификатором встроенного средства выполнения, и его нельзя передавать при выборе AgentHarness.
copilot — это отдельное подключаемое внешнее средство выполнения плагина для
GitHub Copilot CLI; описание выбора между PI, Codex и средой выполнения агента GitHub Copilot
с точки зрения пользователя см. в разделе Среда выполнения агента GitHub Copilot.
Интерфейсы Codex
Название Codex используется в нескольких интерфейсах:
Эти интерфейсы намеренно независимы. Включение плагина
codex
делает доступными нативные возможности app-server; openclaw doctor --fix отвечает за
исправление устаревших маршрутов Codex и очистку устаревших закреплений сеансов. Выбор openai/*
для модели агента теперь означает «выполнить это через Codex», если не используется
неагентский интерфейс OpenAI API.
В обычной конфигурации подписки ChatGPT/Codex для аутентификации используется Codex OAuth,
но ссылка на модель остаётся openai/*, а средой выполнения выбирается codex:
codex включён, используйте нативный интерфейс команд /codex
(/codex bind, /codex threads, /codex resume, /codex steer,
/codex stop) для управления Codex на естественном языке вместо ACP. Используйте ACP для
Codex только при явном запросе ACP/acpx или при тестировании пути
адаптера ACP. Claude Code, Gemini CLI, OpenCode, Cursor и аналогичные внешние
средства выполнения по-прежнему используют ACP.
Дерево решений:
- Привязка/управление/поток/возобновление/направление/остановка Codex -> нативный интерфейс команд
/codex, когда включён встроенный плагинcodex. - Codex как встроенная среда выполнения или обычный интерфейс агента Codex на основе подписки ->
openai/<model>. - OpenClaw явно выбран для модели OpenAI -> сохраните ссылку на модель как
openai/<model>и задайте для политики среды выполнения провайдера/модели значениеagentRuntime.id: "openclaw". Выбранный профиль OAuthopenaiвнутренне направляется через транспорт аутентификации Codex в OpenClaw. - Устаревшие ссылки на модели Codex в конфигурации -> исправьте с помощью
openclaw doctor --fix, преобразовав вopenai/<model>; doctor сохраняет маршрут аутентификации Codex, добавляяagentRuntime.id: "codex"на уровне провайдера/модели там, где на него указывала старая ссылка на модель. Устаревшие ссылки на моделиcodex-cli/*преобразуются в тот же маршрут app-server Codexopenai/<model>; OpenClaw больше не содержит встроенный CLI-бэкенд Codex. - Явно запрошен ACP, acpx или адаптер Codex ACP ->
runtime: "acp"иagentId: "codex". - Claude Code, Gemini CLI, OpenCode, Cursor, Droid или другое внешнее средство выполнения -> ACP/acpx, а не нативная среда выполнения субагента.
Описание разделения префиксов семейства OpenAI см. в разделах OpenAI и
Провайдеры моделей. Контракт поддержки среды выполнения Codex
см. в разделе Среда выполнения средства Codex.
Владение средой выполнения
Разные среды выполнения управляют разными частями цикла:
Правило проектирования: если интерфейсом управляет OpenClaw, он может обеспечивать обычное
поведение хуков плагинов. Если интерфейсом управляет нативная среда выполнения, OpenClaw требуются
события среды выполнения или нативные хуки. Если нативная среда выполнения управляет каноническим
состоянием потока, OpenClaw зеркалирует и проецирует контекст, а не изменяет неподдерживаемые
внутренние механизмы.
Выбор среды выполнения
OpenClaw разрешает встроенную среду выполнения после разрешения провайдера и модели в следующем порядке:- Политика среды выполнения на уровне модели имеет приоритет. Она находится в настроенной записи модели
провайдера либо в
agents.defaults.models["provider/model"].agentRuntime/agents.list[].models["provider/model"].agentRuntime. Подстановочный шаблон провайдера, напримерagents.defaults.models["vllm/*"].agentRuntime, применяется после точной политики модели, поэтому динамически обнаруженные модели провайдера могут совместно использовать одну среду выполнения, не переопределяя точечные исключения для отдельных моделей. - Политика среды выполнения на уровне провайдера:
models.providers.<provider>.agentRuntime. - Режим
auto: зарегистрированные среды выполнения плагинов могут заявлять поддержку пар провайдер/модель. - Если в режиме
autoникто не принимает ход, OpenClaw откатывается кopenclawкак к среде выполнения для совместимости. Используйте явный идентификатор среды выполнения, когда выполнение должно быть строгим.
OPENCLAW_AGENT_RUNTIME,
состояние сеанса agentHarnessId/agentRuntimeOverride, agents.defaults.agentRuntime
и agents.list[].agentRuntime. Выполните openclaw doctor --fix, чтобы удалить устаревшую
конфигурацию среды выполнения на уровне всего агента и преобразовать устаревшие ссылки на модели среды выполнения
там, где исходное намерение можно сохранить.
Явно заданные среды выполнения плагинов на уровне провайдера/модели завершаются с ошибкой при несовпадении:
agentRuntime.id: "codex" для провайдера или модели означает Codex либо понятную ошибку выбора/среды выполнения —
маршрутизация обратно в OpenClaw никогда не выполняется без уведомления. Только auto может направить
неподходящий ход в OpenClaw.
Псевдонимы CLI-бэкендов отличаются от идентификаторов встроенных средств выполнения. Предпочтительная форма Claude CLI:
claude-cli/claude-opus-4-7, продолжают поддерживаться
для совместимости, но в новой конфигурации следует сохранять канонические провайдер/модель,
а бэкенд выполнения указывать в политике среды выполнения провайдера/модели.
Устаревшие ссылки codex-cli/* отличаются: doctor преобразует их в openai/*, чтобы
они выполнялись через средство app-server Codex, а не сохраняли CLI-бэкенд Codex.
Режим auto намеренно консервативен для большинства провайдеров. Агентские модели OpenAI
являются исключением: как отсутствие среды выполнения, так и auto разрешаются в средство
Codex. Явная конфигурация среды выполнения OpenClaw остаётся совместимым маршрутом, включаемым
по желанию для ходов агента openai/*; при использовании с выбранным профилем OAuth openai
OpenClaw внутренне направляет этот путь через транспорт аутентификации Codex,
сохраняя общедоступную ссылку на модель как openai/*. Устаревшие закрепления среды выполнения
сеансов OpenAI игнорируются при выборе среды выполнения и могут быть удалены с помощью
openclaw doctor --fix.
Если openclaw doctor предупреждает, что плагин codex включён, а в конфигурации
остались устаревшие ссылки на модели Codex, считайте это устаревшим состоянием маршрутизации и выполните
openclaw doctor --fix, чтобы заменить их на openai/* со средой выполнения Codex.
Среда выполнения агента GitHub Copilot
Внешний плагин@openclaw/copilot регистрирует включаемую по запросу среду выполнения copilot,
работающую на базе GitHub Copilot CLI (@github/copilot-sdk). Она заявляет
канонический провайдер подписки github-copilot и никогда не выбирается
auto. Включите её для отдельной модели или провайдера через agentRuntime.id:
extensions/copilot/doctor-contract-api.ts, который
автоматически загружает openclaw doctor. Сведения о конфигурации, аутентификации, зеркалировании транскриптов, Compaction,
декларативном контракте doctor и более широком выборе SDK между PI, Codex и Copilot
см. в разделе Среда выполнения агента GitHub Copilot.
Контракт совместимости
Если среда выполнения не является OpenClaw, в её документации должно быть указано, какие возможности OpenClaw она поддерживает:
Контракт поддержки среды выполнения Codex описан в разделе
Среда выполнения обвязки Codex.
Метки состояния
В выводе состояния могут отображаться меткиExecution и Runtime. Рассматривайте их как
диагностические данные, а не как имена провайдеров:
- Ссылка на модель, например
openai/gpt-5.6-sol, обозначает выбранные провайдер и модель. - Идентификатор среды выполнения, например
codex, обозначает цикл, выполняющий ход. - Метка канала, например Telegram или Discord, обозначает, где происходит разговор.