Channels 导读

Synology Chat 接入:先配好两个 Webhook,再管好 DM 权限

这一页教你用 Synology Chat 的 Outgoing 和 Incoming Webhook 把群聊机器人接进 OpenClaw。最容易踩坑的是 DM 策略:默认 allowlist 模式如果 allowedUserIds 为空,Webhook 路由根本不会启动,必须要么填用户 ID,要么改成 open。非交互式配置可以直接用 openclaw channels add 命令一次性传 token 和 incoming URL。

先讲这一页到底在解决什么

Synology Chat 接入:先配好两个 Webhook,再管好 DM 权限

这一页教你用 Synology Chat 的 Outgoing 和 Incoming Webhook 把群聊机器人接进 OpenClaw。最容易踩坑的是 DM 策略:默认 allowlist 模式如果 allowedUserIds 为空,Webhook 路由根本不会启动,必须要么填用户 ID,要么改成 open。非交互式配置可以直接用 openclaw channels add 命令一次性传 token 和 incoming URL。

原文共 10 节,先看 Start Here 路径:/channels/synology-chat 查看官方原文

第一站

🔌 先把两头电线接对:谁负责收,谁负责发

这类 webhook 通道最容易乱的地方,就是把进站口和出站口搞反。

📥

Outgoing webhook

名字虽然叫 outgoing,但对 OpenClaw 来说它是“收件门”。Synology 把用户发来的消息推到这里。

📤

Incoming webhook URL

这才是“发件门”。OpenClaw 回消息时,会顺着这条 URL 把内容送回 Synology Chat。

🪪

token

像门口暗号。没有这个暗号,别人随便敲你的 webhook 门就太危险了。

🚪

/webhook/synology

默认门牌号就是这个。你也可以换门牌,但要让 Synology 和 OpenClaw 两边都认同。

第二站

🛠️ 这几句命令,讲白了就是“装插件、登记暗号、把收发门接进去”

如果你看 CLI 容易晕,就把它理解成给门卫做登记。

openclaw plugins install ./extensions/synology-chat

这句像把 Synology Chat 这套插头先安装到机器上,不装就没有插孔。

openclaw onboard

像新手向导带你边看边填,适合第一次接这类双 webhook 通道。

openclaw channels add --channel synology-chat --token <token> --url <incoming-webhook-url>

这句就是手工登记版:把暗号和发件门地址一次性交给 OpenClaw。

🔄 Restart gateway

重启像重新开门营业。前面登记好的 webhook 路线,开门后才会真正生效。

第三站

👮 这页真正想保护你的,是“别让任何人都能来 DM 机器人”

官方最推荐的默认值很明确:先白名单,再慢慢放开。

dmPolicy: "allowlist"

像只让名单上的人进门。这是最稳的默认做法。

allowedUserIds

这里要填的是数字用户 ID,不是昵称。因为昵称会变,数字门牌更稳。

openclaw pairing list synology-chat

这句像翻门卫登记簿,看看最近谁来敲门、谁还在等审核。

dangerouslyAllowNameMatching

这相当于“别看身份证,只看昵称叫法”。官方都把它写成危险选项了,说明真不建议常开。

第四站

📨 发消息时,目标最好用数字 ID,不要赌名字不会变

这页后半段的重点,是把回信送到正确的人手里。

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

这句像对着编号 123456 的收件箱直接投递,不靠模糊猜名字。

synology-chat:123456

这个写法像把“通道名 + 门牌号”一起写全,路由时更不容易认错门。

多账号

如果你挂多个 Synology 账号,每个账号最好用不同 webhookPath。别让两扇门共用一个门牌。

🎈 最后记一句

Synology Chat 这页本质就是“装插件、接双线、守门、按数字门牌送信”。