Plugin dell'harness dell'agente

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.

​

Quando usare un harness

• un server nativo per agenti di codifica che possiede thread e compaction
• una CLI locale o un daemon che deve trasmettere in streaming eventi nativi di piano/ragionamento/strumenti
• un runtime di modello che necessita del proprio resume id oltre alla trascrizione della sessione OpenClaw

​

Cosa possiede ancora il core

• provider e modello
• stato di autenticazione del runtime
• livello di thinking e budget di contesto
• file di trascrizione/sessione OpenClaw
• workspace, sandbox e criterio degli strumenti
• callback di risposta del canale e callback di streaming
• fallback del modello e criterio di cambio modello live

• runtimePlan.tools.normalize(...) e runtimePlan.tools.logDiagnostics(...) per il criterio dello schema strumenti consapevole del provider
• runtimePlan.transcript.resolvePolicy(...) per la sanitizzazione della trascrizione e il criterio di riparazione delle chiamate agli strumenti
• runtimePlan.delivery.isSilentPayload(...) per la soppressione condivisa di consegna NO_REPLY e media
• runtimePlan.outcome.classifyRunResult(...) per la classificazione del fallback del modello
• runtimePlan.observability per metadati risolti di provider/modello/harness

​

Registrare un harness

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

​

Criterio di selezione

1. Vince il criterio di runtime con ambito sul modello.
2. Segue il criterio di runtime con ambito sul provider.
3. auto chiede agli harness registrati se supportano il provider/modello risolto.
4. Se nessun harness registrato corrisponde, OpenClaw usa PI a meno che il fallback PI non sia disabilitato.

​

Associazione provider più harness

• riferimenti del modello utente preferiti: openai/gpt-5.5
• riferimenti di compatibilità: i riferimenti legacy codex/gpt-* restano accettati, ma le nuove configurazioni non dovrebbero usarli come normali riferimenti provider/modello
• id harness: codex
• auth: disponibilità provider sintetica, perché l’harness Codex possiede il login/sessione nativo Codex
• richiesta app-server: OpenClaw invia l’id del modello puro a Codex e lascia che l’harness parli con il protocollo app-server nativo

​

Middleware dei risultati degli strumenti

​

Classificazione dell’esito terminale

​

Modalità harness Codex nativo

​

Rigidità del runtime

{
  "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"
      }
    }
  }
}

​

Sessioni native e mirror della trascrizione

• cronologia della sessione visibile al canale
• ricerca e indicizzazione della trascrizione
• ritorno all’harness PI integrato in un turno successivo
• comportamento generico di /new, /reset ed eliminazione della sessione

​

Risultati di strumenti e media

​

Limitazioni attuali

• Il percorso di import pubblico è generico, ma alcuni alias di tipi tentativo/risultato portano ancora nomi Pi per compatibilità.
• L’installazione di harness di terze parti è sperimentale. Preferisci i plugin provider finché non hai bisogno di un runtime di sessione nativo.
• Il cambio di harness è supportato tra turni. Non cambiare harness a metà di un turno dopo che strumenti nativi, approvazioni, testo dell’assistente o invii di messaggi sono iniziati.

​

Correlati

• Panoramica dell’SDK
• Helper di runtime
• Plugin dei provider
• Harness Codex
• Provider di modelli