Как это устроено
VoiceRoom соединяет чат и звонки с настроенным вами агентом — например, Hermes или OpenClaw. Агент может работать на вашем компьютере или через подключённый сервер. Модель, инструменты и доступ к файлам зависят от его настройки.
Личный агент и агент в группе
Личный агент доступен владельцу. Владелец может поделиться им с группой — тогда участники получают к нему доступ для звонков. Создавать групповые чаты с агентом и писать в них могут владелец и администраторы группы.
Подключение в три шага
Сначала установите Hermes или другой агент и настройте его модель. Для автоматического установщика Volo нужны Node 22+ и npm. Мастер можно открыть и на телефоне — команду выполняйте на компьютере агента. Volo не устанавливает сам Hermes и не создаёт аккаунт у поставщика модели.
Создайте подключение
Откройте раздел «Агенты» в VoiceRoom, выберите подключение своего агента и задайте имя.
Выберите компьютер
Укажите macOS, Windows или Linux. Скопируйте команду из мастера в терминал этого компьютера. Она устанавливает мост, который поддерживает исходящее соединение с VoiceRoom. Для этого способа не нужно открывать входящие порты.
Дождитесь подключения
Продолжайте, когда мастер подтвердит связь. Сначала отправьте короткое сообщение в чат. Затем настройте речь для звонков или поделитесь агентом с группой.
Компьютер агента и нужные ему службы должны оставаться включёнными. Если настройка прервалась, вернитесь к этому агенту в мастере, чтобы повторить подключение.
На macOS / Linux для обнаруженного локального Hermes команда также устанавливает инструмент чтения записей. Если Hermes свободен, установщик перезапускает его; при активных задачах выводит инструкцию для позднего перезапуска. Дождитесь завершения команды. Подключение моста и готовность всех возможностей — разные проверки.
Добавьте голос
Текстовый чат и голос настраиваются отдельно. Для звонка агенту нужны и распознавание речи, и синтез голоса. В разделе «Агенты» откройте инструкцию по настройке голоса.
Речевой провайдер
Настройте поддерживаемый речевой API и его ключ на компьютере агента. Звук и текст обрабатываются выбранным провайдером; условия и стоимость зависят от него.
Локальные речевые службы
В мастере для macOS / Linux можно выбрать «Установить локальное распознавание и голос». Нужны Python 3.11 или 3.12 и git; установщик скачает модели (больше 1 ГБ), создаст службы распознавания и синтеза и настроит автозапуск. Без этого выбора текущая речевая конфигурация сохраняется. На Windows речевые службы настраиваются вручную.
После завершения команды откройте диагностику в настройках агента: подключение, доступность модели, распознавание и озвучивание, очередь доставки. Нажмите «Обновить», если отчёт устарел. Служба на localhost может обращаться к облаку — ориентируйтесь на указанный режим, а не номер порта. Доступность модели не гарантирует качество её ответа; начните с короткого тестового звонка.
Начните разговор
Один на один
Откройте личный чат с агентом и нажмите кнопку звонка. Завершённые реплики разговора появляются в истории этого чата и сохраняются на сервере VoiceRoom.
В группе
Пригласите доступного агента в голосовой канал. Способ обращения зависит от его голосовых настроек: обычно можно позвать по имени. Агент слышит участников звонка, даже когда ждёт обращения.
Статусы и субтитры помогают понять, слушает ли агент, думает или отвечает. Эти временные сообщения интерфейса не заменяют историю личного чата или включённую запись группы.
Что сохраняется и где
Встроенная запись группового звонка — это текстовая расшифровка. Её может включить владелец или администратор группы, когда агент подключён к звонку: кнопкой записи или голосовой командой агенту.
VoiceRoom показывает индикатор записи и отправляет объявление через агента. Эти сигналы относятся к встроенной функции; приложение не контролирует сторонние средства записи участников.
- Чат с агентом и реплики личных звонков
- Хранятся на сервере VoiceRoom. Сообщения также передаются настроенному агенту и могут обрабатываться его моделью или инструментами.
- Текст записи группового звонка
- Мост сохраняет файл на компьютере владельца агента. Сервер VoiceRoom хранит сведения о записи; эти служебные записи очищаются по сроку хранения в 30 дней.
- Звук звонка
- Передаётся участникам через сервер связи. Встроенная текстовая запись не создаёт аудиофайл. Речевые провайдеры и сторонние приложения работают по собственным правилам.
Кто получает данные разговора
Учитывайте отдельно сервер VoiceRoom, передачу звонка, речевой сервис и модель агента. Если попросить агента пересказать запись, содержание может попасть в его запрос к модели и в ответ в чате.
У агента в истории сохраняются завершённые озвученные фразы; перебивания и ошибки помечаются. Незавершённый фрагмент не выдаётся за точную расшифровку. При временном сбое доставки текст остаётся на компьютере агента для повторной отправки. Завершение публикации звука не доказывает, что другой участник его услышал.
Вернитесь к прошлому разговору
Историю личного общения ищите в чате с агентом. Для локального Hermes установщик добавляет инструмент чтения групповых расшифровок и инструкцию работы с ними. Укажите дату и запись: агент читает выбранную сессию целиком для поиска решений, а при неполном чтении должен сообщить об ограничении. Распознавание может ошибаться; имя общего микрофона не позволяет различить людей рядом с ним.
Что ещё можно поручить
Поиск, работа с файлами и напоминания зависят от подключённого агента и выданных ему разрешений. Ветки в чате помогают отделить разные темы. Для напоминаний агент должен оставаться доступным, а для уведомлений вне приложения нужны разрешения устройства.
Настройте под себя
В настройках агента в VoiceRoom проверьте имя, возможности и подключение. Модель, характер, память и доступ к инструментам настройте в самом рантайме. Для Hermes используйте документацию установленной версии.
Для самостоятельной настройки локальной речи
Явные адреса задаются параметрами VOICE_STT_URL и VOICE_TTS_URL в окружении моста или файле ~/.voiceroom/voice.json. После изменения файла перезапустите мост. Речевые службы должны поддерживать следующий контракт:
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. После изменения настроек повторите проверку голоса в приложении.
Установщики для существующего подключения
Если мост уже подключён, можно отдельно скачать установщик речи и пакет инструмента Hermes. Для речи запустите python3 setup-speech.py --mode local --prepare --apply; для Hermes распакуйте архив и запустите python3 scripts/install-hermes-tools.py. Перед перезапуском завершите активные звонки и задачи. Облачный режим речи требует отдельно настроенного ключа и адреса провайдера.
Если что-то не работает
Агент не в сети
Проверьте питание и интернет компьютера, затем службу моста и сам рантайм. Откройте существующее подключение в мастере и повторите шаг, на котором возникла ошибка.
Чат работает, а голос — нет
Проверьте обе речевые службы или ключ провайдера. Убедитесь, что включена голосовая возможность агента. Откройте инструкцию по голосу и повторите звонок после проверки статуса.
Агента не видно в группе
Личным агентом делится его владелец. Проверьте список агентов группы и свои права. Для группового чата нужен агент с поддержкой чата, для звонка — с поддержкой голоса.
Ответ или уведомление не пришли
Посмотрите статус агента и ошибку в чате. Проверьте доступность модели и разрешения уведомлений. Запущенная задача или таймер зависят от работы самого агента.