Пакети Plugin

​

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

​

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

# Локальний каталог
openclaw plugins install ./my-bundle

# Архів
openclaw plugins install ./my-bundle.tgz

# Маркетплейс Claude
openclaw plugins marketplace list <source>
openclaw plugins install <plugin> --marketplace <source>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

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

​

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

​

Вміст Skills

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

​

Пакети хуків

​

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

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

Транспорти

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

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

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

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

​

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

• shellPath
• shellCommandPrefix

​

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

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

​

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

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

​

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

​

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

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

​

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

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

​

Безпека

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

​

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

​

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

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