Plugins обвязки агента

​

Когда использовать обвязку

• нативный сервер coding-agent, который владеет тредами и Compaction
• локальный CLI или daemon, который должен стримить нативные события планирования, рассуждений и инструментов
• среда выполнения модели, которой нужен собственный resume id в дополнение к транскрипту сеанса OpenClaw

​

Чем по-прежнему владеет ядро

• провайдера и модель
• состояние runtime-аутентификации
• уровень thinking и бюджет контекста
• файл транскрипта/сеанса OpenClaw
• рабочую область, sandbox и политику инструментов
• callback-и ответа канала и 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 использует встроенную среду выполнения.

​

Сочетание провайдера и обвязки

• предпочтительные пользовательские ref-ы моделей: openai/gpt-5.5
• совместимые ref-ы: устаревшие ref-ы codex/gpt-* остаются принимаемыми, но новые конфиги не должны использовать их как обычные ref-ы провайдера/модели
• id обвязки: codex
• auth: синтетическая доступность провайдера, потому что обвязка Codex владеет нативным логином/сеансом Codex
• запрос app-server: OpenClaw отправляет в Codex bare model 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"
      }
    }
  }
}

​

Нативные сеансы и зеркало транскрипта

• истории сеанса, видимой в канале
• поиска и индексирования транскриптов
• переключения обратно на встроенную обвязку OpenClaw на последующем ходе
• общего поведения /new, /reset и удаления сеансов

​

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

​

Текущие ограничения

• Публичный путь импорта является общим, но некоторые псевдонимы типов попыток/результатов все еще содержат устаревшие имена для совместимости.
• Установка сторонних обвязок является экспериментальной. Предпочитайте provider plugins, пока вам не потребуется runtime нативного сеанса.
• Переключение обвязок поддерживается между ходами. Не переключайте обвязки в середине хода после запуска нативных инструментов, подтверждений, текста ассистента или отправки сообщений.

​

Связанные материалы

• Обзор SDK
• Вспомогательные средства runtime
• Provider Plugins
• Обвязка Codex
• Провайдеры моделей