Środowiska uruchomieniowe agentów

• Osadzone harnessy działają wewnątrz przygotowanej pętli agenta OpenClaw. Obecnie jest to wbudowane środowisko openclaw oraz zarejestrowane harnessy Plugin, takie jak codex i copilot.
• Backendy CLI uruchamiają lokalny proces CLI, zachowując kanoniczną referencję modelu. Na przykład anthropic/claude-opus-4-8 z zakreśloną do modelu wartością agentRuntime.id: "claude-cli" znaczy „wybierz model Anthropic, wykonaj przez Claude CLI”. claude-cli nie jest identyfikatorem osadzonego harnessa i nie wolno przekazywać go do wyboru AgentHarness.

​

Powierzchnie Codex

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

1. Jeśli użytkownik prosi o wiązanie/sterowanie/wątek/wznowienie/sterowanie/zatrzymanie Codex, użyj natywnej powierzchni poleceń /codex, gdy dołączony Plugin codex jest włączony.
2. Jeśli użytkownik prosi o Codex jako osadzone środowisko uruchomieniowe albo chce normalnego doświadczenia agenta Codex wspieranego subskrypcją, użyj openai/<model>.
3. Jeśli użytkownik wyraźnie wybiera OpenClaw dla modelu OpenAI, zachowaj referencję modelu jako openai/<model> i ustaw politykę środowiska dostawcy/modelu na agentRuntime.id: "openclaw". Wybrany profil OAuth openai jest wewnętrznie routowany przez transport uwierzytelniania Codex OpenClaw.
4. Jeśli starsza konfiguracja nadal zawiera starsze referencje modeli Codex, napraw ją do openai/<model> za pomocą openclaw doctor --fix; doctor zachowuje trasę uwierzytelniania Codex przez dodanie agentRuntime.id: "codex" o zakresie dostawcy/modelu tam, gdzie sugerowała to stara referencja modelu. Starsze referencje modeli codex-cli/* są naprawiane do tej samej trasy Codex app-server openai/<model>; OpenClaw nie utrzymuje już dołączonego backendu Codex CLI.
5. Jeśli użytkownik wyraźnie mówi ACP, acpx lub adapter Codex ACP, użyj ACP z runtime: "acp" i agentId: "codex".
6. Jeśli prośba dotyczy Claude Code, Gemini CLI, OpenCode, Cursor, Droid lub innego zewnętrznego harnessa, użyj ACP/acpx, a nie natywnego środowiska podagenta.

​

Własność środowiska uruchomieniowego

• Jeśli OpenClaw posiada powierzchnię, OpenClaw może zapewnić normalne zachowanie hooków Plugin.
• Jeśli natywne środowisko posiada powierzchnię, OpenClaw potrzebuje zdarzeń środowiska lub natywnych hooków.
• Jeśli natywne środowisko posiada kanoniczny stan wątku, OpenClaw powinien tworzyć lustrzaną kopię i projektować kontekst, a nie przepisywać nieobsługiwane elementy wewnętrzne.

​

Wybór środowiska uruchomieniowego

1. Wygrywa polityka środowiska o zakresie modelu. Może znajdować się w skonfigurowanym wpisie modelu dostawcy albo w agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime. Wieloznaczny wpis dostawcy, taki jak agents.defaults.models["vllm/*"].agentRuntime, ma zastosowanie po dokładnej polityce modelu, więc dynamicznie wykryte modele dostawcy mogą współdzielić jedno środowisko bez nadpisywania dokładnych wyjątków dla poszczególnych modeli.
2. Następna jest polityka środowiska o zakresie dostawcy w models.providers.<provider>.agentRuntime.
3. W trybie auto zarejestrowane środowiska Plugin mogą zgłaszać obsługiwane pary dostawca/model.
4. Jeśli żadne środowisko nie zgłosi tury w trybie auto, OpenClaw używa openclaw jako środowiska zgodności. Użyj jawnego identyfikatora środowiska, gdy uruchomienie musi być ścisłe.

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

​

Środowisko uruchomieniowe agenta GitHub Copilot

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

​

Kontrakt zgodności

​

Etykiety statusu

• Odwołanie do modelu, takie jak openai/gpt-5.5, wskazuje wybranego dostawcę/model.
• Identyfikator środowiska uruchomieniowego, taki jak codex, wskazuje, która pętla wykonuje turę.
• Etykieta kanału, taka jak Telegram lub Discord, wskazuje, gdzie odbywa się rozmowa.

​

Powiązane

• Harness Codex
• Środowisko uruchomieniowe harnessu Codex
• Środowisko uruchomieniowe agenta GitHub Copilot
• OpenAI
• Pluginy harnessu agenta
• Pętla agenta
• Modele
• Status