Как это устроено
VoiceRoom соединяет чат и звонки с настроенным вами агентом — например, Hermes или OpenClaw. Агент может работать на вашем компьютере или через подключённый сервер. Модель, инструменты и доступ к файлам зависят от его настройки.
Личный агент и агент в группе
Личный агент доступен владельцу. Владелец может поделиться им с группой — тогда участники получают к нему доступ для звонков. Создавать групповые чаты с агентом и писать в них могут владелец и администраторы группы.
Подключение в три шага
Для подключения с компьютера понадобится установленный и настроенный агент. Мастер можно открыть и на телефоне — команду выполняйте на компьютере, где работает агент.
Создайте подключение
Откройте раздел «Агенты» в VoiceRoom, выберите подключение своего агента и задайте имя.
Выберите компьютер
Укажите macOS, Windows или Linux. Скопируйте команду из мастера в терминал этого компьютера. Она устанавливает мост, который поддерживает исходящее соединение с VoiceRoom. Для этого способа не нужно открывать входящие порты.
Дождитесь подключения
Продолжайте, когда мастер подтвердит связь. Сначала отправьте короткое сообщение в чат. Затем настройте речь для звонков или поделитесь агентом с группой.
Компьютер агента и нужные ему службы должны оставаться включёнными. Если настройка прервалась, вернитесь к этому агенту в мастере, чтобы повторить подключение.
Добавьте голос
Текстовый чат и голос настраиваются отдельно. Для звонка агенту нужны и распознавание речи, и синтез голоса. В разделе «Агенты» откройте инструкцию по настройке голоса.
Речевой провайдер
Настройте поддерживаемый речевой API и его ключ на компьютере агента. Звук и текст обрабатываются выбранным провайдером; условия и стоимость зависят от него.
Локальные речевые службы
Запустите совместимые службы распознавания и синтеза на компьютере агента. Мост может обнаружить их на портах 8090 и 8091. Это локальная обработка речи, но звонок всё равно проходит через сервер связи, а модель может быть облачной.
Проверьте статус голоса рядом с агентом. Если звонок не начинается, прочитайте ошибку: она помогает определить, какой компонент ещё нужно настроить.
Начните разговор
Один на один
Откройте личный чат с агентом и нажмите кнопку звонка. Завершённые реплики разговора появляются в истории этого чата и сохраняются на сервере VoiceRoom.
В группе
Пригласите доступного агента в голосовой канал. Способ обращения зависит от его голосовых настроек: обычно можно позвать по имени. Агент слышит участников звонка, даже когда ждёт обращения.
Статусы и субтитры помогают понять, слушает ли агент, думает или отвечает. Эти временные сообщения интерфейса не заменяют историю личного чата или включённую запись группы.
Что сохраняется и где
Встроенная запись группового звонка — это текстовая расшифровка. Её может включить владелец или администратор группы, когда агент подключён к звонку: кнопкой записи или голосовой командой агенту.
VoiceRoom показывает индикатор записи и отправляет объявление через агента. Эти сигналы относятся к встроенной функции; приложение не контролирует сторонние средства записи участников.
- Чат с агентом и реплики личных звонков
- Хранятся на сервере VoiceRoom. Сообщения также передаются настроенному агенту и могут обрабатываться его моделью или инструментами.
- Текст записи группового звонка
- Мост сохраняет файл на компьютере владельца агента. Сервер VoiceRoom хранит сведения о записи; эти служебные записи очищаются по сроку хранения в 30 дней.
- Звук звонка
- Передаётся участникам через сервер связи. Встроенная текстовая запись не создаёт аудиофайл. Речевые провайдеры и сторонние приложения работают по собственным правилам.
Кто получает данные разговора
Учитывайте отдельно сервер VoiceRoom, передачу звонка, речевой сервис и модель агента. Если попросить агента пересказать запись, содержание может попасть в его запрос к модели и в ответ в чате.
Вернитесь к прошлому разговору
Историю личного общения ищите в чате с агентом. Для групповых расшифровок агенту нужен доступ к файлам записей. Можно попросить его найти решение или подготовить выжимку; результат зависит от доступных записей и инструментов.
Что ещё можно поручить
Поиск, работа с файлами и напоминания зависят от подключённого агента и выданных ему разрешений. Ветки в чате помогают отделить разные темы. Для напоминаний агент должен оставаться доступным, а для уведомлений вне приложения нужны разрешения устройства.
Настройте под себя
В настройках агента в VoiceRoom проверьте имя, возможности и подключение. Модель, характер, память и доступ к инструментам настройте в самом рантайме. Для Hermes используйте документацию установленной версии.
Для самостоятельной настройки локальной речи
Явные адреса задаются параметрами VOICE_STT_URL и VOICE_TTS_URL в окружении моста. Речевые службы должны поддерживать следующий контракт:
GET /health → JSON {"status":"ok"}
POST /stt → PCM16LE, mono, 16 kHz → JSON {"text":"…"}
POST /tts → UTF-8 text → PCM16LE, mono, 24 kHzДля другой частоты синтеза укажите rate в ответе /health или настройте VOICE_TTS_URL_RATE. После изменения настроек повторите проверку голоса в приложении.
Если что-то не работает
Агент не в сети
Проверьте питание и интернет компьютера, затем службу моста и сам рантайм. Откройте существующее подключение в мастере и повторите шаг, на котором возникла ошибка.
Чат работает, а голос — нет
Проверьте обе речевые службы или ключ провайдера. Убедитесь, что включена голосовая возможность агента. Откройте инструкцию по голосу и повторите звонок после проверки статуса.
Агента не видно в группе
Личным агентом делится его владелец. Проверьте список агентов группы и свои права. Для группового чата нужен агент с поддержкой чата, для звонка — с поддержкой голоса.
Ответ или уведомление не пришли
Посмотрите статус агента и ошибку в чате. Проверьте доступность модели и разрешения уведомлений. Запущенная задача или таймер зависят от работы самого агента.