Плагіни

​

Вимоги

• робоча копія або інсталяція OpenClaw із доступним CLI openclaw
• доступ до мережі для вибраного джерела (ClawHub, npm або git-хост)
• усі облікові дані, ключі конфігурації або інструменти ОС, потрібні конкретному плагіну й зазначені в документації з його налаштування
• дозвіл для Gateway, який обслуговує ваші канали, на перезавантаження або перезапуск

​

Швидкий початок

openclaw plugins search "calendar"

# Із ClawHub.
openclaw plugins install clawhub:<package>

# Із npm.
openclaw plugins install npm:<package>

# Із git.
openclaw plugins install git:github.com/<owner>/<repo>@<ref>

# Із локальної робочої копії для розробки.
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin

openclaw plugins enable <plugin-id>

openclaw gateway restart

openclaw plugins inspect <plugin-id> --runtime --json

​

Конфігурація

​

Виберіть джерело встановлення

​

Політика встановлення оператора

​

Налаштуйте політику плагінів

{
  plugins: {
    enabled: true,
    allow: ["voice-call"],
    deny: ["untrusted-plugin"],
    load: { paths: ["~/Projects/oss/voice-call-plugin"] },
    slots: { memory: "memory-core" },
    entries: {
      "voice-call": { enabled: true, config: { provider: "twilio" } },
    },
  },
}

• plugins.enabled: false вимикає всі плагіни та пропускає роботу з виявлення й завантаження. Застарілі посилання на плагіни залишаються неактивними, доки цей параметр діє; знову ввімкніть плагіни перед очищенням за допомогою doctor, якщо потрібно видалити застарілі ідентифікатори.
• plugins.deny має пріоритет над списком дозволів і ввімкненням окремого плагіна.
• plugins.allow — це винятковий список дозволів. Інструменти, що належать плагінам поза списком дозволів, залишаються недоступними, навіть коли tools.allow містить "*".
• plugins.entries.<id>.enabled: false вимикає один плагін, зберігаючи його конфігурацію.
• plugins.load.paths додає явні локальні файли або каталоги плагінів. Керовані локальні шляхи plugins install мають бути каталогами або архівами плагінів; для окремих файлів плагінів використовуйте plugins.load.paths.
• Плагіни з робочого простору за замовчуванням вимкнені; явно ввімкніть або додайте їх до списку дозволів перед використанням локального коду робочого простору.
• Вбудовані плагіни дотримуються вбудованих метаданих про ввімкнення або вимкнення за замовчуванням, якщо конфігурація явно не перевизначає їх.
• plugins.slots.<slot> (memory або contextEngine) вибирає один плагін для виняткової категорії. Вибір слота вважається явною активацією та примусово вмикає вибраний плагін для цього слота, навіть якщо інакше він потребував би явного ввімкнення. plugins.deny і plugins.entries.<id>.enabled: false усе одно блокують його.
• Вбудовані плагіни з явним ввімкненням можуть активуватися автоматично, коли конфігурація називає одну з належних їм поверхонь, як-от посилання на постачальника або модель, конфігурацію каналу, серверну частину CLI чи середовище виконання каркаса агента.
• Маршрутизація Codex родини OpenAI зберігає межі плагінів постачальника й середовища виконання окремими: застарілі посилання на моделі Codex є застарілою конфігурацією, яку виправляє doctor, тоді як вбудований плагін codex керує середовищем виконання сервера застосунку Codex для канонічних посилань агентів openai/*, явного agentRuntime.id: "codex" і застарілих посилань codex/*.

​

Формати плагінів

​

Хуки плагінів

• api.on(...) — типізовані хуки для подій життєвого циклу середовища виконання. Це рекомендована поверхня для проміжного ПЗ, політик, переписування повідомлень, формування запитів та керування інструментами.
• api.registerHook(...) — для внутрішньої системи хуків, описаної в розділі Хуки. Вона призначена переважно для грубих побічних ефектів команд і життєвого циклу та сумісності з наявною автоматизацією у стилі HOOK.

​

Перевірте активний Gateway

openclaw gateway status --deep --require-rpc
openclaw plugins inspect <plugin-id> --runtime --json
openclaw gateway restart

​

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

​

Заблокований власник шляху до плагіна

sudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspace

sudo chown -R root:root /path/to/openclaw-config/npm

​

Повільне налаштування інструментів плагіна

openclaw config set logging.level trace
openclaw logs --follow

[trace:plugin-tools] тривалість роботи фабрик ...

openclaw plugins inspect <plugin-id> --runtime --json

​

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

• Керування плагінами - приклади команд для перегляду списку, встановлення, оновлення, видалення й публікації
• openclaw plugins - повний довідник CLI
• Перелік плагінів - згенерований список вбудованих і зовнішніх плагінів
• Довідник плагінів - згенеровані довідкові сторінки для кожного плагіна
• Плагіни спільноти - правила пошуку в ClawHub і PR для документації
• Визначення залежностей плагінів - кореневі каталоги встановлення, записи реєстру та межі середовища виконання
• Створення плагінів - посібник зі створення нативних плагінів
• Огляд SDK плагінів - реєстрація в середовищі виконання, обробники та поля API
• Маніфест плагіна - маніфест і метадані пакета