Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/IstiqlalBhat/aiagent/llms.txt

Use this file to discover all available pages before exploring further.

Launch an interactive wizard that guides you through setting up all required credentials and configuration for Agentic AI. This is the fastest way to get started.

​
Usage

agenticai setup
No options required - the wizard will prompt you for everything.

​
What It Configures

The setup wizard helps you configure:
1

Twilio Credentials

  • Account SID
  • Auth Token
  • Phone Number (E.164 format)
Where to get: console.twilio.com
2

Google Gemini API

  • Gemini API Key for intent analysis
Where to get: aistudio.google.com/apikey
3

OpenClaw Gateway

  • Gateway WebSocket URL for ClawdBot integration
Default: ws://127.0.0.1:18789
4

Server Settings

  • Server host (default: 0.0.0.0)
  • Server port (default: 8080)
5

Ngrok URL (Optional)

  • Public tunnel URL for webhooks
Can be added later after starting tunnel

​
Interactive Flow

$ agenticai setup

┌─────────────────────────────────────────────────────┐
│         🔧 Agentic AI Setup Wizard                  │
│                                                      │
│ This wizard will help you configure:                │
│   • Twilio credentials                              │
│   • Gemini API key                                  │
│   • Gateway settings                                │
│   • Server configuration                            │
└─────────────────────────────────────────────────────┘

Step 1: Twilio Configuration
Get these from https://console.twilio.com/

  Twilio Account SID [ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx]: AC1234...
  Twilio Auth Token: ********
  Your Twilio Phone Number (E.164 format) [+1XXXXXXXXXX]: +15551234567

Step 2: Google Gemini Configuration
Get your API key from https://aistudio.google.com/apikey

  Gemini API Key: ********

Step 3: Gateway Configuration
OpenClaw Gateway WebSocket URL

  Gateway URL [ws://127.0.0.1:18789]: 

Step 4: Server Configuration
Local server settings for Twilio webhooks

  Server Host [0.0.0.0]: 
  Server Port [8080]: 

Step 5: ngrok Configuration (Optional)
Public URL for Twilio webhooks

  ngrok URL (leave empty to skip): 

Writing .env file...

✓ Updated config.yaml with phone number

┌─────────────────────────────────────────────────────┐
│              ✓ Setup Complete!                      │
│                                                      │
│ Next steps:                                         │
│   1. Start ngrok: ngrok http 8080                   │
│   2. Update NGROK_URL in .env with your ngrok URL   │
│   3. Start the server: agenticai server             │
│   4. Make a call: agenticai trigger --to +15551...  │
│                                                      │
│ Or connect to ClawdBot: agenticai bot               │
└─────────────────────────────────────────────────────┘

​
What It Creates

​
.env File

The wizard creates a .env file in your current directory with all credentials: 
# Agentic AI Configuration
# Generated by setup wizard

TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=your_auth_token_here
TWILIO_PHONE_NUMBER=+15551234567
GEMINI_API_KEY=your_gemini_key_here
GATEWAY_URL=ws://127.0.0.1:18789
SERVER_HOST=0.0.0.0
SERVER_PORT=8080
NGROK_URL=https://abc123.ngrok.io

​
Updated config.yaml

The wizard also updates your config.yaml file:
  • Replaces the placeholder phone number with your actual Twilio number
  • Other settings remain unchanged

​
Behavior

​
Existing .env File

If .env already exists, the wizard asks: 
⚠ A .env file already exists. Overwrite? [y/n]:
  • y - Overwrites the file with new configuration
  • n - Cancels setup, leaving existing file unchanged

​
Validation

The wizard does NOT validate credentials. After setup: 
# Test your configuration
agenticai test-connection
This verifies that Twilio, Gemini, and Gateway are all reachable.

​
Examples

​
First-Time Setup

# Run the wizard
agenticai setup

# Start tunnel
agenticai tunnel start

# Copy the ngrok URL and add it to .env
echo "NGROK_URL=https://abc123.ngrok.io" >> .env

# Test connections
agenticai test-connection

# Start the server
agenticai server

​
Re-configure After API Key Rotation

# Run setup again to update credentials
agenticai setup

# Restart service to pick up new config
agenticai service restart

​
Security Notes

The .env file contains sensitive credentials. Never commit it to version control.
  • The wizard prompts use password=True for sensitive fields (auth tokens, API keys)
  • Input is hidden with ******** during entry
  • The generated .env file should be in .gitignore

​
Manual Configuration Alternative

If you prefer manual configuration:
  1. Copy the example file: 
    cp .env.example .env
  2. Edit with your credentials: 
    nano .env
  3. Verify configuration: 
    agenticai status
See Environment Variables for all available options.

​
Troubleshooting

Ensure Agentic AI is installed:
pip install -e .
agenticai --version
Phone numbers must be in E.164 format: +[country code][number]Examples:
  • US: +15551234567
  • UK: +447911123456
  • AU: +61412345678
Run connection test to verify:
agenticai test-connection
If it fails, double-check your credentials at:
Restart the server or service after changing .env:
agenticai service restart
# or
# Ctrl+C and restart: agenticai server

Build docs developers (and LLMs) love

Get started for freeTalk to us