OpenClaw / Agent API

本站提供 HTTP JSON 接口，便于在 OpenClaw 等环境中配置为工具：可调用禄命古法命局与当日运势、六爻农历时间起卦、大六壬时间起课。

端点

路径	说明	Token
POST /api/agent/bazi	禄命古法本命与当日运势	可选（无 Key 时 daily_fortune 锁定）
POST /api/agent/liuyao	六爻农历时间起卦（同 /liuyao/）	必须
POST /api/agent/daliuren	大六壬当前时间起课（同 /daliuren/）	必须

POST https://xungufa.com/api/agent/bazi
POST https://xungufa.com/api/agent/liuyao
POST https://xungufa.com/api/agent/daliuren

请将完整 URL 与部署环境中的 APP_URL 保持一致。

鉴权与配额

请求头格式：Authorization: Bearer <你的 API Key>
API Key 在登录后于「我的 API Key」页面创建，与老黄历 JSON 等接口共用同一套 Key 与计数。
每个 Key 自然日最多 20 次；同一账户下所有 Key 合计自然日最多 30 次（超限返回 429）。
POST /api/agent/bazi：Token 可选。未携带有效 Key 时，服务端仍可根据 IP 处理请求，但同一 IP 每自然日最多 10 次（超限 429）；且响应中 daily_fortune 为锁定态。
POST /api/agent/liuyao、POST /api/agent/daliuren：Token 必须。缺少或无效 Key 时返回 401。

八字请求体（JSON）

字段	必填	说明
birth_date	是	公历生辰，推荐 `YYYY-MM-DDTHH:MM` 或 `YYYY-MM-DD HH:MM:SS`
birth_place	否	出生地，默认「北京」；用于真太阳时等排盘
gender	否	「男」/「女」或 `1`/`0`、`male` 等

六爻 / 大六壬请求体（JSON）

端点	字段	说明
/api/agent/liuyao	time	可选，公历起卦时刻；默认服务器当前时间。格式推荐 `YYYY-MM-DDTHH:MM` 或 `YYYY-MM-DDTHH:MM:SS`
/api/agent/daliuren	time	可选，公历起课时刻；默认服务器当前时间。
/api/agent/daliuren	guiren_mode	可选，整数，贵人模式；默认 `0`。

响应概要

八字：返回 bazi、natal_fortune、daily_fortune、audit_status、logic_reference、SYSTEM_INSTRUCTION 等字段。
六爻：返回 success、method、result、cast_time；起卦明细位于 result._time_detail。
大六壬：返回 status、method、meta、cast_time、courses；courses 包含时课、日课、月课。

调用示例

八字（Token 可选）：

curl -X POST "https://xungufa.com/api/agent/bazi" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的API_KEY>" \
  -d '{"birth_date":"1990-05-15T10:30","birth_place":"北京","gender":"男","time_method":"古法"}'

六爻农历时间起卦（Token 必须）：

curl -X POST "https://xungufa.com/api/agent/liuyao" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的API_KEY>" \
  -d '{}'

大六壬时间起课（Token 必须）：

curl -X POST "https://xungufa.com/api/agent/daliuren" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <你的API_KEY>" \
  -d '{}'

机器可读契约

OpenAPI 3 描述：https://xungufa.com/static/openapi/agent-api.json
本站 llms.txt：https://xungufa.com/llms.txt