Середовища виконання агентів

• Вбудовані harnesses працюють усередині підготовленого циклу агента OpenClaw. Сьогодні це вбудоване середовище виконання openclaw плюс зареєстровані Plugin harnesses, як-от codex і copilot.
• CLI-бекенди запускають локальний процес CLI, зберігаючи посилання на модель канонічним. Наприклад, anthropic/claude-opus-4-8 із політикою agentRuntime.id: "claude-cli" в області моделі означає «вибрати модель Anthropic, виконати через Claude CLI». claude-cli не є ідентифікатором вбудованого harness і не має передаватися до вибору AgentHarness.

​

Поверхні Codex

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

1. Якщо користувач просить Codex bind/control/thread/resume/steer/stop, використовуйте нативну поверхню команд /codex, коли вбудований Plugin codex увімкнено.
2. Якщо користувач просить Codex як вбудоване середовище виконання або хоче звичайний досвід агента Codex із підтримкою підписки, використовуйте openai/<model>.
3. Якщо користувач явно вибирає OpenClaw для моделі OpenAI, збережіть посилання на модель як openai/<model> і встановіть політику середовища виконання провайдера/моделі на agentRuntime.id: "openclaw". Вибраний OAuth-профіль openai маршрутизується внутрішньо через транспорт автентифікації Codex OpenClaw.
4. Якщо застаріла конфігурація досі містить застарілі посилання на моделі Codex, відремонтуйте її до openai/<model> за допомогою openclaw doctor --fix; doctor зберігає маршрут автентифікації Codex, додаючи agentRuntime.id: "codex" в області провайдера/моделі там, де старе посилання на модель це передбачало. Застарілі посилання на моделі codex-cli/* ремонтуються до того самого маршруту app-server Codex openai/<model>; OpenClaw більше не зберігає вбудований бекенд Codex CLI.
5. Якщо користувач явно каже ACP, acpx або адаптер Codex ACP, використовуйте ACP з runtime: "acp" і agentId: "codex".
6. Якщо запит стосується Claude Code, Gemini CLI, OpenCode, Cursor, Droid або іншого зовнішнього harness, використовуйте ACP/acpx, а не нативне середовище виконання під-агента.

​

Володіння середовищем виконання

• Якщо OpenClaw володіє поверхнею, OpenClaw може надавати звичайну поведінку Plugin hooks.
• Якщо нативне середовище виконання володіє поверхнею, OpenClaw потрібні події середовища виконання або нативні хуки.
• Якщо нативне середовище виконання володіє канонічним станом потоку, OpenClaw має дзеркалити і проєктувати контекст, а не переписувати непідтримувані внутрішні частини.

​

Вибір середовища виконання

1. Політика середовища виконання в області моделі має пріоритет. Вона може жити в налаштованому записі моделі провайдера або в agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime. Маска провайдера, як-от agents.defaults.models["vllm/*"].agentRuntime, застосовується після точної політики моделі, тож динамічно виявлені моделі провайдера можуть спільно використовувати одне середовище виконання, не перевизначаючи точних винятків для окремих моделей.
2. Далі йде політика середовища виконання в області провайдера в models.providers.<provider>.agentRuntime.
3. У режимі auto зареєстровані Plugin runtimes можуть заявляти підтримувані пари провайдер/модель.
4. Якщо жодне середовище виконання не заявляє хід у режимі auto, OpenClaw використовує openclaw як сумісне середовище виконання. Використовуйте явний ідентифікатор середовища виконання, коли запуск має бути строгим.

{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-8",
      models: {
        "anthropic/claude-opus-4-8": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

​

Середовище виконання агента GitHub Copilot

{
  agents: {
    defaults: {
      model: "github-copilot/gpt-5.5",
      models: {
        "github-copilot/gpt-5.5": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
}

​

Контракт сумісності

​

Мітки статусу

• Посилання на модель, як-от openai/gpt-5.5, вказує вибраного провайдера/модель.
• Ідентифікатор середовища виконання, як-от codex, вказує, який цикл виконує хід.
• Мітка каналу, як-от Telegram або Discord, вказує, де відбувається розмова.

​

Пов’язане

• Обв’язка Codex
• Середовище виконання обв’язки Codex
• Середовище виконання агента GitHub Copilot
• OpenAI
• Плагіни обв’язки агента
• Цикл агента
• Моделі
• Статус