ORYKSA AI Centro de Ajuda

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

Se hospedas o teu 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 tua própria instância (VPS, Kubernetes, em qualquer lado acessível por HTTPS), podes ligá-la ao ORYKSA AI sem passar pelo dashboard.oryksa.com.

O que o teu servidor precisa expor

O teu 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 teu 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 teu manager (string livre).
    - Owner WhatsApp (opcional): o teu número, fica com privilégios totais.
  3. Clica Connect.

Opt-in por contacto

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 precisas?

Abre um ticket de suporte e respondemos rapidamente.

Abrir ticket