OpenClaw mit Synology Chat verbinden: Schnelleinrichtung

Kennst du das? Du hast dein eigenes NAS-Setup und nutzt Synology Chat für die interne Kommunikation, aber die Integration deiner Bots fühlt sich jedes Mal wie ein Kampf gegen Windmühlen an. Es ist oft mühsam, eingehende Webhooks und ausgehende Antworten sauber zu synchronisieren, ohne dass das Ganze in einer unübersichtlichen Konfiguration endet.

Hier kommt das Synology Chat Plugin für OpenClaw ins Spiel. Es unterstützt Synology Chat als Direct-Message-Channel über Webhooks. Das Plugin nimmt eingehende Nachrichten von den Outgoing Webhooks von Synology Chat entgegen und sendet Antworten über einen Incoming Webhook zurück.

Synology Chat (plugin)

Status: Unterstützt via Plugin als Direct-Message-Channel unter Verwendung von Synology Chat Webhooks. Das Plugin akzeptiert eingehende Nachrichten von Synology Chat Outgoing Webhooks und sendet Antworten über einen Synology Chat Incoming Webhook.

Plugin erforderlich

Synology Chat ist Plugin-basiert und nicht Teil der Standard-Installation des Core-Channels.

Installation aus einem lokalen Checkout:

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

Details: Plugins

Schnelle Einrichtung

Installiere und aktiviere das Synology Chat Plugin.
- openclaw onboard zeigt Synology Chat jetzt in derselben Liste für das Channel-Setup an wie openclaw channels add.
- Nicht-interaktives Setup: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
In den Synology Chat Integrationen:
- Erstelle einen Incoming Webhook und kopiere die URL.
- Erstelle einen Outgoing Webhook mit deinem Secret Token.
Richte die Outgoing Webhook URL auf dein OpenClaw Gateway:
- Standardmäßig https://gateway-host/webhook/synology.
- Oder dein benutzerdefinierter channels.synology-chat.webhookPath.
Schließe das Setup in OpenClaw ab.
- Geführt: openclaw onboard
- Direkt: openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>
Starte das Gateway neu und sende eine DM an den Synology Chat Bot.

Minimale Konfiguration:

{
  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,
    },
  },
}

Umgebungsvariablen

Für den Standard-Account kannst du Umgebungsvariablen verwenden:

SYNOLOGY_CHAT_TOKEN
SYNOLOGY_CHAT_INCOMING_URL
SYNOLOGY_NAS_HOST
SYNOLOGY_ALLOWED_USER_IDS (kommagetrennt)
SYNOLOGY_RATE_LIMIT
OPENCLAW_BOT_NAME

Konfigurationswerte überschreiben die Umgebungsvariablen.

DM-Richtlinien und Zugriffskontrolle

dmPolicy: "allowlist" ist der empfohlene Standard.
allowedUserIds akzeptiert eine Liste (oder einen kommagetrennten String) von Synology User-IDs.
Im allowlist-Modus wird eine leere allowedUserIds-Liste als Fehlkonfiguration betrachtet und die Webhook-Route wird nicht gestartet (nutze dmPolicy: "open", um alles zu erlauben).
dmPolicy: "open" erlaubt jeden Absender.
dmPolicy: "disabled" blockiert DMs.
Die Bindung des Antwortempfängers bleibt standardmäßig auf der stabilen numerischen user_id. channels.synology-chat.dangerouslyAllowNameMatching: true ist ein Notfall-Kompatibilitätsmodus, der die Suche nach veränderbaren Benutzernamen/Nicknames für die Antwortzustellung wieder aktiviert.
Pairing-Bestätigungen funktionieren mit:
- openclaw pairing list synology-chat
- openclaw pairing approve synology-chat <CODE>

Ausgehende Nachrichten

Verwende numerische Synology Chat User-IDs als Ziele.

Beispiele:

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"

Der Versand von Medien wird durch URL-basierte Dateizustellung unterstützt.

Mehrere Accounts

Mehrere Synology Chat Accounts werden unter channels.synology-chat.accounts unterstützt. Jeder Account kann Token, Incoming URL, Webhook-Pfad, DM-Richtlinie und Limits überschreiben. Direct-Message-Sessions sind pro Account und Benutzer isoliert, sodass dieselbe numerische user_id auf zwei verschiedenen Synology-Accounts keinen gemeinsamen Transcript-Status teilt. Gib jedem aktivierten Account einen eindeutigen webhookPath. OpenClaw lehnt identische Pfade ab und verweigert den Start von benannten Accounts, die in Multi-Account-Setups nur einen gemeinsamen Webhook-Pfad erben. Wenn du absichtlich die Vererbung für einen benannten Account benötigst, setze dangerouslyAllowInheritedWebhookPath: true für diesen Account oder unter channels.synology-chat. Dennoch werden doppelte Pfade abgelehnt. Bevorzuge explizite Pfade pro Account.

{
  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"],
        },
      },
    },
  },
}

Sicherheitshinweise

Halte den token geheim und rotiere ihn, falls er bekannt wird.
Behalte allowInsecureSsl: false bei, außer du vertraust explizit einem selbstsignierten lokalen NAS-Zertifikat.
Eingehende Webhook-Anfragen werden Token-verifiziert und pro Absender ratenlimitiert.
Bevorzuge dmPolicy: "allowlist" für den produktiven Einsatz.
Lass dangerouslyAllowNameMatching deaktiviert, außer du benötigst explizit die auf Benutzernamen basierende Antwortzustellung.
Lass dangerouslyAllowInheritedWebhookPath deaktiviert, außer du akzeptierst das Risiko des Shared-Path-Routings in einem Multi-Account-Setup.

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.