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

​

Коли використовувати обв’язку

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

​

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

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

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

​

Реєстрація обв’язки

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. Перемагає політика середовища виконання на рівні моделі.
2. Далі йде політика середовища виконання на рівні провайдера.
3. auto запитує зареєстровані обв’язки, чи підтримують вони визначені провайдер/модель.
4. Якщо жодна зареєстрована обв’язка не збігається, OpenClaw використовує своє вбудоване середовище виконання.

​

Поєднання провайдера й обв’язки

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

​

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

​

Класифікація термінального результату

​

Побічні ефекти завершення агента

​

Користувацьке введення та поверхні інструментів

​

Нативний режим обв’язки Codex

​

Строгість середовища виконання

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

​

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

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

​

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

​

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

• Публічний шлях імпорту є загальним, але деякі псевдоніми типів спроби/результату все ще мають застарілі назви для сумісності.
• Встановлення сторонніх harness є експериментальним. Віддавайте перевагу provider plugins, доки вам не знадобиться нативне середовище виконання сесії.
• Перемикання harness підтримується між ходами. Не перемикайте harness у середині ходу після того, як почалися нативні інструменти, approvals, текст асистента або надсилання повідомлень.

​

Пов’язане

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