OpenClaw 配置群晖 Synology Chat 文档（DSM 7）

本文介绍如何在 OpenClaw 中接入 群晖 Synology Chat，实现 Chat → OpenClaw 的消息输入与 OpenClaw → Chat 的回复输出。
OpenClaw 通过 Synology Chat 的 Incoming / Outgoing Webhook 实现双向通信。[^1][^2]

一、前置条件

• 已完成 OpenClaw 安装与网关运行
• 群晖 NAS 已安装 Synology Chat
• 具有创建整合（Integration）权限（通常为管理员）

二、安装 OpenClaw 群晖插件

Synology Chat 在 OpenClaw 中是 插件式通道，需要手动安装插件：

openclaw plugins install ./extensions/synology-chat

三、在 Synology Chat 创建 Webhook

Synology Chat 的整合功能支持 Incoming / Outgoing Webhook（也支持 Bot 与 Slash Command，但此处只需 Webhook）。

1）创建 Incoming Webhook（用于 OpenClaw 发消息到 Chat）

在 Synology Chat 中打开 整合功能 → Incoming Webhook → 建立
复制生成的 Webhook URL，稍后填入 OpenClaw 配置。

2）创建 Outgoing Webhook（用于 Chat 消息送入 OpenClaw）

在 Synology Chat 中打开 整合功能 → Outgoing Webhook → 建立
设置一个 Token/Secret（用于请求鉴权），稍后填入 OpenClaw 配置。

四、配置 OpenClaw（核心）

在 ~/.openclaw/openclaw.json 添加如下配置：

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

字段说明（重点）

• token：Synology Outgoing Webhook 的密钥
• incomingUrl：Synology Incoming Webhook 的 URL
• webhookPath：OpenClaw 对外接收 webhook 的路径（默认 /webhook/synology）
• dmPolicy：建议 allowlist（更安全）
• allowedUserIds：允许发消息给机器人的 Synology 用户 ID 列表
• allowInsecureSsl：默认 false，仅当 NAS 使用自签证书时才考虑开启[^1]

五、配置 Synology Chat Outgoing Webhook 指向 OpenClaw

在群晖 Outgoing Webhook 设置里，Webhook URL 填：

https://<your-gateway-host>/webhook/synology

若你在 OpenClaw 中自定义了 webhookPath，则改为自定义路径。[^1]

六、重启网关并测试

openclaw gateway restart

在 Synology Chat 中给机器人发送一条 DM，应该能收到 OpenClaw 的回复。

七、可选：发送测试消息（从 OpenClaw 到群晖）

openclaw message send --channel synology-chat --target 123456 --text "Hello from OpenClaw"

target 填 Synology 用户 ID。

八、安全建议

OpenClaw 官方建议：

• dmPolicy 使用 allowlist
• 严格保管 token
• 默认保持 allowInsecureSsl: false
• 避免公开开放 webhook（除非必要）

九、环境变量方式（可选）

如果不想写入配置文件，可以使用环境变量：

• SYNOLOGY_CHAT_TOKEN
• SYNOLOGY_CHAT_INCOMING_URL
• SYNOLOGY_NAS_HOST
• SYNOLOGY_ALLOWED_USER_IDS（逗号分隔）
• SYNOLOGY_RATE_LIMIT

总结

Synology Chat 的 Integration 机制提供 Incoming/Outgoing Webhook，OpenClaw 通过插件即可快速对接，实现群晖 Chat 中的私聊机器人。配置关键点是：

✅ 安装 OpenClaw 插件
✅ 创建 Incoming / Outgoing Webhook
✅ 填写 token + incomingUrl
✅ 设置 dmPolicy 与 allowedUserIds
✅ 将 Outgoing Webhook 指向 OpenClaw 网关

参考资料

[1]: OpenClaw Synology Chat 插件文档
[2]: Synology Chat 整合功能（Incoming/Outgoing Webhook）

下一篇 OpenClaw 部署实战系列五(群晖chat多Agent配置))