Query RoxyAPI through the oo CLI to generate readings, charts, calendars, and forecasts without handling API credentials.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oo-roxyapi
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install oo-roxyapi using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is RoxyAPI Connector?
The RoxyAPI skill gives an AI coding agent a structured way to search and retrieve RoxyAPI data through the OOMOL-connected account and the oo CLI. It covers tarot and I-Ching readings, astrology and natal charts, BaZi, Human Design, numerology, Chinese calendar data, horoscopes, and personal forecast timelines.
Before each request, the agent checks the action's live input and output contract, then submits a matching JSON payload. OOMOL injects credentials server-side, so raw API tokens are not exposed to the agent. For developers evaluating Openclaw Skills, this connector offers a clear, schema-first workflow for accessing a broad range of RoxyAPI features.
RoxyAPI Connector Use Cases
- Generate tarot spreads, draw cards, or retrieve a specific tarot card.
- Request daily, weekly, monthly, or yearly horoscopes by zodiac sign.
- Build natal, BaZi, Human Design, numerology, or synastry charts from birth details.
- Check BaZi compatibility, Day Master strength, luck pillars, and annual forecasts.
- Convert lunar and Gregorian dates, retrieve Chinese almanac details, or find auspicious days.
- Summarize personal forecast events or create a cross-domain timeline.
- Search for a city to resolve location details and timezone needs for chart calculations.
- Check RoxyAPI usage statistics.
How RoxyAPI Connector Works
- Select the RoxyAPI action that matches the request, such as
get_natal_chartorcast_three_card_tarot. - Inspect the action's authoritative input and output schema with
oo connector schema "roxyapi" --action "<action_name>". - Build a JSON object that conforms to the live input schema. Resolve ambiguous birth locations with
search_citieswhen the action requires it, and prefer an IANA timezone for historical daylight-saving accuracy. - Run the action with
oo connector run "roxyapi" --action "<action_name>" --data '<json>' --json. Omit--datato send an empty object, or pass a JSON file using@path/to/file.json. - Read the returned
dataand execution identifier atmeta.executionId. Follow the safety guidance: confirm user approval before any action marked[write]or[destructive].
RoxyAPI Connector Setup
The skill assumes the oo CLI is installed, the user is signed in, and RoxyAPI is connected. Do not run authentication or connection setup proactively; attempt the requested action first and use the matching recovery step only if it fails.
Install the oo CLI if it is missing:
curl -fsSL https://cli.oomol.com/install.sh | bash
On Windows PowerShell, use:
irm https://cli.oomol.com/install.ps1 | iex
If the command reports that the user is not signed in, authenticate once:
oo auth login
If the error indicates a missing, expired, or unavailable RoxyAPI connection (scope_missing, credential_expired, app_not_ready, or app_not_found), connect RoxyAPI once using the API key connection type at https://console.oomol.com/app-connections?provider=roxyapi. For HTTP 402 or OOMOL_INSUFFICIENT_CREDIT, recharge the OOMOL account at https://console.oomol.com/billing/token-recharge before retrying.
RoxyAPI Connector Data Schema & Taxonomy
The skill does not define a local database or generated file layout. It sends action-specific JSON to the roxyapi connector and returns the connector response as JSON.
| Data element | Organization and handling |
|---|---|
| Connector | roxyapi, invoked through the oo CLI |
| Action | Named operation, such as get_almanac_day, get_bazi_chart, or list_tarot_cards |
| Input | JSON object conforming to the action's live schema; inspect it with oo connector schema before constructing a payload |
| Output | Action-specific result under data |
| Execution metadata | meta.executionId identifies the connector execution |
| Credentials | Injected server-side by OOMOL; raw tokens are not handled by the skill |
| Location and time metadata | City search can clarify ambiguous locations; use an IANA timezone for birth-chart calculations, especially where historical daylight-saving changes matter |
| Forecast window limits | Timeline requests are clamped to at most 90 days and capped at 200 events; use returned startDate and endDate as the resolved window. Forecast digests cover 24-hour, 7-day, 30-day, and 90-day windows. |
| Calendar constraints | Auspicious-day searches allow date ranges of up to 93 days; almanac dates must fall between 1900 and 2100. |
RoxyAPI Connector Advanced Features
- Schema-first execution checks the authoritative action contract before payload construction, reducing errors from guessed fields.
- Broad action coverage includes tarot spreads, I-Ching, horoscopes, natal and compatibility charts, BaZi forecasts, Human Design, numerology, lunar conversion, and almanac queries.
- Forecast tools support both digest summaries across predefined time windows and event timelines across domains, with provider-defined window and event caps.
- City lookup helps disambiguate places for birth-chart requests; IANA timezone guidance supports more reliable historical time handling.
- Credential isolation keeps raw API tokens out of agent commands because OOMOL supplies credentials server-side.
- Safety rules distinguish ordinary read actions from
[write]actions that require confirmation and[destructive]actions that require explicit approval of the target. - Responses include an execution ID in
meta.executionIdfor identifying a specific connector run.
SKILL.md
Loading
Related Openclaw Skills
Dynalist
A secure Dynalist integration for reading, creating, updating, organizing, and deleting outlines through the OOMOL-connected oo CLI.
Wisburg Research Connector
Use this Openclaw Skills integration to search and retrieve Wisburg research, reports, articles, and market updates through the oo CLI.
OOMOL Console
Manage OOMOL Console data through the oo CLI, using live action schemas and safeguards for changes that affect teams, permissions, and account settings.
Greip Network Lookup
Query Greip for IP address, autonomous system, and country information through the oo CLI without handling API tokens.
GetYouTubeTranscript
Search YouTube and retrieve video transcripts, titles, and channel details through the OOMOL-connected GetYouTubeTranscript service.
Money Forward Cloud Accounting MCP
Connect an AI coding agent to Money Forward Cloud Accounting MCP to retrieve accounting data and safely create or update ledger records through the oo CLI.
Featured*
