SimpleClaw

Руководства

Подключить Hermes

Подключение Hermes Agent через OpenAI-совместимый Custom Endpoint.

Перед началом

Установите Hermes Agent по официальной инструкции Hermes, создайте отдельный API-ключ в кабинете и выберите в каталоге включённую модель с протоколом chat_completions. Для запросов нужен Provider-доступ или предоплаченный баланс.

Hermes подключается к Simple Claw как к Custom Endpoint через OpenAI-совместимый Chat Completions. Базовый адрес — https://simple-claw.ru/v1.

Настройка через Hermes

  1. Выйдите из текущей сессии Hermes и запустите в терминале hermes model.
  2. Выберите Custom endpoint. Укажите базовый адрес https://simple-claw.ru/v1, ключ Simple Claw в интерактивном запросе и точный ID модели из каталога.
  3. Если мастер спрашивает режим API, выберите Chat Completions. Перед новым чатом проверьте, что сохранились выбранный endpoint и модель.

Настройки Hermes сохраняются в его личном профиле ~/.hermes/config.yaml. Не помещайте ключ в репозиторий или общий файл настроек.

Конфигурация без ключа в YAML

Если ключ уже доступен Hermes через переменную окружения SIMPLECLAW_API_KEY, можно описать отдельного провайдера в ~/.hermes/config.yaml. Замените model-id-from-catalog на точный публичный ID модели. Само значение ключа в YAML не записывайте.

providers:
  simpleclaw:
    api: https://simple-claw.ru/v1
    key_env: SIMPLECLAW_API_KEY
    transport: chat_completions
model:
  provider: custom:simpleclaw
  default: model-id-from-catalog

Для постоянной настройки Hermes читает переменные из личного ~/.hermes/.env; ограничьте доступ к файлу владельцем.

Проверка и ограничения

Запустите новый сеанс hermes, выберите модель, отправьте короткое текстовое сообщение и проверьте его расход в кабинете Simple Claw. Один выбор модели без ответа не подтверждает доступность upstream. Hermes может отправлять дополнительные служебные запросы, поэтому до повторного запуска проверьте историю.

Simple Claw принимает текст и function tools через /v1/chat/completions. Изображения, аудио, видео и hosted tools этим подключением не обещаются; отдельные функции Hermes, которым они нужны, могут быть недоступны.

Подключить Hermes — документация SimpleClaw