Skills

ClawHub

ClawHub adalah registri publik untuk OpenClaw Skills dan Plugin.

Gunakan perintah openclaw bawaan untuk mencari, menginstal, dan memperbarui Skills, serta untuk menginstal Plugin dari ClawHub.
Gunakan CLI clawhub terpisah untuk alur kerja autentikasi registri, publikasi, penghapusan/pemulihan penghapusan, dan sinkronisasi.

Mulai cepat

Cari

openclaw skills search "calendar"

Instal

openclaw skills install <skill-slug>

Gunakan

Mulai sesi OpenClaw baru - sesi tersebut akan mengambil skill baru.

Publikasikan (opsional)

Untuk alur kerja yang diautentikasi registri (publikasi, sinkronisasi, kelola), instal CLI clawhub terpisah:

npm i -g clawhub
# or
pnpm add -g clawhub

Alur OpenClaw bawaan

Skills

openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all

Perintah openclaw bawaan menginstal ke ruang kerja aktif Anda dan mempertahankan metadata sumber agar panggilan update berikutnya tetap dapat menggunakan ClawHub.

Plugin

openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all

plugins search menanyakan katalog Plugin ClawHub dan mencetak nama paket yang siap diinstal. Gunakan clawhub:<package> saat Anda menginginkan resolusi ClawHub. Spesifikasi Plugin mentah yang aman untuk npm diinstal dari npm selama transisi peluncuran:

openclaw plugins install openclaw-codex-app-server

npm:<package> juga hanya npm dan berguna saat suatu spesifikasi dapat menjadi ambigu:

openclaw plugins install npm:openclaw-codex-app-server

Instalasi Plugin memvalidasi kompatibilitas pluginApi dan minGatewayVersion yang diiklankan sebelum instalasi arsip berjalan, sehingga host yang tidak kompatibel gagal tertutup lebih awal, bukan menginstal paket secara parsial. Saat versi paket menerbitkan artefak ClawPack, OpenClaw memilih .tgz npm-pack unggahan yang persis, memverifikasi header digest ClawHub dan byte yang diunduh, serta mencatat jenis artefak, integritas npm, shasum npm, nama tarball, dan metadata digest ClawPack untuk pembaruan berikutnya. Versi paket lama tanpa metadata ClawPack tetap menggunakan jalur verifikasi arsip paket lama.

Apa itu ClawHub

Registri publik untuk OpenClaw Skills dan Plugin.
Penyimpanan bundle skill dan metadata berversi.
Permukaan penemuan untuk pencarian, tag, dan sinyal penggunaan.

Skill biasa adalah bundle file berversi yang mencakup:

File SKILL.md dengan deskripsi utama dan penggunaan.
Konfigurasi, skrip, atau file pendukung opsional yang digunakan oleh skill.
Metadata seperti tag, ringkasan, dan persyaratan instalasi.

ClawHub menggunakan metadata untuk mendukung penemuan dan mengekspos kapabilitas skill dengan aman. Registri melacak sinyal penggunaan (bintang, unduhan) untuk meningkatkan peringkat dan visibilitas. Setiap publikasi membuat versi semver baru, dan registri menyimpan riwayat versi agar pengguna dapat mengaudit perubahan.

Ruang kerja dan pemuatan skill

CLI clawhub terpisah juga menginstal Skills ke ./skills di bawah direktori kerja Anda saat ini. Jika ruang kerja OpenClaw dikonfigurasi, clawhub kembali ke ruang kerja tersebut kecuali Anda mengganti --workdir (atau CLAWHUB_WORKDIR). OpenClaw memuat Skills ruang kerja dari <workspace>/skills dan mengambilnya pada sesi berikutnya.

Jika Anda sudah menggunakan ~/.openclaw/skills atau Skills bawaan, Skills ruang kerja akan diprioritaskan. Untuk detail lebih lanjut tentang cara Skills dimuat, dibagikan, dan digating, lihat Skills.

Fitur layanan

Fitur	Catatan
Penelusuran publik	Skills dan konten `SKILL.md`-nya dapat dilihat publik.
Pencarian	Didukung embedding (pencarian vektor), bukan hanya kata kunci.
Pembuatan versi	Semver, changelog, dan tag (termasuk `latest`).
Unduhan	Zip per versi.
Bintang dan komentar	Umpan balik komunitas.
Ringkasan pemindaian keamanan	Halaman detail menampilkan status pemindaian terbaru sebelum instalasi atau unduhan.
Halaman detail pemindai	Hasil VirusTotal, ClawScan, dan analisis statis memiliki tautan mendalam.
Dasbor pemulihan pemilik	Penerbit dapat melihat konten milik mereka yang ditahan pemindaian dari `/dashboard`.
Pemindaian ulang atas permintaan pemilik	Pemilik dapat meminta pemindaian ulang terbatas untuk pemulihan positif palsu.
Moderasi	Persetujuan dan audit.
API ramah CLI	Cocok untuk otomatisasi dan scripting.

Keamanan dan moderasi

ClawHub terbuka secara default - siapa pun dapat mengunggah Skills, tetapi akun GitHub harus berusia setidaknya satu minggu untuk menerbitkan. Ini memperlambat penyalahgunaan tanpa memblokir kontributor yang sah.

Pemindaian keamanan

ClawHub menjalankan pemeriksaan keamanan otomatis pada Skills dan rilis Plugin yang dipublikasikan. Halaman detail publik merangkum hasil saat ini, dan baris pemindai tertaut ke halaman detail khusus untuk VirusTotal, ClawScan, dan analisis statis.

Rilis yang ditahan pemindaian atau diblokir mungkin tidak tersedia di katalog publik dan permukaan instalasi, tetapi tetap terlihat oleh pemiliknya di /dashboard.

Pelaporan

Setiap pengguna yang masuk dapat melaporkan skill.
Alasan laporan wajib diisi dan dicatat.
Setiap pengguna dapat memiliki hingga 20 laporan aktif sekaligus.
Skills dengan lebih dari 3 laporan unik disembunyikan otomatis secara default.

Moderasi

Moderator dapat melihat Skills tersembunyi, menampilkannya kembali, menghapusnya, atau memblokir pengguna.
Penyalahgunaan fitur laporan dapat berakibat pemblokiran akun.
Tertarik menjadi moderator? Tanyakan di Discord OpenClaw dan hubungi moderator atau maintainer.

CLI ClawHub

Anda hanya memerlukan ini untuk alur kerja yang diautentikasi registri seperti publikasi/sinkronisasi.

Opsi global

"--workdir

"--dir

"--site

"--registry

--no-inputboolean

Nonaktifkan prompt (noninteraktif).

-V, --cli-versionboolean

Cetak versi CLI.

Perintah

Auth (login / logout / whoami)

clawhub login              # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami

Opsi login:

--token <token> - tempel token API.
--label <label> - label yang disimpan untuk token login browser (default: CLI token).
--no-browser - jangan buka browser (memerlukan --token).

Pencarian

clawhub search "query"

Mencari Skills. Untuk penemuan Plugin/paket, gunakan clawhub package explore.

--limit <n> - hasil maksimum.

Jelajahi / inspeksi Plugin

clawhub package explore --family code-plugin
clawhub package explore "episodic-claw" --family code-plugin
clawhub package inspect episodic-claw

package explore dan package inspect adalah permukaan CLI ClawHub untuk penemuan Plugin/paket dan inspeksi metadata. Instalasi OpenClaw bawaan tetap menggunakan openclaw plugins install clawhub:<package>.

Opsi:

--family skill|code-plugin|bundle-plugin - filter keluarga paket.
--official - tampilkan hanya paket resmi.
--executes-code - tampilkan hanya paket yang mengeksekusi kode.
--version <version> / --tag <tag> - inspeksi versi paket tertentu.
--versions, --files, --file <path> - inspeksi riwayat paket dan file.
--json - keluaran yang dapat dibaca mesin.

Instal / perbarui / daftar

clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list

Opsi:

--version <version> - instal atau perbarui ke versi tertentu (hanya satu slug pada update).
--force - timpa jika folder sudah ada, atau saat file lokal tidak cocok dengan versi mana pun yang dipublikasikan.
clawhub list membaca .clawhub/lock.json.

Publikasikan Skills

clawhub skill publish <path>

Opsi:

--slug <slug> - slug skill.
--name <name> - nama tampilan.
--version <version> - versi semver.
--changelog <text> - teks changelog (boleh kosong).
--tags <tags> - tag yang dipisahkan koma (default: latest).

Publikasikan Plugin

clawhub package publish <source>

<source> dapat berupa folder lokal, owner/repo, owner/repo@ref, atau URL GitHub.

Opsi:

--dry-run - bangun rencana publikasi persis tanpa mengunggah apa pun.
--json - keluarkan keluaran yang dapat dibaca mesin untuk CI.
--source-repo, --source-commit, --source-ref - penggantian opsional saat deteksi otomatis tidak cukup.

Minta pemindaian ulang

clawhub skill rescan <slug>
clawhub skill rescan <slug> --yes --json

clawhub package rescan <name>
clawhub package rescan <name> --yes --json

Perintah pemindaian ulang memerlukan token pemilik yang sudah login dan menargetkan versi skill atau rilis Plugin terbaru yang dipublikasikan. Dalam eksekusi noninteraktif, berikan --yes.

Respons JSON mencakup jenis target, nama, versi, status pemindaian ulang, dan jumlah permintaan tersisa/maksimum untuk versi atau rilis tersebut.

Hapus / pulihkan penghapusan (pemilik atau admin)

clawhub delete <slug> --yes
clawhub undelete <slug> --yes

Sinkronisasi (pindai lokal + publikasikan baru atau diperbarui)

clawhub sync

Opsi:

--root <dir...> - root pemindaian tambahan.
--all - unggah semuanya tanpa prompt.
--dry-run - tampilkan apa yang akan diunggah.
--bump <type> - patch|minor|major untuk pembaruan (default: patch).
--changelog <text> - changelog untuk pembaruan noninteraktif.
--tags <tags> - tag yang dipisahkan koma (default: latest).
--concurrency <n> - pemeriksaan registri (default: 4).

Alur kerja umum

Cari

clawhub search "postgres backups"

Cari plugin

clawhub package explore --family code-plugin
clawhub package explore "memory" --family code-plugin
clawhub package inspect episodic-claw

Instal

clawhub install my-skill-pack

Perbarui semua

clawhub update --all

Publikasikan satu skill

clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

Sinkronkan banyak skill

clawhub sync --all

Publikasikan plugin dari GitHub

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]
clawhub package publish https://github.com/your-org/your-plugin

Metadata paket Plugin

Plugin kode harus menyertakan metadata OpenClaw yang diperlukan di package.json:

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./src/index.ts"],
    "runtimeExtensions": ["./dist/index.js"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}

Paket yang dipublikasikan sebaiknya mengirimkan JavaScript yang sudah dibangun dan mengarahkan runtimeExtensions ke keluaran tersebut. Instalasi dari checkout Git masih dapat kembali menggunakan sumber TypeScript ketika tidak ada file hasil build, tetapi entri runtime yang sudah dibangun menghindari kompilasi TypeScript saat runtime pada jalur startup, doctor, dan pemuatan plugin.

Pemversian, lockfile, dan telemetri

Pemversian dan tag

Setiap publikasi membuat SkillVersion semver baru.
Tag (seperti latest) menunjuk ke sebuah versi; memindahkan tag memungkinkan Anda melakukan rollback.
Changelog dilampirkan per versi dan dapat kosong saat menyinkronkan atau memublikasikan pembaruan.

Perubahan lokal vs versi registry

Pembaruan membandingkan konten skill lokal dengan versi registry menggunakan hash konten. Jika file lokal tidak cocok dengan versi yang sudah dipublikasikan, CLI meminta konfirmasi sebelum menimpa (atau memerlukan --force dalam eksekusi non-interaktif).

Pemindaian sinkronisasi dan root fallback

clawhub sync memindai workdir Anda saat ini terlebih dahulu. Jika tidak ada skill yang ditemukan, perintah ini kembali ke lokasi legacy yang dikenal (misalnya ~/openclaw/skills dan ~/.openclaw/skills). Ini dirancang untuk menemukan instalasi skill lama tanpa flag tambahan.

Penyimpanan dan lockfile

Skill yang terinstal dicatat di .clawhub/lock.json di bawah workdir Anda.
Token autentikasi disimpan dalam file konfigurasi CLI ClawHub (override melalui CLAWHUB_CONFIG_PATH).

Telemetri (jumlah instalasi)

Saat Anda menjalankan clawhub sync ketika sudah masuk, CLI mengirim snapshot minimal untuk menghitung jumlah instalasi. Anda dapat menonaktifkan ini sepenuhnya:

export CLAWHUB_DISABLE_TELEMETRY=1

Variabel lingkungan

Variabel	Efek
`CLAWHUB_SITE`	Override URL situs.
`CLAWHUB_REGISTRY`	Override URL API registry.
`CLAWHUB_CONFIG_PATH`	Override tempat CLI menyimpan token/konfigurasi.
`CLAWHUB_WORKDIR`	Override workdir default.
`CLAWHUB_DISABLE_TELEMETRY=1`	Nonaktifkan telemetri pada `sync`.

ClawHub

Mulai cepat

Cari

Instal

Gunakan

Publikasikan (opsional)

Alur OpenClaw bawaan

Skills

Plugin

Apa itu ClawHub

Ruang kerja dan pemuatan skill

Fitur layanan

Keamanan dan moderasi

CLI ClawHub

Opsi global

Perintah

Alur kerja umum

Cari

Cari plugin

Instal

Perbarui semua

Publikasikan satu skill

Sinkronkan banyak skill

Publikasikan plugin dari GitHub

Metadata paket Plugin

Pemversian, lockfile, dan telemetri

Variabel lingkungan

Terkait

Ask OpenClaw

# Mulai cepat

Cari

Instal

Gunakan

Publikasikan (opsional)

# Alur OpenClaw bawaan

Skills

Plugin

# Apa itu ClawHub

# Ruang kerja dan pemuatan skill

# Fitur layanan

# Keamanan dan moderasi

# CLI ClawHub

# Opsi global

# Perintah

# Alur kerja umum

Cari

Cari plugin

Instal

Perbarui semua

Publikasikan satu skill

Sinkronkan banyak skill

Publikasikan plugin dari GitHub

# Metadata paket Plugin

# Pemversian, lockfile, dan telemetri

# Variabel lingkungan

# Terkait

Mulai cepat

Alur OpenClaw bawaan

Apa itu ClawHub

Ruang kerja dan pemuatan skill

Fitur layanan

Keamanan dan moderasi

CLI ClawHub

Opsi global

Perintah

Alur kerja umum

Metadata paket Plugin

Pemversian, lockfile, dan telemetri

Variabel lingkungan

Terkait