Tutorial

Modo de Voz (Talk Mode)

Tenha conversas naturais por voz com o OpenClaw usando ElevenLabs TTS.

🎙️ O que e o Talk Mode?

O Talk Mode permite conversas naturais por voz com o OpenClaw. Fale naturalmente e sua IA responde com fala realista alimentada pelo ElevenLabs.

Como funciona:

Escuta a palavra de ativacao ou pressionar para falar→Transcreve fala para texto (Whisper)→Processa com IA (Claude, GPT, etc.)→Converte resposta para fala (ElevenLabs)

O Talk Mode requer uma chave de API do ElevenLabs para texto-para-fala. Fala-para-texto usa Whisper (OpenAI ou local).

Requisitos

Chave de API ElevenLabs

Obrigatorio

Cadastre-se em elevenlabs.io

Plataforma

macOS, iOS, Android

Entrada de voz requer apps nativos

Permissoes

Acesso ao microfone

Conceda quando solicitado

Passos de Configuracao

Obter Chave de API ElevenLabs

Cadastre-se no ElevenLabs e obtenha sua chave de API:

• Acesse elevenlabs.io e crie uma conta
• Navegue ate Perfil -> Chave de API
• Copie sua chave de API

Configurar OpenClaw

Adicione a configuracao do ElevenLabs ao seu openclaw.json:

{
  "talk": {
    "voiceId": "EXAVITQu4vr4xnSDxMaL",
    "modelId": "eleven_v3",
    "outputFormat": "mp3_44100_128",
    "apiKey": "${ELEVENLABS_API_KEY}",
    "interruptOnSpeech": true
  }
}

Definir Variavel de Ambiente

Alternativamente, defina sua chave de API como uma variavel de ambiente:

export ELEVENLABS_API_KEY="your_api_key_here"

Iniciar Talk Mode

Ative o talk mode a partir do app da barra de menu do OpenClaw ou CLI:

• Clique no icone do OpenClaw na barra de menu
• Selecione 'Iniciar Talk Mode'
• Ou execute: openclaw talk

Opcoes Completas de Configuracao

Todas as opcoes de configuracao de voz disponiveis:

{
  "talk": {
    "voiceId": "EXAVITQu4vr4xnSDxMaL",
    "modelId": "eleven_v3",
    "outputFormat": "mp3_44100_128",
    "apiKey": "${ELEVENLABS_API_KEY}",
    "interruptOnSpeech": true,
    "stability": 0.5,
    "similarityBoost": 0.75,
    "style": 0.5,
    "speakerBoost": true
  }
}

elevenlabs.apiKey — Sua chave de API ElevenLabs
elevenlabs.voiceId — ID da voz a usar (padrao: Rachel)
elevenlabs.model — Modelo a usar (eleven_monolingual_v1, eleven_multilingual_v2)
voice.wakeWord — Palavra de ativacao (padrao: 'Hey Claw')
voice.pushToTalk — Usar pressionar-para-falar em vez de palavra de ativacao
voice.silenceTimeout — Segundos de silencio antes de parar (padrao: 2)

Aliases de Voz

Alterne facilmente entre diferentes personalidades de voz.

{
  "talk": {
    "voiceId": "default",
    "voices": {
      "default": "EXAVITQu4vr4xnSDxMaL",
      "professional": "21m00Tcm4TlvDq8ikWAM",
      "friendly": "AZnzlk1XvdvUeBnXmlld",
      "narrator": "pNInz6obpgDQGcFmaJgB"
    }
  }
}

Vozes Disponiveis

Padrao (Rachel)

Voz feminina calorosa e natural

Profissional (Adam)

Voz masculina clara e autoritaria

Amigavel (Bella)

Voz feminina casual e acessivel

Narrador (Antoni)

Voz masculina profunda, estilo narrador

Alterne vozes dizendo 'Usar voz profissional' ou configurando no config.

Recursos por Plataforma

macOS

✓App na barra de menu com alternancia rapida
✓Atalho global para pressionar-para-falar
✓Integracao com audio do sistema
✓Deteccao de palavra de ativacao

iOS & Android

✓Entrada de voz no app complementar
✓Deteccao de palavra de ativacao em segundo plano
✓Suporte a fones Bluetooth
✓Feedback haptico

Comandos de Voz

Controle o OpenClaw com comandos de voz:

// Per-reply voice control
{
  "voice": "narrator",
  "speed": 1.1,
  "stability": 0.8
}

This response will be spoken in the narrator voice at slightly faster speed.

Comandos Disponiveis

Parar — Parar reproducao de fala atual
Pausar — Pausar e aguardar mais entrada
Cancelar — Cancelar solicitacao atual
Repetir — Repetir a ultima resposta
Mais Lento/Mais Rapido — Ajustar velocidade da fala

TTS para Mensagens

Configure texto-para-fala para mensagens recebidas:

{
  "tts": {
    "enabled": true,
    "mode": "tagged",
    "provider": "elevenlabs",
    "voiceId": "EXAVITQu4vr4xnSDxMaL"
  }
}

Modos TTS

always

Ler todas as mensagens em voz alta

Melhor para: Operacao maos-livres

inbound

Ler apenas mensagens recebidas

Melhor para: Ao enviar por outros canais

tagged

Ler mensagens marcadas com @voice

Melhor para: Saida de voz seletiva

Provedores Suportados

ElevenLabs — ElevenLabs (maior qualidade)
OpenAI — OpenAI TTS (rapido, boa qualidade)

💡 Dicas e Melhores Praticas

•Ambiente Silencioso — O reconhecimento de voz funciona melhor em ambientes silenciosos com ruido de fundo minimo.
•Fale Claramente — Fale em um ritmo normal. Pausar levemente entre frases ajuda na precisao da transcricao.
•Use Fones de Ouvido — Fones de ouvido previnem eco e melhoram a deteccao da palavra de ativacao.
•Verifique os Creditos — O ElevenLabs tem limites de uso. Monitore seus creditos para evitar interrupcoes.

Modo de Voz Pronto!

Comece a conversar com seu assistente de IA maos-livres.

Instalar OpenClaw Explorar Skills