ORYKSA AI Centro de Ayuda

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/outgoing con la misma firma HMAC-SHA256 usando el webhook_secret compartido.

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

  1. En ORYKSA AI ve a Conectores → OpenClaw.
  2. 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.
  3. 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
★ ★ ★ ★ ★
Sé el primero en valorar.

¿No encontraste lo que buscabas?

Abre un ticket y respondemos rápido.

Abrir ticket