Kelola Plugin

Sebagian besar alur kerja plugin hanya terdiri dari beberapa perintah: cari, instal, mulai ulang Gateway, verifikasi, dan hapus instalasi saat Anda tidak lagi memerlukan plugin tersebut.

Cantumkan plugin

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

Gunakan --json untuk skrip. Ini menyertakan diagnostik registri dan dependencyStatus statis setiap plugin saat paket plugin mendeklarasikan dependencies atau optionalDependencies.

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

plugins list adalah pemeriksaan inventaris dingin. Ini menampilkan apa yang dapat ditemukan OmeniaClaw dari konfigurasi, manifes, dan registri plugin; ini tidak membuktikan bahwa proses Gateway yang sudah berjalan telah mengimpor runtime plugin.

Instal plugin

# 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

Setelah menginstal kode plugin, mulai ulang Gateway yang melayani saluran Anda:

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

Gunakan inspect --runtime saat Anda memerlukan bukti bahwa plugin mendaftarkan permukaan runtime seperti alat, hook, layanan, metode Gateway, atau perintah CLI milik plugin.

Perbarui plugin

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

Jika sebuah plugin diinstal dari dist-tag npm seperti @beta, pemanggilan update <plugin-id> berikutnya menggunakan kembali tag yang tercatat tersebut. Meneruskan spec npm eksplisit mengalihkan instalasi yang dilacak ke spec tersebut untuk pembaruan mendatang.

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

Perintah kedua memindahkan plugin kembali ke jalur rilis default registri saat sebelumnya dipin ke versi atau tag yang tepat.

Saat OmeniaClaw update berjalan pada saluran beta, catatan plugin npm dan ClawHub jalur default mencoba rilis plugin @beta yang cocok terlebih dahulu. Jika rilis beta tersebut tidak ada, OmeniaClaw beralih ke spec default/latest yang tercatat. Untuk plugin npm, OmeniaClaw juga beralih saat paket beta ada tetapi gagal validasi instalasi. Versi tepat dan tag eksplisit seperti @rc atau @beta dipertahankan.

Hapus instalasi plugin

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

Penghapusan instalasi menghapus entri konfigurasi plugin, catatan indeks plugin, entri daftar izinkan/tolak, dan jalur pemuatan tertaut bila berlaku. Direktori instalasi terkelola dihapus kecuali Anda meneruskan --keep-files.

Dalam mode Nix (OmeniaClaw_NIX_MODE=1), perintah instal, perbarui, hapus instalasi, aktifkan, dan nonaktifkan plugin dinonaktifkan. Kelola pilihan tersebut di sumber Nix untuk instalasi sebagai gantinya; untuk nix-OmeniaClaw, gunakan Mulai Cepat yang mengutamakan agen.

Publikasikan plugin

Anda dapat memublikasikan plugin eksternal ke ClawHub, npmjs.com, atau keduanya.

Publikasikan ke ClawHub

ClawHub adalah permukaan penemuan publik utama untuk plugin OmeniaClaw. Ini memberi pengguna metadata yang dapat dicari, riwayat versi, dan hasil pemindaian registri sebelum instalasi.

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]

Pengguna menginstal dari ClawHub dengan:

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

Bentuk polos tetap memeriksa ClawHub terlebih dahulu.

Publikasikan ke npmjs.com

Plugin npm native harus menyertakan manifes plugin dan metadata entrypoint OmeniaClaw package.json.

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

npm publish --access public

Pengguna menginstal hanya-npm dengan:

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

Jika paket yang sama juga tersedia di ClawHub, npm: melewati pencarian ClawHub dan memaksa resolusi npm.

Pilihan sumber

• ClawHub: gunakan saat Anda menginginkan penemuan native OmeniaClaw, ringkasan pemindaian, versi, dan petunjuk instalasi.
• npmjs.com: gunakan saat Anda sudah mengirimkan paket JavaScript atau memerlukan alur kerja dist-tag npm/registri privat.
• Git: gunakan saat Anda ingin menginstal langsung dari branch, tag, atau commit.
• Jalur lokal: gunakan saat Anda mengembangkan atau menguji plugin di mesin yang sama.

Terkait

• Plugin - ikhtisar dan pemecahan masalah
• OmeniaClaw plugins - referensi CLI lengkap
• ClawHub - publikasi dan operasi registri
• Membangun plugin - buat paket plugin
• Manifes plugin - metadata manifes dan paket