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。
openclaw status → openclaw gateway status → openclaw channels status --probe → openclaw logs --follow → openclaw doctor。跳过 probe 直接轮换 token 往往浪费数小时。頻道策略矩阵: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 仍失败则重新扫码。
九步上线:从零到可验证回复
- 冻结 20 分鐘变更窗口,在覆盖港/日/韩/新/美的頻道公告。
- 用 status + curl 手册验证网关,勿只看 UI 直觉。
- 写入 Telegram token;重啟前跑
openclaw doctor。 - 若从其他主机迁移,删除陈旧 Telegram webhook。
- 通过 launchd kickstart 或批准的重载脚本重啟网关。
- 执行
channels status --probe并将 JSON 归档到工单。 - 批准首条私信发送方的配對;为审计截取策略界面。
- 关联 WhatsApp QR;在 CMDB 记录会话路径與租约 ID。
- 完成群與私信金丝雀;宣布成功前 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 会话,而不挤占开发者日常机器。
把 OpenClaw 頻道放在用户身边
在港/日/韩/新/美租賃 Apple Silicon,完成 onboard 后用 probe 验证接通 Telegram 與 WhatsApp。