Synology Chat 是群晖（Synology）NAS 设备内置的团队通讯工具，适合家庭或小团队在内网使用。OpenClaw 通过双向 Webhook 接入 Synology Chat：入站消息通过 outgoing webhook 接收，回复通过 incoming webhook URL 发送。
安装 Synology Chat 插件
bash
openclaw plugins install ./extensions/synology-chat目前仅支持本地 checkout 安装（
./extensions/synology-chat），暂未发布到 npm registry。
配置步骤
第一步：在 Synology Chat 创建 Webhook
在 Synology Chat 管理面板的 Integrations 中：
- 创建 Incoming Webhook，复制其 URL（用于 OpenClaw 回复消息）
- 创建 Outgoing Webhook，设置：
- URL：你的 Gateway 地址 +
/webhook/synology - 复制生成的 Secret Token（用于验证请求合法性）
- URL：你的 Gateway 地址 +
第二步：配置 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
}
}
}配置字段说明：
| 字段 | 说明 | 默认值 |
|---|---|---|
token | Synology 生成的 outgoing webhook secret token | 必填 |
incomingUrl | Synology Chat incoming webhook 完整 URL | 必填 |
webhookPath | OpenClaw 监听的路径 | /webhook/synology |
dmPolicy | 私信访问策略 | allowlist |
allowedUserIds | 允许的 Synology 用户 ID 列表 | 空（需设置） |
rateLimitPerMinute | 每分钟最大请求数 | 30 |
allowInsecureSsl | 是否允许不验证 SSL 证书（内网自签证书时用） | false |
第三步：启动并测试
bash
openclaw gateway run向 Synology Chat Bot 发送一条消息，如果配置正确会收到回复。
访问控制
| 策略 | 说明 |
|---|---|
allowlist | 仅允许 allowedUserIds 中的用户，空列表不启动 Webhook |
open | 允许所有用户 |
disabled | 禁用所有私信 |
⚠️
allowlist模式下若allowedUserIds为空，视为配置错误，Webhook 路由不会启动。若需允许所有用户，改用open。
配对审批方式（当 dmPolicy: "pairing" 时）：
bash
openclaw pairing list synology-chat
openclaw pairing approve synology-chat <CODE>环境变量（默认账号）
| 变量名 | 说明 |
|---|---|
SYNOLOGY_CHAT_TOKEN | Outgoing webhook token |
SYNOLOGY_CHAT_INCOMING_URL | Incoming webhook URL |
SYNOLOGY_NAS_HOST | NAS 主机地址 |
SYNOLOGY_ALLOWED_USER_IDS | 允许的用户 ID（逗号分隔） |
SYNOLOGY_RATE_LIMIT | 每分钟限速 |
配置文件中的值优先于环境变量。
主动发送消息
bash
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"目标使用 Synology Chat 的数字用户 ID，支持通过 URL 发送媒体文件。
多账号配置
如需管理多个 Synology Chat 账号（如多台 NAS），在 channels."synology-chat".accounts 中分别配置，每个账号可独立覆盖 token、incoming URL、webhook 路径、DM 策略和限速。
内网自签证书
内网 NAS 通常使用自签名 SSL 证书。若遇到 SSL 验证错误，可临时开启：
json
{ "allowInsecureSsl": true }生产环境建议配置正规 CA 证书或使用 Tailscale 内网访问，避免长期绕过 SSL 验证。
原文：Synology Chat - OpenClaw | 来源：OpenClaw 官方文档