Pluginy środowiska agentów

​

Kiedy używać harnessu

• natywny serwer agenta kodującego, który jest właścicielem wątków i Compaction
• lokalny CLI lub daemon, który musi strumieniować natywne zdarzenia planu, rozumowania i narzędzi
• środowisko uruchomieniowe modelu, które potrzebuje własnego identyfikatora wznowienia oprócz transkrypcji sesji OpenClaw

​

Co nadal należy do rdzenia

• dostawcę i model
• stan uwierzytelniania środowiska uruchomieniowego
• poziom myślenia i budżet kontekstu
• plik transkrypcji/sesji OpenClaw
• obszar roboczy, sandbox i zasady narzędzi
• wywołania zwrotne odpowiedzi kanału i wywołania zwrotne strumieniowania
• zasady awaryjnego przełączania modelu i przełączania modeli na żywo

• runtimePlan.tools.normalize(...) i runtimePlan.tools.logDiagnostics(...) dla zasad schematu narzędzi świadomych dostawcy
• runtimePlan.transcript.resolvePolicy(...) dla sanityzacji transkrypcji i zasad naprawy wywołań narzędzi
• runtimePlan.delivery.isSilentPayload(...) dla współdzielonego NO_REPLY i tłumienia dostarczania mediów
• runtimePlan.outcome.classifyRunResult(...) dla klasyfikacji awaryjnego przełączania modelu
• runtimePlan.observability dla rozwiązanych metadanych dostawcy/modelu/harnessu

​

Rejestrowanie harnessu

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

const myHarness: AgentHarness = {
  id: "my-harness",
  label: "My native agent harness",

  supports(ctx) {
    return ctx.provider === "my-provider"
      ? { supported: true, priority: 100 }
      : { supported: false };
  },

  async runAttempt(params) {
    // Start or resume your native thread.
    // Use params.prompt, params.tools, params.images, params.onPartialReply,
    // params.onAgentEvent, and the other prepared attempt fields.
    return await runMyNativeTurn(params);
  },
};

export default definePluginEntry({
  id: "my-native-agent",
  name: "My Native Agent",
  description: "Runs selected models through a native agent daemon.",
  register(api) {
    api.registerAgentHarness(myHarness);
  },
});

​

Zasady wyboru

1. Wygrywa zasada środowiska uruchomieniowego przypisana do modelu.
2. Następna jest zasada środowiska uruchomieniowego przypisana do dostawcy.
3. auto pyta zarejestrowane harnessy, czy obsługują rozwiązany dostawca/model.
4. Jeśli żaden zarejestrowany harness nie pasuje, OpenClaw używa swojego osadzonego środowiska uruchomieniowego.

​

Parowanie dostawcy i harnessu

• preferowane referencje modelu użytkownika: openai/gpt-5.5
• referencje zgodności: starsze referencje codex/gpt-* pozostają akceptowane, ale nowe konfiguracje nie powinny używać ich jako zwykłych referencji dostawcy/modelu
• identyfikator harnessu: codex
• uwierzytelnianie: syntetyczna dostępność dostawcy, ponieważ harness Codex jest właścicielem natywnego logowania/sesji Codex
• żądanie app-server: OpenClaw wysyła do Codex sam identyfikator modelu i pozwala harnessowi komunikować się z natywnym protokołem app-server

​

Warstwa pośrednia wyników narzędzi

​

Klasyfikacja końcowego wyniku

​

Skutki uboczne końca agenta

​

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

​

Natywny tryb harnessu Codex

​

Rygor środowiska uruchomieniowego

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

{
  "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.5",
        "models": {
          "openai/gpt-5.5": {
            "agentRuntime": { "id": "codex" }
          }
        }
      }
    ]
  }
}

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

​

Sesje natywne i lustrzana kopia transkrypcji

• historii sesji widocznej w kanale
• wyszukiwania i indeksowania transkrypcji
• przełączenia z powrotem na wbudowany harness OpenClaw w późniejszej turze
• ogólnego zachowania /new, /reset i usuwania sesji

​

Wyniki narzędzi i mediów

​

Obecne ograniczenia

• Publiczna ścieżka importu jest generyczna, ale niektóre aliasy typów prób/wyników nadal zachowują starsze nazwy ze względu na zgodność.
• Instalacja harnessów firm trzecich jest eksperymentalna. Preferuj Pluginy dostawców, dopóki nie potrzebujesz natywnego środowiska uruchomieniowego sesji.
• Przełączanie harnessów jest obsługiwane między turami. Nie przełączaj harnessów w środku tury po rozpoczęciu działania natywnych narzędzi, zatwierdzeń, tekstu asystenta lub wysyłania wiadomości.

​

Powiązane

• Omówienie SDK
• Pomocniki środowiska uruchomieniowego
• Pluginy dostawców
• Harness Codex
• Dostawcy modeli