Conector RoxyAPI para Openclaw

Consulte a RoxyAPI pelo oo CLI para gerar leituras, mapas, calendários e previsões sem lidar com credenciais de API.

oomol
v1.0.0
Oct 11, 2026
0
160
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install oo-roxyapi

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o oo-roxyapi usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Conector RoxyAPI?

A skill RoxyAPI oferece a um agente de programação com IA uma maneira estruturada de pesquisar e recuperar dados da RoxyAPI por meio da conta conectada ao OOMOL e do oo CLI. Ela abrange leituras de tarô e I-Ching, astrologia e mapas natais, BaZi, Human Design, numerologia, dados do calendário chinês, horóscopos e cronogramas de previsões pessoais.

Antes de cada solicitação, o agente verifica o contrato de entrada e saída atualizado da ação e, em seguida, envia um payload JSON correspondente. OOMOL injeta as credenciais no servidor, portanto os tokens brutos da API não são expostos ao agente. Para desenvolvedores que avaliam Openclaw Skills, este conector oferece um fluxo de trabalho claro, que prioriza o schema, para acessar uma ampla variedade de recursos da RoxyAPI.

Casos de uso do Conector RoxyAPI

  • Gerar tiragens de tarô, tirar cartas ou recuperar uma carta de tarô específica.
  • Solicitar horóscopos diários, semanais, mensais ou anuais por signo do zodíaco.
  • Criar mapas natais, BaZi, Human Design, numerologia ou sinastria com base em dados de nascimento.
  • Consultar compatibilidade BaZi, força do Mestre do Dia, pilares da sorte e previsões anuais.
  • Converter datas lunares e gregorianas, recuperar detalhes do almanaque chinês ou encontrar dias auspiciosos.
  • Resumir eventos de previsões pessoais ou criar uma linha do tempo entre diferentes áreas.
  • Pesquisar uma cidade para determinar detalhes de localização e necessidades de fuso horário para cálculos de mapas.
  • Consultar as estatísticas de uso da RoxyAPI.

Como o Conector RoxyAPI funciona

  1. Selecione a ação da RoxyAPI correspondente à solicitação, como get_natal_chart ou cast_three_card_tarot.
  2. Inspecione o schema oficial de entrada e saída da ação com oo connector schema "roxyapi" --action "<action_name>".
  3. Crie um objeto JSON conforme o schema de entrada atualizado. Se a ação exigir, use search_cities para resolver locais de nascimento ambíguos e prefira um fuso horário IANA para garantir precisão histórica do horário de verão.
  4. Execute a ação com oo connector run "roxyapi" --action "<action_name>" --data '<json>' --json. Omita --data para enviar um objeto vazio ou passe um arquivo JSON usando @path\/to\/file.json.
  5. Leia o data retornado e o identificador de execução em meta.executionId. Siga as orientações de segurança: confirme a aprovação do usuário antes de qualquer ação marcada como [write] ou [destructive].

Configuração do Conector RoxyAPI

A skill pressupõe que o oo CLI está instalado, que o usuário está conectado e que a RoxyAPI está conectada. Não execute a autenticação nem a configuração da conexão de forma proativa; tente primeiro a ação solicitada e use a etapa de recuperação correspondente somente se ela falhar.

Instale o oo CLI se ele estiver ausente:

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

No Windows PowerShell, use:

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

Se o comando informar que o usuário não está conectado, autentique-se uma vez:

oo auth login

Se o erro indicar que a conexão da RoxyAPI está ausente, expirada ou indisponível (scope_missing, credential_expired, app_not_ready ou app_not_found), conecte a RoxyAPI uma vez usando o tipo de conexão API key em https:\/\/console.oomol.com\/app-connections?provider=roxyapi. Para HTTP 402 ou OOMOL_INSUFFICIENT_CREDIT, recarregue a conta OOMOL em https:\/\/console.oomol.com\/billing\/token-recharge antes de tentar novamente.

Esquema de Dados e Taxonomia de Conector RoxyAPI

A skill não define um banco de dados local nem um layout de arquivos gerados. Ela envia JSON específico da ação ao conector roxyapi e retorna a resposta do conector em JSON.

Elemento de dados Organização e tratamento
Conector roxyapi, invocado pelo oo CLI
Ação Operação nomeada, como get_almanac_day, get_bazi_chart ou list_tarot_cards
Entrada Objeto JSON em conformidade com o schema atualizado da ação; inspecione-o com oo connector schema antes de criar um payload
Saída Resultado específico da ação em data
Metadados de execução meta.executionId identifica a execução do conector
Credenciais Injetadas no servidor pelo OOMOL; a skill não manipula tokens brutos
Metadados de localização e horário A pesquisa de cidades pode esclarecer locais ambíguos; use um fuso horário IANA para cálculos de mapas natais, especialmente quando mudanças históricas de horário de verão forem relevantes
Limites da janela de previsão As solicitações de cronograma são limitadas a no máximo 90 dias e 200 eventos; use startDate e endDate retornados como a janela resolvida. Os resumos de previsão abrangem janelas de 24 horas, 7 dias, 30 dias e 90 dias.
Restrições do calendário As pesquisas de dias auspiciosos aceitam intervalos de até 93 dias; as datas do almanaque devem estar entre 1900 e 2100.

Recursos avançados do Conector RoxyAPI

  • A execução que prioriza o schema verifica o contrato oficial da ação antes da criação do payload, reduzindo erros causados por campos presumidos.
  • A ampla cobertura de ações inclui tiragens de tarô, I-Ching, horóscopos, mapas natais e de compatibilidade, previsões BaZi, Human Design, numerologia, conversão lunar e consultas ao almanaque.
  • As ferramentas de previsão oferecem resumos em janelas de tempo predefinidas e cronogramas de eventos entre áreas, sujeitos aos limites de janela e de eventos definidos pelo provedor.
  • A busca de cidades ajuda a esclarecer locais em solicitações de mapas natais; as orientações sobre fusos horários IANA permitem um tratamento histórico do tempo mais confiável.
  • O isolamento de credenciais mantém os tokens brutos da API fora dos comandos do agente, pois o OOMOL fornece as credenciais no servidor.
  • As regras de segurança distinguem ações comuns de leitura, ações [write] que exigem confirmação e ações [destructive] que exigem aprovação explícita do alvo.
  • As respostas incluem um ID de execução em meta.executionId para identificar uma execução específica do conector.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*