# Send Voice.Ai Voice Agents to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-voiceai-voice-agent",
    "name": "Voice.Ai Voice Agents",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/gizmoGremlin/openclaw-voiceai-voice-agent",
    "canonicalUrl": "https://clawhub.ai/gizmoGremlin/openclaw-voiceai-voice-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/openclaw-voiceai-voice-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-voiceai-voice-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/agent.js",
      "voice-ai-agents-sdk.js",
      "voice-ai-agents.yaml"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-voiceai-voice-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-voiceai-voice-agent",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent.md"
  }
}
```
## Documentation

### 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

### Get Your API Key

Go to Voice.ai Developer Dashboard
Sign in or create an account
Generate a new API key
Copy and save it securely

### Set Up Authentication (3 Methods)

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"
    }
  }
}

### 🔐 Before Any Operation

Important: Always verify authentication before running any commands.

# 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

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

ParameterDefaultDescriptionllm_modelgemini-2.5-flash-liteLLM model for responsesllm_temperature0.7Response creativity (0-2)max_call_duration900Max call length in secondsallow_interruptionstrueLet users interrupt agentauto_noise_reductiontrueFilter background noise

### 🎙️ TTS Voice Settings

ParameterDefaultDescriptionvoice_id-Voice ID for agent speechmodelautoTTS model (auto-selected)languageenLanguage codetemperature1.0Voice expressiveness (0-2)top_p0.8Sampling parameter (0-1)

### 🌍 Supported Languages

auto, en, ca, sv, es, fr, de, it, pt, pl, ru, nl

### 💻 CLI Usage

# 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>

### JSON Configuration

{
  "name": "voice.ai-voice-agents",
  "enabled": true,
  "config": {
    "api_key": "${VOICE_AI_API_KEY}",
    "default_model": "gemini-2.5-flash-lite",
    "auto_deploy": false
  }
}

### Chat Triggers

OpenClaw automatically activates this skill when you mention:

"voice agent", "voice bot", "phone agent"
"create agent", "deploy agent", "list agents"
"Voice.ai", "voice ai"

### 🗣️ User-Friendly Language

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

### 📁 Project Files

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

FilePurposeSKILL.mdDocumentation and OpenClaw skill definitionvoice-ai-agents.yamlAPI config, models, defaultsvoice-ai-agents-sdk.jsFull SDK with all API methodsscripts/agent.jsCommand-line interface

### ❌ Error Handling

ErrorCauseSolution401 UnauthorizedInvalid or missing API keyCheck VOICE_AI_API_KEY is set correctly403 ForbiddenAPI key lacks permissionsGenerate new key with proper scopes404 Not FoundAgent ID doesn't existRun list to get valid agent IDs429 Too Many RequestsRate limit exceededWait 60 seconds and retry500 Server ErrorVoice.ai API issueCheck status pageENOTFOUNDNetwork errorCheck internet connectionAgent not deployedAgent exists but not activeRun deploy --id <agent_id>

### Graceful Error Messages

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.

### 📝 Triggers

These phrases activate the Voice.ai Agents skill in OpenClaw:

CategoryTrigger PhrasesCreate"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"

### 🔗 MCP Server Integration

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"
    }]
  }
});

### 📚 Knowledge Base (RAG)

Add custom knowledge to your agent:

# Create agent with knowledge base
node scripts/agent.js create --name "FAQ Bot" --kb-id 123

### 🔗 Links

Get API Key ← Start here!
Voice Agents Guide
Agent API Reference
Status Page

### 📋 Changelog

VersionDateChanges1.0.02026-01-31Initial release with full agent management

Made with ❤️ by Nick Gill
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: gizmoGremlin
- Version: 0.1.4
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-voiceai-voice-agent)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-voiceai-voice-agent/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-voiceai-voice-agent)