​

Synology Chat

​

Plugin intégré

openclaw plugins install ./path/to/local/synology-chat-plugin

​

Configuration rapide

1. Assurez-vous que le plugin Synology Chat est disponible.
   • Les versions empaquetées actuelles d’OpenClaw l’incluent déjà.
   • Les installations plus anciennes/personnalisées peuvent l’ajouter manuellement depuis un checkout source avec la commande ci-dessus.
   • openclaw onboard affiche désormais Synology Chat dans la même liste de configuration des canaux que openclaw channels add.
   • Configuration non interactive : openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
2. Dans les intégrations Synology Chat :
   • Créez un webhook entrant et copiez son URL.
   • Créez un webhook sortant avec votre jeton secret.
3. Pointez l’URL du webhook sortant vers votre gateway OpenClaw :
   • https://gateway-host/webhook/synology par défaut.
   • Ou votre channels.synology-chat.webhookPath personnalisé.
4. Terminez la configuration dans OpenClaw.
   • Guidé : openclaw onboard
   • Direct : openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
5. Redémarrez la gateway et envoyez un message direct au bot Synology Chat.

• OpenClaw accepte le jeton du webhook sortant depuis body.token, puis ?token=..., puis les en-têtes.
• Formes d’en-tête acceptées :
  • x-synology-token
  • x-webhook-token
  • x-openclaw-token
  • Authorization: Bearer <token>
• Les jetons vides ou manquants échouent en mode fermé.

{
  channels: {
    "synology-chat": {
      enabled: true,
      token: "synology-outgoing-token",
      incomingUrl: "https://nas.example.com/webapi/entry.cgi?api=SYNO.Chat.External&method=incoming&version=2&token=...",
      webhookPath: "/webhook/synology",
      dmPolicy: "allowlist",
      allowedUserIds: ["123456"],
      rateLimitPerMinute: 30,
      allowInsecureSsl: false,
    },
  },
}

​

Variables d’environnement

• SYNOLOGY_CHAT_TOKEN
• SYNOLOGY_CHAT_INCOMING_URL
• SYNOLOGY_NAS_HOST
• SYNOLOGY_ALLOWED_USER_IDS (séparés par des virgules)
• SYNOLOGY_RATE_LIMIT
• OPENCLAW_BOT_NAME

​

Politique DM et contrôle d’accès

• dmPolicy: "allowlist" est la valeur par défaut recommandée.
• allowedUserIds accepte une liste (ou une chaîne séparée par des virgules) d’identifiants utilisateur Synology.
• En mode allowlist, une liste allowedUserIds vide est traitée comme une mauvaise configuration et la route webhook ne démarrera pas (utilisez dmPolicy: "open" pour tout autoriser).
• dmPolicy: "open" autorise n’importe quel expéditeur.
• dmPolicy: "disabled" bloque les messages directs.
• La liaison du destinataire des réponses reste basée par défaut sur le user_id numérique stable. channels.synology-chat.dangerouslyAllowNameMatching: true est un mode de compatibilité de secours qui réactive la recherche basée sur un nom d’utilisateur/surnom mutable pour la remise des réponses.
• Les approbations d’appairage fonctionnent avec :
  • openclaw pairing list synology-chat
  • openclaw pairing approve synology-chat <CODE>

​

Remise sortante

openclaw message send --channel synology-chat --target 123456 --text "Hello from OpenClaw"
openclaw message send --channel synology-chat --target synology-chat:123456 --text "Hello again"

​

Multi-comptes

{
  channels: {
    "synology-chat": {
      enabled: true,
      accounts: {
        default: {
          token: "token-a",
          incomingUrl: "https://nas-a.example.com/...token=...",
        },
        alerts: {
          token: "token-b",
          incomingUrl: "https://nas-b.example.com/...token=...",
          webhookPath: "/webhook/synology-alerts",
          dmPolicy: "allowlist",
          allowedUserIds: ["987654"],
        },
      },
    },
  },
}

​

Notes de sécurité

• Gardez token secret et faites-le tourner en cas de fuite.
• Gardez allowInsecureSsl: false sauf si vous faites explicitement confiance à un certificat NAS local auto-signé.
• Les requêtes webhook entrantes sont vérifiées par jeton et limitées en débit par expéditeur.
• Les vérifications de jeton invalide utilisent une comparaison de secret en temps constant et échouent en mode fermé.
• Préférez dmPolicy: "allowlist" en production.
• Laissez dangerouslyAllowNameMatching désactivé sauf si vous avez explicitement besoin de la remise des réponses historique basée sur le nom d’utilisateur.
• Laissez dangerouslyAllowInheritedWebhookPath désactivé sauf si vous acceptez explicitement le risque de routage à chemin partagé dans une configuration multi-comptes.

​

Dépannage

• Missing required fields (token, user_id, text) :
  • la charge utile du webhook sortant ne contient pas l’un des champs requis
  • si Synology envoie le jeton dans les en-têtes, assurez-vous que la gateway/le proxy conserve ces en-têtes
• Invalid token :
  • le secret du webhook sortant ne correspond pas à channels.synology-chat.token
  • la requête atteint le mauvais compte/chemin webhook
  • un proxy inverse a supprimé l’en-tête du jeton avant que la requête n’atteigne OpenClaw
• Rate limit exceeded :
  • trop de tentatives de jeton invalide depuis la même source peuvent temporairement bloquer cette source
  • les expéditeurs authentifiés ont aussi une limite de débit de messages distincte par utilisateur
• Allowlist is empty. Configure allowedUserIds or use dmPolicy=open. :
  • dmPolicy="allowlist" est activé mais aucun utilisateur n’est configuré
• User not authorized :
  • le user_id numérique de l’expéditeur n’est pas dans allowedUserIds

​

Voir aussi

• Channels Overview — tous les canaux pris en charge
• Pairing — authentification DM et flux d’appairage
• Groups — comportement des discussions de groupe et filtrage par mention
• Channel Routing — routage de session pour les messages
• Security — modèle d’accès et renforcement