ClawHub

ClawHub esegue controlli di sicurezza automatizzati sulle skill pubblicate e sulle release dei Plugin. Le pagine di dettaglio pubbliche riassumono il risultato corrente e le righe degli scanner collegano a pagine di dettaglio dedicate per VirusTotal, ClawScan e analisi statica.

Le release trattenute dalla scansione o bloccate possono non essere disponibili nel catalogo pubblico e nelle superfici di installazione, pur rimanendo visibili al proprietario in /dashboard.

• Qualsiasi utente autenticato può segnalare una skill.
• I motivi della segnalazione sono obbligatori e registrati.
• Ogni utente può avere fino a 20 segnalazioni attive alla volta.
• Le skill con più di 3 segnalazioni uniche sono nascoste automaticamente per impostazione predefinita.

• I moderatori possono visualizzare le skill nascoste, renderle di nuovo visibili, eliminarle o bannare utenti.
• L'abuso della funzione di segnalazione può comportare il ban dell'account.
• Ti interessa diventare moderatore? Chiedi nel Discord di OpenClaw e contatta un moderatore o un maintainer.

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

Opzioni di login:

• --token <token> - incolla un token API.
• --label <label> - etichetta archiviata per i token di login tramite browser (predefinito: CLI token).
• --no-browser - non aprire un browser (richiede --token).

clawhub search "query"

Cerca le skill. Per la scoperta di Plugin/pacchetti, usa clawhub package explore.

• --limit <n> - risultati massimi.

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

package explore e package inspect sono le superfici della CLI ClawHub per la scoperta di Plugin/pacchetti e l'ispezione dei metadati. Le installazioni native di OpenClaw usano comunque openclaw plugins install clawhub:<package>.

Opzioni:

• --family skill|code-plugin|bundle-plugin - filtra la famiglia del pacchetto.
• --official - mostra solo pacchetti ufficiali.
• --executes-code - mostra solo pacchetti che eseguono codice.
• --version <version> / --tag <tag> - ispeziona una versione specifica del pacchetto.
• --versions, --files, --file <path> - ispeziona la cronologia e i file del pacchetto.
• --json - output leggibile da macchina.

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

Opzioni:

• --version <version> - installa o aggiorna a una versione specifica (slug singolo solo su update).
• --force - sovrascrivi se la cartella esiste già o quando i file locali non corrispondono ad alcuna versione pubblicata.
• clawhub list legge .clawhub/lock.json.

clawhub skill publish <path>

Opzioni:

• --slug <slug> - slug della skill.
• --name <name> - nome visualizzato.
• --version <version> - versione semver.
• --changelog <text> - testo del changelog (può essere vuoto).
• --tags <tags> - tag separati da virgole (predefinito: latest).

clawhub package publish <source>

<source> può essere una cartella locale, owner/repo, owner/repo@ref o un URL GitHub.

Opzioni:

• --dry-run - crea il piano esatto di pubblicazione senza caricare nulla.
• --json - emetti output leggibile da macchina per CI.
• --source-repo, --source-commit, --source-ref - override opzionali quando il rilevamento automatico non basta.

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

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

I comandi di nuova scansione richiedono un token proprietario autenticato e puntano all'ultima versione della skill pubblicata o release del Plugin. Nelle esecuzioni non interattive, passa --yes.

Le risposte JSON includono il tipo del target, nome, versione, stato della nuova scansione e conteggi residui/massimi delle richieste per quella versione o release.

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

clawhub sync

Opzioni:

• --root <dir...> - radici di scansione aggiuntive.
• --all - carica tutto senza prompt.
• --dry-run - mostra cosa verrebbe caricato.
• --bump <type> - patch|minor|major per gli aggiornamenti (predefinito: patch).
• --changelog <text> - changelog per aggiornamenti non interattivi.
• --tags <tags> - tag separati da virgole (predefinito: latest).
• --concurrency <n> - controlli del registro (predefinito: 4).

• Ogni pubblicazione crea una nuova SkillVersion semver.
• I tag (come latest) puntano a una versione; spostare i tag consente di eseguire il rollback.
• I changelog sono associati per versione e possono essere vuoti durante la sincronizzazione o la pubblicazione di aggiornamenti.

Gli aggiornamenti confrontano i contenuti locali della skill con le versioni del registro usando un hash del contenuto. Se i file locali non corrispondono a nessuna versione pubblicata, la CLI chiede conferma prima di sovrascrivere (o richiede --force nelle esecuzioni non interattive).

clawhub sync esamina prima la directory di lavoro corrente. Se non vengono trovate skill, ripiega sulle posizioni legacy note (per esempio ~/openclaw/skills e ~/.openclaw/skills). Questo è pensato per trovare installazioni di skill più vecchie senza flag aggiuntivi.

• Le skill installate sono registrate in .clawhub/lock.json sotto la tua directory di lavoro.
• I token di autenticazione sono archiviati nel file di configurazione della CLI di ClawHub (sovrascrivibile tramite CLAWHUB_CONFIG_PATH).

Quando esegui clawhub sync dopo aver effettuato l'accesso, la CLI invia uno snapshot minimo per calcolare i conteggi di installazione. Puoi disattivarlo completamente:

export CLAWHUB_DISABLE_TELEMETRY=1