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/outgoingcom a mesma assinatura HMAC-SHA256 usando owebhook_secretpartilhado.
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
- No ORYKSA AI vai a Conectores → OpenClaw.
- 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. - 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
★
★
★
★
★
Centro de Ajuda