Gateway Overview

​

Overview

• 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

​

Service Management

argent gateway install    # Install LaunchAgent
argent gateway uninstall  # Remove LaunchAgent
argent gateway restart    # Restart the service

~/Library/LaunchAgents/ai.argent.gateway.plist

argent gateway install    # Install systemd service
sudo systemctl status argent-gateway

​

Ports

​

Verifying the Gateway

argent gateway status

• Status: running
• RPC probe: ok
• Listening: *:18789