Create, manage, and deploy Voice.ai conversational AI agents. Use when the user wants to work with voice agents, list their agents, create new ones, or manage agent configurations.
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Build the best conversational AI voice agents with Voice.ai's Agent API.
Method 1: Environment Variable (Recommended)
export VOICE_AI_API_KEY="your-api-key-here"
Method 2: .env File
# Create .env file in project root echo 'VOICE_AI_API_KEY=your-api-key-here' >> .env
Method 3: OpenClaw Config
{ "skills": { "voice.ai-voice-agents": { "api_key": "your-api-key-here" } } }
Important: Always verify authentication before running any commands.
# 1. Check if API key is set echo $VOICE_AI_API_KEY2. 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"
The SDK automatically initializes when you run any command. No manual setup required after setting the API key.
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>
| Parameter | Default | Description |
|---|---|---|
| llm_model | gemini-2.5-flash-lite | LLM model for responses |
| llm_temperature | 0.7 | Response creativity (0-2) |
| max_call_duration | 900 | Max call length in seconds |
| allow_interruptions | true | Let users interrupt agent |
| auto_noise_reduction | true | Filter background noise |
| Parameter | Default | Description |
|---|---|---|
| voice_id | - | Voice ID for agent speech |
| model | auto | TTS model (auto-selected) |
| language | en | Language code |
| temperature | 1.0 | Voice expressiveness (0-2) |
| top_p | 0.8 | Sampling parameter (0-1) |
autoencasvesfrdeitptplrunl# Create a new agent node scripts/agent.js create --name "My Agent" --prompt "System prompt here" --greeting "Hello!"List all agents
node scripts/agent.js list
Get agent details
node scripts/agent.js get --id <agent_id>
Update an agent
node scripts/agent.js update --id <agent_id> --prompt "New prompt"
Deploy an agent
node scripts/agent.js deploy --id <agent_id>
Pause an agent
node scripts/agent.js pause --id <agent_id>
Delete an agent
node scripts/agent.js delete --id <agent_id>
{ "name": "voice.ai-voice-agents", "enabled": true, "config": { "api_key": "${VOICE_AI_API_KEY}", "default_model": "gemini-2.5-flash-lite", "auto_deploy": false } }
OpenClaw automatically activates this skill when you mention:
| When User Says... | Skill Does... |
|---|---|
| "Create a support agent" | Creates agent with support-focused prompt |
| "Show my agents" | Lists all agents with status |
| "Deploy the agent" | Deploys agent for phone calls |
| "Update the greeting" | Updates agent greeting message |
| "Delete the test agent" | Deletes specified agent |
| "What agents do I have?" | Lists agents in friendly format |
| "Make an FAQ bot" | Creates agent with FAQ template |
| "Connect to my MCP server" | Configures MCP integration |
voice-ai-agents/ ├── SKILL.md # This documentation ├── voice-ai-agents.yaml # Skill configuration ├── voice-ai-agents-sdk.js # JavaScript SDK └── scripts/ └── agent.js # CLI tool
| File | Purpose |
|---|---|
| Documentation and OpenClaw skill definition |
| API config, models, defaults |
| Full SDK with all API methods |
| Command-line interface |
| Error | Cause | Solution |
|---|---|---|
| Invalid or missing API key | Check |
| API key lacks permissions | Generate new key with proper scopes |
| Agent ID doesn't exist | Run |
| Rate limit exceeded | Wait 60 seconds and retry |
| Voice.ai API issue | Check status page |
| Network error | Check internet connection |
| Agent exists but not active | Run |
The SDK provides user-friendly error messages:
❌ Authentication failed. Please check your API key. Get one at: https://voice.ai/app/dashboard/developers❌ Agent "support-bot" not found. Run 'node scripts/agent.js list' to see available agents.
❌ Rate limit reached. Please wait 60 seconds before retrying.
These phrases activate the Voice.ai Agents skill in OpenClaw:
| Category | Trigger Phrases |
|---|---|
| Create | "create voice agent", "make a phone bot", "new agent" |
| List | "show agents", "list my agents", "what agents exist" |
| Deploy | "deploy agent", "activate agent", "start the bot" |
| Update | "update agent", "change prompt", "edit greeting" |
| Delete | "delete agent", "remove bot", "destroy agent" |
| Info | "agent details", "show agent", "get agent info" |
Connect your agent to external tools:
const agent = await client.createAgent({ name: "MCP Agent", config: { prompt: "You can use tools to help users", mcp_servers: [{ name: "my-tools", url: "https://my-server.com/mcp", auth_type: "bearer_token", auth_token: "secret" }] } });
Add custom knowledge to your agent:
# Create agent with knowledge base node scripts/agent.js create --name "FAQ Bot" --kb-id 123
| Version | Date | Changes |
|---|---|---|
| 1.0.0 | 2026-01-31 | Initial release with full agent management |
Made with ❤️ by Nick Gill
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.