我要配 Telegram / Slack
就翻 Channels 这一大组里对应的门。
Gateway 导读
主配置入口：openclaw.json 的结构与关键开关
所有核心配置都写在 ~/.openclaw/openclaw.json 里，频道、DM 策略、模型映射都在这里。先看 Channels 部分的 DM/Group 策略——默认是配对模式，群消息默认只允许名单，容易漏配导致消息进不来。模型按频道覆盖用 modelByChannel，只在会话没有手动覆盖时生效。
先讲这一页到底在解决什么
主配置入口：openclaw.json 的结构与关键开关
所有核心配置都写在 ~/.openclaw/openclaw.json 里，频道、DM 策略、模型映射都在这里。先看 Channels 部分的 DM/Group 策略——默认是配对模式，群消息默认只允许名单，容易漏配导致消息进不来。模型按频道覆盖用 modelByChannel，只在会话没有手动覆盖时生效。
第一件事
🧭 这页的正确打开方式：先带问题来，再翻对应抽屉
如果你只是想“开始配置”，先回去看配置总览或配置样例。这一页更像图书馆索引柜。
我要查模型字段
就去模型、provider、agent 默认值那几格里找。
我要藏 API key
就翻 env、SecretRef、secrets providers 这些抽屉。
一句话
先问自己“我要查哪块”，再翻字典，不要整本硬吞。
第二件事
🚪 Channels 这一大块，核心其实只有三个门卫问题
虽然这部分列了很多 provider，但一开始你只要先盯住三个问题。
谁能私聊进门？
dmPolicy 就是在决定陌生人先配对、只看白名单、全部放行，还是完全不理。
群里谁能叫到我？
groupPolicy、groupAllowFrom、requireMention 这些是在管群聊门卫。
这扇门默认请哪位老师值班？
modelByChannel 像给不同门口贴不同老师值班表。
🎈 先别陷进去
你不需要先会背 Slack、Telegram、Discord 全字段。先会看“门卫规则、提及规则、默认老师”就够用了。
第三件事
🧱 字段参考最容易让人犯的错，是把“举例”当“必须全写”
官方这一页列的很多大对象，都像把柜子里的所有抽屉一口气拉开给你看。那不代表你每个抽屉都要先塞东西。
例如 Telegram
botToken、groups、retry、network、webhookUrl 都列出来了，但你并不是第一次接 Telegram 就要每个都写。
例如 Discord
动作权限、线程绑定、语音、presence、组件配色全在这页，但多数人刚开始只会用其中一小块。
正确心法
把大对象当“这间房可以摆哪些家具”的清单，不是“交房前必须买齐”。
第四件事
🗣 DM policy 和 group policy，真的值得单独记住
因为几乎所有通道都会遇到这套门卫语言。
pairing
陌生人先拿一次性配对码，像先在门口登记。
allowlist
只有名单上的人能进。像门卫手里拿着白名单。
open
谁都能进。像把门敞开，但通常也要配合 ["*"] 这种明确表态。
disabled
这扇门直接不接客。
第五件事
🔐 SecretRef 这一类字段，读法是“别把宝藏直接贴墙上”
这一页后面那些 source: "env" | "file" | "exec"，看起来像新术语，其实都在说秘密怎么藏。
source: "env"像藏宝图指向环境变量抽屉。
source: "file"像藏宝图指向另一份秘密文件。
source: "exec"像去问一个外部保险箱管理员，让它现场把秘密吐出来。
📌 为什么这很重要
因为 API key、token、password 这种东西，本来就不该大剌剌写在最显眼的总账本正文里。
第六件事
⚠️ 参考页最适合拿来“纠错”，不是拿来“开局”
什么时候最该来这里？当你知道大概想做什么，但拼写、路径、字段名拿不准的时候。
比如你已经知道要配 Telegram 群聊提及规则，只是不确定 requireMention 写在哪层、topics 怎么挂、defaultAccount 应该放哪。这种时候，参考页特别好用。
最后总结
🎈 把配置参考页压成一句最好记的话
它是字段字典，不是入门课。先知道自己要查哪个抽屉，再来翻这一页，才不会淹在参数海里。
如果你接下来想把 Gateway 放进 Tailscale 里，用更舒服的远程入口去开控制台，下一页就看 Tailscale。