Пользовательская настройка LLM OpenHands

Добавьте пользовательскую OpenAI-совместимую модель TokenHub в дополнительные настройки LLM OpenHands и подтвердите новый разговор.

Создать ключ API TokenHub

Что такое ОпенХандс?

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

Эта настройка OpenHands сохраняет профиль LLM, поддерживаемый TokenHub, через дополнительные настройки LLM. Используйте имя модели LiteLLM с префиксом OpenAI и подтвердите задачу, доступную только для чтения, в новом диалоге, прежде чем разрешать изменения. OpenHands маршрутизирует пользовательские модели через LiteLLM, поэтому значение Custom Model включает префикс поставщика OpenAI, а также точный идентификатор модели TokenHub. Сохраненные настройки LLM не могут заменить профиль существующего разговора, поэтому создайте новый сеанс и проверьте чтение репозитория, прежде чем разрешать изменения в терминале или файле.

OpenHands разрешает пользовательские модели через LiteLLM. Важным шагом является не просто выбор «OpenAI», но и ввод квалифицированного поставщиком Custom Model в официальный Advanced LLM Settings. Для TokenHub используйте openai/YOUR_TOKENHUB_MODEL_ID.

Откройте дополнительные настройки LLM.

  1. Откройте LLM Settings в OpenHands.
  2. Включите Advanced. Официальные поля Custom Model, Base URL и API Key появляются только в расширенных настройках.
  3. Введите openai/YOUR_TOKENHUB_MODEL_ID в Custom Model.
  4. Введите https://us-api.tokenhub.com/v1 в Base URL.
  5. Введите свой ключ TokenHub API в API Key.
  6. Нажмите Save Changes.

Префикс openai/ сообщает LiteLLM использовать маршрут OpenAI-compatible. Идентификатор модели, отправленный в TokenHub, по-прежнему представляет собой значение после косой черты. Простой идентификатор не дает достоверной информации OpenHands, какой поставщик LiteLLM использовать.

Начать новый разговор после сохранения

OpenHands документирует, что настройки LLM применяются к new conversations по умолчанию. Перезапустите существующий диалог, если он должен использовать новую модель. Для первого теста соединения создайте новый диалог, чтобы старый профиль LLM не мог повлиять на результат.

Протестируйте новый диалог в следующем порядке:

  1. Попросите OpenHands прочитать и объяснить один файл, не изменяя его.
  2. Проверьте идентификатор модели, код состояния и путь /v1/chat/completions в журналах TokenHub.
  3. Затем попросите его выполнить одну явную обратимую команду редактирования файла или терминала.

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

Устранение неполадок поле за полем

  • Model not found или ошибка маршрутизации LiteLLM: подтвердите, что Custom Model — это openai/EXACT_MODEL_ID.
  • 401: сохраните API Key еще раз и не добавляйте префикс Bearer .
  • 404: Base URL должен заканчиваться на /v1, а не на /chat/completions.
  • Запросы по-прежнему используют старую модель: перезапустите этот разговор или создайте новый.
  • Текст работает, а инструменты — нет: выберите модель TokenHub с документированным вызовом встроенных функций.

Официальная ссылка

Как выбрать модель

НагрузкаВыбор моделиПочему подходит
Сложные задачиМодель рассуждений с инструментамиПодходит для планирования, многошаговых задач и длинного контекста.
Ежедневная работаСбалансированная модельБаланс качества, скорости и стоимости.
Сводки и лёгкие задачиБыстрая недорогая модельСнижает стоимость сводок и простых итераций.
Открыть модели TokenHub

Часто задаваемые вопросы по OpenHands LLM

Как мне настроить собственный LLM в OpenHands?

Откройте «Настройки» → LLM → «Дополнительно», установите для параметра «Пользовательская модель» значение openai/<идентификатор модели TokenHub>, затем введите базовый URL-адрес TokenHub /v1 и ключ API.

Почему модели OpenHands нужен префикс openai/?

OpenHands использует маршрутизацию LiteLLM. Префикс сообщает LiteLLM о необходимости отправить точный следующий идентификатор модели через транспорт, совместимый с OpenAI.

Почему существующий диалог OpenHands сохранил старую модель?

Сохраненные настройки LLM не могут заменить существующий профиль беседы. Начните или перезапустите разговор и проверьте активный профиль LLM.

Какие модели подходят для OpenHands?

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

Как мне безопасно протестировать OpenHands?

Используйте тестовый репозиторий и начните с объяснения или поиска, доступного только для чтения. Проверьте журналы TokenHub, а затем постепенно разрешите изменения файлов и команд.

Источники

Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-08。

Сравните настройку и совместимость моделей похожих инструментов.

Claude CodeAnthropic CompatibleCodexOpenAI CompatibleQwen CodeOpenAI CompatibleZCodeOpenAI / Anthropic