ORYKSA AI Central de Ajuda

Conectar a sua própria instância OpenClaw (BYOI)

Se hospedas o seu OpenClaw, aponta o ORYKSA AI para o URL + secret e a ponte trata do resto.

OpenClaw é o runtime de agentes por baixo. Se hospedas a sua própria instância (VPS, Kubernetes, em qualquer lado acessível por HTTPS), você pode ligá-la ao ORYKSA AI sem passar pelo dashboard.oryksa.com.

O que o seu servidor precisa expor

O seu manager OpenClaw tem de expor dois endpoints HTTPS:

  • POST /api/whatsapp/incoming: recebe mensagens assinadas do ORYKSA AI.
  • Tem de enviar respostas de volta para https://app.oryksa.com/api/whatsapp/outgoing com a mesma assinatura HMAC-SHA256 usando o webhook_secret partilhado.

Headers (em ambas as direções):

  • X-ORYKSA-Signature / X-OpenORYKSA-Signature: HMAC-SHA256 hex do body bruto.
  • X-ORYKSA-Tenant / X-OpenORYKSA-Tenant: oryksa-tenant-{user-id}.
  • X-ORYKSA-Timestamp / X-OpenORYKSA-Timestamp: unix seconds (rejeitamos requests com mais de 5 min).

Passos

  1. No ORYKSA AI vai a Conectores → OpenClaw.
  2. Preenche:
    - Manager URL: o seu URL HTTPS (ex: https://my-claw.example.com).
    - Webhook secret: pelo menos 16 caracteres; usa o mesmo valor nos dois lados.
    - Agent ID: o nome do agente no seu manager (string livre).
    - Owner WhatsApp (opcional): o seu número, fica com privilégios totais.
  3. Clique Connect.

Opt-in por contato

Mesmo painel que o conector OpenORYKSA: cola números WhatsApp em Contacts answered by your OpenClaw. Os outros continuam no agente padrão do ORYKSA AI.

Notas de rede

  • O endpoint tem de ser acessível a partir de app.oryksa.com. Cloudflare Tunnel ou Traefik público com certificado real funcionam.
  • Nunca fazemos chamadas para IPs privados (proteção SSRF): usa um hostname público.
Este artigo foi útil?
Obrigado pelo feedback.
Avalie este artigo
★ ★ ★ ★ ★
Sê o primeiro a avaliar.

Não encontraste o que precisa?

Abra um ticket de suporte e respondemos rapidamente.

Abrir ticket