Connectez votre propre instance OpenClaw (BYOI)

OpenClaw est le runtime agent sous-jacent. Si vous exécutez votre propre instance (sur votre VPS, Kubernetes, ou tout serveur accessible en HTTPS), vous pouvez la connecter à ORYKSA AI sans passer par dashboard.oryksa.com.

Ce que votre serveur doit exposer

Votre manager OpenClaw doit exposer deux endpoints HTTPS :

• POST /api/whatsapp/incoming : reçoit les messages entrants signés depuis ORYKSA AI.
• Il doit envoyer les réponses en POST vers https://app.oryksa.com/api/whatsapp/outgoing avec la même signature HMAC-SHA256 en utilisant le webhook_secret partagé.

En-têtes utilisés (dans les deux sens) :

• X-ORYKSA-Signature (entrant) / X-OpenORYKSA-Signature (sortant) : HMAC-SHA256 hexadécimal du corps brut.
• X-ORYKSA-Tenant / X-OpenORYKSA-Tenant : oryksa-tenant-{user-id}.
• X-ORYKSA-Timestamp / X-OpenORYKSA-Timestamp : secondes unix (les replays de plus de 5 minutes sont rejetés).

Étapes

1. Dans ORYKSA AI, allez dans Connectors → OpenClaw.
2. Renseignez :
   - Manager URL : votre URL HTTPS (ex : https://my-claw.example.com).
   - Webhook secret : au moins 16 caractères ; utilisez la même valeur des deux côtés.
   - Agent ID : le nom de l’agent sur votre manager (chaîne libre).
   - Owner WhatsApp (optionnel) : votre propre numéro, donne tous les droits sur l’agent.
3. Cliquez sur Connect.

Opt-in par contact

Même panneau que le connecteur OpenORYKSA : collez les numéros WhatsApp dans Contacts answered by your OpenClaw pour les activer. Tous les autres restent sur l’agent par défaut d’ORYKSA AI.

Notes réseau

• L’endpoint doit être accessible depuis app.oryksa.com. Un Cloudflare Tunnel ou un Traefik public avec un vrai certificat fonctionnent parfaitement.
• Nous n’effectuons jamais d’appels sortants vers des IP privées (protection SSRF) : utilisez un nom d’hôte public.