Conector RoxyAPI para Openclaw

Consulta RoxyAPI a través de oo CLI para generar lecturas, cartas, calendarios y previsiones sin gestionar credenciales de API.

oomol
v1.0.0
Oct 11, 2026
0
160
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install oo-roxyapi

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar oo-roxyapi usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es Conector RoxyAPI?

La skill de RoxyAPI proporciona a un agente de programación con IA una forma estructurada de buscar y recuperar datos de RoxyAPI a través de la cuenta conectada a OOMOL y oo CLI. Abarca lecturas de tarot e I-Ching, astrología y cartas natales, BaZi, Human Design, numerología, datos del calendario chino, horóscopos y cronogramas de previsiones personales.

Antes de cada solicitud, el agente comprueba el contrato de entrada y salida vigente de la acción y, a continuación, envía un payload JSON que se ajusta a él. OOMOL inyecta las credenciales en el servidor, por lo que los tokens de API sin procesar no quedan expuestos al agente. Para los desarrolladores que evalúan Openclaw Skills, este conector ofrece un flujo de trabajo claro que prioriza el schema para acceder a una amplia gama de funciones de RoxyAPI.

Casos de uso de Conector RoxyAPI

  • Generar tiradas de tarot, sacar cartas o recuperar una carta de tarot concreta.
  • Solicitar horóscopos diarios, semanales, mensuales o anuales por signo del zodiaco.
  • Crear cartas natales, BaZi, Human Design, numerología o cartas de sinastría a partir de datos de nacimiento.
  • Consultar la compatibilidad BaZi, la fuerza del Maestro del Día, los pilares de la suerte y las previsiones anuales.
  • Convertir fechas lunares y gregorianas, recuperar detalles del almanaque chino o encontrar días propicios.
  • Resumir eventos de previsiones personales o crear una cronología entre distintos ámbitos.
  • Buscar una ciudad para resolver las necesidades de ubicación y zona horaria de los cálculos de cartas.
  • Consultar las estadísticas de uso de RoxyAPI.

Cómo funciona Conector RoxyAPI

  1. Selecciona la acción de RoxyAPI que corresponda a la solicitud, como get_natal_chart o cast_three_card_tarot.
  2. Inspecciona el schema oficial de entrada y salida de la acción con oo connector schema "roxyapi" --action "<action_name>".
  3. Crea un objeto JSON que se ajuste al schema de entrada vigente. Si la acción lo requiere, utiliza search_cities para resolver lugares de nacimiento ambiguos y prefiere una zona horaria IANA para garantizar la precisión histórica del horario de verano.
  4. Ejecuta la acción con oo connector run "roxyapi" --action "<action_name>" --data '<json>' --json. Omite --data para enviar un objeto vacío o pasa un archivo JSON mediante @path\/to\/file.json.
  5. Lee el data devuelto y el identificador de ejecución en meta.executionId. Sigue las indicaciones de seguridad: confirma la aprobación del usuario antes de cualquier acción marcada como [write] o [destructive].

Configuración de Conector RoxyAPI

La skill presupone que oo CLI está instalado, que el usuario ha iniciado sesión y que RoxyAPI está conectado. No ejecutes de forma proactiva la autenticación ni la configuración de la conexión; prueba primero la acción solicitada y utiliza el paso de recuperación correspondiente solo si falla.

Instala oo CLI si no está instalado:

curl -fsSL https:\/\/cli.oomol.com\/install.sh | bash

En Windows PowerShell, utiliza:

irm https:\/\/cli.oomol.com\/install.ps1 | iex

Si el comando indica que el usuario no ha iniciado sesión, autentícate una vez:

oo auth login

Si el error indica que la conexión de RoxyAPI falta, ha caducado o no está disponible (scope_missing, credential_expired, app_not_ready o app_not_found), conecta RoxyAPI una vez mediante el tipo de conexión API key en https:\/\/console.oomol.com\/app-connections?provider=roxyapi. Si se produce HTTP 402 o OOMOL_INSUFFICIENT_CREDIT, recarga la cuenta de OOMOL en https:\/\/console.oomol.com\/billing\/token-recharge antes de volver a intentarlo.

Esquema de datos y taxonomía de Conector RoxyAPI

La skill no define una base de datos local ni una estructura de archivos generados. Envía JSON específico de la acción al conector roxyapi y devuelve la respuesta del conector en JSON.

Elemento de datos Organización y gestión
Conector roxyapi, invocado mediante oo CLI
Acción Operación con nombre, como get_almanac_day, get_bazi_chart o list_tarot_cards
Entrada Objeto JSON conforme al schema vigente de la acción; inspecciónalo con oo connector schema antes de crear un payload
Salida Resultado específico de la acción en data
Metadatos de ejecución meta.executionId identifica la ejecución del conector
Credenciales OOMOL las inyecta en el servidor; la skill no gestiona tokens sin procesar
Metadatos de ubicación y hora La búsqueda de ciudades puede aclarar ubicaciones ambiguas; utiliza una zona horaria IANA para los cálculos de cartas natales, especialmente cuando sean relevantes los cambios históricos del horario de verano
Límites de la ventana de previsión Las solicitudes de cronología se limitan a un máximo de 90 días y 200 eventos; utiliza los valores devueltos de startDate y endDate como ventana resuelta. Los resúmenes de previsiones abarcan ventanas de 24 horas, 7 días, 30 días y 90 días.
Restricciones del calendario Las búsquedas de días propicios admiten intervalos de hasta 93 días; las fechas del almanaque deben estar entre 1900 y 2100.

Funciones avanzadas de Conector RoxyAPI

  • La ejecución que prioriza el schema comprueba el contrato oficial de la acción antes de construir el payload, lo que reduce los errores causados por adivinar campos.
  • La amplia cobertura de acciones incluye tiradas de tarot, I-Ching, horóscopos, cartas natales y de compatibilidad, previsiones BaZi, Human Design, numerología, conversión lunar y consultas al almanaque.
  • Las herramientas de previsión admiten tanto resúmenes por periodos predefinidos como cronologías de eventos entre distintos ámbitos, con los límites de periodos y eventos definidos por el proveedor.
  • La búsqueda de ciudades ayuda a desambiguar lugares en solicitudes de cartas natales; las indicaciones sobre zonas horarias IANA permiten gestionar el tiempo histórico con mayor fiabilidad.
  • El aislamiento de credenciales mantiene los tokens de API sin procesar fuera de los comandos del agente, ya que OOMOL proporciona las credenciales en el servidor.
  • Las reglas de seguridad distinguen las acciones normales de lectura, las acciones [write] que requieren confirmación y las acciones [destructive] que exigen la aprobación explícita del objetivo.
  • Las respuestas incluyen un ID de ejecución en meta.executionId para identificar una ejecución concreta del conector.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*