OpenHands: как подключить свою модель (Custom Model)

Что такое OpenHands

OpenHands — автономный ИИ-инженер: пишет код, ходит в веб, вызывает API и выполняет команды в изолированной песочнице. При self-host полностью бесплатен; модель подключается своя — с ключом LLMost агент работает на любой модели каталога.

Требования

Docker
Linux, macOS или Windows (WSL2)
Аккаунт LLMost с API-ключом

Установка

Разверните OpenHands по официальному Docker-квикстарту — это одна команда docker run (её актуальная версия с нужными тегами образов — в доках). После запуска откройте http://localhost:3000.

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

Создайте ключ на странице Ключи API (формат llmost_...).
В OpenHands откройте Settings → секция LLM и включите режим Advanced.
Заполните поля:
- Custom Model:
```
openai/~anthropic/claude-sonnet-latest
```
  Формат именно такой: префикс openai/ говорит движку LiteLLM «это OpenAI-совместимый endpoint», а дальше идёт полный слаг модели LLMost. Если слаг сам начинается с openai/ (например openai/gpt-5.2-20251211), получится двойной префикс openai/openai/... — это не опечатка.
- Base URL:
```
https://llmost.ru/api/v1
```
- API Key: ваш ключ llmost_...
Сохраните настройки и создайте новую задачу.

Выбор модели

OpenHands — «тяжёлый» агент: длинные сессии, много инструментов. Модель должна поддерживать tool calling и большой контекст; слабые модели здесь разочаруют:

openai/~anthropic/claude-sonnet-latest — лучший выбор, контекст 1 млн токенов;
openai/~openai/gpt-latest — флагманская альтернатива (да, двойной openai/);
openai/~moonshotai/kimi-latest — дешевле при хорошем агентном качестве.

Слаги моделей — в каталоге LLMost; в поле Custom Model к ним всегда добавляется префикс openai/.

Проверка

Создайте задачу: «Создай файл hello.txt с текстом Привет». Агент развернёт песочницу и выполнит задачу — значит, всё работает.

Чтобы проверить endpoint в обход OpenHands, выполните запрос напрямую:

curl https://llmost.ru/api/v1/chat/completions \
  -H "Authorization: Bearer llmost_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "~google/gemini-flash-latest",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Частые проблемы

Ошибка «LLM provider not recognized» или похожая. Проверьте формат Custom Model: он должен начинаться с openai/, дальше — полный слаг LLMost.

Ошибка 401. Ключ скопирован не полностью или удалён. Создайте новый на странице Ключи API.

Ошибка 402 «Недостаточно средств». OpenHands расходует много токенов — проверьте баланс и пополните его в личном кабинете.

Агент путается и бросает задачи. Слабой модели не хватает контекста или агентных способностей — переключитесь на ~anthropic/claude-sonnet-latest.

Настройки не применяются. После смены модели создайте новую задачу — текущая сессия продолжает работать на старых настройках.

Ссылки

Документация: docs.all-hands.dev
GitHub: All-Hands-AI/OpenHands
Другие приложения — в каталоге ИИ-агентов

OpenHands + LLMost: установка и настройка