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 DM は無音、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 グループの @、エンジニアは同じ Mac mini に SSH。失敗は目立ちにくい——設定にチャネルはあるのに返信がない。配対キュー、メンション規則、古い webhook が配送を止めていることが多いです。

  • 配対の滞留:初回 DM は 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 DM dmPolicy + 配対 配対必須;送信者ごとに承認 テストチャットのみ許可リスト Token は有効だが配対未承認
Telegram グループ プライバシー / メンション ボットを @ 必須 ラボでは BotFather でプライバシー解除可 @ なしで返信を期待
WhatsApp DM セッション + allowFrom 明示的許可リスト パイロットは単一運用番号のみ リース移管後に QR 期限切れ
WhatsApp グループ requireMention メンション必須 デモでは一時的に OFF 可 OFF 後に高トラフィック群が溢れる
記録すべき数値:ゲートウェイ loopback 18789、Telegram API タイムアウト再試行 3 回、WhatsApp QR スキャン 60 秒、切替中の probe 間隔 30 秒。

前提:チャネル 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 はゲートウェイに紐づく Web セッション。SSH トンネルまたは VNC ガイド で Control UI を開き、60 秒以内に QR スキャン。ログインが 408 なら mini のリージョン向けに到達可能な HTTPS_PROXY を設定。セキュリティ承認時のみ NO_PROXY 例外。

リンク後は DM カナリア、requireMention 有効な群でボットを @。断続的切断ループなら openclaw gateway restart、probe がまだ失敗なら再スキャン。

9 ステップ:ゼロから検証可能な返信まで

  1. 20 分の変更ウィンドウを確保し、HK/JP/KR/SG/US をカバーするチャネルで告知。
  2. status + curl 手順でゲートウェイ検証——UI の感覚だけに頼らない。
  3. Telegram token を書き込み;再起動前に openclaw doctor
  4. 他ホストから移行するなら古い Telegram webhook を削除。
  5. launchd kickstart または承認済みリロードでゲートウェイ再起動。
  6. channels status --probe を実行し JSON をチケットに保存。
  7. 初回 DM 送信者の配対を承認;監査用に方針画面をキャプチャ。
  8. WhatsApp QR をリンク;CMDB にセッションパスとリース ID。
  9. 群と 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_PROXYHTTP_PROXYNO_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 を検証。