Pluginy środowiska wykonawczego agenta

​

Kiedy używać środowiska wykonawczego

• natywny serwer agenta programistycznego, który zarządza wątkami i Compaction
• lokalny CLI lub demon, który musi strumieniować natywne zdarzenia planu, rozumowania i narzędzi
• środowisko uruchomieniowe modelu, które oprócz transkrypcji sesji OpenClaw wymaga własnego identyfikatora wznowienia

​

Za co nadal odpowiada rdzeń

• dostawcę i model
• stan uwierzytelniania środowiska uruchomieniowego, chyba że środowisko wykonawcze deklaruje, że odpowiada za inicjalizację uwierzytelniania
• poziom rozumowania i budżet kontekstu
• plik transkrypcji/sesji OpenClaw
• obszar roboczy, piaskownicę i zasady dotyczące narzędzi
• wywołania zwrotne odpowiedzi kanału i wywołania zwrotne przesyłania strumieniowego
• zasady awaryjnego wyboru modelu i przełączania modelu na żywo

​

Inicjalizacja uwierzytelniania zarządzana przez środowisko wykonawcze

​

Zweryfikowane artefakty środowiska uruchomieniowego konfiguracji

• runtimePlan.tools.normalize(...) i runtimePlan.tools.logDiagnostics(...) dla zależnych od dostawcy zasad schematu narzędzi
• runtimePlan.transcript.resolvePolicy(...) dla zasad oczyszczania transkrypcji i naprawiania wywołań narzędzi
• runtimePlan.delivery.isSilentPayload(...) dla współdzielonego NO_REPLY i wyłączania dostarczania multimediów
• runtimePlan.outcome.classifyRunResult(...) dla klasyfikacji awaryjnego wyboru modelu
• runtimePlan.observability dla określonych metadanych dostawcy/modelu/środowiska wykonawczego

​

Kontrakt transportu żądania

• runtimePolicy.compatibleIds zawiera identyfikatory środowisk uruchomieniowych, które dostawca deklaruje jako zgodne z daną trasą. Brak zasad oznacza, że dostawca nie zadeklarował zgodności na poziomie trasy; nie stanowi to pozwolenia na założenie obsługi.
• requestTransportOverrides: "none" oznacza, że nie trzeba odtwarzać żadnego jawnie zdefiniowanego nadpisania żądania dostawcy/modelu. "present" oznacza, że istnieją jawnie zdefiniowane nagłówki, transport uwierzytelniania, proxy, TLS, zachowanie usługi lokalnej lub sieci prywatnej albo parametry żądania. Fakt ten nie ujawnia tych wartości.

​

Rejestrowanie środowiska wykonawczego

import type { AgentHarness } from "openclaw/plugin-sdk/agent-harness";
import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";

const myHarness: AgentHarness = {
  id: "my-harness",
  label: "Moje natywne środowisko wykonawcze agenta",

  supports(ctx) {
    const routeSupportsHarness =
      ctx.modelProvider?.runtimePolicy?.compatibleIds.includes("my-harness") === true;
    const canReproduceRequest = ctx.modelProvider?.requestTransportOverrides !== "present";
    return ctx.provider === "my-provider" && routeSupportsHarness && canReproduceRequest
      ? { supported: true, priority: 100 }
      : { supported: false, reason: "efektywna trasa nie jest zgodna ze środowiskiem wykonawczym" };
  },

  async runAttempt(params) {
    // Uruchom lub wznów natywny wątek.
    // Użyj params.prompt, params.tools, params.images, params.onPartialReply,
    // params.onAgentEvent oraz pozostałych pól przygotowanej próby.
    return await runMyNativeTurn(params);
  },
};

export default definePluginEntry({
  id: "my-native-agent",
  name: "Mój natywny agent",
  description: "Uruchamia wybrane modele za pośrednictwem natywnego demona agenta.",
  register(api) {
    api.registerAgentHarness(myHarness);
  },
});

​

Delegowane wykonywanie

​

Zasady wyboru

1. Pierwszeństwo mają zasady środowiska uruchomieniowego dotyczące modelu.
2. Następne są zasady środowiska uruchomieniowego dotyczące dostawcy.
3. auto pyta zarejestrowane środowiska wykonawcze, czy obsługują określoną efektywną trasę. Same prefiksy dostawcy/modelu nigdy nie wybierają środowiska wykonawczego.
4. Jeśli żadne zarejestrowane środowisko wykonawcze nie pasuje, OpenClaw używa osadzonego środowiska uruchomieniowego.

​

Parowanie dostawcy ze środowiskiem wykonawczym

• preferowane odwołania do modeli użytkownika: openai/gpt-5.6-sol
• odwołania zgodności: starsze odwołania codex/gpt-* pozostają akceptowane, ale nowe konfiguracje nie powinny używać ich jako standardowych odwołań dostawcy/modelu
• identyfikator środowiska wykonawczego: codex
• uwierzytelnianie: syntetyczna dostępność dostawcy, ponieważ środowisko wykonawcze Codex zarządza natywnym logowaniem/sesją Codex
• żądanie serwera aplikacji: OpenClaw wysyła sam identyfikator modelu do Codex i pozwala środowisku wykonawczemu komunikować się z natywnym protokołem serwera aplikacji

​

Oprogramowanie pośredniczące wyników narzędzi

​

Klasyfikacja wyniku końcowego

​

Efekty uboczne zakończenia agenta

​

Dane wejściowe użytkownika i powierzchnie narzędzi

​

Natywny tryb mechanizmu testowego Codex

​

Rygor środowiska uruchomieniowego

{
  "models": {
    "providers": {
      "openai": {
        "agentRuntime": {
          "id": "codex"
        }
      }
    }
  },
  "agents": {
    "defaults": {
      "model": "openai/gpt-5.6-sol"
    }
  }
}

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

{
  "agents": {
    "list": [
      {
        "id": "codex-only",
        "model": "openai/gpt-5.6-sol",
        "models": {
          "openai/gpt-5.6-sol": {
            "agentRuntime": { "id": "codex" }
          }
        }
      }
    ]
  }
}

{
  "agents": {
    "defaults": {
      "agentRuntime": {
        "id": "codex"
      }
    }
  }
}

​

Natywne sesje i kopia transkrypcji

• historii sesji widocznej w kanale
• wyszukiwania i indeksowania transkrypcji
• powrotu do wbudowanego mechanizmu testowego OpenClaw podczas późniejszej tury
• ogólnego działania /new, /reset oraz usuwania sesji

​

Wyniki narzędzi i multimediów

​

Końcowe wyniki narzędzi

• Przekaż identyfikator wywołania protokołu, jeśli istnieje, kanoniczną nazwę narzędzia oraz argumenty, które rzeczywiście dotarły do narzędzia po przygotowaniu lub przekształceniach punktów zaczepienia.
• Ustaw executionStarted: false, gdy walidacja, zatwierdzenie lub inny mechanizm ochronny zatrzymał wywołanie przed rozpoczęciem implementacji narzędzia. Gdy wysłanie mogło już nastąpić, ostrożnie zgłoś true.
• Zgłoś outcome: "success" lub outcome: "failure". Uwzględnij ustrukturyzowane pola błędu dostępne w środowisku uruchomieniowym zamiast wnioskować o błędzie z wyświetlanego tekstu.
• Używaj nativeMutation wyłącznie dla narzędzi natywnych, które nie korzystają z definicji narzędzia OpenClaw. Podaj tam fakty dotyczące modyfikacji i ponownego odtwarzania zarządzane przez protokół; nie kopiuj klasyfikatora modyfikacji OpenClaw do mechanizmu testowego.

​

Obecne ograniczenia

• Publiczna ścieżka importu jest ogólna, ale niektóre aliasy typów prób/wyników nadal zawierają starsze nazwy w celu zachowania zgodności.
• Instalowanie mechanizmów testowych innych firm jest eksperymentalne. Preferuj Pluginy dostawców, dopóki natywne środowisko uruchomieniowe sesji nie będzie potrzebne.
• Przełączanie mechanizmów testowych między turami jest obsługiwane. Nie przełączaj mechanizmów testowych w trakcie tury po rozpoczęciu działania natywnych narzędzi, zatwierdzeń, tekstu asystenta lub wysyłania wiadomości.

​

Powiązane materiały

• Omówienie SDK
• Funkcje pomocnicze środowiska uruchomieniowego
• Pluginy dostawców
• Mechanizm testowy Codex
• Dostawcy modeli