메인 콘텐츠로 건너뛰기

​
Synology Chat (plugin)

상태: Synology Chat webhook을 사용하는 direct-message 채널 plugin으로 지원됩니다. 이 plugin은 Synology Chat outgoing webhook에서 inbound message를 받고, Synology Chat incoming webhook을 통해 reply를 보냅니다.

​
Plugin 필요

Synology Chat은 plugin 기반이며 기본 core channel install에는 포함되지 않습니다. 로컬 checkout에서 설치: 
openclaw plugins install ./extensions/synology-chat
자세한 내용: Plugins

​
빠른 설정

  1. Synology Chat plugin을 설치하고 활성화합니다.
  2. Synology Chat integrations에서:
    • incoming webhook을 만들고 URL을 복사합니다.
    • secret token이 포함된 outgoing webhook을 만듭니다.
  3. outgoing webhook URL을 OpenClaw gateway로 지정합니다.
    • 기본값: https://gateway-host/webhook/synology
    • 또는 사용자 지정 channels.synology-chat.webhookPath
  4. OpenClaw에서 channels.synology-chat을 설정합니다.
  5. gateway를 재시작하고 Synology Chat bot에게 DM을 보냅니다.
최소 구성: 
{
  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,
    },
  },
}

​
환경 변수

기본 account에는 env var를 사용할 수 있습니다.
  • SYNOLOGY_CHAT_TOKEN
  • SYNOLOGY_CHAT_INCOMING_URL
  • SYNOLOGY_NAS_HOST
  • SYNOLOGY_ALLOWED_USER_IDS (comma-separated)
  • SYNOLOGY_RATE_LIMIT
  • OPENCLAW_BOT_NAME
config 값이 env var보다 우선합니다.

​
DM policy와 접근 제어

  • dmPolicy: "allowlist"가 권장 기본값입니다.
  • allowedUserIds는 Synology user ID list(또는 comma-separated string)를 받습니다.
  • allowlist 모드에서 비어 있는 allowedUserIds는 misconfiguration으로 간주되며 webhook route가 시작되지 않습니다(모두 허용하려면 dmPolicy: "open" 사용).
  • dmPolicy: "open"은 모든 sender를 허용합니다.
  • dmPolicy: "disabled"는 DM을 차단합니다.
  • pairing approval도 동작합니다:
    • openclaw pairing list synology-chat
    • openclaw pairing approve synology-chat <CODE>

​
Outbound delivery

대상에는 numeric Synology Chat user 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"
media send는 URL 기반 파일 전송으로 지원됩니다.

​
Multi-account

여러 Synology Chat account를 channels.synology-chat.accounts 아래에서 지원합니다. 각 account는 token, incoming URL, webhook path, DM policy, limit를 override할 수 있습니다. 
{
  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은 비밀로 유지하고 유출되면 교체하세요.
  • self-signed local NAS cert를 명시적으로 신뢰하는 경우가 아니면 allowInsecureSsl: false를 유지하세요.
  • inbound webhook request는 token 검증과 sender별 rate limit가 적용됩니다.
  • 운영 환경에는 dmPolicy: "allowlist"를 권장합니다.