OpenClaw

OpenClaw — open-source платформа для AI-ассистента в мессенджерах. Поднимает локальный gateway, маршрутизирует сообщения из Telegram, WhatsApp, Discord, Slack к LLM-провайдеру. Hubris подключается как custom provider через OpenAI-совместимый API.

Требования

• Установленный OpenClaw (см. инструкцию по установке)
• Node.js 22+
• Аккаунт на hubris.pw и API-ключ

Подключение к Hubris

Конфиг OpenClaw — ~/.openclaw/openclaw.json (JSON5, поддерживает комментарии и trailing commas).

Откройте файл:

nano ~/.openclaw/openclaw.json

или через встроенный инструмент:

openclaw configure

В секции models.providers добавьте провайдер hubris:

{
  models: {
    mode: "merge",
    providers: {
      hubris: {
        baseUrl: "https://api.hubris.pw/v1",
        apiKey: "${HUBRIS_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "anthropic/claude-haiku-4.5", name: "Claude Haiku" },
          { id: "openai/gpt-4o-mini",         name: "GPT-4o mini" },
          { id: "google/gemini-2.0-flash",    name: "Gemini Flash" },
        ],
      },
    },
  },
}

Поле api: "openai-completions" обязательно — без него OpenClaw не определит тип API.

Ключ положите в ~/.openclaw/.env:

HUBRIS_API_KEY=sk-gw-...

Модель по умолчанию

В секции agents.defaults укажите основную модель и опционально fallback'и:

{
  agents: {
    defaults: {
      model: {
        primary: "hubris/anthropic/claude-haiku-4.5",
        fallbacks: ["hubris/openai/gpt-4o-mini"],
      },
      models: {
        "hubris/anthropic/claude-haiku-4.5": { alias: "Claude" },
        "hubris/openai/gpt-4o-mini":         { alias: "GPT" },
        "hubris/google/gemini-2.0-flash":    { alias: "Gemini" },
      },
    },
  },
}

Формат ссылки: <provider>/<model-id>, где <provider> — имя из секции providers (у нас hubris).

Применение конфига

Если включён hot-reload (по умолчанию) — изменения подхватятся автоматически. Если нет:

openclaw gateway restart

Переключение моделей в чате

Прямо в любом канале:

/model hubris/openai/gpt-4o-mini

Или через CLI:

openclaw models set hubris/google/gemini-2.0-flash

Список доступных:

openclaw models list

Подключение каналов

В channels секции укажите параметры мессенджеров. Пример для Telegram:

{
  channels: {
    telegram: {
      dmPolicy: "allowlist",
      botToken: "<токен бота от @BotFather>",
      allowFrom: ["<ваш Telegram ID>"],
      groupPolicy: "allowlist",
    },
  },
  plugins: {
    entries: {
      telegram: { enabled: true },
    },
  },
}

Аналогично для WhatsApp, Discord, Slack — детали в документации OpenClaw.

Рекомендуемые модели

OpenClaw как чат-агент в мессенджерах хорошо работает на быстрых моделях. Для агентного сценария с инструментами — более крупная модель из каталога.

Полный список — в каталоге моделей.

Решение проблем

'No API provider registered for api: undefined'

В секции провайдера должно быть поле api: "openai-completions" — без него OpenClaw не понимает тип API.

Invalid API key (401)

• Проверьте формат ключа (sk-gw- + hex).
• Если используете ${HUBRIS_API_KEY}, убедитесь, что переменная действительно установлена в ~/.openclaw/.env.

Модель не находится

• Проверьте, что ID в models[] точно совпадает с одним из каталога.
• Проверьте, что та же модель есть в agents.defaults.models — это allowlist.
• Формат: hubris/<model-id>.

Gateway не запускается после правки конфига

OpenClaw строго валидирует конфиг:

openclaw doctor
openclaw doctor --fix

Медленные ответы

• Переключитесь на более быструю модель — Haiku или Flash.
• В настройках канала включите streamMode: "partial" для стриминговых ответов.

Что дальше

• Каталог моделей — список ID для конфига.
• Управление API-ключами — отдельный ключ под OpenClaw.
• Расходы — детализация сессий.
• Hermes Agent — альтернативный агент с Telegram.

Обновлено: 22 мая 2026 г.