CLI commands
Pluginy
Zarządzaj pluginami Gateway, pakietami hooków i zgodnymi pakietami zbiorczymi.
Przewodnik dla użytkowników końcowych dotyczący instalowania, włączania i rozwiązywania problemów z pluginami.
Szybkie przykłady instalowania, wyświetlania listy, aktualizowania, odinstalowywania i publikowania.
Model zgodności pakietów zbiorczych.
Pola manifestu i schemat konfiguracji.
Wzmacnianie bezpieczeństwa instalacji pluginów.
Polecenia
OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --jsonOmeniaClaw plugins search <query>OmeniaClaw plugins search <query> --limit 20OmeniaClaw plugins search <query> --jsonOmeniaClaw plugins install <path-or-spec>OmeniaClaw plugins inspect <id>OmeniaClaw plugins inspect <id> --runtimeOmeniaClaw plugins inspect <id> --jsonOmeniaClaw plugins inspect --allOmeniaClaw plugins info <id>OmeniaClaw plugins enable <id>OmeniaClaw plugins disable <id>OmeniaClaw plugins registryOmeniaClaw plugins registry --refreshOmeniaClaw plugins uninstall <id>OmeniaClaw plugins doctorOmeniaClaw plugins update <id-or-npm-spec>OmeniaClaw plugins update --allOmeniaClaw plugins marketplace list <marketplace>OmeniaClaw plugins marketplace list <marketplace> --jsonAby zbadać powolną instalację, inspekcję, odinstalowanie lub odświeżenie rejestru, uruchom
polecenie z OmeniaClaw_PLUGIN_LIFECYCLE_TRACE=1. Ślad zapisuje czasy faz
do stderr i zachowuje możliwość parsowania wyjścia JSON. Zobacz Debugowanie.
Instalacja
OmeniaClaw plugins search "calendar" # search ClawHub pluginsOmeniaClaw plugins install <package> # npm by defaultOmeniaClaw plugins install clawhub:<package> # ClawHub onlyOmeniaClaw plugins install npm:<package> # npm onlyOmeniaClaw plugins install npm-pack:<path.tgz> # local npm pack through npm install semanticsOmeniaClaw plugins install git:github.com/<owner>/<repo> # git repoOmeniaClaw plugins install git:github.com/<owner>/<repo>@<ref>OmeniaClaw plugins install <package> --force # overwrite existing installOmeniaClaw plugins install <package> --pin # pin versionOmeniaClaw plugins install <package> --dangerously-force-unsafe-installOmeniaClaw plugins install <path> # local pathOmeniaClaw plugins install <plugin>@<marketplace> # marketplaceOmeniaClaw plugins install <plugin> --marketplace <name> # marketplace (explicit)OmeniaClaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>Opiekunowie testujący instalacje wykonywane podczas konfiguracji mogą zastąpić automatyczne źródła instalacji pluginów za pomocą chronionych zmiennych środowiskowych. Zobacz Zastąpienia instalacji pluginów.
plugins search odpytuje ClawHub o możliwe do zainstalowania pakiety pluginów i wypisuje
nazwy pakietów gotowe do instalacji. Przeszukuje pakiety code-plugin i bundle-plugin,
a nie Skills. Użyj OmeniaClaw skills search dla Skills z ClawHub.
Dołączanie konfiguracji i naprawa nieprawidłowej konfiguracji
Jeśli sekcja plugins jest wspierana przez jednoplikowe $include, plugins install/update/enable/disable/uninstall zapisuje zmiany do tego dołączonego pliku i pozostawia OmeniaClaw.json bez zmian. Dołączenia główne, tablice dołączeń i dołączenia z równoległymi nadpisaniami kończą się bez zmian zamiast spłaszczać konfigurację. Zobacz Dołączanie konfiguracji, aby poznać obsługiwane kształty.
Jeśli konfiguracja jest nieprawidłowa podczas instalacji, plugins install zwykle kończy się bez zmian i informuje, aby najpierw uruchomić OmeniaClaw doctor --fix. Podczas uruchamiania Gateway i przeładowania na gorąco nieprawidłowa konfiguracja pluginów kończy się bez zmian jak każda inna nieprawidłowa konfiguracja; OmeniaClaw doctor --fix może poddać kwarantannie nieprawidłowy wpis pluginu. Jedynym udokumentowanym wyjątkiem podczas instalacji jest wąska ścieżka odzyskiwania dołączonego pluginu dla pluginów, które jawnie wybierają OmeniaClaw.install.allowInvalidConfigRecovery.
--force oraz ponowna instalacja a aktualizacja
--force ponownie używa istniejącego celu instalacji i nadpisuje już zainstalowany plugin lub pakiet hooków w miejscu. Użyj tego, gdy celowo ponownie instalujesz ten sam identyfikator z nowej ścieżki lokalnej, archiwum, pakietu ClawHub lub artefaktu npm. Do rutynowych aktualizacji już śledzonego pluginu npm preferuj OmeniaClaw plugins update <id-or-npm-spec>.
Jeśli uruchomisz plugins install dla identyfikatora pluginu, który jest już zainstalowany, OmeniaClaw zatrzyma się i wskaże plugins update <id-or-npm-spec> dla zwykłej aktualizacji albo plugins install <package> --force, gdy rzeczywiście chcesz nadpisać bieżącą instalację z innego źródła.
Zakres --pin
--pin dotyczy tylko instalacji npm. Nie jest obsługiwane z instalacjami git:; użyj jawnego odwołania git, takiego jak git:github.com/acme/[email protected], gdy chcesz przypięte źródło. Nie jest obsługiwane z --marketplace, ponieważ instalacje z marketplace utrwalają metadane źródła marketplace zamiast specyfikacji npm.
--dangerously-force-unsafe-install
--dangerously-force-unsafe-install to opcja awaryjna dla fałszywych alarmów w wbudowanym skanerze niebezpiecznego kodu. Pozwala kontynuować instalację nawet wtedy, gdy wbudowany skaner zgłasza ustalenia critical, ale nie omija blokad zasad hooka pluginu before_install i nie omija niepowodzeń skanowania.
Ta flaga CLI dotyczy przepływów instalacji/aktualizacji pluginów. Instalacje zależności Skills obsługiwane przez Gateway używają odpowiadającego jej nadpisania żądania dangerouslyForceUnsafeInstall, natomiast OmeniaClaw skills install pozostaje osobnym przepływem pobierania/instalacji Skills z ClawHub.
Jeśli plugin opublikowany przez Ciebie w ClawHub jest blokowany przez skan rejestru, użyj kroków dla wydawcy w ClawHub.
Pakiety hooków i specyfikacje npm
plugins install jest także powierzchnią instalacji dla pakietów hooków, które udostępniają OmeniaClaw.hooks w package.json. Użyj OmeniaClaw hooks do filtrowanej widoczności hooków i włączania poszczególnych hooków, a nie do instalacji pakietów.
Specyfikacje npm są tylko rejestrowe (nazwa pakietu + opcjonalna dokładna wersja lub dist-tag). Specyfikacje Git/URL/file i zakresy semver są odrzucane. Instalacje zależności działają lokalnie dla projektu z --ignore-scripts ze względów bezpieczeństwa, nawet gdy powłoka ma globalne ustawienia instalacji npm. Zarządzane korzenie npm pluginów dziedziczą overrides npm na poziomie pakietu OmeniaClaw, więc piny bezpieczeństwa hosta dotyczą także wyniesionych zależności pluginów.
Użyj npm:<package>, gdy chcesz jawnie wskazać rozwiązywanie przez npm. Same specyfikacje pakietów również instalują bezpośrednio z npm podczas przejścia startowego.
Same specyfikacje i @latest pozostają na ścieżce stabilnej. Oznaczone datą wersje korekcyjne OmeniaClaw, takie jak 2026.5.3-1, są stabilnymi wydaniami dla tego sprawdzenia. Jeśli npm rozwiąże którąkolwiek z nich do wydania wstępnego, OmeniaClaw zatrzyma się i poprosi o jawne wyrażenie zgody za pomocą tagu wydania wstępnego, takiego jak @beta/@rc, lub dokładnej wersji wydania wstępnego, takiej jak @1.2.3-beta.4.
Jeśli sama specyfikacja instalacji pasuje do oficjalnego identyfikatora pluginu (na przykład diffs), OmeniaClaw instaluje bezpośrednio wpis katalogu. Aby zainstalować pakiet npm o tej samej nazwie, użyj jawnej specyfikacji z zakresem (na przykład @scope/diffs).
Repozytoria Git
Użyj git:<repo>, aby instalować bezpośrednio z repozytorium git. Obsługiwane formy obejmują git:github.com/owner/repo, git:owner/repo, pełne adresy URL klonowania https://, ssh://, git://, file:// oraz git@host:owner/repo.git. Dodaj @<ref> lub #<ref>, aby przed instalacją przełączyć się na gałąź, tag lub commit.
Instalacje Git klonują do katalogu tymczasowego, przełączają się na żądane odwołanie, gdy jest obecne, a następnie używają zwykłego instalatora katalogu pluginu. Oznacza to, że walidacja manifestu, skanowanie niebezpiecznego kodu, prace instalacyjne menedżera pakietów i rekordy instalacji zachowują się jak instalacje npm. Zarejestrowane instalacje Git obejmują źródłowy URL/ref oraz rozwiązany commit, aby OmeniaClaw plugins update mógł później ponownie rozwiązać źródło.
Po instalacji z git użyj OmeniaClaw plugins inspect <id> --runtime --json, aby zweryfikować rejestracje środowiska uruchomieniowego, takie jak metody gateway i polecenia CLI. Jeśli plugin zarejestrował korzeń CLI za pomocą api.registerCli, wykonaj to polecenie bezpośrednio przez główny CLI OmeniaClaw, na przykład OmeniaClaw demo-plugin ping.
Archiwa
Obsługiwane archiwa: .zip, .tgz, .tar.gz, .tar. Archiwa natywnych pluginów OmeniaClaw muszą zawierać prawidłowy OmeniaClaw.plugin.json w wyodrębnionym katalogu głównym pluginu; archiwa zawierające tylko package.json są odrzucane, zanim OmeniaClaw zapisze rekordy instalacji.
Użyj npm-pack:<path.tgz>, gdy plik jest tarballem npm-pack i chcesz
przetestować tę samą zarządzaną ścieżkę instalacji korzenia npm, która jest używana przez instalacje z rejestru,
w tym weryfikację package-lock.json, skanowanie wyniesionych zależności i
rekordy instalacji npm. Zwykłe ścieżki archiwów nadal instalują się jako lokalne archiwa
pod głównym katalogiem rozszerzeń pluginów.
Instalacje z marketplace Claude są również obsługiwane.
Instalacje ClawHub używają jawnego lokatora clawhub:<package>:
OmeniaClaw plugins install clawhub:OmeniaClaw-codex-app-serverOmeniaClaw plugins install clawhub:[email protected]Same specyfikacje pluginów bezpieczne dla npm instalują z npm domyślnie podczas przejścia startowego:
OmeniaClaw plugins install OmeniaClaw-codex-app-serverUżyj npm:, aby jawnie wskazać rozwiązywanie tylko przez npm:
OmeniaClaw plugins install npm:OmeniaClaw-codex-app-serverOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw sprawdza deklarowaną zgodność API pluginu / minimalną zgodność z Gateway przed instalacją. Gdy wybrana wersja ClawHub publikuje artefakt ClawPack, OmeniaClaw pobiera wersjonowany pakiet npm .tgz, weryfikuje nagłówek skrótu ClawHub oraz skrót artefaktu, a następnie instaluje go przez standardową ścieżkę archiwum. Starsze wersje ClawHub bez metadanych ClawPack nadal instalują się przez starszą ścieżkę weryfikacji archiwum pakietu. Zarejestrowane instalacje zachowują metadane źródła ClawHub, rodzaj artefaktu, integralność npm, sumę shasum npm, nazwę tarballa oraz fakty skrótu ClawPack na potrzeby późniejszych aktualizacji.
Niewersjonowane instalacje ClawHub zachowują niewersjonowaną zarejestrowaną specyfikację, aby OmeniaClaw plugins update mogło śledzić nowsze wydania ClawHub; jawne selektory wersji lub tagów, takie jak clawhub:[email protected] i clawhub:pkg@beta, pozostają przypięte do tego selektora.
Skrót marketplace
Użyj skrótu plugin@marketplace, gdy nazwa marketplace istnieje w lokalnej pamięci podręcznej rejestru Claude pod ~/.claude/plugins/known_marketplaces.json:
OmeniaClaw plugins marketplace list <marketplace-name>OmeniaClaw plugins install <plugin-name>@<marketplace-name>Użyj --marketplace, gdy chcesz jawnie przekazać źródło marketplace:
OmeniaClaw plugins install <plugin-name> --marketplace <marketplace-name>OmeniaClaw plugins install <plugin-name> --marketplace <owner/repo>OmeniaClaw plugins install <plugin-name> --marketplace https://github.com/<owner>/<repo>OmeniaClaw plugins install <plugin-name> --marketplace ./my-marketplaceŹródła marketplace
- znana nazwa marketplace Claude z
~/.claude/plugins/known_marketplaces.json - lokalny katalog główny marketplace lub ścieżka
marketplace.json - skrót repozytorium GitHub, taki jak
owner/repo - URL repozytorium GitHub, taki jak
https://github.com/owner/repo - URL git
Reguły zdalnego marketplace
W przypadku zdalnych marketplace ładowanych z GitHub lub git wpisy pluginów muszą pozostać wewnątrz sklonowanego repozytorium marketplace. OmeniaClaw akceptuje względne źródła ścieżek z tego repozytorium i odrzuca źródła pluginów HTTP(S), ścieżki bezwzględne, git, GitHub oraz inne źródła niebędące ścieżkami ze zdalnych manifestów.
Dla lokalnych ścieżek i archiwów OmeniaClaw automatycznie wykrywa:
- natywne pluginy OmeniaClaw (
OmeniaClaw.plugin.json) - pakiety zgodne z Codex (
.codex-plugin/plugin.json) - pakiety zgodne z Claude (
.claude-plugin/plugin.jsonlub domyślny układ komponentów Claude) - pakiety zgodne z Cursor (
.cursor-plugin/plugin.json)
Lista
OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --jsonOmeniaClaw plugins search <query>OmeniaClaw plugins search <query> --limit 20OmeniaClaw plugins search <query> --json--enabledbooleanPokaż tylko włączone pluginy.
--verbosebooleanPrzełącz z widoku tabeli na szczegółowe wiersze dla każdego pluginu z metadanymi źródła/pochodzenia/wersji/aktywacji.
--jsonbooleanInwentarz czytelny maszynowo oraz diagnostyka rejestru i stan instalacji zależności pakietów.
plugins search to zdalne wyszukiwanie w katalogu ClawHub. Nie sprawdza lokalnego
stanu, nie modyfikuje konfiguracji, nie instaluje pakietów ani nie ładuje kodu
runtime pluginu. Wyniki wyszukiwania zawierają nazwę pakietu ClawHub, rodzinę,
kanał, wersję, podsumowanie oraz wskazówkę instalacji, taką jak OmeniaClaw plugins install clawhub:<package>.
W przypadku pracy nad dołączonym pluginem wewnątrz spakowanego obrazu Docker zamontuj
katalog źródłowy pluginu przez bind mount na odpowiadającą mu spakowaną ścieżkę źródłową, taką jak
/app/extensions/synology-chat. OmeniaClaw odkryje tę zamontowaną nakładkę źródłową
przed /app/dist/extensions/synology-chat; zwykły skopiowany katalog źródłowy
pozostaje nieaktywny, więc standardowe instalacje pakietowe nadal używają skompilowanego dist.
Do debugowania hooków runtime:
OmeniaClaw plugins inspect <id> --runtime --jsonpokazuje zarejestrowane hooki i diagnostykę z przebiegu inspekcji po załadowaniu modułu. Inspekcja runtime nigdy nie instaluje zależności; użyjOmeniaClaw doctor --fix, aby wyczyścić starszy stan zależności lub odzyskać brakujące pluginy możliwe do pobrania, do których odwołuje się konfiguracja.OmeniaClaw gateway status --deep --require-rpcpotwierdza osiągalny Gateway, wskazówki dotyczące usługi/procesu, ścieżkę konfiguracji i stan RPC.- Niedołączone hooki konwersacji (
llm_input,llm_output,before_model_resolve,before_agent_reply,before_agent_run,before_agent_finalize,agent_end) wymagająplugins.entries.<id>.hooks.allowConversationAccess=true.
Użyj --link, aby uniknąć kopiowania lokalnego katalogu (dodaje do plugins.load.paths):
OmeniaClaw plugins install -l ./my-pluginIndeks pluginów
Metadane instalacji pluginu są stanem zarządzanym maszynowo, a nie konfiguracją użytkownika. Instalacje i aktualizacje zapisują je do plugins/installs.json w aktywnym katalogu stanu OmeniaClaw. Jego mapa najwyższego poziomu installRecords jest trwałym źródłem metadanych instalacji, w tym rekordów dla uszkodzonych lub brakujących manifestów pluginów. Tablica plugins jest pochodzącą z manifestów pamięcią podręczną zimnego rejestru. Plik zawiera ostrzeżenie, aby go nie edytować, i jest używany przez OmeniaClaw plugins update, odinstalowywanie, diagnostykę oraz zimny rejestr pluginów.
Gdy OmeniaClaw widzi dostarczone starsze rekordy plugins.installs w konfiguracji, odczyty runtime traktują je jako dane wejściowe zgodności bez przepisywania OmeniaClaw.json. Jawne zapisy pluginów i OmeniaClaw doctor --fix przenoszą te rekordy do indeksu pluginów i usuwają klucz konfiguracji, gdy zapisy konfiguracji są dozwolone; jeśli którykolwiek zapis się nie powiedzie, rekordy konfiguracji zostają zachowane, aby metadane instalacji nie zostały utracone.
Odinstalowanie
OmeniaClaw plugins uninstall <id>OmeniaClaw plugins uninstall <id> --dry-runOmeniaClaw plugins uninstall <id> --keep-filesuninstall usuwa rekordy pluginu z plugins.entries, utrwalonego indeksu pluginów, wpisów list allow/deny pluginów oraz linkowanych wpisów plugins.load.paths, gdy ma to zastosowanie. O ile nie ustawiono --keep-files, odinstalowanie usuwa również śledzony zarządzany katalog instalacji, gdy znajduje się on wewnątrz katalogu głównego rozszerzeń pluginów OmeniaClaw. W przypadku pluginów Active Memory slot pamięci resetuje się do memory-core.
Aktualizacja
OmeniaClaw plugins update <id-or-npm-spec>OmeniaClaw plugins update --allOmeniaClaw plugins update <id-or-npm-spec> --dry-runOmeniaClaw plugins update @OmeniaClaw/voice-callOmeniaClaw plugins update OmeniaClaw-codex-app-server --dangerously-force-unsafe-installAktualizacje dotyczą śledzonych instalacji pluginów w zarządzanym indeksie pluginów oraz śledzonych instalacji pakietów hooków w hooks.internal.installs.
Rozwiązywanie id pluginu kontra specyfikacja npm
Gdy przekazujesz id pluginu, OmeniaClaw ponownie używa zarejestrowanej specyfikacji instalacji dla tego pluginu. Oznacza to, że wcześniej zapisane dist-tags, takie jak @beta, oraz dokładnie przypięte wersje nadal są używane przy późniejszych uruchomieniach update <id>.
W przypadku instalacji npm możesz również przekazać jawną specyfikację pakietu npm z dist-tag lub dokładną wersją. OmeniaClaw rozwiązuje tę nazwę pakietu z powrotem do śledzonego rekordu pluginu, aktualizuje ten zainstalowany plugin i zapisuje nową specyfikację npm na potrzeby przyszłych aktualizacji opartych na id.
Przekazanie nazwy pakietu npm bez wersji lub tagu również rozwiązuje się z powrotem do śledzonego rekordu pluginu. Użyj tego, gdy plugin został przypięty do dokładnej wersji i chcesz przenieść go z powrotem na domyślną linię wydań rejestru.
Aktualizacje kanału beta
OmeniaClaw plugins update ponownie używa śledzonej specyfikacji pluginu, chyba że przekażesz nową specyfikację. OmeniaClaw update dodatkowo zna aktywny kanał aktualizacji OmeniaClaw: na kanale beta rekordy pluginów npm i ClawHub z domyślnej linii najpierw próbują @beta, a następnie wracają do zarejestrowanej specyfikacji default/latest, jeśli nie istnieje wydanie beta pluginu. Ten fallback jest raportowany jako ostrzeżenie i nie powoduje niepowodzenia aktualizacji core. Dokładne wersje i jawne tagi pozostają przypięte do tego selektora.
Sprawdzanie wersji i dryf integralności
Przed aktualizacją npm na żywo OmeniaClaw sprawdza zainstalowaną wersję pakietu względem metadanych rejestru npm. Jeśli zainstalowana wersja i zarejestrowana tożsamość artefaktu już pasują do rozwiązanego celu, aktualizacja jest pomijana bez pobierania, ponownej instalacji ani przepisywania OmeniaClaw.json.
Gdy istnieje zapisany skrót integralności, a skrót pobranego artefaktu się zmienia, OmeniaClaw traktuje to jako dryf artefaktu npm. Interaktywne polecenie OmeniaClaw plugins update wypisuje oczekiwane i rzeczywiste skróty oraz prosi o potwierdzenie przed kontynuowaniem. Nieinteraktywne helpery aktualizacji kończą się bezpiecznym niepowodzeniem, chyba że wywołujący dostarczy jawną zasadę kontynuacji.
--dangerously-force-unsafe-install przy aktualizacji
--dangerously-force-unsafe-install jest również dostępne w plugins update jako awaryjne obejście dla fałszywych alarmów wbudowanego skanowania niebezpiecznego kodu podczas aktualizacji pluginów. Nadal nie omija blokad zasad pluginu before_install ani blokowania po niepowodzeniu skanowania i dotyczy tylko aktualizacji pluginów, a nie aktualizacji pakietów hooków.
Inspekcja
OmeniaClaw plugins inspect <id>OmeniaClaw plugins inspect <id> --runtimeOmeniaClaw plugins inspect <id> --jsonInspekcja pokazuje tożsamość, stan ładowania, źródło, możliwości manifestu, flagi zasad, diagnostykę, metadane instalacji, możliwości pakietu oraz wszelkie wykryte wsparcie serwerów MCP lub LSP bez domyślnego importowania runtime pluginu. Dodaj --runtime, aby załadować moduł pluginu i uwzględnić zarejestrowane hooki, narzędzia, polecenia, usługi, metody Gateway oraz trasy HTTP. Inspekcja runtime raportuje brakujące zależności pluginu bezpośrednio; instalacje i naprawy pozostają w OmeniaClaw plugins install, OmeniaClaw plugins update i OmeniaClaw doctor --fix.
Polecenia CLI należące do pluginu są zwykle instalowane jako główne grupy poleceń OmeniaClaw, ale pluginy mogą też rejestrować zagnieżdżone polecenia pod nadrzędnym elementem core, takim jak OmeniaClaw nodes. Gdy inspect --runtime pokaże polecenie pod cliCommands, uruchom je pod wymienioną ścieżką; na przykład plugin rejestrujący demo-git można zweryfikować poleceniem OmeniaClaw demo-git ping.
Każdy plugin jest klasyfikowany według tego, co faktycznie rejestruje w runtime:
- plain-capability — jeden typ capability (np. plugin tylko dla dostawcy)
- hybrid-capability — wiele typów capability (np. tekst + mowa + obrazy)
- hook-only — tylko hooki, bez capabilities ani powierzchni
- non-capability — narzędzia/polecenia/usługi, ale bez capabilities
Więcej informacji o modelu capability znajdziesz w kształtach Plugin.
Doctor
OmeniaClaw plugins doctordoctor raportuje błędy ładowania pluginów, diagnostykę manifestu/wykrywania oraz powiadomienia o zgodności. Gdy wszystko jest poprawne, wypisuje No plugin issues detected.
Jeśli skonfigurowany plugin jest obecny na dysku, ale zablokowany przez kontrole bezpieczeństwa ścieżek loadera, walidacja konfiguracji zachowuje wpis pluginu i zgłasza go jako present but blocked. Napraw poprzedzającą diagnostykę zablokowanego pluginu, taką jak własność ścieżki lub uprawnienia do zapisu dla wszystkich, zamiast usuwać konfigurację plugins.entries.<id> lub plugins.allow.
W przypadku błędów kształtu modułu, takich jak brakujące eksporty register/activate, uruchom ponownie z OmeniaClaw_PLUGIN_LOAD_DEBUG=1, aby dołączyć zwięzłe podsumowanie kształtu eksportów w danych wyjściowych diagnostyki.
Rejestr
OmeniaClaw plugins registryOmeniaClaw plugins registry --refreshOmeniaClaw plugins registry --jsonLokalny rejestr pluginów to utrwalony model zimnego odczytu OmeniaClaw dla tożsamości zainstalowanych pluginów, ich włączenia, metadanych źródła i własności wkładów. Zwykłe uruchamianie, wyszukiwanie właściciela dostawcy, klasyfikacja konfiguracji kanału i inwentarz pluginów mogą go odczytywać bez importowania modułów runtime pluginów.
Użyj plugins registry, aby sprawdzić, czy utrwalony rejestr jest obecny, aktualny lub nieaktualny. Użyj --refresh, aby odbudować go z utrwalonego indeksu pluginów, zasad konfiguracji oraz metadanych manifestu/pakietu. To ścieżka naprawy, a nie ścieżka aktywacji runtime.
OmeniaClaw doctor --fix naprawia także zarządzane rozbieżności npm sąsiadujące z rejestrem: jeśli osierocony lub odzyskany pakiet @OmeniaClaw/* pod zarządzanym katalogiem głównym npm pluginów przesłania plugin dołączony do pakietu, doctor usuwa ten nieaktualny pakiet i odbudowuje rejestr, aby uruchamianie walidowało się względem dołączonego manifestu. Doctor ponownie łączy także pakiet hosta OmeniaClaw z zarządzanymi pluginami npm, które deklarują peerDependencies.OmeniaClaw, dzięki czemu lokalne importy runtime pakietu, takie jak OmeniaClaw/plugin-sdk/*, rozwiązują się po aktualizacjach lub naprawach npm.
Marketplace
OmeniaClaw plugins marketplace list <source>OmeniaClaw plugins marketplace list <source> --jsonLista Marketplace przyjmuje lokalną ścieżkę marketplace, ścieżkę marketplace.json, skrót GitHub w rodzaju owner/repo, URL repozytorium GitHub lub URL git. --json wypisuje rozpoznaną etykietę źródła oraz sparsowany manifest marketplace i wpisy pluginów.
