> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Publishing # Penerbitan Penerbitan mengirim folder Skills atau paket Plugin ke ClawHub di bawah pemilik yang Anda pilih. ClawHub memeriksa bahwa token Anda dapat menerbitkan untuk pemilik tersebut, memvalidasi metadata, nama, versi, file, dan informasi sumber, lalu menyimpan rilis dan memulai pemeriksaan keamanan otomatis. Jika validasi gagal, tidak ada yang diterbitkan. Rilis baru juga dapat tetap tidak muncul dari permukaan instalasi dan unduhan normal sampai peninjauan selesai. ## Skills Jalur penerbitan paling sederhana adalah CLI. Masuk, lalu terbitkan folder Skills lokal: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub login clawhub skill publish ./my-skill \ --slug my-skill \ --name "My Skill" \ --owner ``` Gunakan `--owner ` saat menerbitkan ke pemilik organisasi. Abaikan untuk menerbitkan sebagai pengguna yang diautentikasi. Penerbitan melewati konten yang tidak berubah. Skills baru dimulai pada `1.0.0`, dan perubahan berikutnya secara otomatis menerbitkan versi patch berikutnya. Berikan `--version` hanya ketika Anda memerlukan versi eksplisit. Untuk repo katalog, gunakan [`skill-publish.yml` workflow](https://github.com/openclaw/clawhub/blob/main/.github/workflows/skill-publish.yml) pakai ulang milik ClawHub. Workflow ini memanggil `skill publish` untuk setiap folder Skills langsung di bawah `root` (default: `skills`), atau hanya folder yang diberikan sebagai `skill_path`. ```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}} jobs: publish: uses: openclaw/clawhub/.github/workflows/skill-publish.yml@main with: owner: dry_run: false secrets: clawhub_token: ${{ secrets.CLAWHUB_TOKEN }} ``` Gunakan `dry_run: true` untuk meninjau Skills baru dan yang berubah tanpa menerbitkan. ## Plugin Plugin menggunakan nama paket bergaya npm. Nama paket berscope menyertakan pemilik di bagian pertama nama: ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} @owner/package-name ``` Scope harus cocok dengan pemilik penerbitan yang dipilih. Jika paket Anda bernama `@openclaw/dronzer`, paket itu hanya dapat diterbitkan sebagai `@openclaw`. Jika Anda menerbitkan sebagai `@vintageayu`, ganti nama paket menjadi `@vintageayu/dronzer`. Ini mencegah paket mengklaim namespace organisasi yang tidak dikendalikan oleh penerbit. Jika Anda adalah pemilik sah dari organisasi, merek, scope paket, handle pemilik, atau namespace yang sudah diklaim atau dicadangkan di ClawHub, buka [isu Klaim Organisasi / Namespace](https://github.com/openclaw/clawhub/issues/new?template=org-namespace-claim.yml) dengan bukti publik yang tidak sensitif. Lihat [Klaim Organisasi dan Namespace](/id/clawhub/namespace-claims) untuk apa yang harus disertakan dan apa yang harus dijauhkan dari isu publik. ### Sebelum Menerbitkan Plugin * Pilih pemilik yang cocok dengan scope paket. * Sertakan `openclaw.plugin.json`. Plugin kode juga memerlukan `package.json` dengan `openclaw.compat.pluginApi` dan `openclaw.build.openclawVersion`. * Untuk menampilkan ikon kartu Plugin kustom, tambahkan `icon` ke `openclaw.plugin.json` dengan URL gambar HTTPS apa pun. * Sertakan repositori sumber dan metadata commit persis, atau gunakan CLI dari checkout yang didukung GitHub agar dapat mendeteksinya. * Jalankan `clawhub package validate ` sebelum menerbitkan. Untuk temuan paket, manifes, impor SDK, atau artefak, lihat [perbaikan validasi Plugin](/id/clawhub/plugin-validation-fixes). * Jalankan `clawhub package publish --dry-run` sebelum membuat rilis. * Perkirakan rilis baru tetap tidak muncul dari permukaan instalasi publik sampai pemeriksaan keamanan otomatis dan verifikasi selesai. ### Penerbitan Tepercaya untuk Paket Penerbitan tepercaya paket adalah penyiapan dua langkah: 1. Terbitkan paket sekali melalui `clawhub package publish` manual normal atau yang diautentikasi token. Ini membuat baris paket dan menetapkan pengelola paket yang dapat mengubah konfigurasi penerbit tepercaya paket. 2. Pengelola paket mengatur konfigurasi penerbit tepercaya GitHub Actions: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package trusted-publisher set @owner/package-name \ --repository owner/repo \ --workflow-filename package-publish.yml ``` Setelah konfigurasi diatur, penerbitan GitHub Actions yang didukung di masa mendatang dapat menggunakan OIDC/penerbitan tepercaya tanpa menyimpan token ClawHub berumur panjang di repositori. Repositori dan nama file workflow yang dikonfigurasi harus cocok dengan klaim OIDC GitHub Actions. Jika Anda juga memberikan `--environment `, klaim lingkungan GitHub Actions harus sama persis dengan nama tersebut. ClawHub memverifikasi repositori GitHub yang dikonfigurasi saat konfigurasi penerbit tepercaya diatur. Repositori publik dapat diverifikasi melalui metadata GitHub publik. Repositori privat mengharuskan ClawHub memiliki akses GitHub ke repositori tersebut, misalnya melalui instalasi GitHub App ClawHub di masa mendatang atau integrasi GitHub lain yang diotorisasi. Workflow penerbitan paket pakai ulang saat ini mendukung penerbitan tepercaya tanpa secret untuk penerbitan `workflow_dispatch` saat `id-token: write` tersedia. Penerbitan nyata dari push tag masih memerlukan `clawhub_token`, jadi tetap sediakan `CLAWHUB_TOKEN` untuk rilis tag, penerbitan pertama, paket tidak tepercaya, atau penerbitan darurat. Periksa atau hapus konfigurasi dengan: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package trusted-publisher get @owner/package-name clawhub package trusted-publisher delete @owner/package-name ``` Menghapus konfigurasi penerbit tepercaya adalah jalur rollback. Ini menonaktifkan pembuatan token penerbitan tepercaya di masa mendatang sampai pengelola paket mengatur konfigurasi lagi. ## FAQ ### Scope paket harus cocok dengan pemilik yang dipilih Jika scope paket dan pemilik yang dipilih tidak cocok, ClawHub menolak penerbitan: ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} Package scope "@openclaw" must match selected owner "@vintageayu". Publish as "@openclaw" or rename this package to "@vintageayu/dronzer". ``` Untuk memperbaikinya, pilih pemilik yang dinamai oleh scope paket, atau ganti nama paket agar scope cocok dengan pemilik yang dapat Anda gunakan untuk menerbitkan. Jika nama paket sudah memiliki scope yang benar tetapi paket dimiliki oleh penerbit yang salah, transfer kepemilikan sebagai gantinya: ```sh theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub package transfer @opik/opik-openclaw --to opik ``` Gunakan transfer paket atau Skills hanya ketika Anda memiliki akses admin ke pemilik saat ini dan penerbit tujuan. Transfer paket tidak memungkinkan Anda menerbitkan ke scope yang tidak dapat Anda kelola. Jika Anda tidak memiliki akses ke pemilik saat ini tetapi yakin organisasi, proyek, atau merek Anda adalah pemilik namespace yang sah, buka [isu Klaim Organisasi / Namespace](https://github.com/openclaw/clawhub/issues/new?template=org-namespace-claim.yml) dengan bukti publik yang tidak sensitif untuk ditinjau staf. Lihat [Klaim Organisasi dan Namespace](/id/clawhub/namespace-claims) sebelum mengajukan. Ini melindungi namespace organisasi. Paket bernama `@openclaw/dronzer` mengklaim namespace `@openclaw`, sehingga hanya penerbit dengan akses ke pemilik `@openclaw` yang dapat menerbitkannya.