Kelola Plugin

Gunakan halaman ini untuk perintah umum pengelolaan plugin. Untuk kontrak perintah, flag, aturan pemilihan sumber, dan kasus tepi yang lengkap, lihat openclaw plugins.

Sebagian besar alur kerja pemasangan adalah:

1. menemukan paket
2. memasangnya dari ClawHub, npm, git, atau jalur lokal
3. membiarkan Gateway terkelola melakukan mulai ulang otomatis, atau memulainya ulang secara manual saat tidak terkelola
4. memverifikasi pendaftaran runtime plugin

Daftar dan cari plugin

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"

Gunakan --json untuk skrip:

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

plugins list adalah pemeriksaan inventaris dingin. Ini menampilkan apa yang dapat ditemukan OpenClaw dari konfigurasi, manifes, dan registri plugin; ini tidak membuktikan bahwa Gateway yang sudah berjalan telah mengimpor runtime plugin. Keluaran JSON menyertakan diagnostik registri dan dependencyStatus statis setiap plugin saat paket plugin mendeklarasikan dependencies atau optionalDependencies.

plugins search mengueri ClawHub untuk paket plugin yang dapat dipasang dan mencetak petunjuk pemasangan seperti openclaw plugins install clawhub:<package>.

Pasang plugin

# Search ClawHub for plugin packages.openclaw plugins search "calendar" # Install from ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Install from npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Install from a local npm pack artifact.openclaw plugins install npm-pack:<path.tgz> # Install from git or a local development checkout.openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Spesifikasi paket tanpa awalan dipasang dari npm selama cutover peluncuran. Gunakan clawhub:, npm:, git:, atau npm-pack: saat Anda membutuhkan pemilihan sumber yang deterministik. Jika nama tanpa awalan cocok dengan id plugin resmi, OpenClaw dapat memasang entri katalog secara langsung.

Gunakan --force hanya saat Anda sengaja ingin menimpa target pemasangan yang sudah ada. Untuk peningkatan rutin pemasangan npm, ClawHub, atau hook-pack yang terlacak, gunakan openclaw plugins update.

Mulai ulang dan inspeksi

Setelah memasang, memperbarui, atau mencopot kode plugin, Gateway terkelola yang sedang berjalan dengan pemuatan ulang konfigurasi aktif akan dimulai ulang secara otomatis. Jika Gateway tidak terkelola atau pemuatan ulang dinonaktifkan, mulai ulang sendiri sebelum memeriksa permukaan runtime langsung:

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

Gunakan inspect --runtime saat Anda membutuhkan bukti bahwa plugin telah mendaftarkan permukaan runtime seperti alat, hook, layanan, metode Gateway, rute HTTP, atau perintah CLI milik plugin. inspect dan list biasa adalah pemeriksaan dingin untuk manifes, konfigurasi, dan registri.

Perbarui plugin

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-run

Saat Anda meneruskan id plugin, OpenClaw menggunakan kembali spesifikasi pemasangan yang terlacak. Dist-tag tersimpan seperti @beta dan versi persis yang dipin akan terus digunakan pada eksekusi update <plugin-id> berikutnya.

openclaw plugins update --all adalah jalur pemeliharaan massal. Ini tetap menghormati spesifikasi pemasangan terlacak biasa, tetapi catatan plugin resmi OpenClaw tepercaya dapat disinkronkan ke target katalog resmi saat ini, alih-alih tetap pada paket resmi persis yang sudah usang. Jika update.channel diatur ke beta, sinkronisasi resmi massal itu menggunakan konteks kanal beta. Gunakan update <plugin-id> yang ditargetkan saat Anda sengaja ingin mempertahankan spesifikasi resmi persis atau bertag agar tidak tersentuh.

Untuk pemasangan npm, Anda dapat meneruskan spesifikasi paket eksplisit untuk mengganti catatan terlacak:

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

Perintah kedua memindahkan plugin kembali ke lini rilis default registri saat sebelumnya dipin ke versi persis atau tag.

Saat openclaw update berjalan di kanal beta, catatan plugin dapat lebih memilih rilis @beta yang cocok. Untuk fallback persis dan aturan pinning, lihat openclaw plugins.

Copot plugin

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

Pencopotan menghapus entri konfigurasi plugin, catatan indeks plugin yang dipersistenkan, entri daftar izinkan/tolak, dan jalur muat tertaut jika berlaku. Direktori pemasangan terkelola dihapus kecuali Anda meneruskan --keep-files. Gateway terkelola yang sedang berjalan dimulai ulang secara otomatis saat pencopotan mengubah sumber plugin.

Dalam mode Nix (OPENCLAW_NIX_MODE=1), perintah pasang, perbarui, copot, aktifkan, dan nonaktifkan plugin dinonaktifkan. Kelola pilihan tersebut di sumber Nix untuk pemasangan sebagai gantinya.

Pilih sumber

Pemasangan jalur lokal terkelola harus berupa direktori atau arsip plugin. Masukkan file plugin mandiri di plugins.load.paths, bukan memasangnya dengan plugins install.

Publikasikan plugin

ClawHub adalah permukaan penemuan publik utama untuk plugin OpenClaw. Publikasikan di sana saat Anda ingin pengguna menemukan metadata plugin, riwayat versi, hasil pemindaian registri, dan petunjuk pemasangan sebelum mereka memasang.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/your-plugin@v1.0.0

Plugin npm native harus menyertakan manifes plugin dan metadata paket sebelum dipublikasikan:

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

npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/openclaw-plugin@1.0.0

Gunakan halaman ini untuk kontrak publikasi lengkap, alih-alih memperlakukan halaman ini sebagai referensi publikasi:

• Publikasi ClawHub menjelaskan pemilik, cakupan, rilis, peninjauan, validasi paket, dan transfer paket.
• Membangun plugin menunjukkan bentuk paket plugin dan alur kerja publikasi pertama.
• Manifes plugin mendefinisikan field manifes plugin native.

Jika paket yang sama tersedia di ClawHub dan npm, gunakan awalan eksplisit clawhub: atau npm: saat Anda perlu memaksa satu sumber.

Terkait

• Plugin - pasang, konfigurasi, mulai ulang, dan pecahkan masalah
• openclaw plugins - referensi CLI lengkap
• Plugin komunitas - penemuan publik dan publikasi ClawHub
• ClawHub - operasi CLI registri
• Membangun plugin - buat paket plugin
• Manifes plugin - manifes dan metadata paket