Ringg Voice Agent Skill for OpenClaw

This skill connects OpenClaw to Ringg AI — a Voice OS for enterprises that provides low-latency (<337ms), multilingual (20+ languages) AI voice agents for phone interactions including lead qualification, feedback collection, confirmations, and more.

Prerequisites

• A Ringg AI account with API access
• RINGG_API_KEY environment variable set (obtain from Ringg AI dashboard)
• RINGG_WORKSPACE_ID environment variable set
• Optional: RINGG_DEFAULT_ASSISTANT_ID for a default voice agent
• Optional: RINGG_DEFAULT_FROM_NUMBER for outbound calls

Configuration

Add to openclaw.json under skills.entries:

{
  "skills": {
    "entries": {
      "ringg-voice-agent": {
        "enabled": true,
        "apiKey": "RINGG_API_KEY",
        "env": {
          "RINGG_API_KEY": "<your-ringg-api-key>",
          "RINGG_WORKSPACE_ID": "<your-workspace-id>",
          "RINGG_DEFAULT_ASSISTANT_ID": "<optional-default-assistant-id>",
          "RINGG_DEFAULT_FROM_NUMBER": "<optional-default-number>"
        }
      }
    }
  }
}

Available Actions

1. Make an Outbound Call

Initiate a call from a Ringg AI assistant to a phone number.

# Basic outbound call
curl -X POST "https://api.ringg.ai/v1/calls/outbound" \
  -H "Authorization: Bearer $RINGG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": "<assistant-id>",
    "to_number": "+919876543210",
    "from_number": "+918001234567",
    "dynamic_variables": {
      "customer_name": "Rahul",
      "order_id": "ORD-12345"
    }
  }'

Parameters:

• assistant_id — ID of the Ringg voice agent to use (falls back to RINGG_DEFAULT_ASSISTANT_ID)
• to_number — Destination phone number in E.164 format
• from_number — Caller ID number (falls back to RINGG_DEFAULT_FROM_NUMBER)
• dynamic_variables — Key-value pairs passed into the agent's conversation context

When the user says "call +91XXXXXXXXXX" or "make a call to [name/number]", use this action. If no assistant_id is specified, use RINGG_DEFAULT_ASSISTANT_ID. If no from_number is specified, use RINGG_DEFAULT_FROM_NUMBER.

2. Launch a Campaign

Trigger a batch calling campaign for multiple contacts.

curl -X POST "https://api.ringg.ai/v1/campaigns/launch" \
  -H "Authorization: Bearer $RINGG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": "<campaign-id>",
    "contacts": [
      {"phone": "+919876543210", "name": "Rahul", "custom_field": "value"},
      {"phone": "+919876543211", "name": "Priya", "custom_field": "value"}
    ]
  }'

When the user asks to "launch a campaign", "start calling a list", or "run outbound calls for [list/segment]", use this action.

3. Check Call Status

curl -X GET "https://api.ringg.ai/v1/calls/{call_id}/status" \
  -H "Authorization: Bearer $RINGG_API_KEY"