openclaw - 💡(How to fix) Fix Gateway hangs on shutdown when Telegram API is unreachable [2 comments, 3 participants]

[telegram] fetch fallback: enabling sticky IPv4-only dispatcher (codes=UND_ERR_CONNECT_TIMEOUT)
[telegram] fetch fallback: enabling sticky IPv4-only dispatcher (codes=UND_ERR_CONNECT_TIMEOUT)
... (dozens of these)
[gateway] shutdown timed out; exiting without full cleanup

---

[2026-04-03 13:14:44] Restarting gateway — health endpoint failed or timed out
[2026-04-03 13:15:05] Gateway STILL DOWN after restart
[2026-04-03 13:17:12] Restarting gateway — port 18789 not listening
[2026-04-03 13:18:17] Gateway STILL DOWN after restart
... (repeats for 25+ minutes)

---

// channel-manager — no timeout, hangs when API is down
if (plugin?.gateway?.stopAccount) {
  await plugin.gateway.stopAccount({ ... });
}

---

// server close handler — sequential, one slow channel blocks all
for (const plugin of listChannelPlugins())
  await params.stopChannel(plugin.id);

---

const STOP_ACCOUNT_TIMEOUT_MS = 10_000;

if (plugin?.gateway?.stopAccount) {
  await Promise.race([
    plugin.gateway.stopAccount({
      cfg, accountId: id, account,
      runtime: channelRuntimeEnvs[channelId],
      abortSignal: abort?.signal ?? new AbortController().signal,
      log: channelLogs[channelId],
      getStatus: () => getRuntime(channelId, id),
      setStatus: (next) => setRuntime(channelId, id, next),
    }),
    new Promise<void>((_, reject) =>
      setTimeout(() => reject(new Error(
        `stopAccount timed out for ${channelId}/${id} after ${STOP_ACCOUNT_TIMEOUT_MS}ms`
      )), STOP_ACCOUNT_TIMEOUT_MS)
    ),
  ]).catch((err) => {
    channelLogs[channelId]?.warn?.(
      `[${channelId}] stopAccount failed: ${err.message}; continuing shutdown`
    );
  });
}

---

const CHANNEL_SHUTDOWN_TIMEOUT_MS = 15_000;

await Promise.race([
  Promise.allSettled(
    listChannelPlugins().map((plugin) => params.stopChannel(plugin.id))
  ),
  new Promise<void>((resolve) =>
    setTimeout(() => {
      gatewayLog.warn('channel shutdown timed out; continuing');
      resolve();
    }, CHANNEL_SHUTDOWN_TIMEOUT_MS)
  ),
]);

---

{
  "gateway": {
    "shutdown": {
      "timeoutMs": 25000,
      "channelTimeoutMs": 10000
    }
  }
}