Bundel Plugin

OpenClaw dapat memasang plugin dari tiga ekosistem eksternal: Codex, Claude, dan Cursor. Ini disebut bundel — paket konten dan metadata yang dipetakan OpenClaw ke fitur asli seperti skill, hook, dan alat MCP.

Bundel tidak sama dengan plugin asli OpenClaw. Plugin asli berjalan dalam proses dan dapat mendaftarkan kemampuan apa pun. Bundel adalah paket konten dengan pemetaan fitur selektif dan batas kepercayaan yang lebih sempit.

Mengapa bundel ada

Banyak plugin berguna diterbitkan dalam format Codex, Claude, atau Cursor. Alih-alih mewajibkan penulis menulis ulangnya sebagai plugin asli OpenClaw, OpenClaw mendeteksi format ini dan memetakan konten yang didukung ke dalam kumpulan fitur asli. Ini berarti Anda dapat memasang paket perintah Claude atau bundel skill Codex dan langsung menggunakannya.

Memasang bundel

Pasang dari direktori, arsip, atau marketplace

# Local directory
openclaw plugins install ./my-bundle

# Archive
openclaw plugins install ./my-bundle.tgz

# Claude marketplace
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>

Verifikasi deteksi

openclaw plugins list
openclaw plugins inspect <id>

Bundel tampil sebagai Format: bundle dengan subtipe codex, claude, atau cursor.

Mulai ulang dan gunakan

openclaw gateway restart

Fitur yang dipetakan (skill, hook, alat MCP, default LSP) tersedia pada sesi berikutnya.

Yang dipetakan OpenClaw dari bundel

Tidak semua fitur bundel berjalan di OpenClaw saat ini. Berikut ini yang berfungsi dan yang terdeteksi tetapi belum dirangkai.

Didukung sekarang

Fitur	Cara pemetaannya	Berlaku untuk
Konten skill	Root skill bundel dimuat sebagai skill OpenClaw biasa	Semua format
Perintah	`commands/` dan `.cursor/commands/` diperlakukan sebagai root skill	Claude, Cursor
Paket hook	Tata letak `HOOK.md` + `handler.ts` bergaya OpenClaw	Codex
Alat MCP	Konfigurasi MCP bundel digabungkan ke pengaturan Pi tersemat; server stdio dan HTTP yang didukung dimuat	Semua format
Server LSP	`.lsp.json` Claude dan `lspServers` yang dideklarasikan manifest digabungkan ke default LSP Pi tersemat	Claude
Pengaturan	`settings.json` Claude diimpor sebagai default Pi tersemat	Claude

Konten skill

root skill bundel dimuat sebagai root skill OpenClaw biasa
root commands Claude diperlakukan sebagai root skill tambahan
root .cursor/commands Cursor diperlakukan sebagai root skill tambahan

Ini berarti file perintah markdown Claude bekerja melalui pemuat skill OpenClaw biasa. Markdown perintah Cursor bekerja melalui jalur yang sama.

Paket hook

root hook bundel bekerja hanya saat menggunakan tata letak paket hook OpenClaw biasa. Saat ini ini terutama kasus yang kompatibel dengan Codex:
- HOOK.md
- handler.ts atau handler.js

MCP untuk Pi

bundel yang diaktifkan dapat menyumbangkan konfigurasi server MCP
OpenClaw menggabungkan konfigurasi MCP bundel ke pengaturan Pi tersemat efektif sebagai mcpServers
OpenClaw mengekspos alat MCP bundel yang didukung selama giliran agen Pi tersemat dengan meluncurkan server stdio atau menghubungkan ke server HTTP
profil alat coding dan messaging menyertakan alat MCP bundel secara default; gunakan tools.deny: ["bundle-mcp"] untuk menolak ikut bagi agen atau gateway
pengaturan Pi lokal proyek tetap berlaku setelah default bundel, sehingga pengaturan workspace dapat menimpa entri MCP bundel bila diperlukan
katalog alat MCP bundel diurutkan secara deterministik sebelum pendaftaran, sehingga perubahan urutan listTools() upstream tidak mengacaukan blok alat cache prompt

Transport

Server MCP dapat menggunakan transport stdio atau HTTP: Stdio meluncurkan proses anak:

{
  "mcp": {
    "servers": {
      "my-server": {
        "command": "node",
        "args": ["server.js"],
        "env": { "PORT": "3000" }
      }
    }
  }
}

HTTP terhubung ke server MCP yang sedang berjalan melalui sse secara default, atau streamable-http bila diminta:

{
  "mcp": {
    "servers": {
      "my-server": {
        "url": "http://localhost:3100/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer ${MY_SECRET_TOKEN}"
        },
        "connectionTimeoutMs": 30000
      }
    }
  }
}

transport dapat diatur ke "streamable-http" atau "sse"; bila dihilangkan, OpenClaw menggunakan sse
type: "http" adalah bentuk downstream asli CLI; gunakan transport: "streamable-http" dalam konfigurasi OpenClaw. openclaw mcp set dan openclaw doctor --fix menormalkan alias umum tersebut.
hanya skema URL http: dan https: yang diizinkan
nilai headers mendukung interpolasi ${ENV_VAR}
entri server dengan command dan url sekaligus ditolak
kredensial URL (userinfo dan parameter kueri) disamarkan dari deskripsi alat dan log
connectionTimeoutMs menimpa batas waktu koneksi default 30 detik untuk transport stdio maupun HTTP

Penamaan alat

OpenClaw mendaftarkan alat MCP bundel dengan nama yang aman untuk provider dalam bentuk serverName__toolName. Misalnya, server dengan kunci "vigil-harbor" yang mengekspos alat memory_search didaftarkan sebagai vigil-harbor__memory_search.

karakter di luar A-Za-z0-9_- diganti dengan -
fragmen yang akan dimulai dengan non-huruf mendapatkan awalan huruf, sehingga kunci server numerik seperti 12306 menjadi prefiks alat yang aman untuk provider
prefiks server dibatasi hingga 30 karakter
nama alat penuh dibatasi hingga 64 karakter
nama server kosong menggunakan fallback mcp
nama hasil sanitasi yang bertabrakan dibedakan dengan sufiks numerik
urutan alat akhir yang diekspos bersifat deterministik berdasarkan nama aman untuk menjaga giliran Pi berulang tetap stabil untuk cache
pemfilteran profil memperlakukan semua alat dari satu server MCP bundel sebagai milik plugin oleh bundle-mcp, sehingga allowlist dan daftar penolakan profil dapat menyertakan nama alat terekspos individual atau kunci plugin bundle-mcp

Pengaturan Pi tersemat

settings.json Claude diimpor sebagai pengaturan Pi tersemat default saat bundel diaktifkan
OpenClaw menyanitasi kunci override shell sebelum menerapkannya

Kunci yang disanitasi:

shellPath
shellCommandPrefix

LSP Pi tersemat

bundel Claude yang diaktifkan dapat menyumbangkan konfigurasi server LSP
OpenClaw memuat .lsp.json ditambah path lspServers apa pun yang dideklarasikan manifest
konfigurasi LSP bundel digabungkan ke default LSP Pi tersemat efektif
hanya server LSP yang didukung dan berbasis stdio yang dapat dijalankan saat ini; transport yang tidak didukung tetap muncul di openclaw plugins inspect <id>

Terdeteksi tetapi tidak dieksekusi

Ini dikenali dan ditampilkan dalam diagnostik, tetapi OpenClaw tidak menjalankannya:

agents, otomatisasi hooks.json, outputStyles Claude
.cursor/agents, .cursor/hooks.json, .cursor/rules Cursor
metadata inline/aplikasi Codex di luar pelaporan kemampuan

Format bundel

Bundel Codex

Penanda: .codex-plugin/plugin.jsonKonten opsional: skills/, hooks/, .mcp.json, .app.jsonBundel Codex paling cocok dengan OpenClaw saat menggunakan root skill dan direktori paket hook bergaya OpenClaw (HOOK.md + handler.ts).

Bundel Claude

Dua mode deteksi:

Berbasis manifest: .claude-plugin/plugin.json
Tanpa manifest: tata letak Claude default (skills/, commands/, agents/, hooks/, .mcp.json, .lsp.json, settings.json)

Perilaku khusus Claude:

commands/ diperlakukan sebagai konten skill
settings.json diimpor ke pengaturan Pi tersemat (kunci override shell disanitasi)
.mcp.json mengekspos alat stdio yang didukung ke Pi tersemat
.lsp.json ditambah path lspServers yang dideklarasikan manifest dimuat ke default LSP Pi tersemat
hooks/hooks.json terdeteksi tetapi tidak dieksekusi
Path komponen khusus dalam manifest bersifat aditif (memperluas default, bukan menggantikannya)

Bundel Cursor

Penanda: .cursor-plugin/plugin.jsonKonten opsional: skills/, .cursor/commands/, .cursor/agents/, .cursor/rules/, .cursor/hooks.json, .mcp.json

.cursor/commands/ diperlakukan sebagai konten skill
.cursor/rules/, .cursor/agents/, dan .cursor/hooks.json hanya dideteksi

Prioritas deteksi

OpenClaw memeriksa format plugin asli terlebih dahulu:

openclaw.plugin.json atau package.json valid dengan openclaw.extensions — diperlakukan sebagai plugin asli
Penanda bundel (.codex-plugin/, .claude-plugin/, atau tata letak Claude/Cursor default) — diperlakukan sebagai bundel

Jika direktori memuat keduanya, OpenClaw menggunakan jalur asli. Ini mencegah paket format ganda dipasang sebagian sebagai bundel.

Dependensi runtime dan pembersihan

Bundel kompatibel pihak ketiga tidak mendapatkan perbaikan npm install saat startup. Bundel harus dipasang melalui openclaw plugins install dan membawa semua yang dibutuhkannya di direktori plugin yang terpasang.
Plugin bundel milik OpenClaw dikirim ringan di core atau dapat diunduh melalui pemasang plugin. Startup Gateway tidak pernah menjalankan package manager untuknya.
openclaw doctor --fix menghapus direktori dependensi staged lama dan dapat memulihkan plugin yang dapat diunduh yang hilang dari indeks plugin lokal saat konfigurasi merujuknya.

Keamanan

Bundel memiliki batas kepercayaan yang lebih sempit daripada plugin asli:

OpenClaw tidak memuat modul runtime bundel arbitrer dalam proses
Path skill dan paket hook harus tetap berada di dalam root plugin (diperiksa batasnya)
File pengaturan dibaca dengan pemeriksaan batas yang sama
Server MCP stdio yang didukung dapat diluncurkan sebagai subprocess

Ini membuat bundel lebih aman secara default, tetapi Anda tetap harus memperlakukan bundel pihak ketiga sebagai konten tepercaya untuk fitur yang memang mereka ekspos.

Pemecahan masalah

Bundel terdeteksi tetapi kemampuan tidak berjalan

Jalankan openclaw plugins inspect <id>. Jika kemampuan terdaftar tetapi ditandai sebagai belum dirangkai, itu adalah batas produk — bukan pemasangan yang rusak.

File perintah Claude tidak muncul

Pastikan bundel diaktifkan dan file markdown berada di dalam root commands/ atau skills/ yang terdeteksi.

Pengaturan Claude tidak diterapkan

Hanya pengaturan Pi tersemat dari settings.json yang didukung. OpenClaw tidak memperlakukan pengaturan bundel sebagai patch konfigurasi mentah.

Hook Claude tidak dieksekusi

hooks/hooks.json hanya dideteksi. Jika Anda membutuhkan hook yang dapat dijalankan, gunakan tata letak paket hook OpenClaw atau kirim plugin asli.

Terkait

Memasang dan Mengonfigurasi Plugin
Membangun Plugin — membuat plugin asli
Manifest Plugin — skema manifest asli

Overview

Plugins

Bundled plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Mengapa bundel ada

Memasang bundel

Yang dipetakan OpenClaw dari bundel

Didukung sekarang

Konten skill

Paket hook

MCP untuk Pi

Transport

Penamaan alat

Pengaturan Pi tersemat

LSP Pi tersemat

Terdeteksi tetapi tidak dieksekusi

Format bundel

Prioritas deteksi

Dependensi runtime dan pembersihan

Keamanan

Pemecahan masalah

Terkait

Overview

Plugins

Bundled plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Documentation Index

​Mengapa bundel ada

​Memasang bundel

​Yang dipetakan OpenClaw dari bundel

​Didukung sekarang

​Konten skill

​Paket hook

​MCP untuk Pi

Transport

Penamaan alat

​Pengaturan Pi tersemat

​LSP Pi tersemat

​Terdeteksi tetapi tidak dieksekusi

​Format bundel

​Prioritas deteksi

​Dependensi runtime dan pembersihan

​Keamanan

​Pemecahan masalah

​Terkait

Mengapa bundel ada

Memasang bundel

Yang dipetakan OpenClaw dari bundel

Didukung sekarang

Konten skill

Paket hook

MCP untuk Pi

Pengaturan Pi tersemat

LSP Pi tersemat

Terdeteksi tetapi tidak dieksekusi

Format bundel

Prioritas deteksi

Dependensi runtime dan pembersihan

Keamanan

Pemecahan masalah

Terkait