2026 MacLogin 云端 Mac OpenClaw Telegram 与 WhatsApp 频道：配对、dmPolicy 与 probe 排障

已在 MacLogin mini 上完成 openclaw onboard --install-daemon 的团队，常会卡在下一关： openclaw gateway status 全绿，SSH 转发能打开 Control UI，但 Telegram 私信无声、WhatsApp 群聊唤不醒 Agent。本篇 2026 年 5 月 21 日运维手册说明如何配置 Telegram botToken 与 dmPolicy、重新关联 WhatsApp QR 会话，并用 openclaw channels status --probe 结合日志排障，而不是凭感觉换 token。 你将获得策略矩阵、分频道步骤、症状对照表，以及面向香港、日本、韩国、新加坡、美国节点的代理与 DNS 基线。请先阅读 onboard 与守护进程引导，叠加 健康 curl 监控；probe 异常时参考 stderr 分流。入口：帮助、定价、VNC。

谁需要在租赁网关上接消息频道——「已连接却静音」究竟指什么

读者把 OpenClaw 当作 7×24 的 Agent 前台：告警进 Telegram、客户经理要 WhatsApp 群 @、工程仍 SSH 登录同一台 Mac mini。失败模式很隐蔽——配置里频道已登记，真人发消息却收不到回复，往往是配对队列、提及规则或陈旧 webhook 挡住了投递。

• 配对积压：首条私信需 openclaw pairing list 批准；未批准则策略静默拒绝。
• Token 加载竞态：网关启动时环境变量未就绪却引用 ${TELEGRAM_BOT_TOKEN}，getMe 返回 401。
• WhatsApp QR 漂移：Baileys 会话过期；运维把「昨天已扫码」当成「现在仍有效」。
• 群提及门槛：默认 requireMention 导致群内无人 @ 机器人则一直安静。
• 插件/配置干扰：近期回归显示实验性 plugins 阻塞频道初始化时列表为空——doctor 可能建议 unset。

频道策略矩阵：dmPolicy、配对与群提及规则

按环境刻意选择策略；在同一网关上混用生产严苛与预发宽松，会产生「Alice 能用、Bob 不行」类工单。

频道	控制项	严格（生产）	宽松（预发）	常见失误
Telegram 私信	dmPolicy + 配对	必须配对；按发送方批准	仅白名单测试会话	Token 有效但未批准配对
Telegram 群组	隐私模式 / 提及	必须 @ 机器人	实验室可在 BotFather 关闭隐私	未 @ 却期待回复
WhatsApp 私信	会话 + allowFrom	显式白名单	试点仅允许单运营号码	租约移交后 QR 过期
WhatsApp 群组	requireMention	必须提及	演示可临时关闭	关闭后高流量群刷屏

前置条件：先保证网关健康，再写任何频道 token

频道不能替代损坏的守护进程。请确认：

• openclaw gateway status 显示运行中且 RPC probe 正常。
• loopback 18789 监听与 onboard 文中的 SSH 隧道配方一致。
• mini 出站 HTTPS 可达 api.telegram.org 与 WhatsApp Web 端点——在主机上 curl -I，勿只在笔记本上测。
• CMDB 已固定 Node 版本（常见 22.14+，新网关可用 24.x）。

Telegram：bot token、清理 webhook 与配对批准

通过 @BotFather 创建机器人并复制 token；若环境变量注入竞态导致启动为空，调试阶段可暂时明文写入频道配置。若该 token 曾在其他主机使用 webhook，先清理：

curl "https://api.telegram.org/bot<TOKEN>/deleteWebhook"

重启网关后执行 openclaw channels status --probe。用测试账号发送 /start；若策略要求配对，通过 openclaw pairing list telegram 及文档中的 approve 子命令批准，并把事件 ID 写入变更工单。

WhatsApp：QR 重连、代理环境与群提及演练

WhatsApp 使用网关关联的 Web 会话。经 SSH 隧道或按 VNC 说明 打开 Control UI，开始关联并在 60 秒内扫码。若登录返回 408，为 mini 所在区域配置可达的 HTTPS_PROXY；仅在安全团队批准时设置 NO_PROXY 例外。

关联成功后做私信金丝雀，再在启用 requireMention 的群里 @ 机器人。若随机断连循环：openclaw gateway restart，probe 仍失败则重新扫码。

九步上线：从零到可验证回复

1. 冻结 20 分钟变更窗口，在覆盖港/日/韩/新/美的频道公告。
2. 用 status + curl 手册验证网关，勿只看 UI 直觉。
3. 写入 Telegram token；重启前跑 openclaw doctor。
4. 若从其他主机迁移，删除陈旧 Telegram webhook。
5. 通过 launchd kickstart 或批准的重载脚本重启网关。
6. 执行 channels status --probe 并将 JSON 归档到工单。
7. 批准首条私信发送方的配对；为审计截取策略界面。
8. 关联 WhatsApp QR；在 CMDB 记录会话路径与租约 ID。
9. 完成群与私信金丝雀；宣布成功前 tail 日志 10 分钟。

probe 排障矩阵：状态正常但用户听不到回复

症状	probe / 日志信号	可能原因	首选修复
openclaw status 无频道行	无 telegram/whatsapp 条目	插件阻塞或配置未加载	openclaw config unset plugins 后重启
Telegram 启动 401	getMe returned 401	错误 token 或环境竞态	明文 token；经 BotFather 重新生成
私信被忽略	配对列表 pending	dmPolicy	批准发送方或放宽预发策略
群组安静	日志无 mention 事件	requireMention	@ 机器人或临时调策略
回复延迟数分钟	doctor 显示陈旧 TUI 客户端	客户端积压	openclaw doctor --fix
WhatsApp 断连循环	probe 在已连/断开间抖动	代理或会话损坏	修代理；重扫 QR；重启网关

MacLogin 各区域：代理与 DNS 基线

网关应靠近用户且靠近消息 API。以下为路由良好企业网的示意 RTT（务必自行实测）：

MacLogin 区域	典型场景	注意点
香港 (HK)	大湾区运维机器人	跨境代理规则影响 WhatsApp Web
日本 (JP)	东京日间支持	IPv6 偏好异常——用 curl -4 验证
韩国 (KR)	首尔工程告警	企业 MITM 替换证书——谨慎固定
新加坡 (SG)	东盟枢纽群组	RTT 低但出口白名单严
美国 (US)	美洲客户	用户仍在亚太时跨太平洋路径长

若频道依赖代理，请在租约记录中写明 HTTPS_PROXY、HTTP_PROXY、NO_PROXY。

常见问题：频道与 webhook、多网关与安全

频道等于 webhook 吗？相关但不同——频道维持 Messenger 传输；HTTP webhook 是另一入口。可同时使用；排障时勿无意关闭其一。

一台 mini 能跑两个网关吗？避免 18789 端口冲突；优先两台租约或不同 loopback 端口并明确 SSH 映射。

botToken 写在配置里安全吗？把 mini 当机密主机：限制 SSH、离场轮换 token；环境竞态解决后改用保险库注入。

VNC 有用吗？对 QR 扫码体验有帮助；配对仍在 CLI/UI 命令中完成。

为何 MacLogin 上的 Mac mini M4 适合常开消息网关

频道需要稳定的 Node 进程、持久会话文件与出站 HTTPS——不是会休眠的笔记本。Apple Silicon M4 在轮询负载下散热稳定，MacLogin 港/日/韩/新/美节点让你把网关放在用户与 API 之间。租赁意味着可单独开一台「仅频道」mini、隔离 WhatsApp 会话，而不挤占开发者日常机器。

在 定价页 对比核心数与区域，关联 Messenger 时保持 帮助 中的 SSH/VNC 访问说明在手边。