ClawdTalk Client

ClawdTalk — это инструмент для голосовых звонков и SMS-сообщений для Clawdbot. Он позволяет взаимодействовать с вашим AI-агентом по телефону, отправлять текстовые сообщения или запускать автоматизированные сценарии коммуникации.

Быстрый старт

• Зарегистрируйтесь на clawdtalk.com
• Добавьте свой номер телефона в настройках
• Получите API-ключ в панели управления
• Запустите настройку: ./setup.sh
• Запустите подключение: ./scripts/connect.sh start

Голосовые звонки

WebSocket-клиент направляет звонки в основную сессию агента, предоставляя полный доступ к памяти, инструментам и контексту.

./scripts/connect.sh start # Запустить соединение
./scripts/connect.sh stop # Остановить
./scripts/connect.sh status # Проверить статус

Исходящие звонки

Вы можете инициировать звонки от имени бота — себе или другим пользователям:

./scripts/call.sh # Позвонить себе
./scripts/call.sh "Привет, как дела?" # Звонок с приветствием
./scripts/call.sh --to +15551234567 # Звонок на внешний номер*
./scripts/call.sh --to +15551234567 "Привет!" # Внешний звонок с текстом
./scripts/call.sh status  # Статус звонка
./scripts/call.sh end  # Завершить звонок

*Для внешних звонков требуется платный аккаунт и выделенный номер. В этом режиме AI работает с повышенной приватностью и не раскрывает личные данные.

SMS-сообщения

Поддерживается отправка и получение текстовых сообщений:

./scripts/sms.sh send +15551234567 "Привет!"
./scripts/sms.sh list
./scripts/sms.sh conversations

Как это работает

Звонки проходят через Telnyx и поступают на сервер ClawdTalk. WebSocket-клиент обрабатывает распознанную речь и отправляет её в endpoint /v1/chat/completions вашего шлюза. Бот отвечает как на обычное сообщение, после чего ответ преобразуется в речь и воспроизводится пользователю. :

SMS-сообщения проходят через API ClawdTalk и могут запускать обработку со стороны бота через webhook-и. :

Конфигурация

Основные параметры задаются в файле skill-config.json:

• api_key — API-ключ из clawdtalk.com
• server — адрес сервера (по умолчанию: https://clawdtalk.com)
• owner_name — имя владельца
• agent_name — имя агента
• greeting — приветственное сообщение для входящих звонков

Инструменты шлюза (обязательно)

Для корректной работы голосового ассистента необходимо разрешить инструмент sessions_send в конфигурации шлюза:

{
 "gateway": {
 "tools": {
 "allow": ["sessions_send"]
 }
 }
}

Без этого ассистент сможет обрабатывать звонки, но не сможет передавать запросы вашему боту. :

Устранение неполадок

• Ошибка авторизации — пересоздайте API-ключ
• Пустые ответы — выполните ./setup.sh и перезапустите gateway
• sessions_send failed: 404 — добавьте разрешение инструмента в конфиг
• Разрывы соединения — проверьте лог: tail -f .connect.log
• Режим отладки — DEBUG=1 ./scripts/connect.sh restart

Лицензия

MIT

Ссылки

• ClawdTalk — регистрация и управление аккаунтом
• Clawdbot — фреймворк AI-ассистента
• Telnyx — инфраструктура для звонков и сообщений