​

Synology Chat

​

バンドル済みプラグイン

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

​

クイックセットアップ

1. Synology Chatプラグインが利用可能であることを確認します。
   • 現在のパッケージ版OpenClawリリースには、すでにバンドルされています。
   • 古い/カスタムインストールでは、上記コマンドでソースチェックアウトから手動追加できます。
   • openclaw onboardでは、openclaw channels addと同じチャンネルセットアップ一覧にSynology Chatが表示されるようになりました。
   • 非対話型セットアップ: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
2. Synology Chatの統合設定で以下を行います。
   • 受信webhookを作成し、そのURLをコピーします。
   • 送信webhookを作成し、そのシークレットトークンを設定します。
3. 送信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を送信します。

• OpenClawは、まずbody.token、次に ?token=...、最後にヘッダーから送信webhookトークンを受け付けます。
• 受け付けるヘッダー形式:
  • x-synology-token
  • x-webhook-token
  • x-openclaw-token
  • Authorization: Bearer <token>
• 空または欠落したトークンはfail-closedになります。

{
  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"が推奨されるデフォルトです。
• allowedUserIdsは、SynologyユーザーIDのリスト（またはカンマ区切り文字列）を受け付けます。
• allowlistモードでは、allowedUserIdsリストが空だと設定ミスとして扱われ、webhookルートは起動しません（全員許可にするにはdmPolicy: "open"を使用してください）。
• dmPolicy: "open"は任意の送信者を許可します。
• dmPolicy: "disabled"はDMをブロックします。
• 返信先バインディングは、デフォルトで安定した数値のuser_idに基づきます。channels.synology-chat.dangerouslyAllowNameMatching: trueは、返信配信で可変なusername/nickname参照を再有効化する非常用の互換モードです。
• ペアリング承認は次で行えます。
  • openclaw pairing list synology-chat
  • openclaw pairing approve synology-chat <CODE>

​

送信配信

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"

​

複数アカウント

{
  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リクエストはトークン検証され、送信者ごとにレート制限されます。
• 無効なトークンチェックでは定数時間のシークレット比較を使用し、fail-closedになります。
• 本番環境ではdmPolicy: "allowlist"を推奨します。
• レガシーのusernameベース返信配信が明示的に必要な場合を除き、dangerouslyAllowNameMatchingは無効のままにしてください。
• 複数アカウント構成で共有パスのルーティングリスクを明示的に受け入れる場合を除き、dangerouslyAllowInheritedWebhookPathは無効のままにしてください。

​

トラブルシューティング

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

​

関連

• Channels Overview — サポートされているすべてのチャンネル
• Pairing — DM認証とペアリングフロー
• Groups — グループチャットの挙動とメンション制御
• Channel Routing — メッセージのセッションルーティング
• Security — アクセスモデルとハードニング