Documentation
Chat Channels
Synology Chat

Synology Chat

Synology Chat (plugin channel)

Status: supported via a plugin. It receives inbound messages from Synology Chat outgoing webhooks and sends replies via a Synology Chat incoming webhook.

Plugin required

Synology Chat is plugin-based and is not part of the default core channel install.

Install from a local OpenClaw source checkout:

openclaw plugins install ./extensions/synology-chat

Plugin basics: Plugins

Quick setup

  1. Install and enable the Synology Chat plugin.
  2. In Synology Chat integrations:
    • Create an incoming webhook and copy its URL.
    • Create an outgoing webhook and set a secret token.
  3. Point the outgoing webhook URL at your Gateway:
    • Default: https://<gateway-host>/webhook/synology
    • Or your custom channels.synology-chat.webhookPath
  4. Configure channels.synology-chat in OpenClaw and restart the Gateway.

Minimal config:

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

Environment variables (default account)

  • SYNOLOGY_CHAT_TOKEN
  • SYNOLOGY_CHAT_INCOMING_URL
  • SYNOLOGY_NAS_HOST
  • SYNOLOGY_ALLOWED_USER_IDS (comma-separated)
  • SYNOLOGY_RATE_LIMIT

Config values override env vars.

DM policy and access control

  • Recommended default: dmPolicy: "allowlist" with allowedUserIds.
  • Pairing also works:
    • openclaw pairing list synology-chat
    • openclaw pairing approve synology-chat <CODE>

Outbound delivery

Targets are numeric Synology Chat user IDs:

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