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

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• Вбудовані harnesses працюють усередині підготовленого агентного циклу OpenClaw. Нині це вбудоване середовище виконання pi плюс зареєстровані plugin harnesses, як-от codex.
• CLI-бекенди запускають локальний процес CLI, зберігаючи канонічне посилання на модель. Наприклад, anthropic/claude-opus-4-7 із 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. Якщо користувач явно вибирає PI для моделі OpenAI, збережіть посилання на модель як openai/<model> і встановіть політику середовища виконання провайдера/моделі як agentRuntime.id: "pi". Вибраний профіль автентифікації openai-codex маршрутизується всередині через застарілий транспорт Codex-auth PI.
4. Якщо застаріла конфігурація все ще містить openai-codex/* посилання на моделі, виправте її на openai/<model> за допомогою openclaw doctor --fix; doctor зберігає маршрут автентифікації Codex, додаючи agentRuntime.id: "codex" на рівні провайдера/моделі там, де старе посилання на модель це передбачало.
5. Якщо користувач явно каже ACP, acpx або адаптер Codex ACP, використовуйте ACP з runtime: "acp" і agentId: "codex".
6. Якщо запит стосується Claude Code, Gemini CLI, OpenCode, Cursor, Droid або іншого зовнішнього harness, використовуйте ACP/acpx, а не нативне середовище виконання sub-agent.

​

Відповідальність середовища виконання

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

​

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

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

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

​

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

​

Мітки стану

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

​

Пов’язане

• Codex harness
• Середовище виконання Codex harness
• OpenAI
• Plugins агентного harness
• Цикл агента
• Моделі
• Стан