TokenTool
АгентDockerАвтономный

OpenHands + TokenTool

Запустите OpenHands в локальной среде и подключите модели TokenTool через API key, Base URL и Model ID.

Параметры подключения

Base URL

https://api.tokentool.ru/api/v1

API Key

не хранить в коде— env или хранилище credential приложения
1

Установить Docker

Для локальной среды OpenHands нужен Docker. На Windows официальный путь также требует WSL 2.

  • →macOS и Windows: скачай Docker Desktop с docker.com → Download Docker Desktop. Установи, запусти — дождись зелёного статуса «Docker Desktop is running».
  • →Windows: выполни wsl --version в PowerShell и проверь, что Default Version равен 2. Команды OpenHands дальше запускай внутри WSL.
  • →Linux: установи через пакетный менеджер или по инструкции на docs.docker.com.

Проверь в терминале:

bash
docker --version
2

Установить и запустить OpenHands

Официальная документация рекомендует установку через uv. Если uv ещё нет, установи его по инструкции на docs.astral.sh.

bash
uv tool install openhands --python 3.12
openhands serve

Первый запуск дольше следующих: OpenHands подготовит приложение и рабочую среду агента.

Дождись сообщения в терминале:

text
OpenHands is running at http://127.0.0.1:3000
3

Открыть веб-интерфейс

Пока контейнер запущен — открой браузер и перейди по адресу:

text
http://127.0.0.1:3000

Должен появиться интерфейс OpenHands — чат слева, терминал и файловый менеджер справа. Это и есть панель управления агентом.

💡 Не закрывай терминал, где работает openhands serve. Остановить локальный сервер можно сочетанием Ctrl+C.
4

Настроить TokenTool как провайдер

В интерфейсе OpenHands:

  1. 1Нажми на шестерёнку ⚙️ в правом верхнем углу.
  2. 2Выбери раздел «LLM» или «Model Settings».
  3. 3Заполни поля:
text
LLM Provider: OpenAI (или Custom)
LLM API Key:  sk-tt-ваш-ключ
LLM Base URL: https://api.tokentool.ru/api/v1
LLM Model:    <MODEL_ID_ИЗ_КАТАЛОГА>

Выбери доступную текстовую модель в актуальном каталоге.

  1. 4Нажми «Save».
⚠️ Ключ получи в личном кабинете TokenTool → «Мои ключи». Ключ начинается с sk-tt-.
5

Проверка — дать первую задачу

Создай новый проект в UI (кнопка «+» или «New Project»).

Напиши задачу:

text
Создай простое Flask-приложение с одним роутом /hello, который возвращает "Hello, World!"

OpenHands начнёт работать автономно: создавать файлы, устанавливать зависимости, запускать код и исправлять ошибки. Ты видишь каждый шаг в реальном времени в панели справа.

Если агент активен и выполняет действия — подключение настроено правильно ✓

Частые ошибки:

  • ✗Агент не отвечает — проверь настройки LLM, убедись что ключ и URL введены правильно.
  • ✗127.0.0.1:3000 не открывается — проверь что Docker контейнер запущен в терминале.
  • ✗«Docker not running» — убедись что Docker Desktop запущен (иконка кита в трее).

Готово к работе?

Зарегистрируйтесь на TokenTool, получите API-ключ и подключите OpenHands + TokenTool за пару минут.

Получить API-ключ TokenTool →← Все инструкции