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

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

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

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

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

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

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

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

Для подключения с компьютера понадобится установленный и настроенный агент. Мастер можно открыть и на телефоне — команду выполняйте на компьютере, где работает агент.

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

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

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

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

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

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

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

Добавьте голос

Текстовый чат и голос настраиваются отдельно. Для звонка агенту нужны и распознавание речи, и синтез голоса. В разделе «Агенты» откройте инструкцию по настройке голоса.

Речевой провайдер

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

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

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

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

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

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

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

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

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

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

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

For a computer connection, have your agent installed and configured first. You can open the wizard on a phone; run its command on the computer that hosts the agent.

  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.

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

Run compatible recognition and synthesis services on the agent’s computer. The bridge can discover them on ports 8090 and 8091. Speech processing is local, but the call still uses the media server and the agent’s model may be cloud-hosted.

Check the voice status beside the agent. If a call cannot start, read its error message to identify the component that still needs attention.

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.

Return to a past conversation

Find personal conversation history in the agent chat. For group transcripts, the agent needs access to the recording files. Ask it to find a decision or prepare a summary; results depend on the available records and tools.

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. 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.

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.