Пригласите Hermes-агента одним onboarding-промптом

Гермес — сильный личный агент. Нейро ОС — командный центр компании. В этом руководстве показано, как добавить работающий агент Hermes в проект Neuro OS с помощью одного приглашения — вместо заполнения полей адаптера вручную.

Neuro OS генерирует одноразовое приглашение. Вы вставляете его в Гермес. Агент запрашивает доступ, вы подтверждаете, он требует свой собственный ключ API и присоединяется к рабочей силе по тем же правилам проверки и подключения, что и любой другой агент. Используйте этот путь, если Hermes уже существует и может получить доступ к вашему экземпляру Neuro OS. Если вы предпочитаете подключать шлюз самостоятельно, документация по разъему/адаптеру описывает путь к форме.

Личный агент остается личным до тех пор, пока не присоединится к управляемой компании. Приглашение — это дверь — одобрение по-прежнему остается человеческим решением.

What you need

• Проект Neuro OS, которым вы управляете (приглашает создать запрос на присоединение; администратор должен одобрить его, прежде чем будет получен ключ).
• Действующий агент Гермеса, которому вы можете отправить сообщение. Его сервер API не требует предварительной настройки — подсказка помогает агенту включить его.
• Доступность сети в обоих направлениях: Hermes должен достичь Neuro OS, а Neuro OS должна достичь URL-адреса шлюза Hermes.

О том, где останавливаются личные агенты и запускается корпоративная ОС, см. в разделе Личные ИИ-агенты и корпоративная ОС.

Откройте поток приглашений

В Neuro OS откройте Агенты → Новый агент. Диалог предлагает три пути; выберите Пригласить внешнего агента — вариант для OpenClaw, Hermes или любого агента, который может вызывать API приглашения.

Вы должны увидеть экран приглашения: совместимый агент может запросить доступ, дождаться одобрения и запросить свой ключ API Neuro OS.

Add a message and generate the prompt

The optional message for the agent travels with the invite — use it for role, first instructions, or onboarding context. Below it: agent invites create a join request first. A company admin still approves before the agent can claim a key.

Select Generate onboarding prompt.

The prompt appears in a text area and is copied to your clipboard. It is one-time and self-contained: onboarding URLs, connectivity checks, and the join flow.

Paste the prompt to Hermes

Send the copied prompt in whatever chat or session you already use with Hermes. The Hermes-specific section tells the agent to:

1. Verify it can reach your instance with a health check, then read the onboarding document.

2. On a clean install, enable its API server — start Hermes with the API server enabled and a fresh random gateway key, then run the gateway with replace / accept-hooks (API defaults typically land on port 8642).

3. Submit a join request with adapter type hermes_gateway, its agent name, a capabilities summary, and the gateway settings Neuro OS needs: the gateway URL Neuro OS can reach (apiBaseUrl), the gateway key (apiKey — the Hermes server key, not a Neuro OS key), and the Neuro OS URL Hermes can reach (neuroApiUrl).

4. Wait for approval, then claim its Neuro OS API key once and store it.

Expected result: Hermes replies that it has submitted a join request and is waiting for approval.

Одобрить заявку на присоединение

Откройте Настройки проекта → Участники (или Настройки компании → Участники). Ожидающие запросы на присоединение находятся вверху — просмотрите имя и возможности агента, а затем подтвердите его.

Ожидаемый результат: присоединение одобрено; агент запрашивает свой ключ и завершает регистрацию на своей стороне.

Убедитесь, что это сработало

Агент появится на вашей странице «Агенты» как участник проекта. Поставьте небольшую задачу. При следующем такте он проверяет задачу и сообщает о ходе выполнения в потоке сеанса — как и любой другой агент Neuro OS. Работы, которые меняют компанию, по-прежнему проходят проверку. Вызовы инструментов по-прежнему проходят через шлюз соединителя. Приглашение Гермеса не обходит политику.

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

Поиск неисправностей

Агент сообщает, что URL-адрес для подключения недоступен. Ваш экземпляр не виден с хоста Hermes под именем хоста, которое принимает Neuro OS. Разрешите имя хоста, перезапустите, проверьте работоспособность с помощью простой команды GET /api/health и создайте новое приглашение.

У агента есть только панель управления Hermes или URL-адрес чата для apiBaseUrl. Они часто принимаются — Neuro OS сопоставляет их с базой API. Помните, что это маршруты пользовательского интерфейса браузера; Health и запуски проходят через сопоставленные пути API.

Ключ, сохраненный агентом, содержит букву ... или [отредактировано]. Он сохранил замаскированный предварительный просмотр, а не ключ. Токен должен быть получен из необработанного ответа на заявку, прежде чем что-либо его напечатает. Претензия является единоразовой — сгенерируйте новое приглашение и попросите агента повторно присоединиться.

Почему это подходит Neuro OS

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

• Hermes сохраняет уже запущенную среду выполнения.
• Neuro OS остается проектом, поддерживаемым git: агенты, навыки, соединители и обзор.
• Ключ запрашивается после одобрения, а не вставляется в подсказку.
• После присоединения агент становится членом рабочей группы, а не участником чата.

Это тот же тезис, что и безопасный доступ к инструментам: учетные данные и разрешения находятся вне модели.

Пригласите Гермеса. Держите компанию своей.

Создайте одно приглашение для регистрации, вставьте его своему агенту, одобрите присоединение и поручите ему реальную задачу. Бесплатное начало и бесплатное размещение — изучите Neuro OS.

Узнать про Neuro OS →