Langsung ke konten utama
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 list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
openclaw 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.3
openclaw plugins install clawhub:<package>@beta

# Install from npm.
openclaw plugins install npm:<package>
openclaw plugins install npm:@scope/openclaw-plugin@1.2.3
openclaw 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.0
openclaw plugins install ./my-plugin
openclaw 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 restart
openclaw 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 --all
openclaw 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@beta
openclaw 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-run
openclaw 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

SumberGunakan saatContoh
ClawHubAnda menginginkan penemuan asli OpenClaw, ringkasan pemindaian, versi, dan petunjukopenclaw plugins install clawhub:<package>
npmjs.comAnda sudah mengirim paket JavaScript atau membutuhkan dist-tag npm/registri privatopenclaw plugins install npm:@acme/openclaw-plugin
gitAnda menginginkan branch, tag, atau commit dari repositoriopenclaw plugins install git:github.com/<owner>/<repo>@<ref>
jalur lokalAnda sedang mengembangkan atau menguji plugin di mesin yang samaopenclaw plugins install --link ./my-plugin
npm packAnda sedang membuktikan artefak paket lokal melalui semantik pemasangan npmopenclaw plugins install npm-pack:<path.tgz>
marketplaceAnda sedang memasang plugin marketplace yang kompatibel dengan Claudeopenclaw plugins install <plugin> --marketplace <source>
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 clawhub
clawhub login
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/your-plugin@v1.0.0
Plugin npm native harus menyertakan manifes plugin dan metadata paket sebelum dipublikasikan:
package.json
{
  "name": "@acme/openclaw-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}

npm publish --access public
openclaw plugins install npm:@acme/openclaw-plugin
openclaw plugins install npm:@acme/openclaw-plugin@beta
openclaw 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