ClawdTalk Client

Voice calling and SMS messaging for Clawdbot. Talk to your bot by phone or exchange texts.

Powered by Telnyx.

Features

• Voice calls — Real-time conversations with your bot via phone
• SMS messaging — Send and receive text messages
• Tool integration — Your bot's full capabilities, accessible by voice

Requirements

• Clawdbot or OpenClaw with gateway running
• Node.js, bash, jq
• ClawdTalk account (clawdtalk.com)

Installation

# Clone or download to your skills directory
cd ~/clawd/skills/clawdtalk-client

# Run setup
./setup.sh

# Start the WebSocket connection
./scripts/connect.sh start

The setup script will:

• Ask for your API key
• Configure the voice agent in your gateway
• Create skill-config.json

Usage

Voice Calls

Start the connection, then call your ClawdTalk number:

./scripts/connect.sh start      # Start (run in background or via cron)
./scripts/connect.sh stop       # Stop
./scripts/connect.sh status     # Check status
./scripts/connect.sh restart    # Restart

Keep it running:

# Add to crontab (crontab -e):
@reboot cd ~/clawd/skills/clawdtalk-client && ./scripts/connect.sh start

Outbound Calls

Have the bot call you:

./scripts/call.sh                    # Call with default greeting
./scripts/call.sh "Hey, what's up?"  # Custom greeting
./scripts/call.sh status <call_id>   # Check status
./scripts/call.sh end <call_id>      # End call

SMS

./scripts/sms.sh send +15551234567 "Hello from ClawdTalk!"
./scripts/sms.sh send +15551234567 "With image" --media https://example.com/photo.jpg
./scripts/sms.sh list
./scripts/sms.sh list --contact +15551234567
./scripts/sms.sh conversations

Configuration

skill-config.json:

{
  "api_key": "cc_live_xxx",
  "server": "https://clawdtalk.com"
}

Environment Variable Support

Instead of storing credentials in plaintext, you can use ${ENV_VAR} references:

{
  "api_key": "${CLAWDTALK_API_KEY}",
  "server": "https://clawdtalk.com"
}

Then set the variable in one of these locations (checked in order):

• ~/.openclaw/.env
• ~/.clawdbot/.env
• <skill-dir>/.env

Example .env file:

CLAWDTALK_API_KEY=cc_live_xxx

The gateway auth token in openclaw.json/clawdbot.json also supports this:

{
  "gateway": {
    "auth": {
      "token": "${GATEWAY_TOKEN}"
    }
  }
}

How It Works

Voice: Phone calls connect via Telnyx to the ClawdTalk server. The WebSocket client (ws-client.js) routes transcribed speech to your gateway's /v1/chat/completions endpoint. Your bot processes it like any other message — same tools, same context. The response is converted to speech and played back.

SMS: Messages route through the ClawdTalk API. Inbound messages can trigger your bot via webhooks.

Troubleshooting

License

MIT

Links

• ClawdTalk — Sign up and manage your account
• Clawdbot — AI assistant framework
• Telnyx — Voice and messaging infrastructure