Openclaw용 RoxyAPI 커넥터

oo CLI를 통해 RoxyAPI를 쿼리하여 API 자격 증명을 직접 처리하지 않고 점괘, 차트, 달력 및 예측을 생성합니다.

oomol
v1.0.0
Oct 11, 2026
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 데이터를 검색하고 가져올 수 있도록 구조화된 방법을 제공합니다. 타로 및 I-Ching 리딩, 점성술과 출생 차트, BaZi, Human Design, 수비학, 중국 달력 데이터, 별자리 운세 및 개인 예측 타임라인을 지원합니다.

각 요청 전에 에이전트는 해당 작업의 최신 입력 및 출력 계약을 확인한 다음 이에 맞는 JSON 페이로드를 제출합니다. OOMOL은 서버 측에서 자격 증명을 주입하므로 원시 API 토큰이 에이전트에 노출되지 않습니다. Openclaw Skills를 평가하는 개발자에게 이 커넥터는 다양한 RoxyAPI 기능에 접근할 수 있는 명확한 schema 우선 워크플로를 제공합니다.

RoxyAPI 커넥터 활용 사례

  • 타로 스프레드를 생성하거나 카드를 뽑고 특정 타로 카드를 가져옵니다.
  • 별자리에 따라 일간, 주간, 월간 또는 연간 운세를 요청합니다.
  • 출생 정보를 바탕으로 출생 차트, BaZi, Human Design, 수비학 또는 시너스트리 차트를 작성합니다.
  • BaZi 궁합, 일주 강도, 운의 기둥 및 연간 예측을 확인합니다.
  • 음력과 그레고리력 날짜를 변환하고 중국 역서 세부 정보를 가져오거나 길일을 찾습니다.
  • 개인 예측 이벤트를 요약하거나 여러 분야를 아우르는 타임라인을 만듭니다.
  • 차트 계산에 필요한 위치 정보와 시간대를 확인하기 위해 도시를 검색합니다.
  • RoxyAPI 사용 통계를 확인합니다.

RoxyAPI 커넥터 작동 원리

  1. get_natal_chart 또는 cast_three_card_tarot처럼 요청에 맞는 RoxyAPI 작업을 선택합니다.
  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 우선 실행은 페이로드 작성 전에 공식 작업 계약을 확인하여 필드를 추측할 때 발생하는 오류를 줄입니다.
  • 타로 스프레드, I-Ching, 별자리 운세, 출생 및 궁합 차트, BaZi 예측, Human Design, 수비학, 음력 변환 및 역서 조회 등 폭넓은 작업을 지원합니다.
  • 예측 도구는 사전 정의된 기간별 요약과 여러 분야에 걸친 이벤트 타임라인을 모두 지원하며, 제공자가 정한 기간 및 이벤트 수 제한을 따릅니다.
  • 도시 조회는 출생 차트 요청의 장소를 명확히 하는 데 도움이 되며, IANA 시간대 안내는 과거 시간 처리의 신뢰성을 높입니다.
  • OOMOL이 서버 측에서 자격 증명을 제공하므로 자격 증명 격리를 통해 원시 API 토큰이 에이전트 명령에 포함되지 않습니다.
  • 안전 규칙은 일반 읽기 작업, 확인이 필요한 [write] 작업, 대상에 대한 명시적 승인이 필요한 [destructive] 작업을 구분합니다.
  • 응답에는 특정 커넥터 실행을 식별할 수 있도록 meta.executionId에 실행 ID가 포함됩니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*