Synology Chat

​

इंस्टॉल करें

openclaw plugins install @openclaw/synology-chat

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

​

त्वरित सेटअप

1. Plugin इंस्टॉल करें (ऊपर)।
2. Synology Chat इंटीग्रेशन में:
   • एक इनकमिंग Webhook बनाएँ और उसका URL कॉपी करें।
   • अपने सीक्रेट टोकन के साथ एक आउटगोइंग Webhook बनाएँ।
3. आउटगोइंग Webhook URL को अपने OpenClaw Gateway की ओर इंगित करें:
   • https://gateway-host/webhook/synology डिफ़ॉल्ट रूप से।
   • या आपका कस्टम channels.synology-chat.webhookPath।
4. OpenClaw में सेटअप पूरा करें। Synology Chat दोनों प्रवाहों में समान चैनल सेटअप सूची में दिखाई देता है:
   • निर्देशित: openclaw onboard या openclaw channels add
   • प्रत्यक्ष: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
5. Gateway पुनः प्रारंभ करें और Synology Chat बॉट को एक डायरेक्ट संदेश भेजें।

• OpenClaw आउटगोइंग Webhook टोकन को पहले body.token, फिर ?token=..., और उसके बाद हेडर से स्वीकार करता है।
• स्वीकृत हेडर प्रारूप:
  • x-synology-token
  • x-webhook-token
  • x-openclaw-token
  • Authorization: Bearer <token>
• खाली या अनुपस्थित टोकन अस्वीकृत होते हैं।
• पेलोड application/x-www-form-urlencoded या application/json हो सकते हैं; token, user_id, और text आवश्यक हैं।

​

इनबाउंड स्थायित्व

{
  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,
    },
  },
}

​

परिवेश चर

• SYNOLOGY_CHAT_TOKEN
• SYNOLOGY_CHAT_INCOMING_URL
• SYNOLOGY_NAS_HOST
• SYNOLOGY_ALLOWED_USER_IDS (अल्पविराम से अलग)
• SYNOLOGY_RATE_LIMIT
• OPENCLAW_BOT_NAME

​

डायरेक्ट संदेश नीति और अभिगम नियंत्रण

• समर्थित dmPolicy मान: allowlist (डिफ़ॉल्ट), open, और disabled। Synology Chat में पेयरिंग प्रवाह नहीं है; प्रेषकों को स्वीकृत करने के लिए उनकी संख्यात्मक Synology उपयोगकर्ता ID को allowedUserIds में जोड़ें।
• allowedUserIds Synology उपयोगकर्ता ID की सूची (या अल्पविराम से अलग स्ट्रिंग) स्वीकार करता है।
• allowlist मोड में, खाली allowedUserIds सूची को गलत कॉन्फ़िगरेशन माना जाता है और Webhook रूट प्रारंभ नहीं होगा।
• dmPolicy: "open" सार्वजनिक डायरेक्ट संदेशों की अनुमति केवल तभी देता है जब allowedUserIds में "*" शामिल हो; प्रतिबंधात्मक प्रविष्टियों के साथ केवल मेल खाने वाले उपयोगकर्ता चैट कर सकते हैं। खाली allowedUserIds सूची के साथ open भी रूट प्रारंभ करने से इनकार करता है।
• dmPolicy: "disabled" डायरेक्ट संदेशों को अवरुद्ध करता है।
• उत्तर प्राप्तकर्ता बाइंडिंग डिफ़ॉल्ट रूप से स्थिर संख्यात्मक user_id पर रहती है। channels.synology-chat.dangerouslyAllowNameMatching: true आपातकालीन संगतता मोड है, जो उत्तर डिलीवरी के लिए परिवर्तनशील उपयोगकर्ता नाम/उपनाम लुकअप को फिर से सक्षम करता है।

​

आउटबाउंड डिलीवरी

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

​

एकाधिक खाते

{
  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"],
        },
      },
    },
  },
}

​

सुरक्षा संबंधी टिप्पणियाँ

• token को गुप्त रखें और लीक होने पर उसे बदलें।
• allowInsecureSsl: false को बनाए रखें, जब तक कि आप किसी स्व-हस्ताक्षरित स्थानीय NAS प्रमाणपत्र पर स्पष्ट रूप से भरोसा न करते हों।
• इनबाउंड Webhook अनुरोध टोकन द्वारा सत्यापित किए जाते हैं और प्रत्येक प्रेषक के लिए दर-सीमित होते हैं (rateLimitPerMinute, डिफ़ॉल्ट 30)।
• अमान्य टोकन जाँच नियत-समय सीक्रेट तुलना का उपयोग करती है और सुरक्षित रूप से अस्वीकार करती है; बार-बार अमान्य टोकन प्रयास स्रोत IP को अस्थायी रूप से लॉक कर देते हैं।
• इनबाउंड संदेश टेक्स्ट को ज्ञात प्रॉम्प्ट-इंजेक्शन पैटर्न से सुरक्षित करने के लिए साफ़ किया जाता है और 4000 वर्णों पर काट दिया जाता है।
• प्रोडक्शन के लिए dmPolicy: "allowlist" को प्राथमिकता दें।
• dangerouslyAllowNameMatching को बंद रखें, जब तक कि आपको स्पष्ट रूप से लेगेसी उपयोगकर्ता-नाम-आधारित उत्तर डिलीवरी की आवश्यकता न हो।
• dangerouslyAllowInheritedWebhookPath को बंद रखें, जब तक कि आप एकाधिक-खाता सेटअप में साझा-पथ रूटिंग जोखिम को स्पष्ट रूप से स्वीकार न करते हों।

​

समस्या निवारण

• Missing required fields (token, user_id, text):
  • आउटगोइंग Webhook पेलोड में आवश्यक फ़ील्ड में से कोई एक अनुपस्थित है
  • यदि Synology टोकन को हेडर में भेजता है, तो सुनिश्चित करें कि Gateway/प्रॉक्सी उन हेडर को बनाए रखता है
• Invalid token:
  • आउटगोइंग Webhook सीक्रेट channels.synology-chat.token से मेल नहीं खाता
  • अनुरोध गलत खाते/Webhook पथ पर पहुँच रहा है
  • रिवर्स प्रॉक्सी ने अनुरोध के OpenClaw तक पहुँचने से पहले टोकन हेडर हटा दिया
• Rate limit exceeded:
  • एक ही स्रोत से बहुत अधिक अमान्य टोकन प्रयास उस स्रोत को अस्थायी रूप से लॉक कर सकते हैं
  • प्रमाणित प्रेषकों के लिए भी एक अलग प्रति-उपयोगकर्ता संदेश दर सीमा होती है
• Allowlist is empty. Configure allowedUserIds or use dmPolicy=open with allowedUserIds=["*"].:
  • dmPolicy="allowlist" सक्षम है, लेकिन कोई उपयोगकर्ता कॉन्फ़िगर नहीं है
• User not authorized:
  • प्रेषक का संख्यात्मक user_id, allowedUserIds में नहीं है

​

संबंधित

• चैनल अवलोकन — सभी समर्थित चैनल
• समूह — समूह चैट व्यवहार और उल्लेख नियंत्रण
• चैनल रूटिंग — संदेशों के लिए सत्र रूटिंग
• सुरक्षा — अभिगम मॉडल और सुदृढ़ीकरण