Руководство · Агенты

Ваш агент.
В чате и звонке.

Подключите своего ассистента, начните разговор и решите, к каким возможностям и данным у него будет доступ.

Как это устроено

VoiceRoom соединяет чат и звонки с настроенным вами агентом — например, Hermes или OpenClaw. Агент может работать на вашем компьютере или через подключённый сервер. Модель, инструменты и доступ к файлам зависят от его настройки.

Личный агент и агент в группе

Личный агент доступен владельцу. Владелец может поделиться им с группой — тогда участники получают к нему доступ для звонков. Создавать групповые чаты с агентом и писать в них могут владелец и администраторы группы.

Подключение в три шага

Сначала установите Hermes или другой агент и настройте его модель. Для автоматического установщика Volo нужны Node 22+ и npm. Мастер можно открыть и на телефоне — команду выполняйте на компьютере агента. Volo не устанавливает сам Hermes и не создаёт аккаунт у поставщика модели.

  1. Создайте подключение

    Откройте раздел «Агенты» в VoiceRoom, выберите подключение своего агента и задайте имя.

  2. Выберите компьютер

    Укажите macOS, Windows или Linux. Скопируйте команду из мастера в терминал этого компьютера. Она устанавливает мост, который поддерживает исходящее соединение с VoiceRoom. Для этого способа не нужно открывать входящие порты.

  3. Дождитесь подключения

    Продолжайте, когда мастер подтвердит связь. Сначала отправьте короткое сообщение в чат. Затем настройте речь для звонков или поделитесь агентом с группой.

Компьютер агента и нужные ему службы должны оставаться включёнными. Если настройка прервалась, вернитесь к этому агенту в мастере, чтобы повторить подключение.

На 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. Перед перезапуском завершите активные звонки и задачи. Облачный режим речи требует отдельно настроенного ключа и адреса провайдера.

Если что-то не работает

Агент не в сети

Проверьте питание и интернет компьютера, затем службу моста и сам рантайм. Откройте существующее подключение в мастере и повторите шаг, на котором возникла ошибка.

Чат работает, а голос — нет

Проверьте обе речевые службы или ключ провайдера. Убедитесь, что включена голосовая возможность агента. Откройте инструкцию по голосу и повторите звонок после проверки статуса.

Агента не видно в группе

Личным агентом делится его владелец. Проверьте список агентов группы и свои права. Для группового чата нужен агент с поддержкой чата, для звонка — с поддержкой голоса.

Ответ или уведомление не пришли

Посмотрите статус агента и ошибку в чате. Проверьте доступность модели и разрешения уведомлений. Запущенная задача или таймер зависят от работы самого агента.

Guide · Agents

Your agent.
In chat and on calls.

Connect your assistant, start a conversation, and choose which capabilities and data it can access.

How it works

VoiceRoom connects chat and calls to an agent you configure, such as Hermes or OpenClaw. The agent can run on your computer or through a connected server. Its model, tools and file access depend on your setup.

Personal agents and group access

A personal agent is available to its owner. The owner can share it with a group, allowing members to use it in calls. Group owners and administrators can create group agent chats and send messages in them.

Connect in three steps

Install Hermes or another agent and configure its model first. Volo’s automatic installer requires Node 22+ and npm. You can open the wizard on a phone; run its command on the agent’s computer. Volo does not install Hermes itself or create a model-provider account.

  1. Create a connection

    Open Agents in VoiceRoom, choose to connect your own agent, and give it a name.

  2. Choose the computer

    Select macOS, Windows or Linux. Copy the wizard’s command into that computer’s terminal. It installs a bridge that maintains an outbound connection to VoiceRoom. This connection method does not need incoming ports.

  3. Wait for confirmation

    Continue when the wizard confirms the connection. Start with a short chat message. Then set up speech for calls or share your agent with a group.

The agent’s computer and its services must stay on. If setup is interrupted, return to that agent in the wizard and retry the connection.

For detected local Hermes, the command also installs the recording reader. It restarts an idle Hermes; if tasks are active, it prints instructions for restarting later. Wait for the command to finish. A connected bridge and fully working capabilities are separate checks.

Add a voice

Text chat and voice are configured separately. Calls need both speech recognition and speech synthesis. Open the voice setup guide in the app’s Agents section.

Speech provider

Configure a supported speech API and its key on the agent’s computer. Your selected provider processes audio and text; its terms and pricing apply.

Local speech services

On macOS / Linux, select “Install local recognition and voice” in the wizard. Python 3.11 or 3.12 and git are required. The installer downloads models (over 1 GB), creates recognition and synthesis services and configures automatic startup. Leaving this option off preserves your existing speech setup. Windows speech services require manual setup.

After the command finishes, open agent diagnostics to check connection, model access, recognition, synthesis and pending delivery. Refresh stale reports. A localhost service can use cloud recognition: check the reported mode, not just the port. Model access does not guarantee answer quality; begin with a short test call.

Start a conversation

One on one

Open your personal agent chat and use the call button. Completed spoken turns appear in that chat’s history and are stored on the VoiceRoom server.

In a group

Invite an available agent to a voice channel. How you address it depends on its voice settings; calling it by name is a common option. The agent hears participants even while waiting to be addressed.

Status updates and captions show whether the agent is listening, thinking or speaking. These temporary interface messages are separate from personal chat history and an enabled group recording.

What is stored, and where

Built-in group call recording creates a text transcript. A group owner or administrator can start it while an agent is connected, using the recording control or a spoken command to the agent.

VoiceRoom displays a recording indicator and sends an announcement through the agent. These signals describe the built-in feature; the app cannot control participants’ external recording tools.

Agent chat and personal call turns
Stored on the VoiceRoom server. Messages also reach the configured agent and may be processed by its model or tools.
Group recording transcript
The bridge writes a file on the agent owner’s computer. The VoiceRoom server stores recording metadata, which is cleaned up under a 30-day retention period.
Call audio
Travels through the media server to participants. Built-in text recording does not create an audio file. Speech providers and external applications follow their own policies.

Where conversation data goes

Consider the VoiceRoom server, call transport, speech service and agent model separately. If you ask the agent to summarize a recording, its contents may enter a model request and the reply in chat.

Agent history contains completed spoken phrases; interruptions and errors are marked. An unfinished phrase is not presented as an exact transcript. Text remains on the agent’s computer for retry after a temporary delivery failure. Finishing audio publication does not prove that another participant heard it.

Return to a past conversation

Find personal history in the agent chat. For local Hermes, the installer adds a group-transcript reader and its instructions. Specify the date and recording: the agent reads the selected session completely when extracting decisions and must report incomplete coverage. Recognition can contain errors; a shared microphone name cannot identify individual people around it.

What else to ask for

Search, file tasks and reminders depend on the connected agent and its permissions. Chat threads keep topics separate. Reminders need the agent to remain available, and notifications outside the app need permission on your device.

Make it yours

Check the name, capabilities and connection in VoiceRoom’s agent settings. Configure the model, personality, memory and tool access in the agent’s runtime. For Hermes, use the documentation for your installed version.

For self-managed local speech

Set explicit endpoints with VOICE_STT_URL and VOICE_TTS_URL in the bridge environment or ~/.voiceroom/voice.json. Restart the bridge after changing that file. Speech services need to support this contract:

GET /health → JSON {"status":"ok"}
POST /stt   → PCM16LE, mono, 16 kHz → JSON {"text":"…"}
POST /tts   → UTF-8 text → PCM16LE, mono, 24 kHz

For a different synthesis rate, return rate in /health or configure VOICE_TTS_URL_RATE. Check voice readiness in the app again after changing the configuration.

Installers for an existing connection

If the bridge is already connected, download speech setup or the Hermes reader separately. For speech run python3 setup-speech.py --mode local --prepare --apply; for Hermes extract the archive and run python3 scripts/install-hermes-tools.py. Finish active calls and tasks before restarting. Cloud speech mode needs separately configured provider credentials and endpoint.

When something needs attention

The agent is offline

Check the computer’s power and internet connection, then the bridge service and agent runtime. Open the existing connection in the wizard and retry the step that failed.

Chat works, but voice does not

Check both speech services or the provider key. Make sure the agent has voice enabled. Open the voice guide and retry the call after checking readiness.

The agent is missing from a group

A personal agent must be shared by its owner. Check the group’s agent list and your permissions. Group chats need a chat-capable agent; calls need a voice-capable one.

A reply or notification did not arrive

Check the agent status and any chat error. Verify that the model is available and notifications are permitted. Background tasks and timers depend on the agent remaining operational.