Containers
ClawDock
ClawDock è un piccolo livello di comandi shell ausiliari per le installazioni di OpenClaw basate su Docker.
Fornisce comandi brevi come clawdock-start, clawdock-dashboard e clawdock-fix-token al posto di chiamate docker compose ... più lunghe.
Se non hai ancora configurato Docker, inizia da Docker.
Installazione
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.shecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrcSe in precedenza hai installato ClawDock da scripts/shell-helpers/clawdock-helpers.sh, reinstallalo dal percorso corrente scripts/clawdock/clawdock-helpers.sh; il vecchio percorso raw di GitHub è stato rimosso.
Al primo utilizzo, i comandi ausiliari rilevano automaticamente il checkout di OpenClaw (controllando percorsi comuni come ~/openclaw e ~/projects/openclaw) e memorizzano il risultato nella cache in ~/.clawdock/config. Imposta manualmente CLAWDOCK_DIR se il checkout si trova altrove.
Funzionalità disponibili
Operazioni di base
| Comando | Descrizione |
|---|---|
clawdock-start |
Avvia il Gateway |
clawdock-stop |
Arresta il Gateway |
clawdock-restart |
Riavvia il Gateway |
clawdock-status |
Verifica lo stato del container |
clawdock-logs |
Segue i log del Gateway |
Accesso al container
| Comando | Descrizione |
|---|---|
clawdock-shell |
Apre una shell nel container del Gateway |
clawdock-cli <command> |
Esegue i comandi della CLI di OpenClaw in Docker |
clawdock-exec <command> |
Esegue un comando arbitrario nel container |
Interfaccia web e associazione
| Comando | Descrizione |
|---|---|
clawdock-dashboard |
Apre l'URL dell'interfaccia di controllo |
clawdock-devices |
Elenca le associazioni di dispositivi in sospeso |
clawdock-approve <id> |
Approva una richiesta di associazione |
Configurazione e manutenzione
| Comando | Descrizione |
|---|---|
clawdock-fix-token |
Scrive il token del Gateway nella configurazione del container |
clawdock-update |
Scarica, ricompila e riavvia |
clawdock-rebuild |
Ricompila solo l'immagine Docker |
clawdock-clean |
Rimuove container e volumi |
Utilità
| Comando | Descrizione |
|---|---|
clawdock-health |
Esegue un controllo di integrità del Gateway |
clawdock-token |
Visualizza il token del Gateway |
clawdock-cd |
Passa alla directory del progetto OpenClaw |
clawdock-config |
Apre ~/.openclaw |
clawdock-show-config |
Visualizza i file di configurazione con i valori oscurati |
clawdock-workspace |
Apre la directory dello spazio di lavoro |
clawdock-help |
Elenca tutti i comandi ClawDock |
Procedura per il primo utilizzo
clawdock-startclawdock-fix-tokenclawdock-dashboardSe il browser indica che è necessaria l'associazione:
clawdock-devicesclawdock-approve <request-id>Configurazione e segreti
ClawDock legge due file .env distinti, in conformità con la suddivisione descritta in Docker:
- Il file
.envdel progetto accanto adocker-compose.yml: valori specifici di Docker, come il nome dell'immagine, le porte eOPENCLAW_GATEWAY_TOKEN.clawdock-tokenlegge il token da questo file. ~/.openclaw/.env(montato nel container): segreti basati su variabili d'ambiente gestiti direttamente da OpenClaw, insieme aopenclaw.jsoneagents/<agentId>/agent/auth-profiles.json.
clawdock-fix-token copia il token dal file .env del progetto nei valori di configurazione gateway.remote.token e gateway.auth.token del container, quindi riavvia il Gateway.
Usa clawdock-show-config per esaminare rapidamente openclaw.json ed entrambi i file .env; nell'output visualizzato, i valori dei file .env vengono oscurati.
