Skip to main content
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