339 lines
8.5 KiB
Markdown
339 lines
8.5 KiB
Markdown
# Installazione Interattiva: Orto Skills via Chat OpenClaw
|
||
|
||
**Per utenti che vogliono installare le skill Orto direttamente da chat senza comandi terminale**
|
||
|
||
---
|
||
|
||
## 🎯 Obiettivo
|
||
|
||
Installare tutte le 9 skill Orto su OpenClaw **solo tramite chat**, semplicemente:
|
||
1. Caricando il pacchetto `.tar.gz`
|
||
2. Dicendo "installa le skill orto"
|
||
3. Rispondendo a poche domande
|
||
4. Ottenendo un piano completo
|
||
|
||
**Zero comandi terminale. Tutto gestito da me (AgentePotente).**
|
||
|
||
---
|
||
|
||
## 📦 Prerequisiti
|
||
|
||
- ✅ Accesso a questa chat OpenClaw
|
||
- ✅ File `orto-skills-v1.0-dist.tar.gz` (77 KB)
|
||
- ✅ Nessun accesso server necessario
|
||
- ✅ Nessun comando manuale richiesto
|
||
|
||
---
|
||
|
||
## 🚀 Procedura 3-Step
|
||
|
||
### Step 1: Carica il Package
|
||
|
||
**Cosa fare:**
|
||
1. Scarica `orto-skills-v1.0-dist.tar.gz` (77 KB)
|
||
2. Carica il file in questa chat (drag & drop)
|
||
3. Aspetta la verifica
|
||
|
||
**Esempio messaggio:**
|
||
```
|
||
[Carica file orto-skills-v1.0-dist.tar.gz]
|
||
```
|
||
|
||
**Io risponderò:**
|
||
```
|
||
✅ Package ricevuto
|
||
📊 Verificando integrità...
|
||
- File size: 77 KB ✓
|
||
- Formato: tar.gz ✓
|
||
- Skill files: 9 ✓
|
||
|
||
Pronto per installazione!
|
||
```
|
||
|
||
---
|
||
|
||
### Step 2: Chiedi Installazione
|
||
|
||
**Cosa fare:**
|
||
Scrivi uno di questi messaggi:
|
||
- "Installa le skill orto"
|
||
- "Procedo con l'installazione?"
|
||
- "Vai con l'installazione"
|
||
|
||
**Cosa succede:**
|
||
Io eseguirò automaticamente:
|
||
1. Estrazione del package
|
||
2. Verifica dei file
|
||
3. Installazione in `~/.openclaw/skills/orto-suite/`
|
||
4. Test di validazione
|
||
|
||
**Risposta:**
|
||
```
|
||
🔄 Installazione in corso... (30 secondi)
|
||
|
||
✅ 9 skill estratte
|
||
✅ Tutti file verificati
|
||
✅ Installazione completata
|
||
|
||
📂 Location: ~/.openclaw/skills/orto-suite/
|
||
|
||
Pronto! Che facciamo adesso?
|
||
```
|
||
|
||
---
|
||
|
||
### Step 3: Crea Il Tuo Primo Orto
|
||
|
||
**Cosa fare:**
|
||
Rispondi semplicemente alle mie domande:
|
||
|
||
```
|
||
🌍 Dove vuoi il tuo orto?
|
||
|
||
1️⃣ Provincia (es: Roma)
|
||
2️⃣ Regione (es: Lazio)
|
||
3️⃣ Nome orto (es: "Orto Testaccio")
|
||
4️⃣ Coordinate (opzionale, es: 41.8782, 12.4922)
|
||
```
|
||
|
||
**Esempio risposta:**
|
||
```
|
||
Roma, Lazio, Orto Testaccio, 41.8782, 12.4922
|
||
```
|
||
|
||
**Io farò:**
|
||
```
|
||
✅ Orto creato: orto_roma_testaccio_001
|
||
|
||
Adesso, dimmi di più del tuo orto (5 domande):
|
||
|
||
1️⃣ Quanto spazio hai? (m²)
|
||
2️⃣ Esposizione sole: pieno/parziale/ombra?
|
||
3️⃣ Acqua: rubinetto/pozzo/pluviale?
|
||
4️⃣ Quante persone? Qual è la dieta?
|
||
5️⃣ Ore/settimana disponibili per orto?
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 Complete Flow (Dal Caricamento al Piano)
|
||
|
||
```
|
||
┌─ UPLOAD ────────────────────────────┐
|
||
│ Tu: Carica file │
|
||
│ Io: Verifica package │
|
||
└─────────────────────────────────────┘
|
||
↓
|
||
┌─ INSTALL ───────────────────────────┐
|
||
│ Tu: "Installa" │
|
||
│ Io: Esegue installation script │
|
||
│ Verifica 9 skill │
|
||
└─────────────────────────────────────┘
|
||
↓
|
||
┌─ CREATE GARDEN ─────────────────────┐
|
||
│ Tu: Rispondi domande (localizzazione)
|
||
│ Io: Crea orto + registro │
|
||
└─────────────────────────────────────┘
|
||
↓
|
||
┌─ ONBOARDING ────────────────────────┐
|
||
│ Tu: Rispondi 5 blocchi domande │
|
||
│ Io: Raccolgo profile (spazio, dieta)│
|
||
└─────────────────────────────────────┘
|
||
↓
|
||
┌─ FULL PLANNING ─────────────────────┐
|
||
│ Tu: "Genera piano completo" │
|
||
│ Io: Esegue orchestratore │
|
||
│ Merge di tutti i dati │
|
||
│ Validazione QA │
|
||
└─────────────────────────────────────┘
|
||
↓
|
||
┌─ RESULTS ───────────────────────────┐
|
||
│ Piano stagionale completo │
|
||
│ - Colture (12 varietà) │
|
||
│ - Calendario (52 settimane) │
|
||
│ - Layout aiuole │
|
||
│ - Irrigazione (3 zone) │
|
||
│ - Prevenzione malattie │
|
||
└─────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## ❓ Domande Frequenti
|
||
|
||
### D: Cosa succede se la connessione cade?
|
||
**R:** L'installazione è atomica — o tutto funziona, o riproviamo. Niente mezzotermini.
|
||
|
||
### D: Posso installare più orti contemporaneamente?
|
||
**R:** Sì! Ogni orto ha un ID unico. Crea più progetti.
|
||
|
||
### D: I dati rimangono privati?
|
||
**R:** Sì. Tutto è locale in `~/.openclaw/workspace/Orti/`. Io non leggo dati personali.
|
||
|
||
### D: Posso modificare il piano dopo?
|
||
**R:** Sì, tutti i file sono markdown editabili. Modificali e comunica le cambiate.
|
||
|
||
### D: Quanto spazio occupa?
|
||
**R:** ~636 KB totali (skills + references). Leggero.
|
||
|
||
### D: Funziona offline?
|
||
**R:** Quasi. Il meteo ha bisogno internet (ma ha fallback). Tutto altro è offline.
|
||
|
||
---
|
||
|
||
## 🐛 Troubleshooting
|
||
|
||
### Problema: "File non riconosciuto"
|
||
**Soluzione:**
|
||
- Scarica di nuovo il file
|
||
- Verifica che finisca con `.tar.gz`
|
||
- Ricaricare in chat
|
||
|
||
### Problema: "Installazione fallita"
|
||
**Soluzione:**
|
||
- Leggi il log di errore
|
||
- Chiedi "cosa è andato male?"
|
||
- Riproverò con diagnostica
|
||
|
||
### Problema: "9 skill non trovate"
|
||
**Soluzione:**
|
||
- Il package potrebbe essere corrotto
|
||
- Scarica di nuovo
|
||
- Se persiste, contatta support
|
||
|
||
### Problema: "Permission denied"
|
||
**Soluzione:**
|
||
- Io eseguo come utente corrente
|
||
- Se persiste, forse file system issue
|
||
- Proviamo backup/restore
|
||
|
||
---
|
||
|
||
## ✅ Verifica Installazione
|
||
|
||
Dopo che io dico "✅ Installazione completata", puoi verificare:
|
||
|
||
**In chat, chiedi:**
|
||
```
|
||
"Mostrami che le skill sono installate"
|
||
```
|
||
|
||
**Io risponderò mostrando:**
|
||
- 9 directory skill
|
||
- Ogni SKILL.md presente
|
||
- Test di funzionamento
|
||
|
||
---
|
||
|
||
## 🎓 Cosa Aspettarsi Dal Piano
|
||
|
||
Dopo completamento, riceverai:
|
||
|
||
**📋 Files Generati:**
|
||
- `PlanBundle_Master.md` — Piano stagionale completo
|
||
- `piano_colture_annuale.md` — Colture (12 varietà)
|
||
- `calendario_operativo_settimanale.md` — Task settimanali
|
||
- `aiuole_dimensioni.md` — Layout fisico
|
||
- `sistema_irrigazione.md` — Irrigazione multi-zona
|
||
- `diagnosi_problemi.md` — Prevenzione malattie
|
||
- `audit_trail.md` — Log di ogni azione
|
||
|
||
**📊 Informazioni Contenute:**
|
||
- ✅ Colture selezionate per te + clima
|
||
- ✅ 52 settimane di task settimanali
|
||
- ✅ Calendario di semina/trapianto/raccolta
|
||
- ✅ Sistema irrigazione personalizzato
|
||
- ✅ Prevenzione biologica malattie
|
||
- ✅ Layout fisico aiuole
|
||
- ✅ Note accessibilità
|
||
|
||
**📥 Download:**
|
||
Tutti i file rimangono in `~/.openclaw/workspace/Orti/orto_*/`
|
||
Puoi scaricarli, condividerli, modificarli.
|
||
|
||
---
|
||
|
||
## 🌱 Una Volta Installato...
|
||
|
||
### Supporto Settimanale
|
||
|
||
Ogni lunedì, chiedi:
|
||
```
|
||
"Brief settimanale per [nome_orto]"
|
||
```
|
||
|
||
Riceverai:
|
||
- 🌤️ Previsione meteo 7 giorni
|
||
- 📋 Task questa settimana
|
||
- 🚨 Alert (gelo, vento, caldo)
|
||
- 💧 Aggiustamenti irrigazione
|
||
|
||
### Modifica Piano
|
||
|
||
Se qualcosa non ti piace:
|
||
```
|
||
"Voglio aggiungere [coltura] al piano"
|
||
"Ridimensiona l'area irrigazione"
|
||
"Cambia le date di semina"
|
||
```
|
||
|
||
Io ricalcolo e ricreo il piano.
|
||
|
||
### Domande Su Specifiche
|
||
|
||
Puoi chiedere qualsiasi cosa sui dati:
|
||
```
|
||
"Quale è la migliore consociazione per il Pomodoro?"
|
||
"Quanta acqua serve la Lettuga?"
|
||
"Quando è il gelo a Roma?"
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 Iniziamo!
|
||
|
||
**Pronto? Ecco cosa fare ora:**
|
||
|
||
1. **Scarica il file**
|
||
- `orto-skills-v1.0-dist.tar.gz` (77 KB)
|
||
- Da: [insert download link or GitHub]
|
||
|
||
2. **Carica in chat**
|
||
- Drag & drop file qui
|
||
- Aspetta verifica
|
||
|
||
3. **Scrivi il comando**
|
||
- "Installa le skill orto"
|
||
- Io farò il resto
|
||
|
||
4. **Rispondi alle domande**
|
||
- Localizzazione orto
|
||
- Profilo utente
|
||
- Dettagli orto
|
||
|
||
5. **Ricevi il piano**
|
||
- Completo, pronto, personalizzato
|
||
- Markdown editabile
|
||
- Scaricabile
|
||
|
||
---
|
||
|
||
## 📞 Supporto
|
||
|
||
Durante l'installazione:
|
||
- Se qualcosa non torna, chiedi "cosa è andato male?"
|
||
- Se i file non caricano, riprova
|
||
- Se non capisci una domanda, chiedi di ripeterla
|
||
|
||
Dopo installazione:
|
||
- Chiedi cosa vuoi modificare
|
||
- Chiedi supporto settimanale
|
||
- Chiedi chiarimenti su dati
|
||
|
||
---
|
||
|
||
## 🎁 Pronto!
|
||
|
||
**Non ci rimane che iniziare!**
|
||
|
||
Carica il file e dimmi quando sei pronto. 🌱
|