OpenClaw

Give your OpenClaw agent a real phone number. Make calls, receive calls, send and read SMS — all through natural language or the AgentPhone API.

Option 1: MCP Server (recommended)

OpenClaw supports MCP servers natively. This is the fastest path — one config block and your agent has full phone capabilities.

Add to your OpenClaw MCP configuration:

1
{
2
  "mcpServers": {
3
    "agentphone": {
4
      "command": "npx",
5
      "args": ["-y", "agentphone-mcp"],
6
      "env": {
7
        "AGENTPHONE_API_KEY": "your_api_key_here"
8
      }
9
    }
10
  }
11
}

That’s it. Your OpenClaw agent now has 26 phone tools. Try:

“Buy me a US phone number and create a voice agent that answers calls as my personal assistant.”

“Call +14155551234 and ask if they have availability this Thursday.”

“Show me my recent SMS conversations.”

Option 2: Webhook (handle inbound calls with OpenClaw)

If you want OpenClaw to control how inbound calls are handled, point AgentPhone’s webhook at your OpenClaw instance.

1. Expose OpenClaw’s API

Make your OpenClaw API server publicly reachable. If running locally, use a tunnel:

$
# ngrok
$
ngrok http 3210
$
$
# or tailscale funnel
$
tailscale funnel 3210

2. Set the webhook

$
curl -X POST https://api.agentphone.ai/v1/webhooks \
>
  -H "Authorization: Bearer $AGENTPHONE_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "url": "https://your-openclaw-url.ngrok.app/webhook/agentphone",
>
    "contextLimit": 10
>
  }'

3. Handle the webhook in OpenClaw

Create a skill or plugin that receives AgentPhone webhook events:

1
# AgentPhone Inbound Handler
2
3
When you receive a POST to /webhook/agentphone, it contains a phone call
4
transcript or SMS message. The payload looks like:
5
6
- event: "agent.message"
7
- channel: "sms", "imessage", or "voice"
8
- data.message: the sender's message (SMS/iMessage)
9
- data.transcript: the caller's speech (voice)
10
- data.from: their phone number
11
- data.to: your agent's number
12
- data.conversationId: thread ID
13
- recentHistory: past messages (each has content, direction, channel, at)
14
15
Respond with a JSON body containing your reply:
16
{ "response": "your message here" }
17
18
Use your knowledge and tools to craft a helpful response.

Webhook payload

Every inbound call transcript or SMS arrives as:

1
{
2
  "event": "agent.message",
3
  "channel": "sms",
4
  "timestamp": "2025-01-15T10:30:05Z",
5
  "agentId": "agt_abc123",
6
  "data": {
7
    "conversationId": "conv_abc123",
8
    "numberId": "num_xyz789",
9
    "from": "+15559876543",
10
    "to": "+15551234567",
11
    "message": "Hi, I'd like to schedule an appointment",
12
    "direction": "inbound",
13
    "receivedAt": "2025-01-15T10:30:05Z"
14
  },
15
  "recentHistory": [
16
    {
17
      "content": "Hello! How can I help?",
18
      "direction": "outbound",
19
      "channel": "sms",
20
      "at": "2025-01-15T10:30:00Z"
21
    }
22
  ],
23
  "conversationState": null
24
}

Option 3: API from OpenClaw tools

Use the AgentPhone API directly from an OpenClaw tool or plugin:

1
import httpx
2
import os
3
4
API_KEY = os.environ["AGENTPHONE_API_KEY"]
5
BASE = "https://api.agentphone.ai/v1"
6
headers = {"Authorization": f"Bearer {API_KEY}"}
7
8
# Make an outbound call
9
def make_call(agent_id: str, to_number: str, system_prompt: str):
10
    return httpx.post(f"{BASE}/calls", headers=headers, json={
11
        "agentId": agent_id,
12
        "toNumber": to_number,
13
        "systemPrompt": system_prompt,
14
    }).json()
15
16
# Read SMS messages for a number
17
def read_messages(number_id: str):
18
    return httpx.get(f"{BASE}/numbers/{number_id}/messages", headers=headers).json()

Replacing @openclaw/voice-call

If you’re currently using the @openclaw/voice-call plugin with Twilio, AgentPhone replaces that entire stack:

What you can do

Once connected, your OpenClaw agent can:

• Buy and manage phone numbers (buy_number, list_numbers)
• Make AI-powered outbound calls (make_conversation_call)
• Receive and handle inbound calls (webhook or hosted AI)
• Read SMS conversations (list_conversations, get_messages)
• Set up per-agent webhooks for routing
• Check call transcripts and recordings
• Monitor usage and billing