Пакети Plugin

OpenClaw може встановлювати плагіни з трьох зовнішніх екосистем: Codex, Claude і Cursor. Вони називаються пакетами — наборами вмісту та метаданих, які OpenClaw відображає на нативні функції, як-от Skills, хуки та інструменти MCP.

Навіщо потрібні пакети

Багато корисних плагінів публікуються у форматі Codex, Claude або Cursor. Замість того щоб вимагати від авторів переписувати їх як нативні плагіни OpenClaw, OpenClaw виявляє ці формати та відображає підтримуваний ними вміст на нативний набір функцій. Ви можете встановити пакет команд Claude або пакет Skills Codex і відразу ним користуватися.

Установлення пакета

# Локальний каталогopenclaw plugins install ./my-bundle # Архівopenclaw plugins install ./my-bundle.tgz # Маркетплейс Claudeopenclaw plugins marketplace list <source>openclaw plugins install <plugin> --marketplace <source>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

Що OpenClaw відображає з пакетів

Наразі в OpenClaw працюють не всі функції пакетів. Нижче наведено, що працює, а що виявляється, але ще не підключено.

Уже підтримується

Вміст Skills

• Кореневі каталоги Skills пакета завантажуються як звичайні кореневі каталоги Skills OpenClaw.
• Кореневі каталоги Claude commands/ обробляються як додаткові кореневі каталоги Skills.
• Кореневі каталоги Cursor .cursor/commands/ обробляються як додаткові кореневі каталоги Skills.

Файли команд Claude у форматі Markdown і файли команд Cursor у форматі Markdown працюють через звичайний завантажувач Skills OpenClaw.

Пакети хуків

Кореневі каталоги хуків пакета працюють лише тоді, коли використовують звичайну структуру пакета хуків OpenClaw: HOOK.md разом із handler.ts або handler.js. Наразі це насамперед стосується сумісного з Codex варіанта.

MCP для вбудованого OpenClaw

• Увімкнені пакети можуть надавати конфігурацію сервера MCP.
• OpenClaw об'єднує конфігурацію MCP пакета з ефективними налаштуваннями вбудованого OpenClaw як mcpServers.
• OpenClaw надає підтримувані інструменти MCP пакета під час звернень агента вбудованого OpenClaw, запускаючи сервери stdio або підключаючись до серверів HTTP.
• Профілі інструментів coding і messaging типово містять інструменти MCP пакета; щоб вимкнути їх для агента або Gateway, використовуйте tools.deny: ["bundle-mcp"].
• Локальні для проєкту налаштування вбудованого агента все одно застосовуються після типових налаштувань пакета, тому за потреби налаштування робочого простору можуть перевизначати записи MCP пакета.
• Каталоги інструментів MCP пакета детерміновано сортуються перед реєстрацією, тому зміни порядку в listTools() на стороні джерела не спричиняють постійних змін блоків інструментів у кеші промптів.

Транспорти

Сервери MCP можуть використовувати транспорт stdio або HTTP.

Stdio запускає дочірній процес:

{  "mcp": {    "servers": {      "my-server": {        "command": "node",        "args": ["server.js"],        "env": { "PORT": "3000" }      }    }  }}

HTTP підключається до запущеного сервера MCP, типово використовуючи sse, якщо не запитано streamable-http:

{  "mcp": {    "servers": {      "my-server": {        "url": "http://localhost:3100/mcp",        "transport": "streamable-http",        "headers": {          "Authorization": "Bearer ${MY_SECRET_TOKEN}"        },        "connectionTimeoutMs": 30000      }    }  }}

• transport приймає "streamable-http" або "sse"; якщо його пропущено, типовим значенням є sse.
• type: "http" — це нативна для CLI форма нижчого рівня; у конфігурації OpenClaw використовуйте transport: "streamable-http". openclaw mcp set і openclaw doctor --fix нормалізують поширений псевдонім.
• Дозволено лише схеми URL http: і https:.
• Значення headers підтримують інтерполяцію ${ENV_VAR}.
• Запис сервера, що містить одночасно command і url, відхиляється.
• Облікові дані URL (дані користувача та параметри запиту) вилучаються з описів інструментів і журналів.
• connectionTimeoutMs перевизначає типовий 30-секундний час очікування підключення для транспортів stdio та HTTP. Типовий час очікування запиту становить 60 секунд і може бути перевизначений за допомогою requestTimeoutMs.

Іменування інструментів

OpenClaw реєструє інструменти MCP пакета з безпечними для постачальника іменами у формі serverName__toolName. Наприклад, сервер із ключем "vigil-harbor", який надає інструмент memory_search, реєструється як vigil-harbor__memory_search.

• Символи поза межами A-Za-z0-9_- замінюються на -.
• Фрагменти, які починалися б не з літери, отримують літерний префікс, тому числові ключі серверів, як-от 12306, перетворюються на безпечні для постачальника префікси інструментів.
• Довжина префіксів серверів обмежена 30 символами.
• Довжина повних імен інструментів обмежена 64 символами.
• Для порожніх імен серверів використовується резервне значення mcp.
• Колізії очищених імен усуваються за допомогою числових суфіксів.
• Остаточний порядок наданих інструментів є детермінованим за безпечним іменем, що забезпечує стабільність кешу під час повторних звернень вбудованого агента.
• Під час фільтрування профілів кожен інструмент одного сервера MCP пакета вважається таким, що належить плагіну bundle-mcp, тому списки дозволів і заборон профілю можуть посилатися або на окремі надані імена інструментів, або на ключ плагіна bundle-mcp.

Налаштування вбудованого OpenClaw

settings.json Claude імпортується як типові налаштування вбудованого OpenClaw, коли пакет увімкнено. Перед застосуванням OpenClaw очищає ключі перевизначення оболонки:

• shellPath
• shellCommandPrefix

LSP вбудованого OpenClaw

• Увімкнені пакети Claude можуть надавати конфігурацію сервера LSP.
• OpenClaw завантажує .lsp.json разом з усіма шляхами lspServers, оголошеними в маніфесті.
• Конфігурація LSP пакета об'єднується з ефективними типовими налаштуваннями LSP вбудованого OpenClaw.
• Наразі можна запускати лише підтримувані сервери LSP на основі stdio; непідтримувані транспорти все одно відображаються в openclaw plugins inspect <id>.

Виявляється, але не виконується

Наведені нижче елементи розпізнаються й відображаються в діагностиці, але OpenClaw їх не запускає:

• agents, автоматизація hooks/hooks.json, outputStyles у Claude
• .cursor/agents, .cursor/hooks.json, .cursor/rules у Cursor
• Метадані Codex .app.json, окрім звітування про можливості

Формати пакетів

Пріоритет виявлення

OpenClaw спочатку перевіряє наявність формату нативного плагіна:

1. openclaw.plugin.json або дійсний package.json з openclaw.extensions — обробляється як нативний плагін
2. Маркери пакета (.codex-plugin/, .claude-plugin/ або типова структура Claude/Cursor) — обробляється як пакет

Якщо каталог містить обидва формати, OpenClaw використовує нативний шлях. Це запобігає частковому встановленню пакетів із двома форматами як пакетів.

Залежності середовища виконання й очищення

• Для сумісних пакетів сторонніх розробників під час запуску не виконується відновлення через npm install. Їх слід установлювати через openclaw plugins install, і вони мають містити все необхідне в каталозі встановленого плагіна.
• Пакетні плагіни, що належать OpenClaw, або постачаються в полегшеному вигляді в ядрі, або доступні для завантаження через інсталятор плагінів. Під час запуску Gateway ніколи не запускає для них менеджер пакетів.
• openclaw doctor --fix видаляє застарілі локальні записи про встановлення пакетних плагінів і може відновити доступні для завантаження плагіни, яких немає в локальному індексі плагінів, якщо конфігурація все ще посилається на них.

Безпека

Пакети мають вужчу межу довіри, ніж нативні плагіни:

• OpenClaw не завантажує довільні модулі середовища виконання пакетів усередині процесу.
• Шляхи Skills і пакетів хуків мають залишатися в межах кореневого каталогу плагіна (межі перевіряються).
• Файли налаштувань читаються з такими самими перевірками меж.
• Підтримувані сервери MCP stdio можуть запускатися як підпроцеси.

Завдяки цьому пакети типово безпечніші, але сторонні пакети все одно слід вважати довіреним вмістом щодо функцій, які вони надають.

Усунення несправностей

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

• Установлення та налаштування плагінів
• Створення плагінів — створення нативного плагіна
• Маніфест плагіна — схема нативного маніфесту