Skip to content

Comments

feat: add Telnyx/ClawdTalk voice channel integration#39

Open
a692570 wants to merge 1 commit intoTinyAGI:mainfrom
a692570:feat/telnyx-voice-channel
Open

feat: add Telnyx/ClawdTalk voice channel integration#39
a692570 wants to merge 1 commit intoTinyAGI:mainfrom
a692570:feat/telnyx-voice-channel

Conversation

@a692570
Copy link

@a692570 a692570 commented Feb 13, 2026

Summary

This PR adds a voice channel integration to TinyClaw, enabling AI agents to make and receive phone calls through Telnyx programmable voice API, powered by ClawdTalk for voice AI capabilities.

Features Added

  • Inbound calls: Receive calls on your Telnyx phone number with auto-answer and greeting
  • Outbound calls: Make calls programmatically from agents or via CLI
  • Text-to-speech: Agent responses are spoken to callers automatically
  • DTMF gathering: Collect keypad input from callers during conversations
  • Webhook server: Handle Telnyx call events for real-time call control

Changes

New Files

  • src/channels/telnyx-voice-client.ts - Voice channel client implementation
  • docs/VOICE.md - Comprehensive setup and usage documentation
  • .env.example - Environment variable template with Telnyx configuration

Modified Files

  • lib/common.sh - Added voice channel to channel registry
  • lib/setup-wizard.sh - Added voice channel setup prompts
  • src/lib/types.ts - Added voice configuration interface
  • package.json - Added telnyx SDK dependency and voice script
  • README.md - Updated features, architecture, and documentation links

Setup Requirements

  1. Create a Telnyx account at https://telnyx.com
  2. Create an API key at https://portal.telnyx.com/#/app/api-keys
  3. Configure a voice profile and purchase a phone number
  4. Set up webhook URL in Telnyx portal

Usage

CLI Outbound Call

node dist/channels/telnyx-voice-client.js call +15551234567 "Hello, this is a test call"

Inbound Call Flow

  1. Call is answered automatically
  2. Greeting is spoken to caller
  3. Agent handles the conversation
  4. DTMF input is collected and processed

Testing

The voice channel follows the same patterns as existing channels (Discord, Telegram, WhatsApp):

  • Uses the same queue-based message processing
  • Integrates with multi-agent routing via @agent_id
  • Supports team collaboration for voice calls

Resources

- Add telnyx-voice-client.ts for voice calling capabilities
- Support inbound calls with auto-answer and greeting
- Support outbound calls via CLI and agent responses
- DTMF gathering for keypad input during calls
- Text-to-speech for agent responses to callers
- Webhook server for Telnyx call events
- Update channel registry in common.sh and setup-wizard.sh
- Add voice configuration to types.ts
- Create docs/VOICE.md with setup instructions
- Update README.md with voice channel information
- Add .env.example with Telnyx configuration variables

ClawdTalk integration enables AI agents to make and receive
phone calls through Telnyx programmable voice API.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant