Skip to main content

​
Gateway Issues

Symptom: argent gateway start exits immediately or shows an error.Check:
Common causes:
  • Port 18789 is already in use: lsof -i :18789
  • Node.js version mismatch: verify node --version shows v22+
  • Config syntax error: argent config validate
Symptom: argent gateway status shows “running” but “RPC probe: failed”.Common cause: Native module ABI mismatch. The gateway is using a different Node.js version than the one used to compile native modules.Fix:
Symptom: Error log shows NODE_MODULE_VERSION mismatch.Fix: Rebuild native modules against the correct Node.js version:

​
Channel Issues

WhatsApp Web sessions expire. Re-scan the QR code:
Enable Privileged Gateway Intents in the Discord Developer Portal under your application’s Bot settings. See Discord setup.

​
Memory Issues

  • Check that memories exist: argent memory stats
  • Use simpler queries: single keywords work best with FTS5
  • Try OR syntax for multi-word queries: "telegram OR discord"
  • Verify the database is accessible: ls -la ~/.argentos/memory.db
Another process may be holding a lock:

​
Model/API Issues

The failover system should handle this automatically. Check profile status:
If all profiles are in cooldown, wait for the cooldown to expire or add more auth profiles.
The conversation has grown too large. This triggers automatic compaction, but if it persists:

​
Performance Issues

Check for zombie processes:
The health check reaper should clean these up every 60 seconds. If they persist, restart the gateway.
  • Check model tier: LOCAL tier is fastest, POWERFUL is slowest
  • Check for API latency in gateway logs
  • Verify network connectivity to API providers

​
Getting More Help

If these steps do not resolve your issue:
1

Collect diagnostics

2

Gather logs

3

Open an issue

File a report on GitHub.