# Send AsianSeeker - Openclaw FortuneTeller to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mingli",
    "name": "AsianSeeker - Openclaw FortuneTeller",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/hiehoo/mingli",
    "canonicalUrl": "https://clawhub.ai/hiehoo/mingli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mingli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mingli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/calculate-bazi.py",
      "scripts/cast-i-ching-hexagram.py",
      "scripts/calculate-western-natal-chart-using-kerykeion.py",
      "scripts/fetch-planetary-positions.py",
      "scripts/calculate-numerology.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "mingli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T04:43:53.604Z",
      "expiresAt": "2026-05-07T04:43:53.604Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mingli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mingli",
        "contentDisposition": "attachment; filename=\"mingli-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "mingli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mingli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mingli",
    "downloadUrl": "https://openagent3.xyz/downloads/mingli",
    "agentUrl": "https://openagent3.xyz/skills/mingli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mingli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mingli/agent.md"
  }
}
```
## Documentation

### Mingli 命理

Multi-system divination skill: Western astrology (Placidus houses, precise aspects), Ba-Zi / Four Pillars (Ngu Hanh), numerology (LifePath + personal cycles), and I Ching (hexagram + SPARK). Delivered daily via Telegram cron or on-demand.

### Modes

ModeDescriptionTriggerSetupRegister birth data, compute all charts"set up my horoscope"DailyAutomated 4-system horoscope via cronCron scheduleOn-demandInstant horoscope"my horoscope", "horoscope now"I ChingHexagram reading (random or manual)"cast I Ching", "throw hexagram"ManagePause/resume/change time"pause horoscope", "change horoscope time"

### Scripts

# Western natal chart (kerykeion — houses, aspects, nodes)
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-western-natal-chart-using-kerykeion.py \\
  --date 2000-03-25 --time 12:00 --tz "Asia/Saigon" --lat 21.0245 --lon 105.84117 --name "User"

# Ba-Zi Four Pillars + Western zodiac
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-bazi.py \\
  --date 1990-05-15 --time 14:30 --tz "Asia/Saigon"

# Planetary positions (astronomyapi.com fallback for transit data)
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/fetch-planetary-positions.py \\
  --lat 10.8231 --lon 106.6297

# Numerology — LifePath, Birthday, Attitude, Challenges, Pinnacles, Personal cycles
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-numerology.py \\
  --date 2000-03-25

# I Ching hexagram casting
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/cast-i-ching-hexagram.py --mode random
.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/cast-i-ching-hexagram.py \\
  --mode manual --upper Kan --lower Kun --moving 2,1

### Setup Mode

Ask for: birth date (YYYY-MM-DD), birth time (HH:MM), birth city (lat/lon + timezone)
Ask for: Telegram chat ID, preferred delivery time + timezone
Run all calculation scripts: natal chart, Ba-Zi, numerology
Write results to ~/clawd/memory/horoscope-users.md (include lat/lon, LifePath number)
Create daily cron job
Confirm: Western sign + ASC + Ba-Zi Day Master + LifePath + delivery schedule

### Daily Mode

Cron triggers 4 scripts → all JSON fed to LLM → compose multi-system horoscope → Telegram.

See references/horoscope-prompt-template.md for full agentTurn message.

### On-Demand Mode

Trigger: "my horoscope", "horoscope now", "what's my horoscope today"

Same flow, inline (not isolated session). Includes daily I Ching hexagram.

### I Ching Mode

Trigger: "cast I Ching", "throw hexagram", "que Kinh Dich"

Random cast: 3-coin method, cryptographic randomness
Manual input: User provides upper/lower trigrams + moving lines
Output: primary hexagram, moving lines, transformed hexagram, SPARK summary

### Management Commands

CommandAction"pause horoscope"Disable cron job"resume horoscope"Enable cron job"change horoscope time to 7am"Update cron schedule"remove horoscope"Delete cron job + memory entry

### Cron Delivery

One cron job per user: horoscope-daily-{username}

{
  "name": "horoscope-daily-{username}",
  "enabled": true,
  "schedule": { "kind": "cron", "expr": "0 {hour} * * *", "tz": "{timezone}" },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "[prompt from references/horoscope-prompt-template.md]",
    "model": "claude-sonnet-4-20250514",
    "timeoutSeconds": 180,
    "deliver": true,
    "channel": "telegram",
    "to": "{telegram_chat_id}"
  },
  "isolation": { "postToMainPrefix": "Horoscope delivered", "postToMainMode": "summary" }
}

### State Tracking

File: state/users.json — maps usernames to cron job IDs.

### Error Handling

kerykeion fails: Fallback to fetch-planetary-positions.py (API-based, no houses)
API down: LLM generates horoscope from zodiac knowledge only
Memory missing: Prompt user to run setup first
I Ching data missing: Generate hexagram from embedded trigram math only

### References

references/astronomyapi-reference.md - API auth + endpoints
references/zodiac-reference.md - Western + Chinese zodiac tables, stems, branches
references/horoscope-prompt-template.md - LLM prompt for daily generation
references/i-ching-64-hexagrams.json - 64 hexagrams with Chinese/Vietnamese names

### Dependencies

kerykeion (pip) — natal chart, houses, aspects. Install: pip install kerykeion
astronomyapi.com — env: ASTRONOMY_APP_ID, ASTRONOMY_APP_SECRET
All other scripts: Python stdlib only
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: hiehoo
- Version: 1.0.2
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T04:43:53.604Z
- Expires at: 2026-05-07T04:43:53.604Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mingli)
- [Send to Agent page](https://openagent3.xyz/skills/mingli/agent)
- [JSON manifest](https://openagent3.xyz/skills/mingli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mingli/agent.md)
- [Download page](https://openagent3.xyz/downloads/mingli)