I Ching Divination (Qi Gua) for Openclaw

A professional I Ching divination tool that combines local Python script execution with online research to provide deep metaphysical interpretations of the Book of Changes.

crystalchen1017
v1.0.2
Apr 14, 2026
0
933
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install gua

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install gua 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 I Ching Divination (Qi Gua)?

The Qi Gua skill is a sophisticated implementation of ancient Chinese Eastern mystical metaphysics designed for the modern AI era. It allows users to cast hexagrams based on natural language queries, bridging the gap between traditional wisdom and computational logic. By invoking a dedicated local script, the skill derives primary and resulting hexagrams with high precision.

Beyond simple casting, this skill integrates a robust interpretation engine. It cross-references local references and real-time internet search results to provide structured, plain-language explanations of complex hexagram meanings. Whether analyzing life changes or seeking philosophical guidance, this Openclaw Skills addition transforms abstract symbols into actionable insights.

I Ching Divination (Qi Gua) Use Cases

  • Seeking guidance on career changes or personal decisions using traditional I Ching methods.
  • Interpreting existing hexagrams and their transforming lines (Yaowei).
  • Learning the philosophical meanings behind the 64 hexagrams of the Zhou Yi.
  • Conducting deep research into Eastern mystical metaphysics through structured AI analysis.

How I Ching Divination (Qi Gua) Works

  1. The skill receives a natural language question and provides pre-divination guidance to help the user focus their intent.
  2. Upon confirmation, it reformats the user's input into a concise 'divination sentence'.
  3. The skill executes a local python script to generate the hexagram, including the primary hexagram, changing lines, and resulting hexagram.
  4. It references local Markdown files and performs online searches to gather authoritative interpretations.
  5. It applies specific 'Seven Rules of Changing Lines' to determine which text (Hexagram or Line statement) takes priority.
  6. A structured Chinese response is generated, combining the raw technical output with a tailored contextual interpretation.

I Ching Divination (Qi Gua) Setup

To use this skill, ensure you have the necessary python script in your local directory and run it via the following command structure:

# Navigate to your skill directory and execute the script with your question
python3 ./scripts/qi_gua.py "Should I change my job recently?"

Ensure that the references/ directory contains zhouyi-64-gua.md and output-format.md for proper data retrieval and formatting.

I Ching Divination (Qi Gua) Data Schema & Taxonomy

The skill organizes its knowledge and output using a specific taxonomy:

Component Source Description
Hexagram Data zhouyi-64-gua.md Original text, Xiang statements, and plain-language meanings.
Formatting output-format.md Structural rules for the final response.
Script Logic qi_gua.py Generates Gua names, images, 6-line details, and Gong affiliations.
Research Web Search Real-time cross-validation of hexagram meanings and line statements.

I Ching Divination (Qi Gua) Advanced Features

  • Multi-stage workflow: Includes a psychological 'clearing of thoughts' phase before casting.
  • Dynamic Interpretation: Uses a complex logical tree to select the most relevant line statements based on the number of changing lines (0 to 6).
  • Hybrid Data Retrieval: Prioritizes local authoritative references before falling back to web-based sources.
  • Structural Integrity: Maintains the raw script output (hexagram graphics) while providing a separate, human-readable analysis.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*