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

​

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

• нативний сервер агента програмування, який керує потоками та Compaction
• локальний CLI або демон, який має потоково передавати нативні події планування, міркування та інструментів
• середовище виконання моделі, якому потрібен власний ідентифікатор відновлення на додачу до стенограми сеансу OpenClaw

​

Що й надалі контролює ядро

• провайдера та модель
• стан автентифікації середовища виконання, якщо засіб виконання не оголошує, що контролює початкове налаштування автентифікації
• рівень міркування та бюджет контексту
• файл стенограми/сеансу OpenClaw
• робочий простір, пісочницю та політику інструментів
• зворотні виклики відповідей каналу та потокового передавання
• політику резервної моделі та перемикання моделі в реальному часі

​

Початкове налаштування автентифікації під керуванням засобу виконання

​

Перевірені артефакти середовища виконання налаштування

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

​

Контракт транспорту запитів

• runtimePolicy.compatibleIds містить ідентифікатори середовищ виконання, які провайдер оголошує сумісними з цим конкретним маршрутом. Відсутність політики означає, що провайдер не оголосив сумісність на рівні маршруту; це не дозвіл припускати підтримку.
• requestTransportOverrides: "none" означає, що не потрібно відтворювати жодне задане перевизначення запиту провайдера/моделі. "present" означає, що існують задані заголовки, транспорт автентифікації, проксі, TLS, поведінка локальної служби чи приватної мережі або параметри запиту. Цей факт не розкриває їхніх значень.

​

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

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) {
    const routeSupportsHarness =
      ctx.modelProvider?.runtimePolicy?.compatibleIds.includes("my-harness") === true;
    const canReproduceRequest = ctx.modelProvider?.requestTransportOverrides !== "present";
    return ctx.provider === "my-provider" && routeSupportsHarness && canReproduceRequest
      ? { supported: true, priority: 100 }
      : { supported: false, reason: "effective route is not harness-compatible" };
  },

  async runAttempt(params) {
    // Запустіть або відновіть свій нативний потік.
    // Використовуйте params.prompt, params.tools, params.images, params.onPartialReply,
    // params.onAgentEvent та інші поля підготовленої спроби.
    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 використовує своє вбудоване середовище виконання.

​

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

• бажані користувацькі посилання на моделі: openai/gpt-5.6-sol
• посилання сумісності: застарілі посилання codex/gpt-* залишаються прийнятними, але нові конфігурації не повинні використовувати їх як звичайні посилання провайдера/моделі
• ідентифікатор засобу виконання: codex
• автентифікація: синтетична доступність провайдера, оскільки засіб виконання Codex контролює нативний вхід/сеанс Codex
• запит до сервера застосунку: OpenClaw надсилає Codex лише ідентифікатор моделі й дозволяє засобу виконання взаємодіяти з нативним протоколом сервера застосунку

​

Проміжне ПЗ результатів інструментів

​

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

​

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

​

Поверхні введення користувача та інструментів

​

Нативний режим середовища Codex

​

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

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

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

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

​

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

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

​

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

​

Кінцеві результати інструментів

• Передавайте ідентифікатор виклику протоколу, якщо він існує, канонічну назву інструмента та аргументи, які фактично надійшли до інструмента після підготовки або перезаписування хуками.
• Установлюйте executionStarted: false, якщо валідація, схвалення або інший захисний механізм зупинив виклик до початку реалізації інструмента. Щойно диспетчеризація могла відбутися, консервативно повідомляйте true.
• Повідомляйте outcome: "success" або outcome: "failure". Додавайте структуровані поля помилки, доступні із середовища виконання, замість виведення факту помилки з відображуваного тексту.
• Використовуйте nativeMutation лише для нативних інструментів, які не використовують визначення інструмента OpenClaw. Передавайте там дані про мутацію та повторне відтворення, якими керує протокол; не копіюйте класифікатор мутацій OpenClaw у середовище.

​

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

• Загальнодоступний шлях імпорту є універсальним, але деякі псевдоніми типів спроб/результатів усе ще містять застарілі назви для сумісності.
• Установлення сторонніх середовищ є експериментальним. Надавайте перевагу плагінам провайдерів, доки не знадобиться нативне середовище сеансу.
• Перемикання середовищ між ходами підтримується. Не перемикайте середовища посеред ходу після початку роботи нативних інструментів, схвалень, тексту асистента або надсилання повідомлень.

​

Пов’язані матеріали

• Огляд SDK
• Допоміжні функції середовища виконання
• Плагіни провайдерів
• Середовище Codex
• Провайдери моделей