Skip to content

mickmicksh/Audiocodes-Livehub-OpenClaw

Repository files navigation

OpenClaw ↔ AudioCodes Live Hub Bridge

Give your AI agent a phone number. 📞🤖

This bridge connects OpenClaw agents to AudioCodes Live Hub, enabling voice calls with your AI.

Phone Call → Live Hub (STT) → This Bridge → OpenClaw → Response → Live Hub (TTS) → Caller

Features

  • 🎙️ Voice conversations with your OpenClaw agent
  • 🔐 Caller verification — trusted numbers get full access, others are limited
  • 📞 Inbound calls — people call your AI
  • 📤 Outbound calls — your AI calls people (coming soon)
  • 🌍 Multi-language — use any STT/TTS language Live Hub supports

Quick Start

  1. Deploy the bridge alongside OpenClaw
  2. Configure Live Hub with your webhook URL
  3. Get a phone number and route it to the bot
  4. Call your AI!

📖 Full Setup Guide →

Phone Number Setup

You need a phone number routed through Live Hub to your bot:

  1. Get a number — In Live Hub, go to Voice Channels → Phone Numbers and buy one (or bring your own SIP trunk via SIP Connections)
  2. Create bot connection — Go to Bot Connections → Add new voice bot connection, select AudioCodes Bot API, set your bridge URL (https://your-host:3100/webhook) and BOT_TOKEN
  3. Configure speech — Set up STT (e.g. Google Chirp 2, Deepgram Nova-3) and TTS (e.g. ElevenLabs, Deepgram Aura-2) providers
  4. Route the number — Go to Routing Rules → Add Rule, set your phone number as source and your bot connection as destination

That's it — calls to that number now hit your AI agent.

Requirements

  • OpenClaw instance with /v1/responses API enabled
  • AudioCodes Live Hub account (free tier available)
  • Public HTTPS endpoint for the webhook

Environment Variables

BOT_TOKEN=secret-token-for-livehub      # Live Hub authenticates with this
OPENCLAW_URL=http://localhost:3000       # Your OpenClaw gateway
OPENCLAW_TOKEN=your-gateway-token        # OpenClaw auth
TRUSTED_CALLERS=+31612345678             # Comma-separated trusted numbers

Architecture

┌─────────────┐     ┌──────────────┐     ┌─────────────┐     ┌──────────┐
│   Caller    │────▶│  Live Hub    │────▶│   Bridge    │────▶│ OpenClaw │
│   (Phone)   │◀────│  (STT/TTS)   │◀────│  (Webhook)  │◀────│  (Agent) │
└─────────────┘     └──────────────┘     └─────────────┘     └──────────┘

Live Hub handles voice (STT/TTS), phone numbers, SIP. Bridge implements AudioCodes Bot API, connects to OpenClaw. OpenClaw is your AI agent with memory, tools, personality.

Security

Unknown callers are automatically restricted:

  • No access to private information
  • No actions on your behalf
  • General chat only

Add trusted numbers via TRUSTED_CALLERS env var.

API Endpoints

Endpoint Method Description
/webhook GET Health check
/webhook POST Create conversation
/conversation/:id/activities POST Exchange messages
/conversation/:id/refresh POST Keep alive
/conversation/:id/disconnect POST End call

License

MIT

Credits

Built for the OpenClaw + AudioCodes Live Hub integration PoC.

About

Integreates AudioCodes voice connecitvity and bots to OpenClaw

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors