Synology Chat

​

インストール

openclaw plugins install @openclaw/synology-chat

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

​

クイックセットアップ

1. Plugin をインストールします（上記）。
2. Synology Chat の連携で:
   • 受信 Webhook を作成し、その URL をコピーします。
   • シークレットトークン付きの送信 Webhook を作成します。
3. 送信 Webhook URL を OpenClaw Gateway に向けます:
   • 既定では https://gateway-host/webhook/synology。
   • またはカスタムの channels.synology-chat.webhookPath。
4. OpenClaw でセットアップを完了します。Synology Chat は、両方のフローで同じチャンネルセットアップ一覧に表示されます:
   • ガイド付き: openclaw onboard または openclaw channels add
   • 直接: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
5. Gateway を再起動し、Synology Chat ボットに DM を送信します。

• OpenClaw は送信 Webhook トークンを body.token、次に ?token=...、次にヘッダーから受け付けます。
• 受け付けるヘッダー形式:
  • x-synology-token
  • x-webhook-token
  • x-openclaw-token
  • Authorization: Bearer <token>
• 空または欠落したトークンは fail closed します。
• ペイロードは application/x-www-form-urlencoded または application/json にできます。token、user_id、text が必須です。

{
  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（既定）、open、disabled。Synology Chat にはペアリングフローがありません。送信者を承認するには、数値の Synology ユーザー ID を allowedUserIds に追加します。
• allowedUserIds は Synology ユーザー ID のリスト（またはカンマ区切り文字列）を受け付けます。
• allowlist モードでは、空の allowedUserIds リストは構成ミスとして扱われ、Webhook ルートは開始されません。
• dmPolicy: "open" は、allowedUserIds に "*" が含まれている場合にのみ公開 DM を許可します。制限付きのエントリがある場合は、一致するユーザーだけがチャットできます。空の allowedUserIds リストでの open も、ルートの開始を拒否します。
• dmPolicy: "disabled" は DM をブロックします。
• 返信先のバインドは、既定で安定した数値の user_id に留まります。channels.synology-chat.dangerouslyAllowNameMatching: true は break-glass 互換モードで、返信配信のために変更可能なユーザー名/ニックネーム検索を再度有効にします。

​

送信配信

openclaw message send --channel synology-chat --target 123456 --message "Hello from OpenClaw"
openclaw message send --channel synology-chat --target synology-chat:123456 --message "Hello again"
openclaw message send --channel synology-chat --target synology:123456 --message "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 は秘密に保ち、漏えいした場合はローテーションしてください。
• 自己署名されたローカル NAS 証明書を明示的に信頼する場合を除き、allowInsecureSsl: false のままにしてください。
• 受信 Webhook リクエストはトークン検証され、送信者ごとにレート制限されます（rateLimitPerMinute、既定 30）。
• 無効なトークンチェックは定数時間のシークレット比較を使用し、fail closed します。無効なトークン試行が繰り返されると、送信元 IP が一時的にロックアウトされます。
• 受信メッセージテキストは、既知のプロンプトインジェクションパターンに対してサニタイズされ、4000 文字で切り捨てられます。
• 本番環境では dmPolicy: "allowlist" を優先してください。
• レガシーのユーザー名ベース返信配信が明示的に必要な場合を除き、dangerouslyAllowNameMatching はオフのままにしてください。
• マルチアカウントセットアップで共有パスルーティングのリスクを明示的に受け入れる場合を除き、dangerouslyAllowInheritedWebhookPath はオフのままにしてください。

​

トラブルシューティング

• Missing required fields (token, user_id, text):
  • 送信 Webhook ペイロードに必須フィールドのいずれかが欠けています
  • Synology がヘッダーでトークンを送信する場合は、Gateway/プロキシがそれらのヘッダーを保持していることを確認してください
• Invalid token:
  • 送信 Webhook シークレットが channels.synology-chat.token と一致しません
  • リクエストが誤ったアカウント/Webhook パスに到達しています
  • リクエストが OpenClaw に到達する前に、リバースプロキシがトークンヘッダーを削除しました
• Rate limit exceeded:
  • 同じ送信元からの無効なトークン試行が多すぎると、その送信元が一時的にロックアウトされることがあります
  • 認証済み送信者にも、ユーザーごとの別のメッセージレート制限があります
• Allowlist is empty. Configure allowedUserIds or use dmPolicy=open with allowedUserIds=["*"].:
  • dmPolicy="allowlist" が有効ですが、ユーザーが構成されていません
• User not authorized:
  • 送信者の数値 user_id が allowedUserIds に含まれていません

​

関連

• チャンネル概要 — 対応しているすべてのチャンネル
• グループ — グループチャットの動作とメンションゲート
• チャンネルルーティング — メッセージのセッションルーティング
• セキュリティ — アクセスモデルと強化