voice.ai-voice-agents

# Voice.ai Agents

Build the best conversational AI voice agents with Voice.ai's Agent API.

## ✨ Features

- **Agent Management** - Create, update, and delete voice agents
- **One-Click Deploy** - Deploy agents for phone calls instantly
- **Knowledge Base** - RAG-powered agents with custom knowledge
- **MCP Integration** - Connect agents to external tools via MCP
- **Phone Numbers** - Manage inbound/outbound phone numbers
- **Analytics** - Track call history and agent performance

## ⚙️ Configuration

### Get Your API Key

1. Go to [Voice.ai Developer Dashboard](https://voice.ai/app/dashboard/developers)
2. Sign in or create an account
3. Generate a new API key
4. Copy and save it securely

### Set Up Authentication (3 Methods)

**Method 1: Environment Variable (Recommended)**
```bash
export VOICE_AI_API_KEY="your-api-key-here"
```

**Method 2: .env File**
```bash
# Create .env file in project root
echo 'VOICE_AI_API_KEY=your-api-key-here' >> .env
```

**Method 3: OpenClaw Config**
```json
{
  "skills": {
    "voice.ai-voice-agents": {
      "api_key": "your-api-key-here"
    }
  }
}
```

## 🔐 Before Any Operation

> **Important:** Always verify authentication before running any commands.

```bash
# 1. Check if API key is set
echo $VOICE_AI_API_KEY

# 2. Test connection (list agents)
node scripts/agent.js list

# 3. If errors, re-export your key
export VOICE_AI_API_KEY="your-api-key-here"
```

### Silent Initialization
The SDK automatically initializes when you run any command. No manual setup required after setting the API key.

## 🚀 Quick Start

```bash
export VOICE_AI_API_KEY="your-api-key"

# Create an agent
node scripts/agent.js create --name "Support Bot" --prompt "You are a helpful assistant"

# List all agents
node scripts/agent.js list

# Deploy an agent
node scripts/agent.js deploy --id <agent_id>
```

## 🤖 Agent Configuration

| Parameter              | Default | Description                          |
|------------------------|---------|-------------...