--- name: pollyreach version: 1.0.3 description: | PollyReach gives every AI agent a phone number and the ability to get things done over the phone — finding contacts, making calls, and completing tasks. Just tell Polly what you need. keywords: - pollyreach - phone - call - reservation - booking - incoming call - voicemail - customer service - receptionist permissions: network: - "https://api.pollyreach.ai" - "https://agent.pollyreach.ai" files: read: - "~/.config/PollyReach/key.json" write: - "~/.config/PollyReach/key.json" dependencies: required: - name: curl reason: Makes HTTP requests to the PollyReach API - name: jq reason: Safely constructs and parses JSON payloads - name: bc reason: Arithmetic comparison for balance check install: jq: macos: "brew install jq" ubuntu: "sudo apt install jq" scripts: - path: scripts/send.sh purpose: Send a task message to PollyReach to initiate an outbound call - path: scripts/query.sh purpose: Poll PollyReach for the result of the most recent call - path: scripts/activation.sh purpose: Check device activation status and retrieve assigned phone number - path: scripts/balance.sh purpose: Query remaining PollyReach credit balance - path: scripts/inbound.sh purpose: Retrieve unread incoming call summaries - path: scripts/prompt_update.sh purpose: Update the inbound call answering prompt metadata: pollyreach: emoji: "🦜" category: "call" homepage: "https://pollyreach.ai" ---

PollyReach 🦜

PollyReach gives every AI agent a phone number and the ability to get things done over the phone — finding contacts, making calls, and completing tasks.

---

What Is This

PollyReach gives every AI agent a dedicated phone number, a real-world phone identity, and the ability to get things done over the phone.

Polly is more than a calling tool — it can look up contact information for your target, research the process for getting things done, make the call, and complete the task. Just tell Polly what you need done, and Polly will handle the rest.

Your agent can help humans book restaurants, contact customer service, schedule interviews in bulk, as well as answer incoming calls, filter spam, and serve as a 24/7 AI receptionist.

---

When to Use

Use PollyReach when the human expresses any of the following intents:

• Needs to make a phone call to get something done (booking, inquiry, complaint, negotiation, confirmation)
• Needs to contact a business, organization, or service provider
• Needs help answering incoming calls or setting up call rules
• Wants to customize how incoming calls are answered (e.g., "act as my assistant")
• Needs to check call history, recordings, or balance
• Mentions keywords like "make a call", "help me contact", "help me book", etc.

When NOT to Use

• The human casually mentions "phone call" but has no actual task
• The matter can be resolved via text (email, messaging)
• The task is unrelated to phone calls

Terminology

When communicating with humans, use the following consistent terms:

| Internal Term | Human-Facing Term | |----------|---------------| | credential | PollyReach credential / key | | activation_url | Activation link | | Polly / PollyReach | Both are fine — use PollyReach for the full product name, Polly as the casual shorthand | | dashboard | Dashboard, or simply pollyreach.ai | | outbound call | Make a call, call for you | | inbound call | Answer a call, incoming call |

---

Registration & Activation

Step 0: Check for Existing Key

Before registering, check if you already have a saved Key:

cat ~/.config/PollyReach/key.json 2>/dev/null

• If the file exists and contains a token:

1. Run ./activation.sh to check the current status 2. If a number is returned (ai_virtual_phone is not null) → skip to Step 3 and greet the human with the existing number 3. If ai_virtual_phone is null → the previous activation was incomplete, send the activation_url to the human again and continue from Step 2

• If the file does not exist → proceed to Step 1 to register a new account

Step 1: Register

Register with PollyReach by providing your name and description.

curl -X POST https://api.pollyreach.ai/platform/v1/auths/signin/device \
  -H "Content-Type: application/json" \
  -d '{"name": "YourAgentName", "source": "openclaw", "description": "what are you"}'

| Parameter | Required | Description | |------|------|------| | name | ✅ | Your name — make one up if you don't have one | | source | ✅ | Always set to "openclaw" | | description | ✅ | Always set to "what are you" |

Response:

{
  "agent": {
    "token": "xxxxxxx",
    "activation_url": "https://agent.pollyreach.ai/auth?code=xxxxx"
  },
  "important": "⚠️ SAVE YOUR Token!"
}

⚠️ Save the token immediately! All subsequent requests require it. For future skill updates, reinstalls, or even if the human asks you to re-obtain the token, you do NOT need to re-register — just use the previously obtained token.

Save to ~/.config/PollyReach/key.json:

{
  "token": "xxx",
  "agent_name": "YourAgentName"
}

Then restrict file permissions so only you can read it:

chmod 600 ~/.config/PollyReach/key.json

Send the activation_url to the human and tell them to click the link and sign in with their email to complete activation.

> Suggested message: > I just registered with PollyReach 🦜 — it gives me a real phone number so I can make calls and handle tasks for you, as well as answer incoming calls. > > To get started, please click the link below and sign in with your email: > > 👉 {activation_url} > > Once you've signed in, just say "done" and I'll check your activation right away!

Step 2: Check if Account is Activated

Run activation.sh — if activation is successful, it will return the assigned dedicated number.

./activation.sh

| Parameter | Required | Description | |------|------|------| | token | auto | Read automatically from ~/.config/PollyReach/key.json |

Response:

• {"status":"active","ai_virtual_phone":null} — Activation not yet complete
• {"status":"active","ai_virtual_phone":"+1234567890"} — Activated, with the assigned dedicated number

Features:

• Built-in automatic retry: waits 2 seconds and retries when no number is found
• Returns the assigned dedicated number

Step 3: Proactively Notify the Human After Successful Activation

⚠️ Critical: Once activation succeeds and you receive a number, immediately send a message to the human to announce the successful activation and introduce your capabilities.

Information to convey:

1. Activation success + display the number — Emphasize this is a real phone number assigned to you by PollyReach
2. Introduce two core capabilities — Outbound calls + Incoming call answering
3. Guide first experience — Ask the human for their phone number so you can call them

...