Манифест плагина

На этой странице описан нативный манифест плагина OpenClaw, openclaw.plugin.json. Совместимые структуры пакетов (Codex, Claude, Cursor) см. в разделе Пакеты плагинов.

Совместимые форматы пакетов используют вместо него собственные файлы манифестов:

• Пакет Codex: .codex-plugin/plugin.json
• Пакет Claude: .claude-plugin/plugin.json либо стандартная структура компонентов Claude без манифеста
• Пакет Cursor: .cursor-plugin/plugin.json

OpenClaw автоматически обнаруживает эти структуры, но не проверяет их по приведённой ниже схеме openclaw.plugin.json. Если структура совместимого пакета соответствует требованиям среды выполнения OpenClaw, система считывает метаданные пакета, объявленные корневые каталоги навыков, корневые каталоги команд Claude, значения settings.json по умолчанию для Claude, настройки LSP по умолчанию для Claude и поддерживаемые наборы хуков.

Каждый нативный плагин OpenClaw обязан содержать openclaw.plugin.json в корневом каталоге плагина. OpenClaw считывает его для проверки конфигурации без выполнения кода плагина. Отсутствующий или недопустимый манифест блокирует проверку конфигурации и считается ошибкой плагина.

Полное руководство по системе плагинов см. в разделе Плагины, а описание нативной модели возможностей и текущие рекомендации по внешней совместимости — в разделе Модель возможностей.

Назначение этого файла

openclaw.plugin.json — это метаданные, которые OpenClaw считывает до загрузки кода вашего плагина. Проверка всех содержащихся в нём данных должна выполняться без ресурсоёмкого запуска среды выполнения плагина.

Используйте его для:

• идентификации плагина, проверки конфигурации и подсказок интерфейса конфигурации
• метаданных аутентификации, первоначальной настройки и установки (псевдоним, автоматическое включение, переменные среды провайдера, варианты аутентификации)
• подсказок по активации для поверхностей плоскости управления
• сокращённого указания принадлежности семейств моделей
• статических снимков принадлежности возможностей (contracts)
• метаданных средства запуска контроля качества, доступных общему хосту openclaw qa
• метаданных конфигурации отдельных каналов, объединяемых с каталогом и поверхностями проверки

Не используйте его для: регистрации поведения среды выполнения, объявления точек входа кода или метаданных установки npm. Они должны находиться в коде вашего плагина и package.json.

Минимальный пример

{  "id": "voice-call",  "configSchema": {    "type": "object",    "additionalProperties": false,    "properties": {}  }}

Расширенный пример

{  "id": "openrouter",  "name": "OpenRouter",  "description": "Плагин провайдера OpenRouter",  "version": "1.0.0",  "providers": ["openrouter"],  "modelSupport": {    "modelPrefixes": ["router-"]  },  "modelIdNormalization": {    "providers": {      "openrouter": {        "prefixWhenBare": "openrouter"      }    }  },  "providerEndpoints": [    {      "endpointClass": "openrouter",      "hostSuffixes": ["openrouter.ai"]    }  ],  "providerRequest": {    "providers": {      "openrouter": {        "family": "openrouter"      }    }  },  "cliBackends": ["openrouter-cli"],  "syntheticAuthRefs": ["openrouter-cli"],  "setup": {    "providers": [      {        "id": "openrouter",        "envVars": ["OPENROUTER_API_KEY"]      }    ]  },  "providerAuthAliases": {    "openrouter-coding": "openrouter"  },  "channelEnvVars": {    "openrouter-chatops": ["OPENROUTER_CHATOPS_TOKEN"]  },  "providerAuthChoices": [    {      "provider": "openrouter",      "method": "api-key",      "choiceId": "openrouter-api-key",      "choiceLabel": "API-ключ OpenRouter",      "groupId": "openrouter",      "groupLabel": "OpenRouter",      "optionKey": "openrouterApiKey",      "cliFlag": "--openrouter-api-key",      "cliOption": "--openrouter-api-key <key>",      "cliDescription": "API-ключ OpenRouter",      "onboardingScopes": ["text-inference"]    }  ],  "uiHints": {    "apiKey": {      "label": "API-ключ",      "placeholder": "sk-or-v1-...",      "sensitive": true    }  },  "configSchema": {    "type": "object",    "additionalProperties": false,    "properties": {      "apiKey": {        "type": "string"      }    }  }}

Справочник полей верхнего уровня

Справочник по catalog

catalog предоставляет необязательные подсказки по отображению для каталогов плагинов. Хосты могут игнорировать эти подсказки. Они никогда не устанавливают и не включают плагин, а также не изменяют его поведение во время выполнения или уровень доверия.

{  "catalog": {    "featured": true,    "order": 10  }}

Справочник по метаданным провайдера генерации

Поля метаданных провайдера генерации описывают статические сигналы аутентификации для провайдеров, объявленных в соответствующем списке contracts.*GenerationProviders. OpenClaw считывает эти поля до загрузки среды выполнения провайдера, чтобы основные инструменты могли определить доступность провайдера генерации без импорта каждого плагина провайдера.

Используйте эти поля только для простых декларативных фактов. Транспорт, преобразования запросов, обновление токенов, проверка учётных данных и фактическое поведение генерации остаются в среде выполнения плагина.

{  "contracts": {    "imageGenerationProviders": ["example-image"]  },  "imageGenerationProviderMetadata": {    "example-image": {      "aliases": ["example-image-oauth"],      "authProviders": ["example-image"],      "configSignals": [        {          "rootPath": "plugins.entries.example-image.config",          "overlayPath": "image",          "mode": {            "path": "mode",            "default": "local",            "allowed": ["local"]          },          "requiredAny": ["workflow", "workflowPath"],          "required": ["promptNodeId"]        }      ],      "authSignals": [        {          "provider": "example-image"        },        {          "provider": "example-image-oauth",          "providerBaseUrl": {            "provider": "example-image",            "defaultBaseUrl": "https://api.example.com/v1",            "allowedBaseUrls": ["https://api.example.com/v1"]          }        }      ]    }  }}

Каждая запись метаданных поддерживает следующие поля:

Каждая запись configSignals поддерживает следующие поля:

Каждое условие mode поддерживает следующие поля:

Каждая запись authSignals поддерживает следующие поля:

Каждое условие providerBaseUrl поддерживает следующие поля:

Справочник по метаданным инструментов

toolMetadata использует те же структуры configSignals и authSignals, что и метаданные провайдера генерации, с ключами по имени инструмента. contracts.tools объявляет принадлежность. toolMetadata объявляет простые свидетельства доступности, чтобы OpenClaw мог не импортировать среду выполнения плагина лишь для того, чтобы фабрика инструмента вернула null.

{  "setup": {    "providers": [      {        "id": "example",        "envVars": ["EXAMPLE_API_KEY"]      }    ]  },  "contracts": {    "tools": ["example_search"]  },  "toolMetadata": {    "example_search": {      "authSignals": [        {          "provider": "example"        }      ],      "configSignals": [        {          "rootPath": "plugins.entries.example.config",          "overlayPath": "search",          "required": ["apiKey"]        }      ]    }  }}

Записи toolMetadata также принимают optional (обозначает инструмент как необязательный для активации плагина) и replaySafe (обозначает выполнение инструмента как безопасное для повторения после незавершённого хода модели) в дополнение к общим полям configSignals/authSignals, описанным выше.

Если у инструмента нет toolMetadata, OpenClaw сохраняет существующее поведение и загружает владеющий им плагин, когда контракт инструмента соответствует политике. Для инструментов горячего пути, фабрика которых зависит от аутентификации или конфигурации, авторам плагинов следует объявлять toolMetadata вместо того, чтобы заставлять ядро импортировать среду выполнения для проверки.

Справочник по providerAuthChoices

Каждая запись providerAuthChoices описывает один вариант первоначальной настройки или аутентификации. OpenClaw считывает её до загрузки среды выполнения провайдера. Списки настройки провайдера используют эти варианты из манифеста, варианты настройки, полученные из дескриптора, и метаданные каталога установки без загрузки среды выполнения провайдера.

Справочник commandAliases

Используйте commandAliases, когда плагину принадлежит имя команды среды выполнения, которое пользователи могут по ошибке указать в plugins.allow или попытаться выполнить как корневую команду CLI. OpenClaw использует эти метаданные для диагностики, не импортируя код среды выполнения плагина.

{  "commandAliases": [    {      "name": "dreaming",      "kind": "runtime-slash",      "cliCommand": "memory"    }  ]}

Справочник activation

Используйте activation, если плагин может без существенных затрат объявить, при каких событиях плоскости управления его следует включать в план активации или загрузки.

Этот блок содержит метаданные планировщика, а не API жизненного цикла. Он не регистрирует поведение среды выполнения, не заменяет register(...) и не гарантирует, что код плагина уже был выполнен. Планировщик активации использует эти поля, чтобы сузить набор плагинов-кандидатов, прежде чем переходить к существующим метаданным владения из манифеста, таким как providers, channels, commandAliases, setup.providers, contracts.tools и хуки.

Предпочитайте наиболее узкие метаданные, которые уже описывают владение. Используйте providers, channels, commandAliases, дескрипторы настройки или contracts, когда эти поля выражают соответствующую связь. Используйте activation для дополнительных подсказок планировщику, которые нельзя представить этими полями владения. Используйте cliBackends верхнего уровня для псевдонимов среды выполнения CLI, таких как claude-cli, my-cli или google-gemini-cli; activation.onAgentHarnesses предназначен только для идентификаторов встроенной среды агента, для которых ещё нет поля владения.

Каждый плагин должен задавать activation.onStartup явно. Устанавливайте значение true только тогда, когда плагин должен выполняться при запуске Gateway. Устанавливайте значение false, если плагин неактивен при запуске и должен загружаться только по более узким триггерам. Если onStartup не указан, плагин больше не загружается неявно при запуске; используйте явные метаданные активации для запуска, канала, конфигурации, среды агента, памяти или других более узких триггеров активации.

{  "activation": {    "onStartup": false,    "onProviders": ["openai"],    "onCommands": ["models"],    "onChannels": ["web"],    "onRoutes": ["gateway-webhook"],    "onConfigPaths": ["browser"],    "onCapabilities": ["provider", "tool"]  }}

Текущие активные потребители:

• Планирование запуска Gateway использует activation.onStartup для явного импорта при запуске.
• Планирование CLI, запускаемое командой, при необходимости возвращается к устаревшим commandAliases[].cliCommand или commandAliases[].name.
• Планирование запуска среды выполнения агента использует activation.onAgentHarnesses для встроенных сред и cliBackends[] верхнего уровня для псевдонимов среды выполнения CLI.
• Планирование настройки или канала, запускаемое каналом, при отсутствии явных метаданных активации канала возвращается к устаревшим метаданным владения channels[].
• Планирование плагинов при запуске использует activation.onConfigPaths для корневых поверхностей конфигурации, не относящихся к каналам, например блока browser встроенного браузерного плагина.
• Планирование настройки или среды выполнения, запускаемое провайдером, при отсутствии явных метаданных активации провайдера возвращается к устаревшим метаданным владения providers[] и cliBackends[] верхнего уровня.

Диагностика планировщика может различать явные подсказки активации и резервное использование владения из манифеста. Например, activation-command-hint означает, что совпало activation.onCommands, а manifest-command-alias означает, что вместо этого планировщик использовал владение commandAliases. Эти метки причин предназначены для диагностики хоста и тестов; авторам плагинов следует продолжать объявлять метаданные, наиболее точно описывающие владение.

Справочник qaRunners

Используйте qaRunners, когда плагин предоставляет один или несколько транспортных исполнителей в рамках общего корня openclaw qa. Эти метаданные должны оставаться простыми и статическими; среда выполнения плагина по-прежнему отвечает за фактическую регистрацию CLI через облегчённую поверхность runtime-api.ts, экспортирующую соответствующие qaRunnerCliRegistrations. Необязательный adapterFactory делает транспорт доступным для общих сценариев контроля качества, не изменяя исполнитель зарегистрированной команды.

{  "qaRunners": [    {      "commandName": "matrix",      "description": "Запустить выполняемый в Docker сценарий интерактивного контроля качества Matrix с одноразовым домашним сервером"    }  ]}

Идентификатор adapterFactory должен соответствовать commandName. Не экспортируйте регистрации для команд, отсутствующих в манифесте.

Справочник setup

Используйте setup, когда интерфейсам настройки и первоначальной конфигурации нужны легковесные метаданные плагина до загрузки среды выполнения.

{  "setup": {    "providers": [      {        "id": "openai",        "authMethods": ["api-key"],        "envVars": ["OPENAI_API_KEY"],        "authEvidence": [          {            "type": "local-file-with-env",            "fileEnvVar": "OPENAI_CREDENTIALS_FILE",            "requiresAllEnv": ["OPENAI_PROJECT"],            "credentialMarker": "openai-local-credentials",            "source": "локальные учётные данные openai"          }        ]      }    ],    "cliBackends": ["openai-cli"],    "configMigrations": ["legacy-openai-auth"],    "requiresRuntime": false  }}

Верхнеуровневое поле cliBackends остаётся допустимым и продолжает описывать серверные части логического вывода CLI. setup.cliBackends — это специальная для настройки поверхность дескрипторов для потоков плоскости управления и настройки, которая должна содержать только метаданные.

Если присутствуют setup.providers и setup.cliBackends, они являются предпочтительной поверхностью поиска на основе дескрипторов для обнаружения при настройке. Если дескриптор лишь сужает выбор плагина-кандидата, а для настройки всё ещё требуются более функциональные перехватчики среды выполнения, действующие во время настройки, задайте requiresRuntime: true и сохраните setup-api как резервный путь выполнения.

OpenClaw также включает setup.providers[].envVars в общие операции поиска аутентификации провайдера и переменных окружения. providerAuthEnvVars продолжает поддерживаться через адаптер совместимости в течение периода устаревания, однако несвязанные плагины, которые всё ещё его используют, получают диагностическое сообщение манифеста. Новые плагины должны размещать метаданные переменных окружения для настройки и состояния в setup.providers[].envVars.

Используйте providerUsageAuthEnvVars, когда учётные данные уровня биллинга или организации должны активировать resolveUsageAuth, не становясь учётными данными для логического вывода. Эти имена включаются в блокировку dotenv рабочей области, удаление из дочерних процессов ACP, фильтрацию секретов песочницы и общую очистку секретов. Среда выполнения провайдера по-прежнему считывает и классифицирует значение внутри resolveUsageAuth.

OpenClaw также может формировать простые варианты настройки на основе setup.providers[].authMethods, если запись настройки отсутствует или если setup.requiresRuntime: false объявляет среду выполнения настройки ненужной. Явные записи providerAuthChoices остаются предпочтительными для пользовательских меток, флагов CLI, области первоначальной конфигурации и метаданных ассистента.

Задавайте requiresRuntime: false только тогда, когда этих дескрипторов достаточно для интерфейса настройки. OpenClaw рассматривает явное значение false как контракт только на дескрипторы и не будет выполнять setup-api или openclaw.setupEntry для поиска при настройке. Если плагин, работающий только с дескрипторами, всё же поставляет одну из этих записей среды выполнения настройки, OpenClaw сообщает дополнительное диагностическое сообщение и продолжает её игнорировать. Если requiresRuntime не задано, сохраняется прежнее резервное поведение, чтобы не нарушить работу существующих плагинов, добавивших дескрипторы без этого флага.

Поскольку поиск при настройке может выполнять принадлежащий плагину код setup-api, нормализованные значения setup.providers[].id и setup.cliBackends[] должны оставаться уникальными среди обнаруженных плагинов. При неоднозначном владении операция завершается отказом, а не выбирает победителя на основе порядка обнаружения.

Когда среда выполнения настройки всё же запускается, диагностика реестра настройки сообщает о расхождении дескрипторов, если setup-api регистрирует провайдера или серверную часть CLI, не объявленную дескрипторами манифеста, либо если дескриптор не имеет соответствующей регистрации в среде выполнения. Эти диагностические сообщения являются дополнительными и не приводят к отклонению устаревших плагинов.

Справочник setup.providers

authEvidence предназначено для принадлежащих провайдеру локальных маркеров учётных данных, которые можно проверить без загрузки кода среды выполнения. Эти проверки должны оставаться легковесными и локальными: без сетевых вызовов, чтения связки ключей или менеджера секретов, команд оболочки и запросов к API провайдера.

Поддерживаемые записи признаков:

Поля setup

Справочник uiHints

uiHints — это сопоставление имён полей конфигурации с небольшими подсказками по отображению. В ключах можно использовать точки для вложенных полей конфигурации, но ни один сегмент пути не может быть __proto__, constructor или prototype; настройка отклоняет такие имена.

{  "uiHints": {    "apiKey": {      "label": "Ключ API",      "help": "Используется для запросов OpenRouter",      "placeholder": "sk-or-v1-...",      "sensitive": true    }  }}

Каждая подсказка для поля может включать:

Справочник contracts

Используйте contracts только для статических метаданных владения возможностями, которые OpenClaw может прочитать без импорта среды выполнения плагина.

{  "contracts": {    "agentToolResultMiddleware": ["openclaw", "codex"],    "trustedToolPolicies": ["workflow-budget"],    "externalAuthProviders": ["acme-ai"],    "embeddingProviders": ["openai-compatible"],    "speechProviders": ["openai"],    "realtimeTranscriptionProviders": ["openai"],    "realtimeVoiceProviders": ["openai"],    "memoryEmbeddingProviders": ["local"],    "mediaUnderstandingProviders": ["openai"],    "imageGenerationProviders": ["openai"],    "videoGenerationProviders": ["qwen"],    "musicGenerationProviders": ["stability-audio"],    "documentExtractors": ["example-docs"],    "webContentExtractors": ["firecrawl"],    "webFetchProviders": ["firecrawl"],    "webSearchProviders": ["gemini"],    "workerProviders": ["example-worker"],    "usageProviders": ["acme-ai"],    "migrationProviders": ["hermes"],    "gatewayMethodDispatch": ["authenticated-request"],    "tools": ["firecrawl_search", "firecrawl_scrape"]  }}

Каждый список необязателен:

contracts.embeddedExtensionFactories сохраняется для встроенных фабрик расширений, работающих только с сервером приложений Codex. Встроенные преобразования результатов инструментов должны вместо этого объявлять contracts.agentToolResultMiddleware и регистрироваться с помощью api.registerAgentToolResultMiddleware(...). Установленные плагины могут использовать тот же механизм промежуточного ПО только при явном включении и только для сред выполнения, объявленных ими в contracts.agentToolResultMiddleware.

Установленные плагины, которым требуется доверенный хостом уровень политики перед вызовом инструмента, должны объявить каждый регистрируемый локальный идентификатор в contracts.trustedToolPolicies и быть явно включены. Встроенные плагины сохраняют существующий путь доверенных политик, но установленные плагины с необъявленными идентификаторами политик отклоняются до регистрации. Идентификаторы политик ограничены областью регистрирующего плагина, поэтому два плагина могут объявить и зарегистрировать workflow-budget; один плагин не может дважды зарегистрировать один и тот же локальный идентификатор.

Регистрации api.registerTool(...) среды выполнения должны соответствовать contracts.tools. Обнаружение инструментов использует этот список, чтобы загружать только те среды выполнения плагинов, которым могут принадлежать запрошенные инструменты.

Плагины провайдеров, реализующие resolveExternalAuthProfiles, должны объявлять contracts.externalAuthProviders; необъявленные функции внешней аутентификации игнорируются.

Плагины провайдеров, реализующие одновременно resolveUsageAuth и fetchUsageSnapshot, должны объявить каждый автоматически обнаруживаемый идентификатор провайдера в contracts.usageProviders. Механизм обнаружения использования читает этот контракт до загрузки кода среды выполнения, а затем проверяет обе функции после загрузки только объявленных владельцев.

Провайдеры векторных представлений общего назначения должны объявлять contracts.embeddingProviders для каждого адаптера, зарегистрированного с помощью api.registerEmbeddingProvider(...). Используйте общий контракт для многократно используемой генерации векторов, включая провайдеров, используемых поиском по памяти. contracts.memoryEmbeddingProviders — устаревший механизм совместимости, относящийся только к памяти; он сохраняется лишь на время миграции существующих провайдеров на общий механизм провайдеров векторных представлений.

Провайдеры рабочих узлов должны объявить каждый идентификатор api.registerWorkerProvider(...) в contracts.workerProviders. Ядро сохраняет устойчивое намерение перед вызовом provision; провайдеры проверяют свои настройки до внешнего выделения ресурсов, а повторные вызовы с тем же идентификатором операции должны принимать ту же аренду. Ядро также сохраняет снимок этих проверенных настроек и передаёт его с leaseId в inspect({ leaseId, profile }) и destroy({ leaseId, profile }), в том числе после изменения или удаления именованного профиля. Уничтожение идемпотентно, проверка возвращает закрытое объединение состояний active / destroyed / unknown, а материал закрытого ключа SSH указывается только через SecretRef. Подготовленные конечные точки SSH также должны включать открытый hostKey из доверенного результата подготовки ресурсов точно в виде algorithm base64, без имени хоста или комментария, чтобы ядро могло закрепить хост перед подключением. Провайдеры, создающие динамические ссылки на удостоверения, могут реализовать авторитетный resolveSshIdentity({ leaseId, profile, keyRef }); для провайдеров без него используется универсальный механизм разрешения секретов ядра. Авторитетный unknown делает активную локальную запись потерянной; после сохранённого запроса на уничтожение он подтверждает завершение удаления ресурсов.

contracts.gatewayMethodDispatch в настоящее время принимает "authenticated-request". Это механизм контроля чистоты API для нативных HTTP-маршрутов плагинов, которые намеренно диспетчеризуют методы плоскости управления Gateway внутри процесса, а не песочница для защиты от вредоносных нативных плагинов. Используйте его только для тщательно проверенных встроенных или операторских поверхностей, которые уже требуют HTTP-аутентификацию Gateway. Маршрут с таким разрешением остаётся доступным при закрытом допуске корневых работ Gateway, только если он также объявляет auth: "gateway" и специфичный для маршрута gatewayRuntimeScopeSurface: "trusted-operator"; обычные соседние маршруты того же плагина остаются за границей допуска. Это позволяет сохранять доступ к состоянию приостановки и возобновлению, не предоставляя всему плагину обход допуска. Ограничивайте синтаксический разбор и формирование ответа вне диспетчеризации; существенная работа или работа с изменением состояния должна выполняться через диспетчеризацию методов Gateway, которая отвечает за допуск и соблюдение областей действия.

Справочник configContracts

Используйте configContracts для поведения конфигурации, принадлежащего манифесту и необходимого универсальным вспомогательным средствам ядра без импорта среды выполнения плагина: обнаружения опасных флагов, целей миграции SecretRef и сужения устаревших путей конфигурации.

{  "configContracts": {    "compatibilityMigrationPaths": ["legacyProvider"],    "compatibilityRuntimePaths": ["legacyProvider.webhook"],    "dangerousFlags": [      {        "path": "accounts.*.allowUnverifiedSenders",        "equals": true      }    ],    "secretInputs": {      "bundledDefaultEnabled": false,      "paths": [        {          "path": "apiKey",          "expected": "string"        }      ]    }  }}

Каждая запись dangerousFlags поддерживает:

secretInputs поддерживает:

Справочник mediaUnderstandingProviderMetadata

Используйте mediaUnderstandingProviderMetadata, если у провайдера анализа медиаданных есть модели по умолчанию, приоритет резервного автоматического выбора на основе аутентификации или встроенная поддержка документов, необходимые универсальным вспомогательным средствам ядра до загрузки среды выполнения. Ключи также должны быть объявлены в contracts.mediaUnderstandingProviders.

{  "contracts": {    "mediaUnderstandingProviders": ["example"]  },  "mediaUnderstandingProviderMetadata": {    "example": {      "capabilities": ["image", "audio"],      "defaultModels": {        "image": "example-vision-latest",        "audio": "example-transcribe-latest"      },      "autoPriority": {        "image": 40      },      "nativeDocumentInputs": ["pdf"],      "documentModels": {        "pdf": {          "textExtraction": "example-doc-text-latest",          "image": "example-doc-vision-latest"        }      }    }  }}

Каждая запись провайдера может включать:

Справочник channelConfigs

Используйте channelConfigs, когда плагину канала нужны легковесные метаданные конфигурации до загрузки среды выполнения. Обнаружение настроек и состояния канала только для чтения может напрямую использовать эти метаданные для настроенных внешних каналов, когда запись настройки отсутствует или когда setup.requiresRuntime: false указывает, что среда выполнения настройки не требуется.

channelConfigs — это метаданные манифеста плагина, а не новый раздел верхнего уровня пользовательской конфигурации. Пользователи по-прежнему настраивают экземпляры каналов в channels.<channel-id>. OpenClaw читает метаданные манифеста, чтобы определить, какой плагин владеет настроенным каналом, до выполнения кода среды выполнения плагина.

Для плагина канала configSchema и channelConfigs описывают разные пути:

• configSchema проверяет plugins.entries.<plugin-id>.config
• channelConfigs.<channel-id>.schema проверяет channels.<channel-id>

Невстроенные плагины, объявляющие channels[], также должны объявлять соответствующие записи channelConfigs. Без них OpenClaw всё равно может загрузить плагин, но схема конфигурации холодного пути, настройка и поверхности Control UI не смогут определить структуру параметров, принадлежащих каналу, до выполнения среды выполнения плагина.

channelConfigs.<channel-id>.commands.nativeCommandsAutoEnabled и nativeSkillsAutoEnabled могут объявлять статические значения по умолчанию auto для проверок конфигурации команд, выполняемых до загрузки среды выполнения канала. Встроенные каналы также могут публиковать те же значения по умолчанию через package.json#openclaw.channel.commands вместе с другими принадлежащими пакету метаданными каталога каналов.

{  "channelConfigs": {    "matrix": {      "schema": {        "type": "object",        "additionalProperties": false,        "properties": {          "homeserverUrl": { "type": "string" }        }      },      "uiHints": {        "homeserverUrl": {          "label": "URL домашнего сервера",          "placeholder": "https://matrix.example.com"        }      },      "label": "Matrix",      "description": "Подключение к домашнему серверу Matrix",      "commands": {        "nativeCommandsAutoEnabled": true,        "nativeSkillsAutoEnabled": true      },      "preferOver": ["matrix-legacy"]    }  }}

Каждая запись канала может включать:

Замена другого плагина канала

Используйте preferOver, когда ваш плагин является предпочтительным владельцем идентификатора канала, который также может предоставлять другой плагин. Типичные случаи: переименованный идентификатор плагина, отдельный плагин, заменяющий встроенный, или поддерживаемый форк, сохраняющий тот же идентификатор канала для совместимости конфигурации.

{  "id": "acme-chat",  "channels": ["chat"],  "channelConfigs": {    "chat": {      "schema": {        "type": "object",        "additionalProperties": false,        "properties": {          "webhookUrl": { "type": "string" }        }      },      "preferOver": ["chat"]    }  }}

Когда настроен channels.chat, OpenClaw учитывает как идентификатор канала, так и идентификатор предпочтительного плагина. Если плагин с меньшим приоритетом был выбран только потому, что он встроен или включён по умолчанию, OpenClaw отключает его в эффективной конфигурации среды выполнения, чтобы каналом и его инструментами владел один плагин. Явный выбор пользователя по-прежнему имеет приоритет: если пользователь явно включает оба плагина (через plugins.allow или существенную конфигурацию plugins.entries), OpenClaw сохраняет этот выбор и сообщает диагностические сведения о дублирующихся каналах и инструментах вместо скрытого изменения запрошенного набора плагинов.

Ограничивайте preferOver только идентификаторами плагинов, которые действительно могут предоставлять тот же канал. Это не общее поле приоритета, и оно не переименовывает ключи пользовательской конфигурации.

Справочник modelSupport

Используйте modelSupport, когда OpenClaw должен определить ваш плагин провайдера по сокращённым идентификаторам моделей, таким как gpt-5.6-sol или claude-sonnet-4.6, до загрузки среды выполнения плагина.

{  "modelSupport": {    "modelPrefixes": ["gpt-", "o1", "o3", "o4"],    "modelPatterns": ["^computer-use-preview"]  }}

OpenClaw применяет следующий порядок приоритетов:

• явные ссылки provider/model используют метаданные манифеста владельца providers
• modelPatterns имеют приоритет над modelPrefixes
• если совпадают один невстроенный и один встроенный плагин, побеждает невстроенный
• оставшаяся неоднозначность игнорируется, пока пользователь или конфигурация не укажет провайдера

Поля:

Записи modelPatterns компилируются через compileSafeRegex, который отклоняет шаблоны с вложенными повторениями (например, (a+)+$). Шаблоны, не прошедшие проверку безопасности, молча пропускаются, как и синтаксически некорректные регулярные выражения. Используйте простые шаблоны и избегайте вложенных квантификаторов.

Справочник modelCatalog

Используйте modelCatalog, когда OpenClaw должен знать метаданные моделей провайдера до загрузки среды выполнения плагина. Это принадлежащий манифесту источник фиксированных строк каталога, псевдонимов провайдеров, правил исключения и режима обнаружения. Обновление во время выполнения по-прежнему относится к коду среды выполнения провайдера, но манифест сообщает ядру, когда среда выполнения необходима.

{  "providers": ["openai"],  "modelCatalog": {    "providers": {      "openai": {        "baseUrl": "https://api.openai.com/v1",        "api": "openai-responses",        "models": [          {            "id": "gpt-5.4",            "name": "GPT-5.4",            "input": ["text", "image"],            "reasoning": true,            "contextWindow": 256000,            "maxTokens": 128000,            "cost": {              "input": 1.25,              "output": 10,              "cacheRead": 0.125            },            "status": "available",            "tags": ["default"]          }        ]      }    },    "aliases": {      "azure-openai-responses": {        "provider": "openai",        "api": "azure-openai-responses"      }    },    "suppressions": [      {        "provider": "azure-openai-responses",        "model": "gpt-5.3-codex-spark",        "reason": "недоступно в Azure OpenAI Responses"      }    ],    "discovery": {      "openai": "static"    }  }}

Поля верхнего уровня:

aliases участвует в поиске владельца провайдера при планировании каталога моделей. Целевые провайдеры псевдонимов должны быть верхнеуровневыми провайдерами, принадлежащими тому же плагину. Когда отфильтрованный по провайдеру список использует псевдоним, OpenClaw может прочитать манифест владельца и применить переопределения API и базового URL для псевдонима без загрузки среды выполнения провайдера. Псевдонимы не расширяют нефильтрованные списки каталога; широкие списки содержат только строки канонического провайдера-владельца.

suppressions заменяет прежний обработчик среды выполнения провайдера suppressBuiltInModel. Записи подавления учитываются, только если провайдер принадлежит плагину или объявлен как ключ modelCatalog.aliases, указывающий на принадлежащего плагину провайдера. Обработчики подавления среды выполнения больше не вызываются при разрешении модели.

Поля провайдера:

Поля модели:

Поля подавления:

Не помещайте данные, доступные только в среде выполнения, в modelCatalog. Используйте static, только если строки манифеста достаточно полны, чтобы списки с фильтрацией по провайдеру и интерфейсы выбора могли пропустить обнаружение реестра и среды выполнения. Используйте refreshable, когда строки манифеста полезны как доступные для перечисления начальные или дополнительные данные, но обновление или кэш может позднее добавить другие строки; обновляемые строки сами по себе не являются авторитетными. Используйте runtime, когда OpenClaw должен загрузить среду выполнения провайдера, чтобы получить список.

Справочник modelIdNormalization

Используйте modelIdNormalization для недорогой очистки принадлежащих провайдеру идентификаторов моделей, которая должна выполняться до загрузки среды выполнения провайдера. Благодаря этому псевдонимы, например короткие имена моделей, прежние локальные идентификаторы провайдера и правила префиксов прокси, остаются в манифесте плагина-владельца, а не в основных таблицах выбора моделей.

{  "providers": ["anthropic", "openrouter"],  "modelIdNormalization": {    "providers": {      "anthropic": {        "aliases": {          "sonnet-4.6": "claude-sonnet-4-6"        }      },      "openrouter": {        "prefixWhenBare": "openrouter"      }    }  }}

Поля провайдера:

Справочник providerEndpoints

Используйте providerEndpoints для классификации конечных точек, которую общая политика запросов должна знать до загрузки среды выполнения провайдера. Основная система по-прежнему определяет значение каждого endpointClass; манифесты плагинов определяют метаданные хоста и базового URL.

Официально вынесенные во внешние пакеты плагины провайдеров исключены из основного дистрибутива, поэтому их манифесты недоступны до установки. Их providerEndpoints также должны дублироваться в scripts/lib/official-external-provider-catalog.json, чтобы классификация конечных точек продолжала работать без плагина; соответствие копии обеспечивается контрактным тестом.

Поля конечной точки:

Справочник providerRequest

Используйте providerRequest для недорогих метаданных совместимости запросов, которые нужны общей политике запросов без загрузки среды выполнения провайдера. Перезапись полезной нагрузки, зависящую от поведения, оставляйте обработчикам среды выполнения провайдера или общим вспомогательным функциям семейства провайдеров.

{  "providerRequest": {    "providers": {      "vllm": {        "family": "vllm",        "openAICompletions": {          "supportsStreamingUsage": true        }      }    }  }}

Поля провайдера:

Справочник secretProviderIntegrations

Используйте secretProviderIntegrations, когда плагин может опубликовать многократно используемую предустановку exec-провайдера SecretRef. OpenClaw считывает эти метаданные до загрузки среды выполнения плагина, сохраняет принадлежность плагину в secrets.providers.<alias>.pluginIntegration и оставляет фактическое разрешение секретов среде выполнения SecretRef. Предустановки доступны только для встроенных плагинов и установленных плагинов, обнаруженных в управляемых корневых каталогах установки плагинов, например при установке через git и ClawHub.

{  "secretProviderIntegrations": {    "secret-store": {      "providerAlias": "team-secrets",      "displayName": "Team secrets",      "source": "exec",      "command": "${node}",      "args": ["./bin/resolve-secrets.mjs"]    }  }}

Ключ карты — идентификатор интеграции. Если providerAlias опущен, OpenClaw использует идентификатор интеграции как псевдоним провайдера SecretRef. Псевдонимы провайдеров должны соответствовать обычному шаблону псевдонима провайдера SecretRef, например team-secrets или onepassword-work.

Когда оператор выбирает предустановку, OpenClaw записывает ссылку на провайдера следующего вида:

{  "secrets": {    "providers": {      "team-secrets": {        "source": "exec",        "pluginIntegration": {          "pluginId": "acme-secrets",          "integrationId": "secret-store"        }      }    }  }}

При запуске или перезагрузке OpenClaw разрешает этот провайдер, загружая текущие метаданные манифеста плагина, проверяя, что плагин-владелец установлен и активен, и формируя команду exec из манифеста. Отключение или удаление плагина отзывает провайдер для активных SecretRef. Операторы, которым нужна автономная конфигурация exec, по-прежнему могут напрямую задавать вручную провайдеры command/args.

В настоящее время поддерживаются только предустановки source: "exec". command должен иметь значение ${node}, а args[0] должен быть скриптом разрешения ./ с путём относительно корневого каталога плагина. При запуске или перезагрузке OpenClaw преобразует его в текущий исполняемый файл Node и абсолютный путь к скрипту внутри плагина. Параметры Node, такие как --require, --import, --loader, --env-file, --eval и --print, не входят в контракт предустановки манифеста. Операторы, которым нужны команды не на Node, могут напрямую настроить автономные ручные exec-провайдеры.

OpenClaw формирует trustedDirs для предустановок манифеста из корневого каталога плагина, а для предустановок ${node} — также из каталога текущего исполняемого файла Node. Заданные в манифесте trustedDirs игнорируются. Другие параметры exec-провайдера, такие как timeoutMs, noOutputTimeoutMs, maxOutputBytes, jsonOnly, env, passEnv и allowInsecurePath, передаются в обычную конфигурацию exec-провайдера SecretRef.

Справочник modelPricing

Используйте modelPricing, когда провайдеру требуется управление ценообразованием на уровне управляющей плоскости до загрузки среды выполнения. Кэш цен Gateway считывает эти метаданные без импорта кода среды выполнения провайдера.

{  "providers": ["ollama", "openrouter"],  "modelPricing": {    "providers": {      "ollama": {        "external": false      },      "openrouter": {        "openRouter": {          "passthroughProviderModel": true        },        "liteLLM": false      }    }  }}

Поля провайдера:

Поля источника:

Индекс провайдеров OpenClaw

Индекс провайдеров OpenClaw — это принадлежащие OpenClaw метаданные предварительного просмотра для провайдеров, плагины которых могут быть ещё не установлены. Он не является частью манифеста плагина. Манифесты плагинов остаются авторитетным источником сведений об установленных плагинах. Индекс провайдеров — это внутренний резервный контракт, который будущие интерфейсы устанавливаемых провайдеров и выбора моделей перед установкой будут использовать, когда плагин провайдера не установлен.

Порядок приоритета источников каталога:

1. Пользовательская конфигурация.
2. Манифест установленного плагина modelCatalog.
3. Кэш каталога моделей после явного обновления.
4. Строки предварительного просмотра из индекса провайдеров OpenClaw.

Индекс провайдеров не должен содержать секреты, состояние включения, обработчики среды выполнения или актуальные данные моделей, зависящие от конкретной учётной записи. Его каталоги предварительного просмотра используют ту же структуру строки провайдера modelCatalog, что и манифесты плагинов, но должны ограничиваться стабильными отображаемыми метаданными, если только поля адаптера среды выполнения, такие как api, baseUrl, цены или флаги совместимости, намеренно не синхронизируются с манифестом установленного плагина. Провайдеры с динамическим обнаружением /models должны записывать обновлённые строки через явный путь кэша каталога моделей, а не вызывать API провайдера при обычном выводе списка или первоначальной настройке.

Записи индекса провайдеров также могут содержать метаданные устанавливаемого плагина для провайдеров, чей плагин был вынесен из ядра или по иной причине ещё не установлен. Эти метаданные соответствуют шаблону каталога каналов: имени пакета, спецификации установки npm, ожидаемой целостности и простых меток вариантов аутентификации достаточно для отображения устанавливаемого варианта настройки. После установки плагина приоритет получает его манифест, а запись индекса провайдеров для этого провайдера игнорируется.

openclaw doctor --fix переносит небольшой закрытый набор устаревших ключей возможностей верхнего уровня манифеста в contracts.*: speechProviders, mediaUnderstandingProviders, imageGenerationProviders и tools. Ни один из них, как и любой другой список возможностей, больше не считывается как поле верхнего уровня манифеста; обычная загрузка манифеста распознаёт их только в contracts.

Манифест и package.json

Эти два файла выполняют разные задачи:

Если вы не уверены, где должны находиться определённые метаданные, используйте следующее правило:

• если OpenClaw должен знать их до загрузки кода плагина, поместите их в openclaw.plugin.json
• если они относятся к упаковке, входным файлам или поведению установки npm, поместите их в package.json

Поля package.json, влияющие на обнаружение

Некоторые метаданные плагина, необходимые до запуска среды выполнения, намеренно хранятся в package.json в блоке openclaw, а не в openclaw.plugin.json. openclaw.bundle и openclaw.bundle.json не являются контрактами плагинов OpenClaw; нативные плагины должны использовать openclaw.plugin.json вместе с поддерживаемыми полями package.json#openclaw, перечисленными ниже.

Важные примеры:

Метаданные манифеста определяют, какие варианты провайдеров, каналов и настройки отображаются при первоначальной настройке до загрузки среды выполнения. package.json#openclaw.install сообщает процессу первоначальной настройки, как получить или включить этот плагин, когда пользователь выбирает один из этих вариантов. Не переносите подсказки по установке в openclaw.plugin.json.

openclaw.install.minHostVersion проверяется во время установки и загрузки реестра манифестов для источников невстроенных плагинов. Недопустимые значения отклоняются; более новые, но допустимые значения приводят к пропуску внешних плагинов на старых хостах. Предполагается, что версии встроенных исходных плагинов согласованы с версией рабочей копии хоста.

openclaw.install.requiredPlatformPackages предназначен для пакетов npm, предоставляющих необходимые нативные двоичные файлы через необязательные платформенные псевдонимы. Укажите базовое имя пакета npm для каждого поддерживаемого платформенного псевдонима. Во время установки npm OpenClaw проверяет только объявленный псевдоним, ограничения которого в lock-файле соответствуют текущему хосту. Если npm сообщает об успешной установке, но пропускает этот псевдоним, OpenClaw повторяет попытку один раз с новым кэшем и откатывает установку, если псевдоним по-прежнему отсутствует.

openclaw.compat.pluginApi проверяется во время установки пакета для источников невстроенных плагинов. Используйте его для указания нижней границы API SDK/среды выполнения плагинов OpenClaw, под которую был собран пакет. Она может быть строже, чем minHostVersion, когда пакету плагина нужен более новый API, но для других процессов он сохраняет более низкую подсказку по установке. Официальная синхронизация выпусков OpenClaw по умолчанию повышает существующие нижние границы API официальных плагинов до версии выпуска OpenClaw, однако выпуски только плагинов могут сохранять более низкую границу, если пакет намеренно поддерживает старые хосты. Не используйте только версию пакета в качестве контракта совместимости. peerDependencies.openclaw остаётся метаданными пакета npm; OpenClaw использует контракт openclaw.compat.pluginApi для принятия решений о совместимости при установке.

В официальных метаданных установки по требованию следует использовать clawhubSpec, если плагин опубликован в ClawHub; процесс первоначальной настройки рассматривает его как предпочтительный удалённый источник и после установки записывает сведения об артефакте ClawHub. npmSpec остаётся резервным вариантом совместимости для пакетов, которые ещё не перенесены в ClawHub.

Точная фиксация версии npm уже задаётся в npmSpec, например "npmSpec": "@wecom/wecom-openclaw-plugin@1.2.3". В официальных записях внешнего каталога точные спецификации следует сочетать с expectedIntegrity, чтобы процессы обновления завершались с ошибкой, если полученный артефакт npm больше не соответствует зафиксированному выпуску. Для совместимости интерактивная первоначальная настройка по-прежнему предлагает доверенные спецификации npm из реестра, включая базовые имена пакетов и dist-теги. Диагностика каталога позволяет различать точные, плавающие, закреплённые по целостности источники, источники без данных о целостности, с несовпадением имени пакета, а также недопустимые источники выбора по умолчанию. Она также предупреждает, когда присутствует expectedIntegrity, но нет допустимого источника npm, к которому его можно привязать. Если присутствует expectedIntegrity, процессы установки и обновления обеспечивают его соблюдение; если он отсутствует, результат разрешения через реестр записывается без фиксации целостности.

Плагины каналов должны предоставлять openclaw.setupEntry, если проверкам статуса, списка каналов или SecretRef необходимо определять настроенные учётные записи без загрузки полной среды выполнения. Точка входа настройки должна предоставлять метаданные канала, а также безопасные для настройки адаптеры конфигурации, статуса и секретов; сетевые клиенты, слушатели Gateway и транспортные среды выполнения следует оставлять в основной точке входа расширения.

Поля точек входа среды выполнения не отменяют проверки границ пакета для полей исходных точек входа. Например, openclaw.runtimeExtensions не может сделать доступным для загрузки путь openclaw.extensions, выходящий за границы пакета.

openclaw.install.allowInvalidConfigRecovery намеренно имеет узкую область действия. Он не позволяет устанавливать произвольные пакеты при неисправной конфигурации. Сейчас он лишь позволяет процессам установки восстанавливаться после конкретных сбоев обновления устаревших встроенных плагинов, например при отсутствии пути встроенного плагина или наличии устаревшей записи channels.<id> для того же встроенного плагина. Несвязанные ошибки конфигурации по-прежнему блокируют установку и направляют операторов к openclaw doctor --fix.

openclaw.channel.persistedAuthState — это метаданные пакета для небольшого модуля проверки:

{  "openclaw": {    "channel": {      "id": "whatsapp",      "persistedAuthState": {        "specifier": "./auth-presence",        "exportName": "hasAnyWhatsAppAuth"      }    }  }}

Используйте их, когда процессам настройки, doctor, проверки статуса или доступной только для чтения проверки наличия требуется недорогая проверка аутентификации с ответом «да» или «нет» до загрузки полного плагина канала. Сохранённое состояние аутентификации не является настроенным состоянием канала: не используйте эти метаданные для автоматического включения плагинов, восстановления зависимостей среды выполнения или принятия решения о том, должна ли загружаться среда выполнения канала. Целевой экспорт должен быть небольшой функцией, которая только считывает сохранённое состояние; не направляйте его через основной модуль экспорта полной среды выполнения канала.

openclaw.channel.configuredState использует такую же структуру для недорогих проверок настроенного состояния только по переменным среды:

{  "openclaw": {    "channel": {      "id": "telegram",      "configuredState": {        "specifier": "./configured-state",        "exportName": "hasTelegramConfiguredState"      }    }  }}

Используйте их, когда канал может определить настроенное состояние по переменным среды или другим небольшим входным данным, не требующим среды выполнения. Если для проверки требуется полное разрешение конфигурации или реальная среда выполнения канала, оставьте эту логику в обработчике config.hasConfiguredState плагина.

Приоритет обнаружения (повторяющиеся идентификаторы плагинов)

OpenClaw обнаруживает плагины в трёх корневых каталогах, проверяемых в следующем порядке: встроенные плагины, поставляемые с OpenClaw, глобальный корневой каталог установки (~/.openclaw/extensions) и корневой каталог текущего рабочего пространства (<workspace>/.openclaw/extensions), а также все явно заданные записи plugins.load.paths.

Если у двух обнаруженных элементов совпадает id, сохраняется только манифест с наивысшим приоритетом; дубликаты с более низким приоритетом отбрасываются, а не загружаются вместе с ним. Приоритет от наивысшего к низшему:

1. Выбранный конфигурацией — путь, явно закреплённый в plugins.entries.<id>
2. Глобальная установка, соответствующая отслеживаемой записи установки — плагин, установленный через openclaw plugin install/openclaw plugin update, который система отслеживания установок OpenClaw распознаёт для того же идентификатора, даже если этот идентификатор также принадлежит встроенному плагину
3. Встроенный — плагины, поставляемые с OpenClaw
4. Рабочее пространство — плагины, обнаруженные относительно текущего рабочего пространства
5. Любой другой обнаруженный кандидат

Следствия:

• Ответвлённая или устаревшая копия встроенного плагина, находящаяся без отслеживания в рабочем пространстве или глобальном корневом каталоге, не заменит встроенную сборку.
• Чтобы переопределить встроенный плагин, выполните openclaw plugin install для этого идентификатора, чтобы отслеживаемая глобальная установка получила приоритет над встроенной копией, либо закрепите конкретный путь через plugins.entries.<id>, чтобы он получил приоритет как выбранный конфигурацией.
• Отбрасывание дубликатов записывается в журнал, чтобы Doctor и диагностика запуска могли указать на отброшенную копию.
• В диагностике выбранные конфигурацией переопределения дубликатов описываются как явные переопределения, но предупреждения всё равно выводятся, чтобы устаревшие ответвления и случайные подмены оставались заметными.

Требования JSON Schema

• Каждый плагин должен поставляться со схемой JSON, даже если он не принимает конфигурацию.
• Допустима пустая схема (например, { "type": "object", "additionalProperties": false }).
• Схемы проверяются при чтении и записи конфигурации, а не во время выполнения.
• При расширении или создании форка встроенного плагина с новыми ключами конфигурации одновременно обновите openclaw.plugin.json configSchema этого плагина. Схемы встроенных плагинов строгие, поэтому добавление plugins.entries.<id>.config.myNewKey в пользовательскую конфигурацию без добавления myNewKey в configSchema.properties будет отклонено до загрузки среды выполнения плагина.

Пример расширения схемы:

{  "configSchema": {    "type": "object",    "additionalProperties": false,    "properties": {      "myNewKey": {        "type": "string"      }    }  }}

Поведение при проверке

• Неизвестные ключи channels.* считаются ошибками, если только идентификатор канала не объявлен в манифесте плагина. Если тот же идентификатор также присутствует в plugins.allow, plugins.entries или plugins.installs (плагин, на который есть ссылка, но который сейчас недоступен для обнаружения), OpenClaw вместо этого понижает уровень проблемы до предупреждения.
• Ссылки на неизвестные идентификаторы плагинов в plugins.entries.<id>, plugins.allow и plugins.deny считаются предупреждениями («устаревшая запись конфигурации проигнорирована»), а не ошибками, поэтому обновления и удалённые или переименованные плагины не блокируют запуск Gateway.
• Ссылка на неизвестный идентификатор плагина в plugins.slots.memory считается ошибкой, кроме известного официального внешнего плагина memory-lancedb, для которого вместо этого выводится предупреждение.
• Если плагин установлен, но его манифест или схема повреждены либо отсутствуют, проверка завершается с ошибкой, а Doctor сообщает об ошибке плагина.
• Если конфигурация плагина существует, но плагин отключён, конфигурация сохраняется, а в Doctor и журналах отображается предупреждение.

Полную схему plugins.* см. в справочнике по конфигурации.

Примечания

• Манифест обязателен для нативных плагинов OpenClaw, включая загрузку из локальной файловой системы. Среда выполнения по-прежнему загружает модуль плагина отдельно; манифест используется только для обнаружения и проверки.
• Нативные манифесты разбираются как JSON5, поэтому допускаются комментарии, завершающие запятые и ключи без кавычек, если итоговое значение по-прежнему является объектом.
• Загрузчик манифеста считывает только документированные поля манифеста. Избегайте пользовательских ключей верхнего уровня.
• channels, providers, cliBackends и skills можно не указывать, если они не нужны плагину.
• providerCatalogEntry должен оставаться легковесным и не должен импортировать обширный код среды выполнения; используйте его для статических метаданных каталога провайдера или узкоспециализированных дескрипторов обнаружения, а не для выполнения во время обработки запросов.
• Взаимоисключающие виды плагинов выбираются через plugins.slots.*: kind: "memory" через plugins.slots.memory (по умолчанию memory-core), kind: "context-engine" через plugins.slots.contextEngine (по умолчанию legacy).
• Объявляйте взаимоисключающий вид плагина в этом манифесте. OpenClawPluginDefinition.kind в точке входа среды выполнения устарел и сохраняется только как резервный механизм совместимости для старых плагинов.
• Метаданные переменных среды (setup.providers[].envVars, устаревший providerAuthEnvVars и channelEnvVars) носят исключительно декларативный характер. Статус, аудит, проверка доставки Cron и другие поверхности только для чтения по-прежнему применяют политику доверия к плагину и его фактической активации, прежде чем считать переменную среды настроенной.
• Метаданные мастера среды выполнения, для которых требуется код провайдера, описаны в разделе Перехватчики среды выполнения провайдера.
• Если ваш плагин зависит от нативных модулей, задокументируйте этапы сборки и все требования к списку разрешений менеджера пакетов (например, pnpm allow-build-scripts + pnpm rebuild <package>).

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