Quick-start

Install Ring-a-Ding in OpenClaw and make the first call.

This is the shortest path from keys to a working agent call. Use this page when you want the setup sequence only. Use /docs when you need the broader technical handbook: prompting guidance, MCP and CLI usage, public call routes, limits, and troubleshooting.

What lives where

- This page: install, configure, smoke test, and sanity check.

- /docs: prompting guidance, MCP and CLI reference, public call routes, limits, and troubleshooting.

Open full docs

Requirements

You need both keys before the first call can work. Ring-a-Ding handles telephony. Your OpenAI key powers the live voice model.

Ring-a-Ding API key

Open

Authenticates Ring-a-Ding and gives the platform permission to place calls for your account.

- Issued from the hosted account and checkout flow.
- Typically starts with rad_live_.
- Rotate it from the account page if an agent loses access.

OpenAI API key

Open

Powers the live voice model during the call. Ring-a-Ding does not replace your OpenAI account.

- Starts with sk-.
- Required for MCP and CLI calls.
- Stored in OpenClaw config or local CLI setup.

Step 1

Install the CLI and skill

Install the rad CLI, install the ring-a-ding OpenClaw skill, then run the readiness check.

npm install -g ring-a-ding-cli
openclaw skills install ring-a-ding
openclaw skills check

Step 2

Add the keys to OpenClaw

Put your Ring-a-Ding key and OPENAI_API_KEY in ~/.openclaw/openclaw.json, then start a fresh OpenClaw session so the skill is loaded with the new values.

{
  "skills": {
    "entries": {
      "ring-a-ding": {
        "enabled": true,
        "apiKey": "rad_live_...",
        "env": {
          "OPENAI_API_KEY": "sk-..."
        }
      }
    }
  }
}

Step 3

Run the smoke test

Do not reuse an old OpenClaw session. Start a fresh one, then paste this prompt exactly.

Use the ring-a-ding skill to call the best pizza place around me and order delivery.

Success looks like

- openclaw skills check shows ring-a-ding without missing binary or key errors
- A fresh OpenClaw session loads the skill and chooses it for a phone task
- The smoke-test prompt places a real outbound call without command-level failures
- The final result includes a usable summary after the call ends

Optional

Use the CLI directly

If you want to run Ring-a-Ding outside OpenClaw, save both keys locally and use the CLI directly.

rad init
rad init --api-key rad_live_... --openai-key sk-...

Need the OpenAI key page?OpenAI API keys

Next action

Open full docs Account and key recovery Get API key