Yuanfenju Connector

安装指南

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

什么是

Yuanfenju 技能为 AI 代理提供一种安全、结构化的方式，用于搜索和读取已连接的 Yuanfenju 账户中的数据。它使用 OOMOL oo CLI 连接器，凭据由服务器端注入，因此代理无需处理原始令牌。对于 Openclaw Skills 用户，它提供了一种一致的 Yuanfenju 请求方式，而不是直接调用 API。
可用查询包括八字和紫微命盘、八字解读与合盘、西方本命盘、塔罗占卜、吉日、黄历详情、节气、日历转换和账户用量。结果以 JSON 返回，并附带执行 ID。占星和占卜功能仅供文化研究与娱乐之用。

应用场景

将公历日期转换为中国农历日期，或将农历日期转换为公历日期，包括闰月处理。
根据提供的出生日期和时间，获取八字、紫微斗数或西方本命盘数据。
请求 Yuanfenju 的八字解读，或比较两张八字命盘，用于关系或婚姻方面的娱乐用途。
查询受支持公历日期的黄历，或为传统活动查找吉日。
获取当年的节令节点，或包含公历和农历时间戳的全部 24 个节气。
查看已连接账户的会员身份、适用的剩余配额或年度方案用量。
当已连接账户拥有所需的付费会员资格时，抽取并解读塔罗牌阵。

工作原理

确定与请求相匹配的 Yuanfenju 操作。
在创建负载之前，使用 oo connector schema "yuanfenju" --action "" 检查实时操作契约。
使用权威输入字段构建 JSON 对象，并运行操作：oo connector run "yuanfenju" --action "" --data '' --json。使用 @path/to/file.json 从文件提供负载，或省略 --data 以发送 {}。
阅读 JSON 响应。操作结果位于 data 下，执行 ID 位于 meta.executionId 下。
如果命令因缺少身份验证或连接问题而失败，请执行相应的一次性设置步骤；不要主动重复登录或连接设置。

配置指南

该技能要求安装 oo CLI、用户已登录 OOMOL，并且已连接 Yuanfenju。首先运行所请求的操作；仅在出现相应错误时执行设置步骤。
如果找不到 oo，请安装 CLI：
curl -fsSL https://cli.oomol.com/install.sh | bash
对于 Windows PowerShell，请使用：
irm https://cli.oomol.com/install.ps1 | iex
如果命令报告身份验证错误，请登录一次：
oo auth login
如果连接缺失、已过期或缺少所需范围，请通过 API 密钥连接流程连接 Yuanfenju：https://console.oomol.com/app-connections?provider=yuanfenju。
如果请求返回 HTTP 402 或 OOMOL_INSUFFICIENT_CREDIT，请在重试前前往 https://console.oomol.com/billing/token-recharge 充值。
检查并运行操作：
oo connector schema "yuanfenju" --action ""
oo connector run "yuanfenju" --action "" --data '' --json

数据架构

连接器的实时操作架构是负载字段的权威依据。每次操作前都应检查架构，而不要假设输入名称或类型。将 --data 设为 JSON 对象字符串或 @path/to/file.json；省略该参数会发送空对象。
数据元素 用途
操作输入 与所选操作实时架构相匹配的 JSON 负载
data 连接器返回的操作结果
meta.executionId 连接器执行的标识符
可选负载文件 调用方提供的 JSON 文件，使用 @path/to/file.json 引用；该技能未指定生成文件的布局
操作集涵盖账户和年度用量查询；日历转换、黄历、吉日和节气；八字命盘、解读与合盘；紫微命盘；西方本命盘；以及塔罗解读。对于 1900–2100 年间的农历日期，相关命盘和解读操作可能需要额外的转换调用。使用该日期范围内农历日期的合盘请求也会增加转换调用。其他非闰月农历日期在指定情况下可使用原生输入。本命盘使用原始的公历当地出生时间；服务提供方会处理时区和夏令时，且不会进行真太阳时校正。

高级特性

使用 OOMOL 管理的服务器端凭据，因此代理不会处理 Yuanfenju 原始令牌。
支持架构优先执行，代理可在组装请求之前获取权威操作输入。
通过单一连接器提供广泛的 Yuanfenju 操作，包括八字、紫微、西方本命盘、塔罗、黄历、吉日、节气和日历转换。
返回带有执行 ID 的结构化 JSON 结果，便于追踪。
包含会员资格、配额和年度方案用量查询；账户查询不会消耗调用额度，而年度用量仅向年度会员开放。
考虑农历日期转换要求和已记录的日期范围限制，包括黄历所支持的今天前后 90 天窗口。
遵循操作安全指引：运行写入操作前确认具体负载及其效果，并在执行破坏性操作前获得明确批准。

name: oo-yuanfenju description: "Yuanfenju (yuanfenju.com). Use this skill for ANY Yuanfenju request — searching and reading data. Whenever a task involves Yuanfenju, use this skill instead of calling the API directly." allowed-tools: [Bash(oo *)]