Skip to main content
The Agentic AI CLI provides a comprehensive set of commands for managing AI-powered phone call agents, webhook servers, scheduling, and OpenClaw Gateway integration.

​
Installation

The CLI is automatically available after installing Agentic AI: 
pip install -e .
Verify the installation: 
agenticai --help

​
Command Structure

The CLI follows a grouped command structure: 
agenticai [GLOBAL_OPTIONS] COMMAND [COMMAND_OPTIONS]

​
Global Options

​
--config
string
default:"config.yaml"
Path to the configuration fileShort form: -cExample:
agenticai --config /path/to/config.yaml status

​
Command Categories

​
Server Management

  • server - Start the webhook server
  • daemon - Run server with scheduler (daemon mode)

​
Phone Calls

  • trigger - Quick trigger a phone call
  • call - Initiate an outbound phone call (direct)

​
Scheduling

  • schedule list - List all configured schedules
  • schedule run - Run a schedule immediately

​
Service Management

  • service install - Install as background service
  • service start - Start the service
  • service stop - Stop the service
  • service restart - Restart the service
  • service status - Check service status
  • service logs - View service logs
  • service uninstall - Uninstall the service

​
Tunnel Management

  • tunnel start - Start a tunnel (ngrok/cloudflare)
  • tunnel info - Show tunnel setup information

​
System

  • status - Show system status
  • test-connection - Test connections to Twilio, Gemini, and Gateway
  • bot - Connect to OpenClaw Gateway (interactive terminal)
  • setup - Interactive setup wizard

​
Common Workflows

​
First-Time Setup

# 1. Run the setup wizard
agenticai setup

# 2. Start a tunnel
agenticai tunnel start

# 3. Install as a service
agenticai service install --webhook-url https://your-url.ngrok.io

# 4. Start the service
agenticai service start

# 5. Test the connection
agenticai test-connection

​
Making Calls

# Quick call using running server
agenticai trigger --to +15551234567

# Call with custom prompt
agenticai trigger -t +15551234567 -p "Ask about their appointment"

# Direct call (starts temporary server)
agenticai call --to +15551234567 \
  --prompt "You are a helpful assistant" \
  --webhook-url https://your-url.ngrok.io

​
Development Mode

# Terminal 1: Start the server
agenticai server

# Terminal 2: Start ngrok
agenticai tunnel start

# Terminal 3: Trigger calls
export NGROK_URL=https://your-url.ngrok.io
agenticai trigger --to +15551234567

​
Production Mode

# Install service with permanent tunnel URL
agenticai service install --webhook-url https://permanent-tunnel.com

# Service auto-starts on boot, no manual intervention needed
agenticai service status

# View live logs
agenticai service logs -f

​
Using Schedules

# List configured schedules
agenticai schedule list

# Run a schedule immediately (for testing)
agenticai schedule run "morning-reminders" --webhook-url https://your-url.ngrok.io

# Schedules run automatically in daemon mode
agenticai daemon --webhook-url https://your-url.ngrok.io

​
OpenClaw Integration

# Connect to OpenClaw Gateway (interactive terminal)
agenticai bot

# Connect to custom gateway
agenticai bot --gateway-url ws://localhost:18789

​
Configuration File

Most commands load configuration from config.yaml (or the path specified via --config): 
twilio:
  account_sid: ${TWILIO_ACCOUNT_SID}
  auth_token: ${TWILIO_AUTH_TOKEN}
  from_number: ${TWILIO_PHONE_NUMBER}

gemini:
  api_key: ${GEMINI_API_KEY}
  model: "models/gemini-2.5-flash-native-audio-latest"

gateway:
  url: "ws://127.0.0.1:18789"

server:
  host: "0.0.0.0"
  port: 8080
Environment variables are loaded from .env file.

​
Exit Codes

  • 0 - Success
  • 1 - Configuration error or operation failed
Interactive commands (like bot or tunnel start) exit with 0 on normal termination (Ctrl+C).

​
Getting Help

View help for any command: 
agenticai --help
agenticai server --help
agenticai service --help
agenticai schedule --help

​
Next Steps

Build docs developers (and LLMs) love

Get started for freeTalk to us