A professional traditional Chinese metaphysics skill enabling AI agents to parse BaZi charts, cast Liu Yao hexagrams, and compute Da Liu Ren mathematical layouts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install xungu-query
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 xungu-query 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 Xungu Query?
Xungu Query is a technically comprehensive metaphysics and divination skill designed for AI agent integration. Powered by the professional computational engine from xungufa.com, it enables AI agents to compute complex ancient Chinese astrology charts—specifically BaZi (Four Pillars of Destiny), Liu Yao (Six Lines Divination), and Da Liu Ren (Three Transmissions and Four Classes)—directly within developer environments. This skill is optimized to run as part of the Openclaw Skills framework, providing structured destiny assessments, chart scoring, and localized daily fortune forecasts.
With robust handling of both modern (timezone-standard) and ancient (traditional solar astronomical) timing frameworks, the skill guarantees highly precise mathematical alignments. Agents can parse geographic birth coordinates, analyze five-element distribution metrics, and construct detailed ASCII charts of metaphysical systems, seamlessly bridging traditional mystical sciences with modern automated environments.
Xungu Query Use Cases
- BaZi Chart Analysis: Compute birth-chart configurations with custom natal stability scores and detailed level readings.
- Daily Fortune Forecasts: Retrieve daily forecasts outlining auspicious timing indicators and dynamic warning indicators.
- Liu Yao Hexagram Divination: Cast six-line hexagram charts dynamically to resolve career, wealth, and relationship inquiries.
- Da Liu Ren Coordinate Grids: Generate full celestial-terrestrial boards (Tian Di Pan), tracking transmissions and class distributions for situational forecasting.
- Consent-Driven Local Records: Automate secure local profile management for instant context retrieval.
How Xungu Query Works
- Intent Extraction: The AI agent detects explicit user triggers for traditional Chinese metaphysics (such as '帮我算八字' or '起个六爻卦') and routes them to the Xungu Query skill.
- Profile Retrieval: The skill scans the local directory database for existing birth files. If empty, it prompts the user for date, time, gender, and geographic coordinate parameters.
- Consent Safeguard: Following input, the system explicitly requests user confirmation to save the profile to local memory, implementing a strict consent-driven storage protocol.
- Secure API Request: The skill communicates securely with the xungufa.com endpoints (
/api/agent/bazi,/api/agent/liuyao, or/api/agent/daliuren) utilizing authorization headers configured via local environment setups. - ASCII Processing & Layout: Structured raw JSON yields are parsed into localized visual grids (such as the 4x4 coordinate map for Da Liu Ren) or custom text logs to display highly detailed charts to the user.
Xungu Query Setup
To deploy the Xungu Query skill in your Openclaw Skills workspace, configure your environment credentials using the steps below:
# Create your local configuration file if it does not exist
touch ~/.openclaw/.env
# Configure your Xungu API Token from https://xungufa.com
echo 'XUNGU_API_TOKEN=your_private_api_token' >> ~/.openclaw/.env
Authentication and Quota Rules
- BaZi queries: Token configuration is optional. Unauthenticated queries are limited to 10 daily requests per IP, and advanced forecasting modules remain locked.
- Liu Yao and Da Liu Ren: Strictly require an active Xungu API Token. Unauthenticated calls to these endpoints return a 401 Unauthorized status code.
- Rate Limiting: Configured tokens permit up to 20 daily API invocations per key and 30 per account.
Xungu Query Data Schema & Taxonomy
The skill isolates local memory storage within highly restricted directories to ensure top-tier privacy. Birth coordinates and user profiles are stored as structured JSON elements inside your local workspace directory.
Storage Path
~/.openclaw/workspace-jarvis/memory/xungu-users.json
Local JSON Record Profile Schema
{
"users": {
"user_id_string": {
"name": "User Name",
"birth_date": "YYYY-MM-DDTHH:MM",
"gender": "男 / 女",
"birth_place": "Location City"
}
}
}
API Routing Directory
| Metaphysical Method | Endpoint Path | Token Required? | Quota Limitations |
|---|---|---|---|
| BaZi Charting | POST /api/agent/bazi |
Optional | Max 10 free IP queries/day |
| Liu Yao Casts | POST /api/agent/liuyao |
Yes | Token restricted (20 calls/day) |
| Da Liu Ren Grids | POST /api/agent/daliuren |
Yes | Token restricted (20 calls/day) |
Xungu Query Advanced Features
- Dual Time Alignment Mechanisms: Detects time conflicts through automatic comparison algorithms, tracking standard timezone values versus solar astronomical models.
- Dynamic ASCII Layout Rendering: Dynamically creates a 4x4 spatial grid for Da Liu Ren's celestial arrangements and multi-state line tables indicating active changes for Liu Yao.
- ASI03-Compliant Token Isolation: Prevents total memory sweeps by performing pinpoint file lookups for designated tokens instead of bulk-loading global system environments.
- Zero-Footprint Query Execution: Strictly processes transient data in volatile memory without caching user inputs on disk unless explicit permission is granted by the end user.
SKILL.md
Loading
Related Openclaw Skills
axiom-color-palette
A zero-dependency, high-performance image color palette extractor utilizing frequency analysis and optional K-means clustering.
Axiom SQL Formatter
A lightweight, pure standard library SQL formatting tool that styles SQL queries without execution or external parsing dependencies.
Bank Compliance Review Assistant
An AI-powered bank compliance and regulatory review assistant that automates screening for marketing materials, KYC documents, AML alerts, and NFRA/CBIRC regulations.
The Laws of Human Nature
An AI-powered behavioral psychology skill that translates Robert Greene's 18 universal laws into actionable advice for personal and professional relationship management.
Axiom Image Metadata Stripper
A lightweight, zero-dependency Python tool to strip EXIF, GPS, and other privacy-invasive metadata from JPEG, PNG, and GIF images without re-encoding.
axiom-css-specificity
A CSS specificity calculator that computes W3C-compliant (a, b, c) tuples for any selector to debug styling conflicts.
Featured*
