OpenClaw

Utilisez OpenClaw avec VillaSlot pour passer en revue les réservations à venir, vérifier la disponibilité des villas et préparer des changements opérationnels. Le skill donne à l’agent le contrat de l’API ; la clé API de votre organisation détermine les données auxquelles il a accès.

Installer le skill VillaSlot

Lancez la commande sur la machine où tourne OpenClaw, depuis l’espace de travail que vous utilisez avec l’agent :

npx skills add https://github.com/mikecodeur/skills --skill villaslot

Sélectionnez OpenClaw dans l’installateur. Pour le cibler directement :

npx skills add https://github.com/mikecodeur/skills --skill villaslot --agent openclaw

Choisissez une portée d’installation accessible à votre instance OpenClaw. Si l’agent tourne sur un serveur, installer le skill sur votre seul ordinateur portable ne le rendra pas disponible là-bas. Ouvrez une nouvelle session après l’installation et demandez-lui d’utiliser le skill villaslot.

Générer une clé API

Connectez-vous à VillaSlot, ouvrez Compte → Clés API, et créez une clé pour l’organisation que vous voulez gérer. Transmettez la clé de façon sécurisée à l’environnement d’exécution d’OpenClaw sous le nom VILLASLOT_API_KEY et définissez :

export VILLASLOT_BASE_URL="https://www.villaslot.io"

Un service en arrière-plan ou un conteneur a besoin de ces variables dans son propre environnement. Évitez de mettre la clé dans une conversation partagée ou dans un fichier suivi de l’espace de travail.

Vérifier l’organisation

Use the villaslot skill and the API key from your environment.
Read /api/v1/me and list my active villas. Tell me the organization,
its timezone and whether its booking settings are configured.
Do not make changes.

Vérifiez l’organisation renvoyée avant de demander à OpenClaw de gérer ses annonces ou ses réservations. La clé agit avec les permissions actuelles de la personne qui l’a créée.

Préparer un résumé quotidien des réservations

Read tomorrow's bookings in the organization's timezone. Group them
by villa, show the local start and end times, customer names and
booking statuses. Flag unpaid and partially paid bookings separately.
Return the summary here; do not contact customers or change bookings.

L’agent doit convertir les bornes du jour local en instants ISO pour la requête du calendrier. Le statut de confirmation et le statut de paiement d’une réservation sont distincts : une réservation confirmée peut encore avoir un solde dû.

Agir sur une demande client

Après avoir lu le résumé, vous pouvez demander à OpenClaw de vérifier un autre créneau, de créer une fiche client ou de déplacer une réservation. Désignez la réservation et le changement voulu, et précisez si son prix actuel doit être conservé.

Les permissions de propriétaire ou d’administrateur sont nécessaires pour créer ou modifier les annonces de villas, les horaires et les grilles tarifaires. Lire un créneau libre ne garantit pas qu’une réservation ultérieure réussira : l’API revérifie la disponibilité au moment d’écrire.

Limites et dépannage

Un 401 signifie que la clé ne peut pas s’authentifier ; un 409 peut signifier un conflit de créneau ou un plafond de l’offre. Demandez à l’agent d’expliquer la réponse avant de réessayer. Ne transformez pas une erreur répétée en boucle de tentatives illimitée en arrière-plan.

Le skill n’expose ni la messagerie automatique aux clients, ni l’encaissement, ni les remboursements. Ces actions restent dans l’application. Un workflow planifié doit aussi être configuré à part ; installer ce skill ne crée aucune planification.

Poursuivez avec l’index des agents, la référence de l’API, ou la documentation du CLI Skills.