---

name: retellai-manager description: Manage and maintain Retell AI voice agents, phone numbers, and calls. Use for creating, updating, monitoring voice agents; importing phone numbers; troubleshooting issues; and maintaining the AI Voice Receptionist system.

Retell AI Manager

Overview

This skill provides tools to manage, maintain, and support Retell AI voice infrastructure for the NexVision AI Voice Receptionist system.

Quick Reference - NexVision AI Voice Receptionist

| Component | Value | |-----------|-------| | Phone Number | +1 (438) 256-1852 | | Agent ID | agent_8d781886289fdc010ed868a33c | | LLM ID | llm_f27da33ea4e9c72de73076ad91ba | | Webhook URL | https://voice.nexvision.cc/retell/webhook | | KB ID | knowledge_base_1485d11dd42d2558 | | Email | cathylui@nexvision.cc | | K8s Namespace | openclaw | | GitHub KB Repo | nexvisioncc/retellai-kb |

---

Part 1: Maintenance Operations

Daily Checks

1.1 Check System Health

# Check if pod is running
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml get pods -n openclaw -l app=ai-voice-receptionist

# Check logs for errors
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml logs -n openclaw -l app=ai-voice-receptionist --tail=50

# Test webhook endpoint
curl -s https://voice.nexvision.cc/health

1.2 Check Call History

curl -s "https://api.retellai.com/list-calls?limit=10" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0" \
  -H "Content-Type: application/json" | jq '.[] | {call_id, call_status, duration_ms, from_number}'

1.3 Check Agent Status

curl -s "https://api.retellai.com/get-agent/agent_8d781886289fdc010ed868a33c" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0" \
  -H "Content-Type: application/json" | jq '{agent_id, agent_name, is_published, language}'

Weekly Maintenance

2.1 Review Call Analytics

• Check call volume and duration trends
• Identify common issues or failed calls
• Review email delivery success rate

2.2 Update Knowledge Base (if needed)

cd /home/herbert/.openclaw/workspace/cathy/retellai-kb
# Edit sources/*.md files
git add .
git commit -m "Update KB content"
git push  # Auto-syncs to Retell

2.3 Backup Configuration

• Export agent configuration
• Backup KB content from GitHub
• Document any prompt changes

---

Part 2: Troubleshooting Guide

Issue: Call Shows "Application Error"

Symptoms: Caller hears "An application error has occurred"

Diagnosis Steps:

1. Check Twilio webhook configuration
2. Verify SIP trunk settings
3. Check k8s pod logs

Solution:

# Check if webhook is set correctly in Twilio
# Should be: https://voice.nexvision.cc/twilio/incoming

# Check k8s logs
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml logs -n openclaw -l app=ai-voice-receptionist --tail=100

# Restart if needed
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml rollout restart deployment/ai-voice-receptionist -n openclaw

Issue: AI Not Responding / "No Answer"

Symptoms: Phone rings but AI doesn't answer

Diagnosis Steps:

1. Check agent publish status
2. Verify phone number is linked to agent
3. Check Retell LLM configuration

Solution:

# Check agent status
curl -s "https://api.retellai.com/list-agents" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0" | jq '.[] | {agent_id, is_published}'

# If not published, publish via Retell Dashboard
# Or check if multiple versions exist - use published version

Issue: Email Not Sending

Symptoms: No summary email received after call

Diagnosis Steps:

1. Check email was collected during call
2. Verify SMTP configuration
3. Check k8s logs for email errors

Solution:

# Check logs for email errors
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml logs -n openclaw -l app=ai-voice-receptionist | grep -i email

# Verify SMTP settings in deployment
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml get deployment ai-voice-receptionist -n openclaw -o yaml | grep -A5 SMTP

Issue: Wrong Language / Voice

Symptoms: AI speaks wrong language or voice sounds wrong

Solution:

# Check current language setting
curl -s "https://api.retellai.com/get-agent/agent_8d781886289fdc010ed868a33c" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0" | jq '{language, voice_id}'

# Update language if needed (zh-CN for Mandarin, yue-CN for Cantonese)
curl -s -X PATCH "https://api.retellai.com/update-agent/agent_8d781886289fdc010ed868a33c" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0" \
  -H "Content-Type: application/json" \
  -d '{"language": "zh-CN"}'

Issue: Knowledge Base Out of Date

Symptoms: AI gives outdated pricing or information

Solution:

# Update KB via GitHub
cd /home/herbert/.openclaw/workspace/cathy/retellai-kb

# Edit files in sources/
# Then commit and push - auto-syncs to Retell

git add .
git commit -m "Update pricing information"
git push

# Check sync status
gh run list --repo nexvisioncc/retellai-kb --limit 5

---

Part 3: Support Operations

Updating Agent Prompt

When you need to change how the AI responds:

# Update the LLM prompt
curl -s -X PATCH "https://api.retellai.com/update-retell-llm/llm_f27da33ea4e9c72de73076ad91ba" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0" \
  -H "Content-Type: application/json" \
  -d '{
    "general_prompt": "NEW_PROMPT_HERE"
  }'

Important: Keep the colloquial Cantonese style for HK customers.

Updating Pricing

1. Edit KB files:

   • /home/herbert/.openclaw/workspace/cathy/retellai-kb/sources/pricing.md
   • /home/herbert/.openclaw/workspace/cathy/retellai-kb/sources/services.md

2. Commit and push to GitHub (auto-syncs)

3. Update LLM prompt if pricing structure changes significantly

Adding New Tools

If you need to add new capabilities (e.g., new appointment types):

1. Update backend code in src/index.js
2. Add tool definition to LLM configuration
3. Rebuild and redeploy
4. Test thoroughly

Monitoring Call Quality

# Get recent calls with transcripts
curl -s "https://api.retellai.com/list-calls?limit=5" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0" | jq '.[] | {call_id, duration_ms, transcript}'

# Check for disconnection reasons
curl -s "https://api.retellai.com/get-call/CALL_ID_HERE" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0" | jq '{disconnection_reason, call_status}'

---

Part 4: Emergency Procedures

System Down - Full Recovery

1. Check K8s Status:

kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml get pods -n openclaw

1. Check Retell Status:

curl -s "https://api.retellai.com/list-agents" \
  -H "Authorization: Bearer key_0815cc9796db897ff644bb6710a0"

1. Redeploy if Needed:

cd /home/herbert/.openclaw/workspace/cathy/projects/ai-voice-receptionist
docker build -t registry.nexvision.cc/nexvisioncc/ai-voice-receptionist:latest .
docker push registry.nexvision.cc/nexvisioncc/ai-voice-receptionist:latest
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml rollout restart deployment/ai-voice-receptionist -n openclaw

1. Verify Recovery:

curl -s https://voice.nexvision.cc/health
# Should return "OK"

Rollback to Previous Version

# Check rollout history
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml rollout history deployment/ai-voice-receptionist -n openclaw

# Rollback to previous version
kubectl --kubeconfig=/home/herbert/k3s/kubeconfig.yaml rollout undo deployment/ai-voice-receptionist -n openclaw

---

Part 5: Configuration Reference

Environment Variables (K8s Deployment)

| Variable | Value | Description | |----------|-------|-------------| | RETELL_API_KEY | key_0815cc9796db897ff644bb6710a0 | Retell API authentication | | AGENT_ID | agent_8d781886289fdc010ed868a33c | Voice agent ID | | SMTP_HOST | mail.nexvision.cc | Email server | | SMTP_PORT | 587 | Email port | | SMTP_USER | cathylui@nexvision.cc | From email address | | SMTP_PASS | Cx7#pRv2!kNm9@Yw | Email password |

Retell AI Configuration

| Setting | Current Value | |---------|---------------| | Language | zh-CN (Mandarin) | | Voice | minimax-Cimo | | Knowledge Base | knowledge_base_1485d11dd42d2558 | | Tools | check_availability, book_appointment, collect_email, confirm_email |

GitHub Repositories

| Repo | Purpose | |------|---------| | nexvisioncc/openclaw-skills | Skill documentation | | nexvisioncc/retellai-kb | Knowledge Base content |

---

Resources

scripts/

• retell_cli.js - Command-line helper for common operations

references/

• api_reference.md - Complete API endpoint documentation
• maintenance_guide.md - This maintenance and support guide

Support Contacts

• Technical Issues: Check this guide first, then escalate
• Pricing Updates: Edit KB in GitHub
• Prompt Changes: Update via Retell API