占星术

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install astrology
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 astrology。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Astrology 是 Openclaw Skills 的集成，可通过 Astro Agents MCP 服务器准确计算西方与吠陀占星数据。它提供本命盘、星座运势、行星位置、相位、行运、合盘、kundli、分盘、dashas、doshas、panchang、nakshatras 和 kundli 配对。
计算采用 NASA/JPL DE440 星历，而非语言模型估算。结果包含确定性结果指示器和 meta.result_sha256 等元数据，使输出可供检查并可重复生成。服务器会解析当地出生时间和历史时区偏移，帮助避免涉及夏令时、恒星时和 ayanamsa 的常见错误。

应用场景

生成西方本命盘或出生星盘、星座运势，或太阳、月亮和上升星座解读。
查询某个时刻或本命盘的行星位置、相位或精确行运日期。
使用西方合盘比较两个人的出生星盘。
创建吠陀 kundli，包括 D1、D9，或从 D1 到 D60 的全部 16 种分盘。
查看 nakshatras、Vimshottari dasha 时期，或 Manglik、Kaal Sarp 和 Sade Sati doshas。
获取特定地点的 panchang，或进行 Ashtakoota Gun Milan kundli 配对。
需要确保可重复性时，使用结果哈希验证计算结果。

工作原理

收集此人的当地出生日期和时间，以及以十进制度表示的纬度和经度；北纬和东经为正值。
搜索合适的 Astro Agents 工具，例如 natal_chart、kundli 或 transits，并在调用前检查其 schema。
将当地时间作为 datetime 连同坐标一起发送。不要将其转换为 UTC，也不要提供时区；服务器会解析历史当地时区偏移。
如果出生时间未知，只提供日期。服务器将使用正午进行计算，并返回 TIME_UNKNOWN 警告；请将上升点和宫位视为不可靠。
对于合盘或 Gun Milan 等双人分析，分别提供 person_a 和 person_b 的出生数据。
按返回结果呈现位置、星座和分数。如有要求，请使用 verify_result_hash 以及返回的 result 和 meta.result_sha256 验证结果。

配置指南

连接 Astro Agents MCP 服务器一次即可。无需账户或 API 密钥。检查服务器是否已配置，如有需要则添加：
hermes mcp list
hermes mcp add astro-agents --url https://astro-agent.dev/mcp
出现身份验证提示时，回答 n，启用全部 16 个工具，然后开始新会话。或者，将以下服务器条目添加到 ~/.hermes/config.yaml：
mcp_servers:
astro-agents:
url: https://astro-agent.dev/mcp
在 Hermes 中，工具采用延迟加载方式：使用 tool_search 查找功能，使用 tool_describe 加载其 schema，再使用 tool_call 调用。搜索示例包括 astrology natal chart、vedic astrology kundli、kundli matching 和 panchang。

数据架构

MCP 响应包含 endpoint、result 和 meta 字段。元数据会标明计算是否具有确定性，以及是否使用了 LLM；meta.result_sha256 提供用于通过 verify_result_hash 验证结果的哈希。
数据或元数据 提供或使用方式
出生日期和时间 将当地时间作为 datetime 发送，例如 1990-05-15T14:30；不要转换为 UTC。
出生地点 以十进制度发送 latitude 和 longitude；南纬和西经为负值。
出生时间未知 仅发送 date；预期将按正午计算，并收到 TIME_UNKNOWN 警告。
夏令时存在歧义 对于回拨时段，请将 ambiguous_time 设为 earlier 或 later。
双人分析 传入 person_a 和 person_b，并为两人分别提供时间和坐标。
黄道体系 西方工具默认使用回归黄道；吠陀工具使用恒星黄道，默认采用 Lahiri ayanamsa。请勿混淆这两种体系。
验证 将返回的 result 和 meta.result_sha256 提交给 verify_result_hash。
此技能不会说明生成的本地星盘文件；计算结果和数据通过 MCP 工具返回。

高级特性

使用 16 种 MCP 工具进行西方和吠陀占星分析，包括
natal_chart
、
planet_positions
、
aspects
、
transits
、
synastry
、
kundli
、
kundli_full
、
vimshottari_dasha
、
doshas
、
panchang
、
nakshatras
、
gun_milan
vedic_report
。
resolve_birth_time
解析历史当地时间偏移；夏令时回拨导致时间存在歧义时，指定
ambiguous_time
。
使用 DE440 星历数据和
verify_result_hash
生成可重复且可核查的计算结果。
通过延迟加载的工具发现功能和
astro_catalog
查看可用工具、schema、价格和示例。
正确处理免费调用限额：每位客户端可免费调用工具三次，Claude connector 用户共用每小时调用池。如果调用返回
payment_required
，请说明端点、价格和提供的 x402 付款示例；不要重试同一调用，也不要自行计算星盘。

name: astrology description: "Western and Vedic astrology: birth chart, horoscope, kundli" version: 1.1.0 author: Astro Agents license: MIT compatibility: Requires the Astro Agents MCP server (https://astro-agent.dev/mcp, Streamable HTTP, no account or API key). tags: [astrology, horoscope, birth-chart, natal-chart, kundli, vedic-astrology, jyotish, panchang, dasha, synastry, transits, zodiac, gun-milan, mcp] metadata: author: Astro Agents version: "1.1.0" Astrology: exact charts from the Astro Agents MCP server

Computes astrology charts with the Astro Agents MCP server (https://astro-agent.dev/mcp) instead of estimating them. Positions come from the NASA/JPL DE440 ephemeris, no language model is involved, and every result carries meta.result_sha256: the same input always gives the same, checkable output.

When to Use

Load this skill whenever a request depends on where the planets were or are:

Western: birth chart / natal chart, horoscope, sun, moon and rising sign, planet positions, aspects, transits, relationship compatibility (synastry).
Vedic (Jyotish): kundli, divisional charts (navamsa D9 to D60), nakshatra, Vimshottari dasha, Manglik / Kaal Sarp / Sade Sati doshas, panchang (tithi, yoga, karana), kundli matching (Ashtakoota Gun Milan).

Never compute these yourself. Time zones, historical daylight saving, sidereal time and the ayanamsa are where models get charts wrong; the tools resolve them.

Prerequisites

Connect the MCP server once (no account, no API key). Check with hermes mcp list; if astro-agents is missing:

hermes mcp add astro-agents --url https://astro-agent.dev/mcp

Answer n to "Does this server require authentication?", enable all 16 tools, then start a new session. Equivalent ~/.hermes/config.yaml entry:

mcp_servers:
astro-agents:
url: https://astro-agent.dev/mcp

Quick Reference

Question Tool

Birth chart, horoscope, sun/moon/rising sign natal_chart
Where the planets are at a moment planet_positions

Aspects between planets aspects

Transits to a natal chart, exact dates transits
Relationship compatibility (Western) synastry
Vedic birth chart (kundli, D1 + D9) kundli
All 16 divisional charts (D1 to D60) kundli_full
Vimshottari dasha periods vimshottari_dasha
Manglik, Kaal Sarp, Sade Sati doshas

Panchang for a day and place panchang

Nakshatra and pada of each graha nakshatras

Kundli matching for marriage (36 points) gun_milan
Everything Vedic in one call vedic_report
Local time to UTC with historical offset resolve_birth_time
Prices and an example for every tool astro_catalog
Check a result was not altered verify_result_hash

Through Hermes the tools are deferred: find them with tool_search (e.g. "astrology natal chart", "vedic astrology kundli", "kundli matching", "panchang"), load the schema with tool_describe, then call them with tool_call.

Procedure

Collect the birth data: local date and time (24 h) and the place as latitude and longitude in decimal degrees (north and east positive). Look up the coordinates of a named city if needed.
Pass the local clock time as datetime, e.g. 1990-05-15T14:30, plus latitude and longitude. Do not convert to UTC and do not pass a time zone: the server resolves the zone and its historical offset.

If the birth time is unknown, pass date only. The chart is computed at 12:00 with a TIME_UNKNOWN warning: do not present the ascendant or houses as reliable then.

For two people (synastry, gun_milan), pass person_a and person_b, each with its own datetime, latitude and longitude.
Quote positions, signs and scores exactly as returned; do not recompute or round them differently. Mention meta.result_sha256 when the user wants something they can verify.

Pitfalls

Free calls run out. Each client gets 3 free tool calls (users of Claude's connectors share an hourly pool). After that a tool returns an error with payment_required: the REST endpoint, its price ($0.01 to $0.50) and a one-line x402 payment example. Tell the user; do not retry the same call, and do not compute the chart yourself.
Coordinate signs. West longitudes and south latitudes are negative.
Ambiguous local times. During a daylight-saving fall-back hour, pass ambiguous_time: "earlier" or "later".
Tropical vs sidereal. Western tools default to the tropical zodiac; Vedic tools are sidereal (Lahiri ayanamsa by default). Do not mix signs from the two systems in one answer.

Verification

A result has endpoint, result and meta, with meta.deterministic: true and meta.llm_used: false.
verify_result_hash with the returned result and meta.result_sha256 answers "matches": true.
Reference: natal_chart for 1990-05-15T14:30, latitude 48.8566, longitude 2.3522 (Paris) gives Sun Taurus, Moon Capricorn, Virgo rising.

Verdikta Discover

AEP 会话证据