{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/mingli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mingli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "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"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/mingli",
    "agentPageUrl": "https://openagent3.xyz/skills/mingli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mingli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mingli/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Mingli 命理",
        "body": "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."
      },
      {
        "title": "Modes",
        "body": "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\""
      },
      {
        "title": "Scripts",
        "body": "# Western natal chart (kerykeion — houses, aspects, nodes)\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-western-natal-chart-using-kerykeion.py \\\n  --date 2000-03-25 --time 12:00 --tz \"Asia/Saigon\" --lat 21.0245 --lon 105.84117 --name \"User\"\n\n# Ba-Zi Four Pillars + Western zodiac\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-bazi.py \\\n  --date 1990-05-15 --time 14:30 --tz \"Asia/Saigon\"\n\n# Planetary positions (astronomyapi.com fallback for transit data)\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/fetch-planetary-positions.py \\\n  --lat 10.8231 --lon 106.6297\n\n# Numerology — LifePath, Birthday, Attitude, Challenges, Pinnacles, Personal cycles\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-numerology.py \\\n  --date 2000-03-25\n\n# I Ching hexagram casting\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/cast-i-ching-hexagram.py --mode random\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/cast-i-ching-hexagram.py \\\n  --mode manual --upper Kan --lower Kun --moving 2,1"
      },
      {
        "title": "Setup Mode",
        "body": "Ask for: birth date (YYYY-MM-DD), birth time (HH:MM), birth city (lat/lon + timezone)\nAsk for: Telegram chat ID, preferred delivery time + timezone\nRun all calculation scripts: natal chart, Ba-Zi, numerology\nWrite results to ~/clawd/memory/horoscope-users.md (include lat/lon, LifePath number)\nCreate daily cron job\nConfirm: Western sign + ASC + Ba-Zi Day Master + LifePath + delivery schedule"
      },
      {
        "title": "Daily Mode",
        "body": "Cron triggers 4 scripts → all JSON fed to LLM → compose multi-system horoscope → Telegram.\n\nSee references/horoscope-prompt-template.md for full agentTurn message."
      },
      {
        "title": "On-Demand Mode",
        "body": "Trigger: \"my horoscope\", \"horoscope now\", \"what's my horoscope today\"\n\nSame flow, inline (not isolated session). Includes daily I Ching hexagram."
      },
      {
        "title": "I Ching Mode",
        "body": "Trigger: \"cast I Ching\", \"throw hexagram\", \"que Kinh Dich\"\n\nRandom cast: 3-coin method, cryptographic randomness\nManual input: User provides upper/lower trigrams + moving lines\nOutput: primary hexagram, moving lines, transformed hexagram, SPARK summary"
      },
      {
        "title": "Management Commands",
        "body": "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"
      },
      {
        "title": "Cron Delivery",
        "body": "One cron job per user: horoscope-daily-{username}\n\n{\n  \"name\": \"horoscope-daily-{username}\",\n  \"enabled\": true,\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 {hour} * * *\", \"tz\": \"{timezone}\" },\n  \"sessionTarget\": \"isolated\",\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"[prompt from references/horoscope-prompt-template.md]\",\n    \"model\": \"claude-sonnet-4-20250514\",\n    \"timeoutSeconds\": 180,\n    \"deliver\": true,\n    \"channel\": \"telegram\",\n    \"to\": \"{telegram_chat_id}\"\n  },\n  \"isolation\": { \"postToMainPrefix\": \"Horoscope delivered\", \"postToMainMode\": \"summary\" }\n}"
      },
      {
        "title": "State Tracking",
        "body": "File: state/users.json — maps usernames to cron job IDs."
      },
      {
        "title": "Error Handling",
        "body": "kerykeion fails: Fallback to fetch-planetary-positions.py (API-based, no houses)\nAPI down: LLM generates horoscope from zodiac knowledge only\nMemory missing: Prompt user to run setup first\nI Ching data missing: Generate hexagram from embedded trigram math only"
      },
      {
        "title": "References",
        "body": "references/astronomyapi-reference.md - API auth + endpoints\nreferences/zodiac-reference.md - Western + Chinese zodiac tables, stems, branches\nreferences/horoscope-prompt-template.md - LLM prompt for daily generation\nreferences/i-ching-64-hexagrams.json - 64 hexagrams with Chinese/Vietnamese names"
      },
      {
        "title": "Dependencies",
        "body": "kerykeion (pip) — natal chart, houses, aspects. Install: pip install kerykeion\nastronomyapi.com — env: ASTRONOMY_APP_ID, ASTRONOMY_APP_SECRET\nAll other scripts: Python stdlib only"
      }
    ],
    "body": "Mingli 命理\n\nMulti-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.\n\nModes\nMode\tDescription\tTrigger\nSetup\tRegister birth data, compute all charts\t\"set up my horoscope\"\nDaily\tAutomated 4-system horoscope via cron\tCron schedule\nOn-demand\tInstant horoscope\t\"my horoscope\", \"horoscope now\"\nI Ching\tHexagram reading (random or manual)\t\"cast I Ching\", \"throw hexagram\"\nManage\tPause/resume/change time\t\"pause horoscope\", \"change horoscope time\"\nScripts\n# Western natal chart (kerykeion — houses, aspects, nodes)\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-western-natal-chart-using-kerykeion.py \\\n  --date 2000-03-25 --time 12:00 --tz \"Asia/Saigon\" --lat 21.0245 --lon 105.84117 --name \"User\"\n\n# Ba-Zi Four Pillars + Western zodiac\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-bazi.py \\\n  --date 1990-05-15 --time 14:30 --tz \"Asia/Saigon\"\n\n# Planetary positions (astronomyapi.com fallback for transit data)\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/fetch-planetary-positions.py \\\n  --lat 10.8231 --lon 106.6297\n\n# Numerology — LifePath, Birthday, Attitude, Challenges, Pinnacles, Personal cycles\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/calculate-numerology.py \\\n  --date 2000-03-25\n\n# I Ching hexagram casting\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/cast-i-ching-hexagram.py --mode random\n.claude/skills/.venv/bin/python3 .claude/skills/mingli/scripts/cast-i-ching-hexagram.py \\\n  --mode manual --upper Kan --lower Kun --moving 2,1\n\nSetup Mode\nAsk for: birth date (YYYY-MM-DD), birth time (HH:MM), birth city (lat/lon + timezone)\nAsk for: Telegram chat ID, preferred delivery time + timezone\nRun all calculation scripts: natal chart, Ba-Zi, numerology\nWrite results to ~/clawd/memory/horoscope-users.md (include lat/lon, LifePath number)\nCreate daily cron job\nConfirm: Western sign + ASC + Ba-Zi Day Master + LifePath + delivery schedule\nDaily Mode\n\nCron triggers 4 scripts → all JSON fed to LLM → compose multi-system horoscope → Telegram.\n\nSee references/horoscope-prompt-template.md for full agentTurn message.\n\nOn-Demand Mode\n\nTrigger: \"my horoscope\", \"horoscope now\", \"what's my horoscope today\"\n\nSame flow, inline (not isolated session). Includes daily I Ching hexagram.\n\nI Ching Mode\n\nTrigger: \"cast I Ching\", \"throw hexagram\", \"que Kinh Dich\"\n\nRandom cast: 3-coin method, cryptographic randomness\nManual input: User provides upper/lower trigrams + moving lines\nOutput: primary hexagram, moving lines, transformed hexagram, SPARK summary\nManagement Commands\nCommand\tAction\n\"pause horoscope\"\tDisable cron job\n\"resume horoscope\"\tEnable cron job\n\"change horoscope time to 7am\"\tUpdate cron schedule\n\"remove horoscope\"\tDelete cron job + memory entry\nCron Delivery\n\nOne cron job per user: horoscope-daily-{username}\n\n{\n  \"name\": \"horoscope-daily-{username}\",\n  \"enabled\": true,\n  \"schedule\": { \"kind\": \"cron\", \"expr\": \"0 {hour} * * *\", \"tz\": \"{timezone}\" },\n  \"sessionTarget\": \"isolated\",\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"[prompt from references/horoscope-prompt-template.md]\",\n    \"model\": \"claude-sonnet-4-20250514\",\n    \"timeoutSeconds\": 180,\n    \"deliver\": true,\n    \"channel\": \"telegram\",\n    \"to\": \"{telegram_chat_id}\"\n  },\n  \"isolation\": { \"postToMainPrefix\": \"Horoscope delivered\", \"postToMainMode\": \"summary\" }\n}\n\nState Tracking\n\nFile: state/users.json — maps usernames to cron job IDs.\n\nError Handling\nkerykeion fails: Fallback to fetch-planetary-positions.py (API-based, no houses)\nAPI down: LLM generates horoscope from zodiac knowledge only\nMemory missing: Prompt user to run setup first\nI Ching data missing: Generate hexagram from embedded trigram math only\nReferences\nreferences/astronomyapi-reference.md - API auth + endpoints\nreferences/zodiac-reference.md - Western + Chinese zodiac tables, stems, branches\nreferences/horoscope-prompt-template.md - LLM prompt for daily generation\nreferences/i-ching-64-hexagrams.json - 64 hexagrams with Chinese/Vietnamese names\nDependencies\nkerykeion (pip) — natal chart, houses, aspects. Install: pip install kerykeion\nastronomyapi.com — env: ASTRONOMY_APP_ID, ASTRONOMY_APP_SECRET\nAll other scripts: Python stdlib only"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/hiehoo/mingli",
    "publisherUrl": "https://clawhub.ai/hiehoo/mingli",
    "owner": "hiehoo",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}