Gateway Overview
The always-on WebSocket control plane that manages agents, channels, and sessions.
Overview
The gateway is the central nerve system of ArgentOS. It is an always-on process that:
- Manages channels: Connects to Telegram, Discord, WhatsApp, and other platforms
- Routes messages: Directs incoming messages to the correct agent and session
- Streams responses: Delivers agent responses back to channels and the dashboard
- Runs health checks: Monitors system health and cleans up zombie processes
- Triggers heartbeats: Periodically wakes the agent for autonomous task work
Starting the Gateway
# Start in the foreground (for debugging)
argent gateway start
# Install as a system service (launchd on macOS, systemd on Linux)
argent gateway install
# Check status
argent gateway statusArchitecture
┌───────────────────────┐
│ Gateway │
│ (WebSocket Server) │
│ │
Telegram ────────>│ │──────> Agent Runtime
Discord ─────────>│ Message Router │ │
WhatsApp ────────>│ │ ├── Claude API
Slack ───────────>│ Session Manager │ ├── Tools
Signal ──────────>│ │ └── MemU
Dashboard ───────>│ Health Checks │
│ │
└───────────────────────┘The gateway listens on a WebSocket port (default: 18789) and accepts connections from the dashboard and internal components.
Service Management
macOS (launchd)
argent gateway install # Install LaunchAgent
argent gateway uninstall # Remove LaunchAgent
argent gateway restart # Restart the serviceThe LaunchAgent plist is written to:
~/Library/LaunchAgents/ai.argent.gateway.plistLinux (systemd)
argent gateway install # Install systemd service
sudo systemctl status argent-gatewayPorts
| Port | Service | Description |
|---|---|---|
| 18789 | Gateway | WebSocket control plane |
| 3141 | Dashboard | Web UI and API server |
Verifying the Gateway
argent gateway statusA healthy gateway shows:
- Status: running
- RPC probe: ok
- Listening: *:18789
If the RPC probe fails, check the troubleshooting guide.