# NousResearch/hermes-agent · WhatsApp bridge stability, config, and port issues

## Open now

- 5 issues, 4 PRs open on GitHub.
- #5965: WhatsApp bridge_port from config.yaml silently ignored — yaml_cfg not in scope in _apply_env_overrides()
- #16521: \[Bug\]: bridge_port config not loaded into config.extra — WhatsApp bridge always uses default port 3000
- #24122: WhatsApp bridge hardcodes port 3000, conflicts with local dev servers
- #26997: \[Bug\]: WhatsApp bridge dies immediately with code -9 under systemd
- #58936: WhatsApp bridge (Baileys) crashes silently, loses creds.json, requires full re-pairing
- PR #6024: fix(gateway): bridge_port, bridge_script, session_path from config.yaml
- PR #24320: fix(whatsapp): move bridge default port off 3000
- PR #29742: fix: move WhatsApp bridge default port off 3000
- PR #43795: feat(gateway): configurable bridge port for WhatsApp

These items concern crashes, crash-loop behavior, credential loss, and silent config failures in the WhatsApp Baileys bridge, alongside a recurring theme of the bridge hardcoding port 3000 and ignoring configurable port settings from config.yaml.

## TL;DR

- 15 member(s): 5 open issue(s), 4 closed issue(s), 4 open PR(s), 0 merged PR(s), 2 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.09`: 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

- #5965: WhatsApp bridge_port from config.yaml silently ignored — yaml_cfg not in scope in _apply_env_overrides()
- #16521: \[Bug\]: bridge_port config not loaded into config.extra — WhatsApp bridge always uses default port 3000
- #24122: WhatsApp bridge hardcodes port 3000, conflicts with local dev servers
- #26997: \[Bug\]: WhatsApp bridge dies immediately with code -9 under systemd
- #58936: WhatsApp bridge (Baileys) crashes silently, loses creds.json, requires full re-pairing

## Closed / duplicate issues

- #23322: \[Feature\]: Support setting WhatsApp \`bridge_port\` configuration
- #33365: WhatsApp gateway crashes (exit 1) on first poll after using existing bridge
- #43554: \[Feature\]: Configurable port for gateway WhatsApp
- #52702: \[Bug\]: WhatsApp Baileys bridge crash-loop persists in v0.17.0 — kills Telegram as collateral

## Prior & competing PRs

- **#6024: fix(gateway): bridge_port, bridge_script, session_path from config.yaml**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#6024`, `#5965`, `#16584`, `#26598`, `#37077`, `#6024`, `#5965`, `#16521`, `#24122`, `#6024`
  - files: `gateway/config.py`
- **#24320: fix(whatsapp): move bridge default port off 3000**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `gateway/platforms/whatsapp.py`, `scripts/whatsapp-bridge/bridge.js`, `tests/gateway/test_whatsapp_reply_prefix.py`
- **#29742: fix: move WhatsApp bridge default port off 3000**. open
  - maintainer direction: category `duplicate_of`; implication `duplicate`; refs `#24320`, `#24122`
  - files: `gateway/platforms/whatsapp.py`, `scripts/whatsapp-bridge/bridge.js`, `tests/gateway/test_whatsapp_connect.py`, `tests/tools/test_send_message_tool.py`, `tools/send_message_tool.py`
- **#37327: fix(whatsapp): retry external-bridge probe and skip port-kill on timeout (#33365)**. closed without merge
  - maintainer direction: category `volume_quota`; implication `active`
- **#43795: feat(gateway): configurable bridge port for WhatsApp**. open
  - maintainer direction: category `uncategorized`; implication `needs_llm`
  - files: `gateway/config.py`, `tests/gateway/test_config.py`
- **#58959: fix(whatsapp): crash resilience for Baileys bridge — uncaught exception logging, creds.json backup/restore, crash-loop detection (#58936)**. closed without merge
  - maintainer direction: category `silent_close`; implication `active`

## Fix status

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