【最新版】Synology ChatでOpenClawを使う方法（Webhook連携）

Synology Chat

Synology Chat（プラグイン）

ステータス：Synology Chat の Webhook を使う DM（ダイレクトメッセージ）チャネルとして、プラグイン経由でサポートされています。 このプラグインは、Synology Chat の Outgoing Webhook からの受信メッセージを受け取り、返信は Incoming Webhook を通じて送信します。

プラグインが必要

Synology Chat はプラグインベースで、OpenClaw のデフォルト（コア）チャネルには含まれていません。

ローカルチェックアウトからインストール：

openclaw plugins install ./extensions/synology-chat

詳細： Plugins

クイックセットアップ

1. Synology Chat プラグインをインストールし、有効化します。
   • openclaw onboard で、openclaw channels add と同じ一覧に Synology Chat が表示されます。
   • 非対話式セットアップ：openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
2. Synology Chat の連携（integrations）で設定します：
   • Incoming webhook を作成し、その URL をコピーします。
   • Outgoing webhook を作成し、secret token を設定します。
3. Outgoing webhook の URL を 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 を再起動し、Synology Chat ボットに DM を送ってテストします。

最小 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,
      allowInsecureSsl: false,
    },
  },
}

環境変数

デフォルトアカウントは、次の環境変数を使えます：

• SYNOLOGY_CHAT_TOKEN
• SYNOLOGY_CHAT_INCOMING_URL
• SYNOLOGY_NAS_HOST
• SYNOLOGY_ALLOWED_USER_IDS（カンマ区切り）
• SYNOLOGY_RATE_LIMIT
• OPENCLAW_BOT_NAME

config の値は環境変数より優先されます。

DM policy とアクセス制御

• dmPolicy: "allowlist" が推奨のデフォルトです。
• allowedUserIds は Synology の user ID のリスト（またはカンマ区切り文字列）を受け取ります。
• allowlist モードでは、allowedUserIds が空だと「設定ミス」として扱われ、Webhook ルートは起動しません（全許可にしたい場合は dmPolicy: "open" を使います）。
• dmPolicy: "open" は任意の送信者を許可します。
• dmPolicy: "disabled" は DM をブロックします。
• ペアリング承認コマンド：

openclaw pairing list synology-chat
openclaw pairing approve synology-chat <CODE>

アウトバウンド配信（送信）

ターゲットには、数値の 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"

メディア送信は URL ベースのファイル配信でサポートされています。

マルチアカウント

複数の Synology Chat アカウントは channels.synology-chat.accounts に設定できます。 各アカウントは token、incoming URL、webhook path、DM policy、各種 limits を上書きできます。

{
  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 を維持してください。
• Inbound webhook リクエストは token 検証され、送信者ごとに 1 分あたりの rate limit が適用されます。
• 本番運用では dmPolicy: "allowlist" を推奨します。

参考

• https://docs.openclaw.ai/channels/synology-chat.md