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

OpenHands + TokenTool

Запустите OpenHands (ex-OpenDevin) через Docker и подключите модели TokenTool для автономной разработки.

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

Base URL

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

API Key

sk-tt-xxxxxxx— в личном кабинете
1

Установить Docker

OpenHands запускается через Docker. Если Docker уже установлен — перейди к шагу 2.

  • macOS и Windows: скачай Docker Desktop с docker.com → Download Docker Desktop. Установи, запусти — дождись зелёного статуса «Docker Desktop is running».
  • Windows: может потребоваться включить WSL2 — Docker Desktop подскажет и предложит установить автоматически.
  • Linux: установи через пакетный менеджер или по инструкции на docs.docker.com.

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

bash
docker --version
2

Скачать и запустить OpenHands

Запусти OpenHands одной командой:

bash
docker run -it --rm \
  -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.38-nikolaik \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -p 3000:3000 \
  --add-host host.docker.internal:host-gateway \
  --name openhands-app \
  docker.all-hands.dev/all-hands-ai/openhands:0.38

При первом запуске Docker скачает образы — это займёт несколько минут (около 2–3 ГБ). Последующие запуски будут быстрыми.

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

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

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

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

text
http://127.0.0.1:3000

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

💡 Не закрывай терминал с Docker — OpenHands работает, пока контейнер запущен. Для фонового запуска убери флаг -it и добавь -d.
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:    anthropic/claude-3-5-sonnet
  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 за пару минут.