Integrazione OpenClaw
OpenClaw è una piattaforma di assistenti AI che può interagire con WhenToMeet attraverso la nostra API. Questa integrazione ti permette di creare eventi di pianificazione, controllare la disponibilità e gestire il tuo calendario utilizzando comandi in linguaggio naturale.
Cos'è OpenClaw?
OpenClaw è una piattaforma che ti permette di connettere assistenti AI ai tuoi strumenti preferiti. Con la skill WhenToMeet per OpenClaw, puoi:
- Creare eventi di pianificazione di gruppo
- Elencare e visualizzare i tuoi eventi esistenti
- Controllare la disponibilità dei partecipanti
- Prenotare fasce orarie sulle pagine di pianificazione altrui
Configurazione
1. Crea una Chiave API con Ambito Limitato
Per sicurezza, ti consigliamo di creare una chiave API con permessi limitati specificamente per OpenClaw:
- Vai su Impostazioni → Chiavi API
- Clicca su "Crea Chiave API"
- Inserisci un nome (es. "Integrazione OpenClaw")
- Seleziona permessi "Standard" — questo permette di creare eventi e visualizzare dati senza accesso all'eliminazione
- Copia immediatamente la chiave
2. Configura OpenClaw
Aggiungi la tua chiave API alla configurazione di OpenClaw:
{
"skills": {
"entries": {
"whentomeet": {
"apiKey": "sk_your_api_key_here"
}
}
}
}
La chiave viene iniettata come WHENTOMEET_API_KEY durante l'esecuzione.
Considerazioni sulla Sicurezza
Condividere chiavi API con servizi di terze parti comporta rischi intrinseci. Utilizzando l'integrazione OpenClaw, riconosci che:
- La tua chiave API sarà memorizzata e utilizzata dai server di OpenClaw
- OpenClaw avrà accesso ai tuoi eventi, prenotazioni e connessioni calendario
- Sei responsabile del monitoraggio dell'utilizzo e della revoca dell'accesso se necessario
Utilizza a tuo rischio.
Buone Pratiche
- Usa l'ambito "Standard" — Questo limita OpenClaw alla creazione di eventi e visualizzazione dei dati, senza la possibilità di eliminare nulla
- Monitora l'utilizzo — Controlla regolarmente l'utilizzo delle tue chiavi API in Impostazioni → Chiavi API
- Ruota le chiavi periodicamente — Elimina le vecchie chiavi e creane di nuove se sospetti una compromissione
- Usa una chiave dedicata — Crea una chiave API separata solo per OpenClaw in modo da poterla revocare indipendentemente
Ambiti di Permesso
Quando crei una chiave API, puoi scegliere tra tre livelli di permesso:
| Ambito | Può Visualizzare | Può Creare | Può Eliminare | Ideale Per |
|---|---|---|---|---|
| Sola Lettura | Eventi, prenotazioni, calendari | No | No | Dashboard analitiche |
| Standard | Eventi, prenotazioni, calendari | Eventi | No | OpenClaw, assistenti AI |
| Completo | Eventi, prenotazioni, calendari | Eventi | Eventi | Strumenti interni affidabili |
Per OpenClaw, consigliamo l'ambito Standard. Questo permette all'AI di creare eventi di pianificazione e visualizzare i tuoi dati, ma previene l'eliminazione accidentale o malevola di eventi.
Esempi di Utilizzo
Una volta configurato, puoi chiedere a OpenClaw di:
- "Crea un evento standup del team per domani alle 9:00 o alle 10:00"
- "Mostrami i miei prossimi eventi"
- "Quali fasce orarie sono disponibili sulla pagina di prenotazione di Jane?"
OpenClaw utilizzerà la tua chiave API per interagire con WhenToMeet programmaticamente.
Risoluzione dei Problemi
"L'ambito della chiave API non permette l'accesso"
La tua chiave API non ha i permessi necessari. Crea una nuova chiave con ambito Standard o Completo.
"Chiave API non valida o scaduta"
- Verifica che la chiave inizi con
sk_ - Controlla che la chiave non sia stata revocata in Impostazioni → Chiavi API
- Assicurati che la chiave non sia scaduta (se hai impostato una data di scadenza)
Limitazione delle Richieste
Le chiavi API sono soggette a limiti di richieste in base al tuo abbonamento:
- Gratuito: 32 richieste (totali)
- Plus: 1.000 richieste all'ora