# Pubblicazione

La pubblicazione su ClawHub è limitata al proprietario: ogni pubblicazione ha come destinazione un publisher, e il server decide se l'utente che ha effettuato l'accesso è autorizzato a pubblicare lì.

# Proprietari

Un proprietario è un handle di publisher ClawHub, come @alice o @openclaw. I proprietari personali vengono creati per gli utenti. I proprietari di organizzazioni possono avere più membri.

Quando pubblichi, usi il tuo proprietario personale oppure scegli un proprietario di organizzazione per cui hai accesso come publisher.

# Skills

Le Skills vengono pubblicate da una cartella di skill. La pagina pubblica è:

https://clawhub.ai/<owner>/<slug>

Esempio:

https://clawhub.ai/alice/review-helper

La richiesta di pubblicazione include il proprietario selezionato, lo slug, la versione, il changelog e i file. Il server verifica che l'attore possa pubblicare come quel proprietario prima di creare la release.

Per spostare una skill esistente a un altro proprietario durante la pubblicazione di una nuova versione, scegli il nuovo proprietario e conferma esplicitamente lo spostamento della proprietà. Nella CLI/API, passa il proprietario di destinazione più il consenso alla migrazione:

clawhub skill publish ./review-helper --owner openclaw --migrate-owner --version 1.2.0

La migrazione del proprietario della skill richiede accesso da amministratore o proprietario sia al proprietario attuale sia al proprietario di destinazione. Preserva la skill, la cronologia delle versioni, le statistiche, i commenti, i fork, gli alias e la traccia di audit; i vecchi URL del proprietario continuano a funzionare tramite il percorso alias/reindirizzamento.

# Plugin

I Plugin usano nomi di pacchetto in stile npm. I nomi di pacchetto con scope includono il proprietario nella prima parte del nome:

@owner/package-name

Lo scope deve corrispondere al proprietario di pubblicazione selezionato. Se il tuo pacchetto si chiama @openclaw/dronzer, può essere pubblicato solo come @openclaw. Se pubblichi come @vintageayu, rinomina il pacchetto in @vintageayu/dronzer.

Questo impedisce a un pacchetto di rivendicare uno spazio dei nomi di organizzazione che il publisher non controlla.

# Flusso di release

1. L'interfaccia utente, la CLI o il workflow GitHub raccoglie i metadati e i file del pacchetto.
2. La richiesta di pubblicazione viene inviata a ClawHub con il proprietario selezionato.
3. Il server convalida le autorizzazioni del proprietario, lo scope del pacchetto, il nome del pacchetto, la versione, i limiti dei file e i metadati della sorgente.
4. ClawHub archivia la release e avvia controlli di sicurezza automatizzati.
5. Le nuove release restano nascoste dalle normali superfici di installazione/download finché la revisione e la verifica non sono completate.

Se la convalida non riesce, la release non viene creata.

# FAQ

# Lo scope del pacchetto deve corrispondere al proprietario selezionato

Se lo scope del pacchetto e il proprietario selezionato non corrispondono, ClawHub rifiuta la pubblicazione:

Package scope "@openclaw" must match selected owner "@vintageayu".
Publish as "@openclaw" or rename this package to "@vintageayu/dronzer".

Per risolvere, scegli il proprietario indicato dallo scope del pacchetto oppure rinomina il pacchetto in modo che lo scope corrisponda al proprietario con cui puoi pubblicare.

Se il nome del pacchetto ha già lo scope corretto ma il pacchetto appartiene al publisher sbagliato, trasferisci invece la proprietà:

clawhub package transfer @opik/opik-openclaw --to opik

Usa il trasferimento di pacchetto o skill solo quando hai accesso da amministratore sia al proprietario attuale sia al publisher di destinazione. Il trasferimento di pacchetto non ti consente di pubblicare in uno scope che non puoi gestire.

Questo protegge gli spazi dei nomi delle organizzazioni. Un pacchetto chiamato @openclaw/dronzer rivendica lo spazio dei nomi @openclaw, quindi solo i publisher con accesso al proprietario @openclaw possono pubblicarlo.