适用于 Openclaw 的 RoxyAPI 连接器

通过 oo CLI 查询 RoxyAPI,生成占卜解读、星盘、日历和预测,无需处理 API 凭据。

oomol
v1.0.0
2026年10月11日
0
98
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install oo-roxyapi

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 oo-roxyapi。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 RoxyAPI 连接器?

RoxyAPI 技能为 AI 编程代理提供了一种结构化方式,让其通过 OOMOL 连接的账户和 oo CLI 搜索并获取 RoxyAPI 数据。它涵盖塔罗和易经占卜、占星与本命盘、八字、人类图、数字命理、中国历法数据、星座运势以及个人预测时间线。

每次请求前,代理都会检查该操作当前有效的输入和输出约定,然后提交相符的 JSON 负载。OOMOL 在服务器端注入凭据,因此原始 API 令牌不会暴露给代理。对于正在评估 Openclaw Skills 的开发者而言,此连接器提供了一种清晰、以 schema 为先的工作流,可用于访问丰富的 RoxyAPI 功能。

RoxyAPI 连接器 应用场景

  • 生成塔罗牌阵、抽牌或获取特定塔罗牌。
  • 按星座查询每日、每周、每月或每年的星座运势。
  • 根据出生信息制作本命盘、八字、人类图、数字命理或合盘。
  • 查询八字合盘、日主强弱、大运和年度预测。
  • 转换农历和公历日期、获取中国黄历详情或查找吉日。
  • 汇总个人预测事件或创建跨领域时间线。
  • 搜索城市,以解析图表计算所需的位置详情和时区。
  • 查询 RoxyAPI 使用统计信息。

RoxyAPI 连接器 工作原理

  1. 选择与请求相符的 RoxyAPI 操作,例如 get_natal_chart 或 cast_three_card_tarot。
  2. 使用 oo connector schema "roxyapi" --action "<action_name>" 检查操作权威的输入和输出 schema。
  3. 构建符合当前有效输入 schema 的 JSON 对象。如果操作需要,使用 search_cities 解析有歧义的出生地点;为确保历史夏令时准确性,优先使用 IANA 时区。
  4. 使用 oo connector run "roxyapi" --action "<action_name>" --data '<json>' --json 运行操作。省略 --data 可发送空对象,也可以通过 @path\/to\/file.json 传入 JSON 文件。
  5. 读取返回的 data 以及位于 meta.executionId 的执行标识符。遵循安全指南:对于任何标记为 [write] 或 [destructive] 的操作,必须先确认用户已批准。

RoxyAPI 连接器 配置指南

此技能假设已安装 oo CLI、用户已登录且 RoxyAPI 已连接。不要主动运行身份验证或连接设置;先尝试所请求的操作,只有在失败时才使用相应的恢复步骤。

如果尚未安装 oo CLI,请安装:

curl -fsSL https:\/\/cli.oomol.com\/install.sh | bash

在 Windows PowerShell 中,使用:

irm https:\/\/cli.oomol.com\/install.ps1 | iex

如果命令提示用户尚未登录,请进行一次身份验证:

oo auth login

如果错误表明 RoxyAPI 连接缺失、已过期或不可用(scope_missing、credential_expired、app_not_ready 或 app_not_found),请使用 API key 连接类型,在 https:\/\/console.oomol.com\/app-connections?provider=roxyapi 连接一次 RoxyAPI。如果出现 HTTP 402 或 OOMOL_INSUFFICIENT_CREDIT,请先在 https:\/\/console.oomol.com\/billing\/token-recharge 为 OOMOL 账户充值,然后重试。

RoxyAPI 连接器 数据架构与分类体系

此技能不定义本地数据库或生成文件布局。它向 roxyapi 连接器发送特定操作的 JSON,并以 JSON 形式返回连接器响应。

数据元素 组织方式与处理方法
连接器 roxyapi,通过 oo CLI 调用
操作 命名操作,例如 get_almanac_day、get_bazi_chart 或 list_tarot_cards
输入 符合该操作当前有效 schema 的 JSON 对象;构建负载前使用 oo connector schema 检查
输出 data 下的特定操作结果
执行元数据 meta.executionId 用于标识连接器执行
凭据 由 OOMOL 在服务器端注入;技能不会处理原始令牌
位置和时间元数据 城市搜索可帮助澄清有歧义的位置;出生星盘计算应使用 IANA 时区,尤其是在历史夏令时变更会产生影响的情况下
预测窗口限制 时间线请求的范围最多限制为 90 天,事件数最多为 200 条;使用返回的 startDate 和 endDate 作为解析后的时间窗口。预测摘要涵盖 24 小时、7 天、30 天和 90 天窗口。
日历限制 吉日搜索的日期范围最多为 93 天;黄历日期必须介于 1900 年和 2100 年之间。

RoxyAPI 连接器 高级特性

  • 以 schema 为先的执行流程会在构建负载前检查权威操作约定,减少因猜测字段而导致的错误。
  • 广泛的操作覆盖范围包括塔罗牌阵、易经、星座运势、本命盘与合盘、八字预测、人类图、数字命理、农历转换和黄历查询。
  • 预测工具既支持按预定义时间窗口生成摘要,也支持跨领域事件时间线,并遵循服务提供方定义的窗口和事件数量上限。
  • 城市查询有助于消除出生星盘请求中的地点歧义;IANA 时区指南可提高历史时间处理的可靠性。
  • 凭据隔离可避免原始 API 令牌出现在代理命令中,因为 OOMOL 会在服务器端提供凭据。
  • 安全规则区分普通读取操作、需要确认的 [write] 操作,以及需要明确批准目标的 [destructive] 操作。
  • 响应会在 meta.executionId 中包含执行 ID,用于识别特定的连接器运行。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*