適用於 Openclaw 的 RoxyAPI 連接器

透過 oo CLI 查詢 RoxyAPI，產生占卜解讀、星盤、日曆與預測，無須處理 API 憑證。

oomol

v1.0.0

Oct 11, 2026

安裝

基本資訊

Skill.md

安裝與下載

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 連接器運作原理

選取符合要求的 RoxyAPI 操作，例如 get_natal_chart 或 cast_three_card_tarot。
使用 oo connector schema "roxyapi" --action "<action_name>" 檢視操作的權威輸入與輸出 schema。
建立符合目前有效輸入 schema 的 JSON 物件。若操作需要，請使用 search_cities 釐清有歧義的出生地點；為確保歷史日光節約時間的準確性，優先使用 IANA 時區。
使用 oo connector run "roxyapi" --action "<action_name>" --data '<json>' --json 執行操作。省略 --data 可傳送空物件，或使用 @path\/to\/file.json 傳入 JSON 檔案。
讀取傳回的 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 年之間。