Наборы плагинов

​

Зачем нужны пакеты

​

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

# Локальный каталог
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 пакета; используйте tools.deny: ["bundle-mcp"], чтобы отключить их для агента или Gateway.
• Локальные настройки встроенного агента проекта по-прежнему применяются после настроек пакета по умолчанию, поэтому при необходимости настройки рабочей области могут переопределять записи 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>.

​

Обнаруживается, но не выполняется

• Claude agents, автоматизация hooks/hooks.json, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• Метаданные 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 могут запускаться как подпроцессы.

​

Устранение неполадок

​

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

• Установка и настройка плагинов
• Создание плагинов — создание нативного плагина
• Манифест плагина — схема нативного манифеста