Skip to main content

​
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 status

​
Architecture

The gateway listens on a WebSocket port (default: 18789) and accepts connections from the dashboard and internal components.

​
Service Management

argent gateway install    # Install LaunchAgent
argent gateway uninstall  # Remove LaunchAgent
argent gateway restart    # Restart the service
The LaunchAgent plist is written to:
~/Library/LaunchAgents/ai.argent.gateway.plist

​
Ports

PortServiceDescription
18789GatewayWebSocket control plane
3141DashboardWeb UI and API server

​
Verifying the Gateway

argent gateway status
A healthy gateway shows:
  • Status: running
  • RPC probe: ok
  • Listening: *:18789
If the RPC probe fails, check the troubleshooting guide.