Synology Chat - 群晖 NAS 通讯接入
Synology Chat 是群晖 NAS（Network Attached Storage，网络附属存储）内置的即时通讯应用。通过 Incoming/Outgoing Webhook（入站/出站 Webhook），可以将 OpenClaw 接入 Synology Chat，在私有 NAS 环境中运行 AI 聊天机器人。
前置要求
- 群晖 NAS（DSM 7.0+）
- 已安装 Synology Chat 套件
- 拥有 Synology Chat 管理员权限
- OpenClaw Gateway（网关）已安装并运行
安装插件
openclaw plugins install @openclaw/synology-chat接入步骤
第一步：创建 Incoming Webhook
Incoming Webhook（入站 Webhook）用于 OpenClaw 向 Synology Chat 发送消息：
- 打开 Synology Chat，点击左上角头像 > Integration（集成）
- 选择 Incoming Webhooks > Create
- 填写名称（如
OpenClaw Bot），选择发送目标频道 - 记录生成的 Webhook URL
第二步：创建 Outgoing Webhook
Outgoing Webhook（出站 Webhook）用于 Synology Chat 将用户消息转发给 OpenClaw：
- 在 Integration 页面选择 Outgoing Webhooks > Create
- 填写名称，设置 Trigger Word（触发词，如
@bot）或选择 All messages - 将 URL 设置为 OpenClaw Gateway 地址：
https://your-gateway/synology-chat/webhook- 记录生成的 Token
网络访问
如果 OpenClaw Gateway 与群晖 NAS 在同一局域网，可以使用内网 IP；如需外网访问，需配置端口转发或反向代理。
第三步：配置 OpenClaw
{
channels: {
"synology-chat": {
enabled: true,
incomingUrl: "https://your-nas:5001/webapi/entry.cgi?api=SYNO.Chat.External&method=incoming&version=2&token=%22YOUR_INCOMING_TOKEN%22",
outgoingToken: "YOUR_OUTGOING_TOKEN", // Outgoing Webhook Token
dmPolicy: "pairing" // DM Policy（私信策略）
}
}
}也可以通过 Environment Variable（环境变量）设置：
export SYNOLOGY_CHAT_INCOMING_URL="https://your-nas:5001/webapi/..."
export SYNOLOGY_CHAT_OUTGOING_TOKEN="your-token"第四步：重启 Gateway 并验证
openclaw gateway restart在 Synology Chat 中发送消息触发 Bot 回复，确认集成正常工作。
Bot 高级配置
Slash Commands（斜杠命令）
在 Synology Chat 的 Integration 中还可以创建 Slash Commands：
- 选择 Slash Commands > Create
- 设置命令名（如
/ask） - 将 URL 指向 OpenClaw Gateway
{
channels: {
"synology-chat": {
slashCommands: {
"/ask": { description: "向 AI 提问" },
"/reset": { description: "重置对话上下文" },
"/status": { description: "查看机器人状态" }
}
}
}
}频道过滤
{
channels: {
"synology-chat": {
allowChannels: ["general", "support"], // 允许响应的频道
requireTrigger: true // 需要触发词才响应
}
}
}DM Policy（私信策略）
| 策略 | 说明 |
|---|---|
pairing | 用户需先获取 Pairing Code（配对码）验证 |
allowlist | 仅允许指定 Synology 用户私聊 |
open | 所有人均可私聊（谨慎使用） |
HTTPS 证书配置
Synology Chat Webhook 要求 HTTPS 连接。如果使用自签名证书：
{
channels: {
"synology-chat": {
rejectUnauthorized: false // 允许自签名证书（仅内网使用）
}
}
}生产环境
在生产环境中应使用有效的 SSL 证书（如 Let's Encrypt），避免关闭证书验证。
常见问题
Outgoing Webhook 不触发
- 确认 OpenClaw Gateway 地址可从 NAS 访问
- 检查 DSM 防火墙是否阻断了出站请求
- 确认 Trigger Word 设置正确或选择了 All messages
消息发送失败
- 确认 Incoming Webhook URL 完整正确（包含 Token）
- 检查 NAS 的 HTTPS 端口（默认 5001）是否正常
- 确认 Synology Chat 套件正在运行
Bot 响应缓慢
- 检查 NAS 系统资源（CPU、内存）
- 确认 OpenClaw Gateway 与 NAS 的网络延迟
🇨🇳 中国用户须知
群晖 NAS 在中国有大量用户基础，Synology Chat 是一个完全私有的通讯解决方案。
适用场景：家庭/SOHO 办公、小型团队内部通讯、NAS 管理自动化。已经使用群晖 NAS 的用户可以零成本启用 Chat 功能。
内网部署：大多数群晖 NAS 部署在内网，OpenClaw Gateway 也部署在同一网络时，无需考虑外网访问和代理问题。
QuickConnect：如果通过 QuickConnect（群晖远程访问）使用，需确保 Webhook 回调地址可达。建议使用 DDNS + 端口转发 方案以获得更稳定的连接。
国行群晖：中国大陆销售的群晖 NAS 完全支持 Synology Chat，DSM 系统有完整中文界面。