2026 MacLogin クラウド Mac OpenClaw Telegram・WhatsApp チャネル:配対、dmPolicy、probe トラブルシュート
MacLogin mini で openclaw onboard --install-daemon まで終えたチームが次に詰まるのはここです。 openclaw gateway status は緑、SSH 転送で Control UI も開くのに、Telegram DM は無音、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 グループの @、エンジニアは同じ Mac mini に SSH。失敗は目立ちにくい——設定にチャネルはあるのに返信がない。配対キュー、メンション規則、古い webhook が配送を止めていることが多いです。
- 配対の滞留:初回 DM は
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 DM | dmPolicy + 配対 |
配対必須;送信者ごとに承認 | テストチャットのみ許可リスト | Token は有効だが配対未承認 |
| Telegram グループ | プライバシー / メンション | ボットを @ 必須 | ラボでは BotFather でプライバシー解除可 | @ なしで返信を期待 |
| WhatsApp DM | セッション + allowFrom | 明示的許可リスト | パイロットは単一運用番号のみ | リース移管後に QR 期限切れ |
| WhatsApp グループ | requireMention |
メンション必須 | デモでは一時的に OFF 可 | OFF 後に高トラフィック群が溢れる |
前提:チャネル token の前にゲートウェイを健全に
チャネルは壊れたデーモンの代替になりません。確認:
openclaw gateway statusが稼働中で RPC probe OK。- loopback 18789 が onboard 記事の SSH トンネル手順と一致。
- mini から
api.telegram.orgと WhatsApp Web へ HTTPS 到達——ホストでcurl -I、ノート PC だけで測らない。 - CMDB に Node 版を固定(多くは 22.14+、新ゲートウェイは 24.x)。
Telegram:bot token、webhook 削除、配対承認
@BotFather でボットを作り token をコピー。環境変数注入の競合で起動時に空になる場合、デバッグ中はチャネル設定に平文で書いてもよい。他ホストで webhook を使っていた token なら先に削除:
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 秒以内に QR スキャン。ログインが 408 なら mini のリージョン向けに到達可能な HTTPS_PROXY を設定。セキュリティ承認時のみ NO_PROXY 例外。
リンク後は DM カナリア、requireMention 有効な群でボットを @。断続的切断ループなら openclaw gateway restart、probe がまだ失敗なら再スキャン。
9 ステップ:ゼロから検証可能な返信まで
- 20 分の変更ウィンドウを確保し、HK/JP/KR/SG/US をカバーするチャネルで告知。
- status + curl 手順でゲートウェイ検証——UI の感覚だけに頼らない。
- Telegram token を書き込み;再起動前に
openclaw doctor。 - 他ホストから移行するなら古い Telegram webhook を削除。
- launchd kickstart または承認済みリロードでゲートウェイ再起動。
channels status --probeを実行し JSON をチケットに保存。- 初回 DM 送信者の配対を承認;監査用に方針画面をキャプチャ。
- WhatsApp QR をリンク;CMDB にセッションパスとリース ID。
- 群と DM のカナリア;成功宣言の前に 10 分ログを tail。
probe 切り分け表:状態は正常だがユーザーに返信が届かない
| 症状 | probe / ログ | 想定原因 | 最初の対処 |
|---|---|---|---|
openclaw status にチャネル行なし |
telegram/whatsapp 行なし | プラグインまたは設定未読込 | openclaw config unset plugins 後再起動 |
| Telegram 起動時 401 | getMe returned 401 |
不正 token または環境競合 | 平文 token;BotFather で再生成 |
| DM が無視される | 配対リストが 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) | ASEAN ハブグループ | RTT は低いが出口許可リストが厳しい |
| 米国 (US) | 米州顧客 | ユーザーが APAC にいると太平洋横断が長い |
チャネルがプロキシ依存なら、リース記録に HTTPS_PROXY、HTTP_PROXY、NO_PROXY を明記。
FAQ:チャネルと webhook、複数ゲートウェイ、セキュリティ
チャネルは webhook と同じ?関連するが別物——チャネルは Messenger 輸送を維持;HTTP webhook は別入口。併用可;切り分け中に意図せず一方だけ止めない。
1 台の mini で 2 ゲートウェイ?ポート 18789 の衝突を避ける。2 リースまたは別 loopback ポートと明示的 SSH マップが無難。
設定に botToken を書くのは安全?mini を機密ホスト扱い:SSH 制限、オフボーディングで token ローテーション;環境競合解消後はボルト注入へ。
VNC は役立つ?QR スキャン UX に有効;配対は CLI/UI コマンドで行う。
常時稼働メッセージゲートウェイに MacLogin の Mac mini M4 が向く理由
チャネルには安定した Node プロセス、永続セッション、出站 HTTPS が必要——スリープするノート PC ではない。Apple Silicon M4 はポーリング負荷でも熱が安定し、MacLogin の HK/JP/KR/SG/US でユーザーと API の間に置ける。レンタルなら「チャネル専用」mini を切り出し、WhatsApp セッションを開発者の日常機から分離できる。
コア数とリージョンは 料金ページ で比較。Messenger をリンクするときは ヘルプ の SSH/VNC 手順を手元に。
OpenClaw チャネルをユーザーのそばに
HK/JP/KR/SG/US で Apple Silicon をレンタルし、onboard 後に probe で Telegram と WhatsApp を検証。