Claw Voice Call

Claw Voice Call turns assistant replies into real outbound phone calls.

The plugin is designed for normal users first:

• default setup only asks for your phone number
• provider keys stay in environment variables or operator-managed infrastructure
• self-hosted credentials are available, but kept in advanced paths

Install

openclaw plugins install claw-voice-call

Quick Start

Managed deployment

For most users:

openclaw voice-bridge setup

Set your phone number, then ask your workspace owner to provision the voice backend if it is not already available.

Useful commands:

• /reflect: start a reflection call
• /ring <message>: call your phone and speak a message
• /ring-cmd <question>: ask Claw, then call you with the answer
• openclaw voice-bridge status: check readiness

Self-hosted deployment

If you run the backend yourself, you can either:

• use openclaw voice-bridge setup and choose advanced self-hosted setup
• import a .env file with openclaw voice-bridge setup --env-file /path/to/.env
• paste self-hosted variables with /voice-bridge-config

If you need the plugin to create a SIP trunk automatically, run:

/voice-setup

That command is only for self-hosted deployments with LiveKit and Telnyx credentials.

Security Model

• End users should not store provider keys in the plugin UI.
• Workspace operators should inject LIVEKIT_*, DEEPGRAM_API_KEY, ELEVENLABS_*, SIP_TRUNK_ID, and related secrets through environment variables or server-side infrastructure.
• The plugin reads those environment variables automatically when plugin config does not define them.
• .env is ignored by git and is not part of the published package.

Configuration

End-user fields

• phoneNumber: your destination phone number in E.164 format
• enabled: turn the plugin on or off
• callTimeoutSec: optional call timeout override

Self-hosted fields

These are advanced operator fields:

• LIVEKIT_URL
• LIVEKIT_API_KEY
• LIVEKIT_API_SECRET
• DEEPGRAM_API_KEY
• ELEVENLABS_API_KEY
• ELEVENLABS_VOICE_ID
• SIP_TRUNK_ID
• TELNYX_API_KEY
• SIP_FROM_NUMBER
• GROQ_API_KEY

ClawHub Packaging

This repo now includes the ClawHub/Codex plugin manifest at .codex-plugin/plugin.json.

Published package contents include:

• dist/
• skills/
• assets/
• .codex-plugin/
• openclaw.plugin.json
• README.md

Local Development

pnpm install
pnpm typecheck
pnpm build

For standalone operator testing:

cp .env.example .env
pnpm dev

Troubleshooting

• If openclaw voice-bridge status shows missing voice backend credentials, the workspace owner still needs to provision the backend.
• If self-hosted calls do not start, confirm SIP_TRUNK_ID exists or run /voice-setup.
• The plugin auto-loads gateway.auth.token from ~/.openclaw/openclaw.json when gatewayAuthToken is not set manually.

License

MIT