From ae30368d1244385faa96b8bcaf1d2e6650fa2bf1 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Mon, 27 Apr 2026 10:32:57 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@f50fb735604e7eb3b291c5f140d9aa4953493cd9 --- .openclaw-sync/source.json | 4 ++-- docs/channels/troubleshooting.md | 11 ++++++----- docs/channels/whatsapp.md | 7 +++++++ 3 files changed, 15 insertions(+), 7 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 9a1756366..c005457b3 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "f0b327cf686e3a957fef8c94985ee6509953a3b7", - "syncedAt": "2026-04-27T10:28:36.945Z" + "sha": "f50fb735604e7eb3b291c5f140d9aa4953493cd9", + "syncedAt": "2026-04-27T10:31:34.098Z" } diff --git a/docs/channels/troubleshooting.md b/docs/channels/troubleshooting.md index 653cfc81c..fffe943c4 100644 --- a/docs/channels/troubleshooting.md +++ b/docs/channels/troubleshooting.md @@ -31,11 +31,12 @@ Healthy baseline: ### WhatsApp failure signatures -| Symptom | Fastest check | Fix | -| ------------------------------- | --------------------------------------------------- | ------------------------------------------------------- | -| Connected but no DM replies | `openclaw pairing list whatsapp` | Approve sender or switch DM policy/allowlist. | -| Group messages ignored | Check `requireMention` + mention patterns in config | Mention the bot or relax mention policy for that group. | -| Random disconnect/relogin loops | `openclaw channels status --probe` + logs | Re-login and verify credentials directory is healthy. | +| Symptom | Fastest check | Fix | +| ------------------------------- | --------------------------------------------------- | -------------------------------------------------------- | +| Connected but no DM replies | `openclaw pairing list whatsapp` | Approve sender or switch DM policy/allowlist. | +| Group messages ignored | Check `requireMention` + mention patterns in config | Mention the bot or relax mention policy for that group. | +| QR login times out with 408 | Check gateway `HTTPS_PROXY` / `HTTP_PROXY` env | Set a reachable proxy; use `NO_PROXY` only for bypasses. | +| Random disconnect/relogin loops | `openclaw channels status --probe` + logs | Re-login and verify credentials directory is healthy. | Full troubleshooting: [WhatsApp troubleshooting](/channels/whatsapp#troubleshooting) diff --git a/docs/channels/whatsapp.md b/docs/channels/whatsapp.md index ae3bfe97d..7cc59d248 100644 --- a/docs/channels/whatsapp.md +++ b/docs/channels/whatsapp.md @@ -526,6 +526,13 @@ Behavior notes: + + Symptom: `openclaw channels login --channel whatsapp` fails before showing a usable QR code with `status=408 Request Time-out` or a TLS socket disconnect. + + WhatsApp Web login uses the gateway host's standard proxy environment (`HTTPS_PROXY`, `HTTP_PROXY`, lowercase variants, and `NO_PROXY`). Verify the gateway process inherits the proxy env and that `NO_PROXY` does not match `mmg.whatsapp.net`. + + + Outbound sends fail fast when no active gateway listener exists for the target account.