AI 自動化 2026年5月21日

2026 MacLogin 云端 Mac OpenClaw Telegram 與 WhatsApp 頻道:配對、dmPolicy 與 probe 排障

MacLogin AI 自動化團隊 2026年5月21日 约 16 分鐘

已在 MacLogin mini 上完成 openclaw onboard --install-daemon 的团队,常会卡在下一关: openclaw gateway status 全绿,SSH 转发能打开 Control UI,但 Telegram 私信无声、WhatsApp 群聊唤不醒 Agent。本篇 2026 年 5 月 21 日運維手册说明如何配置 Telegram botTokendmPolicy、重新关联 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 statusopenclaw gateway statusopenclaw channels status --probeopenclaw logs --followopenclaw doctor。跳过 probe 直接轮换 token 往往浪费数小时。

頻道策略矩阵:dmPolicy、配對與群提及规则

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

頻道 控制项 严格(生产) 宽松(预发) 常见失误
Telegram 私信 dmPolicy + 配對 必须配對;按发送方批准 仅白名单测试会话 Token 有效但未批准配對
Telegram 群组 隐私模式 / 提及 必须 @ 機器人 实验室可在 BotFather 关闭隐私 未 @ 却期待回复
WhatsApp 私信 会话 + allowFrom 显式白名单 试点仅允许单运营号码 租约移交后 QR 过期
WhatsApp 群组 requireMention 必须提及 演示可临时关闭 关闭后高流量群刷屏
建议记录的数值:网关 loopback 端口 18789、Telegram API 超时重试 3 次、WhatsApp QR 扫描窗口 60 秒、割接期 probe 间隔 30 秒。

前置条件:先保证网关健康,再写任何頻道 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 使用网关关联的 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_PROXYHTTP_PROXYNO_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 访问说明在手边。

把 OpenClaw 頻道放在用户身边

在港/日/韩/新/美租賃 Apple Silicon,完成 onboard 后用 probe 验证接通 Telegram 與 WhatsApp。