# NousResearch/hermes-agent · QQBot gateway reconnect and session timeout issues

## Open now

- 2 issues, 0 PRs open on GitHub.
- #11489: QQ Bot WebSocket session timeout and gateway URL fetch failure
- #11493: QQ Bot WebSocket session timeout and failure to fetch gateway URL

These items concern bugs and fixes related to QQBot WebSocket gateway reconnection logic, session timeouts (opcode 4009), and gateway URL fetch failures with cache fallback. Multiple fixes address reconnect contract enforcement and related edge cases across the adapter.

## TL;DR

- 6 member(s): 2 open issue(s), 1 closed issue(s), 0 open PR(s), 0 merged PR(s), 3 PR(s) closed without merging.
- No fix has been merged to main; one or more PRs were attempted (see below).
- **Recommended:** review the prior/competing PR(s) below. A fix was attempted but not merged; your case may extend or revive that work.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `unresolved`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_PARTIAL`): some members are connected by structural evidence (shared changed files, or a closing/superseded reference); the rest are joined by an automated relevance judgement over their text.
- Members outside that structural core may belong to a different underlying problem.
- Pairwise link density `0.31`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Open related issues

- #11489: QQ Bot WebSocket session timeout and gateway URL fetch failure
- #11493: QQ Bot WebSocket session timeout and failure to fetch gateway URL

## Closed / duplicate issues

- #24357: \[Bug\]: QQBot gateway can stop heartbeating after reconnect and loop on 4009 Session timed out

## Prior & competing PRs

- **#17256: fix(qqbot): retry gateway URL fetch with cache fallback**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#17240`, `#17256`, `#17240`, `#17240`
- **#25702: fix(qqbot): handle gateway reconnect opcodes**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `a54f5afc7086ffe14bc5a46d1e56e835c61092e4`
- **#83697: fix(qqbot): retry gateway URL fetch with cache fallback**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`

## Fix status

- No merged fix on record.
- Subsystem: `gateway`