phone-voice

# Phone Voice Integration

Turn your OpenClaw into a phone-callable assistant with ElevenLabs Agents + Twilio.

**What you get:**
- 📞 Call your bot from any phone
- 🔐 Caller ID authentication + voice PIN security
- 🛡️ Call screening (whitelist-based)
- 🧠 Full memory context (loads MEMORY.md, USER.md)
- 💰 Cost tracking per call
- 📝 Call transcripts with summaries
- ⏱️ Rate limiting
- 🌐 Permanent tunnel (Cloudflare) or temporary (ngrok)

## Architecture

```
Phone → Twilio → ElevenLabs Agent → Your Bridge → Anthropic Claude → OpenClaw Tools
                                          ↓
                                    Memory Context
                                    (MEMORY.md, USER.md)
```

**Flow:**
1. Caller dials your Twilio number
2. Twilio routes to ElevenLabs Agent
3. Agent sends chat completions to your bridge (mimics OpenAI API)
4. Bridge translates to Anthropic, injects context from memory files
5. Claude response → ElevenLabs TTS → caller hears it

## Prerequisites

- OpenClaw installed and running
- ElevenLabs account + API key
- Twilio account + phone number
- Anthropic API key
- Cloudflare tunnel **or** ngrok (for exposing localhost)

## Setup

### 1. Enable Chat Completions in OpenClaw

Not needed for this skill — the bridge bypasses OpenClaw and calls Claude directly. This gives you more control over memory injection and cost tracking.

### 2. Create the Bridge Server

The bridge is a FastAPI server that:
- Accepts OpenAI-compatible `/v1/chat/completions` requests from ElevenLabs
- Injects memory context (MEMORY.md, USER.md, live data)
- Calls Anthropic Claude API
- Streams responses back in OpenAI format
- Logs costs and transcripts

**Key files:**
- `server.py` — FastAPI app with /v1/chat/completions endpoint
- `fred_prompt.py` — System prompt builder (loads memory files)
- `.env` — Secrets (API keys, tokens, whitelist)
- `contacts.json` — Caller whitelist for screening

### 3. Set Up Cloudflare Tunnel (Recommended)

Permanent, secure altern...