Synology Chat（外掛）

狀態：透過外掛支援，作為使用 Synology Chat webhook 的私訊頻道。此外掛從 Synology Chat 傳出 webhook 接收訊息，並透過 Synology Chat 傳入 webhook 發送回覆。

需要外掛

Synology Chat 是外掛式的，不包含在預設核心頻道安裝中。

從本機 checkout 安裝：

openclaw plugins install ./extensions/synology-chat

詳情：外掛

快速設定

安裝並啟用 Synology Chat 外掛。
在 Synology Chat 整合設定中：
- 建立傳入 webhook 並複製其 URL。
- 建立含密鑰 token 的傳出 webhook。
將傳出 webhook URL 指向你的 OpenClaw Gateway：
- 預設為 https://gateway-host/webhook/synology。
- 或你自訂的 channels.synology-chat.webhookPath。
在 OpenClaw 中設定 channels.synology-chat。
重啟 Gateway 並發送私訊給 Synology Chat 機器人。

最小設定：

{
  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" 是推薦的預設值。
allowedUserIds 接受清單（或逗號分隔的字串）的 Synology 使用者 ID。
在 allowlist 模式下，空的 allowedUserIds 清單會被視為設定錯誤，且 webhook 路由不會啟動（若要允許所有人，請使用 dmPolicy: "open"）。
dmPolicy: "open" 允許任何發送者。
dmPolicy: "disabled" 封鎖私訊。
配對核准方式：
- openclaw pairing list synology-chat
- openclaw pairing approve synology-chat <CODE>

外送訊息

使用數字 Synology Chat 使用者 ID 作為目標。

範例：

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"

媒體傳送透過 URL 式檔案遞送支援。

多帳號

channels.synology-chat.accounts 支援多個 Synology Chat 帳號。每個帳號可覆寫 token、傳入 URL、webhook 路徑、私訊政策和限制。

{
  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 密鑰，若洩漏請輪換。
除非你明確信任自簽的本機 NAS 憑證，否則請保持 allowInsecureSsl: false。
接收的 webhook 請求會進行 token 驗證和按發送者的頻率限制。
正式環境建議使用 dmPolicy: "allowlist"。