循古黄历（老黄历）

要解决什么问题

工程师或日常用户向助手问「今天宜忌」「明天是不是黄道吉日」「某公历对应农历几号」「今年清明是哪天」时，需要可核对的传统历法数据，而不是泛泛的文化常识。择日、排八字四柱、对照道历/佛历/月相时，同样依赖统一、结构化的黄历接口。

技能如何工作

本技能基于 循古排盘 提供的万年历 API，通过 Bearer Token（环境变量 HUANGLI_API_TOKEN）调用：

• 查今天：请求 https://cdndns.org/huangli/api/calendar，不传 date 参数
• 查指定日：同一端点加 ?date=YYYY-MM-DD

返回数据覆盖公历/农历与二十四节气、每日吉凶宜忌、年月日干支（输出格式为如 丙午 辛巳 甲申，不带「年/月/日」字样）、月相及道历/佛历等字段。技能侧按约定用 Python 将 API 结果完整格式化给用户，宜忌与三柱干支不得用省略号截断。

典型触发：二十四节气、农历日期、今日/某日宜忌、吉凶与黄道吉日、干支历相关提问。

边界与注意点

• Token 需在 OpenClaw 或 .env 中配置；未配置则无法拉取实时数据。
• 数据以 API 为准，技能不负责本地推算历法；不同择日流派对「宜忌」解读可能仍有差异，宜作参考而非唯一依据。