Synology Chat

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

bundled plugin

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

​

ตั้งค่าอย่างรวดเร็ว

1. ตรวจสอบให้แน่ใจว่า Synology Chat plugin พร้อมใช้งาน
   • OpenClaw รุ่นแพ็กเกจปัจจุบันรวมไว้แล้ว
   • การติดตั้งรุ่นเก่า/แบบกำหนดเองสามารถเพิ่มด้วยตนเองจาก source checkout โดยใช้คำสั่งด้านบน
   • openclaw onboard ตอนนี้แสดง Synology Chat ในรายการตั้งค่าช่องทางเดียวกับ openclaw channels add
   • การตั้งค่าแบบไม่โต้ตอบ: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
2. ใน Synology Chat integrations:
   • สร้าง incoming webhook แล้วคัดลอก URL
   • สร้าง outgoing webhook พร้อม token ลับของคุณ
3. ชี้ URL ของ outgoing webhook ไปยัง OpenClaw gateway ของคุณ:
   • https://gateway-host/webhook/synology โดยค่าเริ่มต้น
   • หรือ channels.synology-chat.webhookPath แบบกำหนดเองของคุณ
4. ตั้งค่าให้เสร็จใน OpenClaw
   • แบบมีคำแนะนำ: openclaw onboard
   • แบบตรง: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
5. รีสตาร์ท gateway แล้วส่ง DM ไปยังบอต Synology Chat

• OpenClaw ยอมรับ token ของ outgoing webhook จาก body.token จากนั้น ?token=... แล้วจึงเป็น headers
• รูปแบบ header ที่ยอมรับ:
  • x-synology-token
  • x-webhook-token
  • x-openclaw-token
  • Authorization: Bearer <token>
• token ที่ว่างหรือขาดหายจะล้มเหลวแบบปิด

{
  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

​

นโยบาย DM และการควบคุมการเข้าถึง

• dmPolicy: "allowlist" เป็นค่าเริ่มต้นที่แนะนำ
• allowedUserIds รับรายการ (หรือสตริงที่คั่นด้วยจุลภาค) ของ Synology user IDs
• ในโหมด allowlist รายการ allowedUserIds ที่ว่างจะถือว่าเป็นการกำหนดค่าผิดพลาด และ webhook route จะไม่เริ่มทำงาน (ใช้ dmPolicy: "open" พร้อม allowedUserIds: ["*"] สำหรับอนุญาตทั้งหมด)
• dmPolicy: "open" อนุญาต DM สาธารณะเฉพาะเมื่อ allowedUserIds มี "*"; หากมีรายการแบบจำกัด เฉพาะผู้ใช้ที่ตรงกันเท่านั้นจึงจะแชตได้
• dmPolicy: "disabled" บล็อก DM
• การผูกผู้รับการตอบกลับจะคงอยู่กับ user_id แบบตัวเลขที่เสถียรโดยค่าเริ่มต้น channels.synology-chat.dangerouslyAllowNameMatching: true คือโหมดความเข้ากันได้กรณีฉุกเฉินที่เปิดใช้การค้นหาชื่อผู้ใช้/ชื่อเล่นที่เปลี่ยนแปลงได้อีกครั้งสำหรับการส่งการตอบกลับ
• การอนุมัติการจับคู่ทำงานกับ:
  • openclaw pairing list synology-chat
  • openclaw pairing approve synology-chat <CODE>

​

การส่งขาออก

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"
openclaw message send --channel synology-chat --target synology:123456 --text "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 ไว้ เว้นแต่คุณจะไว้วางใจ cert ของ NAS ในเครื่องที่ลงนามเองอย่างชัดเจน
• คำขอ inbound webhook จะได้รับการตรวจสอบ token และจำกัดอัตราต่อผู้ส่ง
• การตรวจสอบ token ที่ไม่ถูกต้องใช้การเปรียบเทียบ secret แบบ constant-time และล้มเหลวแบบปิด
• ควรใช้ dmPolicy: "allowlist" สำหรับ production
• ปิด dangerouslyAllowNameMatching ไว้ เว้นแต่คุณต้องการการส่งการตอบกลับตามชื่อผู้ใช้แบบเดิมอย่างชัดเจน
• ปิด dangerouslyAllowInheritedWebhookPath ไว้ เว้นแต่คุณยอมรับความเสี่ยงในการ route ผ่าน shared-path ในการตั้งค่าแบบหลายบัญชีอย่างชัดเจน

​

การแก้ไขปัญหา

• Missing required fields (token, user_id, text):
  • payload ของ outgoing webhook ขาดหนึ่งในฟิลด์ที่จำเป็น
  • หาก Synology ส่ง token ใน headers ให้ตรวจสอบว่า gateway/proxy เก็บ headers เหล่านั้นไว้
• Invalid token:
  • secret ของ outgoing webhook ไม่ตรงกับ channels.synology-chat.token
  • คำขอกำลังไปยังบัญชี/webhook path ที่ไม่ถูกต้อง
  • reverse proxy ลบ token header ออกก่อนที่คำขอจะถึง OpenClaw
• Rate limit exceeded:
  • ความพยายามใช้ token ที่ไม่ถูกต้องจำนวนมากเกินไปจากแหล่งเดียวกันอาจล็อกแหล่งนั้นชั่วคราว
  • ผู้ส่งที่ยืนยันตัวตนแล้วยังมีขีดจำกัดอัตราข้อความต่อผู้ใช้อีกชุดหนึ่ง
• Allowlist is empty. Configure allowedUserIds or use dmPolicy=open with allowedUserIds=["*"].:
  • เปิดใช้ dmPolicy="allowlist" แล้วแต่ยังไม่ได้กำหนดค่าผู้ใช้
• User not authorized:
  • user_id แบบตัวเลขของผู้ส่งไม่อยู่ใน allowedUserIds

​

ที่เกี่ยวข้อง

• ภาพรวมช่องทาง — ช่องทางทั้งหมดที่รองรับ
• การจับคู่ — การยืนยันตัวตน DM และขั้นตอนการจับคู่
• กลุ่ม — พฤติกรรมแชตกลุ่มและการควบคุมด้วยการกล่าวถึง
• การกำหนดเส้นทางช่องทาง — การกำหนดเส้นทางเซสชันสำหรับข้อความ
• ความปลอดภัย — โมเดลการเข้าถึงและการเสริมความปลอดภัย