Pluginy środowiska uruchomieniowego agentów

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.

​

Kiedy używać harnessu

• natywny serwer agenta kodującego, 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 potrzebuje własnego identyfikatora wznowienia oprócz transkryptu sesji OpenClaw

​

Za co nadal odpowiada core

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

• runtimePlan.tools.normalize(...) i runtimePlan.tools.logDiagnostics(...) dla polityki schematu narzędzi świadomej dostawcy
• runtimePlan.transcript.resolvePolicy(...) dla sanitizacji transkryptu i polityki naprawy wywołań narzędzi
• runtimePlan.delivery.isSilentPayload(...) dla wspólnego NO_REPLY i tłumienia dostarczania mediów
• runtimePlan.outcome.classifyRunResult(...) dla klasyfikacji awaryjnego wyboru modelu
• runtimePlan.observability dla rozstrzygniętych metadanych dostawcy/modelu/harnessu

​

Rejestracja 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);
  },
});

​

Polityka wyboru

1. Wygrywa polityka środowiska uruchomieniowego przypisana do modelu.
2. Następna jest polityka środowiska uruchomieniowego przypisana do dostawcy.
3. auto pyta zarejestrowane harnessy, czy obsługują rozstrzygniętego dostawcę/model.
4. Jeśli żaden zarejestrowany harness nie pasuje, OpenClaw używa PI, chyba że awaryjne użycie PI jest wyłączone.

​

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 zarządza natywnym logowaniem/sesją Codex
• żądanie app-server: OpenClaw wysyła do Codex sam identyfikator modelu i pozwala harnessowi komunikować się z natywnym protokołem app-server

​

Middleware wyników narzędzi

​

Klasyfikacja wyniku terminalowego

​

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-7",
      "models": {
        "anthropic/claude-opus-4-7": {
          "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"
      }
    }
  }
}

​

Natywne sesje i lustro transkryptu

• widocznej w kanale historii sesji
• wyszukiwania i indeksowania transkryptu
• przełączenia z powrotem na wbudowany harness PI w późniejszej turze
• generycznego 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 zawierają nazwy Pi 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 natywnych narzędzi, zatwierdzeń, tekstu asystenta lub wysyłania wiadomości.

​

Powiązane

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