Плагіни середовища агента

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.

​

Коли використовувати harness

• нативний сервер coding-agent, який володіє потоками та compaction
• локальний CLI або daemon, який має транслювати нативні події плану/міркувань/інструментів
• середовище виконання моделі, якому потрібен власний resume id на додачу до транскрипту сесії OpenClaw

​

Чим досі володіє core

• постачальника та модель
• стан автентифікації середовища виконання
• рівень thinking і бюджет контексту
• файл транскрипту/сесії OpenClaw
• workspace, sandbox і політику інструментів
• callbacks відповіді каналу та callbacks streaming
• політику fallback моделі та live перемикання моделей

• runtimePlan.tools.normalize(...) і runtimePlan.tools.logDiagnostics(...) для політики схем інструментів з урахуванням постачальника
• runtimePlan.transcript.resolvePolicy(...) для sanitization транскрипту та політики repair викликів інструментів
• runtimePlan.delivery.isSilentPayload(...) для спільного NO_REPLY та приглушення доставки media
• runtimePlan.outcome.classifyRunResult(...) для класифікації fallback моделі
• runtimePlan.observability для визначених metadata постачальника/моделі/harness

​

Реєстрація 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);
  },
});

​

Політика вибору

1. Спершу застосовується runtime policy на рівні моделі.
2. Далі застосовується runtime policy на рівні постачальника.
3. auto запитує зареєстровані harnesses, чи підтримують вони визначену пару постачальник/модель.
4. Якщо жоден зареєстрований harness не збігається, OpenClaw використовує PI, якщо PI fallback не вимкнено.

​

Поєднання постачальника та harness

• бажані refs користувацьких моделей: openai/gpt-5.5
• refs сумісності: застарілі refs codex/gpt-* досі приймаються, але нові configs не повинні використовувати їх як звичайні refs постачальник/модель
• harness id: codex
• auth: синтетична доступність постачальника, оскільки Codex harness володіє нативним login/session Codex
• запит app-server: OpenClaw надсилає Codex лише bare model id і дозволяє harness працювати з нативним protocol app-server

​

Middleware результатів інструментів

​

Класифікація terminal outcome

​

Нативний режим Codex harness

​

Суворість 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"
      }
    }
  }
}

​

Нативні сесії та дзеркало транскрипту

• видимої в каналі історії сесії
• пошуку та індексації транскриптів
• перемикання назад на вбудований PI harness у пізнішому ході
• generic поведінки /new, /reset і видалення сесії

​

Результати інструментів і media

​

Поточні обмеження

• Публічний шлях імпорту є generic, але деякі aliases типів attempt/result досі містять назви Pi для сумісності.
• Встановлення third-party harness є експериментальним. Віддавайте перевагу provider plugins, доки вам не потрібне нативне середовище виконання сесії.
• Перемикання harness підтримується між ходами. Не перемикайте harnesses посередині ходу після запуску native tools, approvals, assistant text або message sends.

​

Повʼязане

• Огляд SDK
• Допоміжні засоби середовища виконання
• Plugins постачальників
• Codex Harness
• Постачальники моделей