Керування Plugin

Найпоширеніші робочі процеси Plugin складаються з кількох команд: пошук, установлення, перезапуск Gateway, перевірка та видалення, коли Plugin більше не потрібен.

Список Plugins

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --json

Використовуйте --json для скриптів. Він містить діагностику реєстру та статичний dependencyStatus кожного Plugin, коли пакет Plugin оголошує dependencies або optionalDependencies.

OmeniaClaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list — це холодна перевірка інвентарю. Вона показує, що OmeniaClaw може виявити з конфігурації, маніфестів і реєстру Plugin; вона не доводить, що вже запущений процес Gateway імпортував runtime Plugin.

Установлення Plugins

# Search ClawHub for plugin packages.OmeniaClaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.OmeniaClaw plugins install <package> # Force one source.OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install npm:<package> # Install a specific version or dist-tag.OmeniaClaw plugins install clawhub:<package>@1.2.3OmeniaClaw plugins install clawhub:<package>@betaOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw plugins install npm:@OmeniaClaw/codex # Install from git or a local development checkout.OmeniaClaw plugins install git:github.com/acme/[email protected]OmeniaClaw plugins install ./my-pluginOmeniaClaw plugins install --link ./my-plugin

Після встановлення коду Plugin перезапустіть Gateway, який обслуговує ваші канали:

OmeniaClaw gateway restartOmeniaClaw plugins inspect <plugin-id> --runtime --json

Використовуйте inspect --runtime, коли вам потрібен доказ, що Plugin зареєстрував runtime-поверхні, як-от інструменти, hooks, сервіси, методи Gateway або команди CLI, що належать Plugin.

Оновлення Plugins

OmeniaClaw plugins update <plugin-id>OmeniaClaw plugins update <npm-package-or-spec>OmeniaClaw plugins update --all

Якщо Plugin було встановлено з npm dist-tag, такого як @beta, подальші виклики update <plugin-id> повторно використовують цей записаний тег. Передавання явної npm-специфікації перемикає відстежуване встановлення на цю специфікацію для майбутніх оновлень.

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-plugin

Друга команда повертає Plugin до стандартної лінії випусків реєстру, якщо раніше він був закріплений за точною версією або тегом.

Коли OmeniaClaw update виконується на beta-каналі, записи Plugin npm і ClawHub зі стандартної лінії спочатку пробують відповідний випуск Plugin @beta. Якщо такого beta-випуску не існує, OmeniaClaw повертається до записаної специфікації default/latest. Для npm Plugins OmeniaClaw також повертається назад, коли beta-пакет існує, але не проходить перевірку встановлення. Точні версії та явні теги, як-от @rc або @beta, зберігаються.

Видалення Plugins

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw gateway restart

Видалення прибирає конфігураційний запис Plugin, запис індексу Plugin, записи списків дозволу/заборони та пов’язані шляхи завантаження, коли це застосовно. Керовані каталоги встановлення видаляються, якщо не передано --keep-files.

У режимі Nix (OmeniaClaw_NIX_MODE=1) команди встановлення, оновлення, видалення, увімкнення та вимкнення Plugin вимкнені. Натомість керуйте цими виборами у джерелі Nix для встановлення; для nix-OmeniaClaw використовуйте agent-first Швидкий старт.

Публікація Plugins

Ви можете публікувати зовнішні Plugins у ClawHub, npmjs.com або в обох місцях.

Публікація в ClawHub

ClawHub є основною публічною поверхнею виявлення для OmeniaClaw Plugins. Він надає користувачам метадані з пошуком, історію версій і результати сканування реєстру перед встановленням.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

Користувачі встановлюють із ClawHub так:

OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install <package>

Коротка форма все одно спочатку перевіряє ClawHub.

Публікація в npmjs.com

Нативні npm Plugins повинні містити маніфест Plugin і метадані entrypoint OmeniaClaw у package.json.

{  "name": "@acme/OmeniaClaw-plugin",  "version": "1.0.0",  "type": "module",  "OmeniaClaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access public

Користувачі встановлюють лише з npm так:

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw plugins install npm:@acme/[email protected]

Якщо той самий пакет також доступний у ClawHub, npm: пропускає пошук у ClawHub і примусово використовує розв’язання через npm.

Вибір джерела

• ClawHub: використовуйте, коли вам потрібні нативне для OmeniaClaw виявлення, підсумки сканування, версії та підказки щодо встановлення.
• npmjs.com: використовуйте, коли ви вже постачаєте JavaScript-пакети або потребуєте npm dist-tags/робочих процесів приватного реєстру.
• Git: використовуйте, коли потрібно встановити безпосередньо з гілки, тегу або коміту.
• Локальний шлях: використовуйте, коли розробляєте або тестуєте Plugin на тій самій машині.

Пов’язане

• Plugins - огляд і усунення несправностей
• OmeniaClaw plugins - повна довідка CLI
• ClawHub - публікація та операції реєстру
• Створення Plugins - створення пакета Plugin
• Маніфест Plugin - маніфест і метадані пакета