OpenClaw

Usa OpenClaw con VillaSlot para revisar las próximas reservas, comprobar la disponibilidad de las villas y preparar cambios operativos. El skill da al agente el contrato de la API; tu clave API de organización determina a qué datos puede acceder.

Instalar el skill VillaSlot

Ejecuta el comando en la máquina donde se ejecuta OpenClaw, desde el espacio de trabajo que usas con el agente:

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

Selecciona OpenClaw en el instalador. Para indicarlo directamente:

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

Elige un alcance de instalación accesible para tu instancia de OpenClaw. Si el agente se ejecuta en un servidor, instalar el skill solo en tu portátil no lo hará disponible allí. Abre una nueva sesión después de la instalación y pídele que use el skill villaslot.

Generar una clave API

Inicia sesión en VillaSlot, abre Cuenta → Claves API y crea una clave para la organización que quieres gestionar. Entrega la clave de forma segura al entorno de ejecución de OpenClaw como VILLASLOT_API_KEY y define:

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

Un servicio en segundo plano o un contenedor necesita estas variables en su propio entorno. Evita poner la clave en un chat compartido o en un archivo versionado del espacio de trabajo.

Verificar la organización

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.

Comprueba la organización devuelta antes de pedir a OpenClaw que gestione sus anuncios o sus reservas. La clave actúa con los permisos actuales de quien la creó.

Preparar un resumen diario de reservas

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.

El agente debe convertir los límites del día local en instantes ISO para la consulta del calendario. La confirmación de una reserva y su estado de pago son independientes: una reserva confirmada puede tener todavía un saldo pendiente.

Actuar ante la petición de un cliente

Después de revisar el resumen, puedes pedir a OpenClaw que compruebe otra franja, cree una ficha de cliente o reprograme una reserva. Identifica la reserva y el cambio que quieres, e indica si debe conservarse su precio actual.

Se necesitan permisos de propietario o administrador para crear o editar anuncios de villas, horarios y cuadrículas de tarifas. Leer una franja libre no garantiza que una reserva posterior vaya a tener éxito: la API vuelve a comprobar la disponibilidad al escribir.

Límites y solución de problemas

Un 401 significa que la clave no puede autenticarse; un 409 puede significar un conflicto de franja o un límite del plan. Pide al agente que explique la respuesta antes de reintentar. No conviertas un error repetido en un bucle de reintentos ilimitado en segundo plano.

El skill no expone mensajes automáticos a clientes, cobros ni reembolsos. Esas acciones se quedan en la aplicación. Un flujo programado también debe configurarse por separado; instalar este skill no crea ninguna programación.

Continúa con el índice de Agentes, la referencia de la API o la documentación de la CLI de Skills.