Conectar tu propia instancia OpenClaw (BYOI)
Si auto-alojas OpenClaw, apunta ORYKSA AI a tu URL + secret y el puente hace el resto.
OpenClaw es el runtime de agentes subyacente. Si auto-alojas tu propia instancia (VPS, Kubernetes, en cualquier sitio accesible vía HTTPS), puedes conectarla a ORYKSA AI sin pasar por dashboard.oryksa.com.
Lo que tu servidor debe exponer
Tu manager OpenClaw debe exponer dos endpoints HTTPS:
POST /api/whatsapp/incoming: recibe mensajes firmados desde ORYKSA AI.- Debe enviar respuestas a
https://app.oryksa.com/api/whatsapp/outgoingcon la misma firma HMAC-SHA256 usando elwebhook_secretcompartido.
Headers (en ambas direcciones):
X-ORYKSA-Signature/X-OpenORYKSA-Signature: HMAC-SHA256 hex del body crudo.X-ORYKSA-Tenant/X-OpenORYKSA-Tenant:oryksa-tenant-{user-id}.X-ORYKSA-Timestamp/X-OpenORYKSA-Timestamp: unix seconds (rechazamos requests > 5 min).
Pasos
- En ORYKSA AI ve a Conectores → OpenClaw.
- Rellena:
- Manager URL: tu URL HTTPS (ej:https://my-claw.example.com).
- Webhook secret: al menos 16 caracteres; usa el mismo valor en ambos lados.
- Agent ID: el nombre del agente en tu manager (string libre).
- Owner WhatsApp (opcional): tu número, recibe privilegios totales. - Pulsa Connect.
Opt-in por contacto
Mismo panel que el conector OpenORYKSA: pega números WhatsApp en Contacts answered by your OpenClaw. Los demás siguen en el agente estándar de ORYKSA AI.
Notas de red
- El endpoint debe ser accesible desde
app.oryksa.com. Cloudflare Tunnel o Traefik público con certificado real funcionan. - Nunca hacemos llamadas a IPs privadas (protección SSRF): usa un hostname público.
¿Te resultó útil este artículo?
Gracias por tu opinión.
Califica este artículo
★
★
★
★
★
Centro de Ayuda