​

Synology Chat

​

Paketlenmiş eklenti

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

​

Hızlı kurulum

1. Synology Chat eklentisinin kullanılabilir olduğundan emin olun.
   • Mevcut paketlenmiş OpenClaw sürümleri bunu zaten içerir.
   • Eski/özel kurulumlar bunu yukarıdaki komutla bir kaynak checkout’tan manuel olarak ekleyebilir.
   • openclaw onboard artık openclaw channels add ile aynı kanal kurulum listesinde Synology Chat’i gösterir.
   • Etkileşimsiz kurulum: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
2. Synology Chat entegrasyonlarında:
   • Gelen bir webhook oluşturun ve URL’sini kopyalayın.
   • Gizli token’ınızla giden bir webhook oluşturun.
3. Giden webhook URL’sini OpenClaw gateway’inize yönlendirin:
   • Varsayılan olarak https://gateway-host/webhook/synology.
   • Veya özel channels.synology-chat.webhookPath yolunuz.
4. Kurulumu OpenClaw içinde tamamlayın.
   • Rehberli: openclaw onboard
   • Doğrudan: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
5. Gateway’i yeniden başlatın ve Synology Chat botuna bir DM gönderin.

• OpenClaw, giden webhook token’ını önce body.token, ardından ?token=..., sonra da başlıklardan kabul eder.
• Kabul edilen başlık biçimleri:
  • x-synology-token
  • x-webhook-token
  • x-openclaw-token
  • Authorization: Bearer <token>
• Boş veya eksik token’lar kapalı varsayılanla başarısız olur.

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

​

Ortam değişkenleri

• SYNOLOGY_CHAT_TOKEN
• SYNOLOGY_CHAT_INCOMING_URL
• SYNOLOGY_NAS_HOST
• SYNOLOGY_ALLOWED_USER_IDS (virgülle ayrılmış)
• SYNOLOGY_RATE_LIMIT
• OPENCLAW_BOT_NAME

​

DM ilkesi ve erişim denetimi

• dmPolicy: "allowlist" önerilen varsayılandır.
• allowedUserIds, bir Synology kullanıcı kimliği listesi (veya virgülle ayrılmış dize) kabul eder.
• allowlist modunda boş bir allowedUserIds listesi yanlış yapılandırma olarak değerlendirilir ve webhook rotası başlatılmaz (herkese izin vermek için dmPolicy: "open" kullanın).
• dmPolicy: "open" herhangi bir göndericiye izin verir.
• dmPolicy: "disabled" DM’leri engeller.
• Yanıt alıcısı bağlama varsayılan olarak sabit sayısal user_id üzerinde kalır. channels.synology-chat.dangerouslyAllowNameMatching: true, yanıt teslimi için değiştirilebilir kullanıcı adı/takma ad aramasını yeniden etkinleştiren acil durum uyumluluk modudur.
• Eşleştirme onayları şu komutlarla çalışır:
  • openclaw pairing list synology-chat
  • openclaw pairing approve synology-chat <CODE>

​

Giden teslimat

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"

​

Çoklu hesap

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

​

Güvenlik notları

• token değerini gizli tutun ve sızarsa yenileyin.
• Kendinden imzalı yerel bir NAS sertifikasına açıkça güvenmiyorsanız allowInsecureSsl: false olarak bırakın.
• Gelen webhook istekleri token ile doğrulanır ve gönderici başına hız sınırına tabidir.
• Geçersiz token denetimleri sabit süreli gizli karşılaştırma kullanır ve kapalı varsayılanla başarısız olur.
• Üretim için dmPolicy: "allowlist" tercih edin.
• Eski kullanıcı adı tabanlı yanıt teslimine açıkça ihtiyacınız yoksa dangerouslyAllowNameMatching seçeneğini kapalı tutun.
• Çoklu hesap kurulumunda paylaşılan yol yönlendirme riskini açıkça kabul etmiyorsanız dangerouslyAllowInheritedWebhookPath seçeneğini kapalı tutun.

​

Sorun giderme

• Missing required fields (token, user_id, text):
  • giden webhook yükünde gerekli alanlardan biri eksik
  • Synology token’ı başlıklarda gönderiyorsa gateway/proxy’nin bu başlıkları koruduğundan emin olun
• Invalid token:
  • giden webhook gizli değeri channels.synology-chat.token ile eşleşmiyor
  • istek yanlış hesaba/webhook yoluna gidiyor
  • ters proxy, istek OpenClaw’a ulaşmadan önce token başlığını kaldırdı
• Rate limit exceeded:
  • aynı kaynaktan çok fazla geçersiz token denemesi o kaynağı geçici olarak kilitleyebilir
  • kimliği doğrulanmış göndericiler için de kullanıcı başına ayrı bir ileti hız sınırı vardır
• Allowlist is empty. Configure allowedUserIds or use dmPolicy=open.:
  • dmPolicy="allowlist" etkin ancak yapılandırılmış kullanıcı yok
• User not authorized:
  • göndericinin sayısal user_id değeri allowedUserIds içinde değil

​

İlgili

• Channels Overview — desteklenen tüm kanallar
• Pairing — DM kimlik doğrulaması ve eşleştirme akışı
• Groups — grup sohbeti davranışı ve bahsetme geçidi
• Channel Routing — iletiler için oturum yönlendirmesi
• Security — erişim modeli ve sağlamlaştırma