Прямой доступ автономного ИИ-агента к оболочке рабочей станции разработчика способен сломать локальные инструменты сразу нескольких репозиториев после одной неудачной установки пакета. В рамках трендов экосистемы открытых ИИ-агентов ноября 2026 года команды, создающие промышленные решения искусственного интеллекта, выбирают OpenHands, поскольку контейнерная изоляция лежит в основе его исполнения.
Что такое OpenHands? OpenHands (эволюция проектов OpenDevin и All-Hands-AI) — вендор-независимая открытая платформа автономной разработки ПО под лицензией MIT. В изолированных песочницах Docker или Kubernetes агент редактирует множество файлов репозитория, устанавливает зависимости, запускает модульные и интеграционные тесты и итеративно устраняет сбои до прохождения проверок без риска для хостовой ОС.
Важно
Краткое резюме — архитектурные опоры OpenHands
- Лицензия MIT без привязки к вендору: Платформа, Software Agent SDK, CLI и контур оценки открыты под лицензией MIT и работают с коммерческими API и локальными моделями.
- Изолированные правки и автономные тесты: Docker Runtime по умолчанию и Kubernetes Remote Runtime изолируют изменения файлов, зависимости и тестовые прогоны в эфемерных контейнерах.
- Модульный V1 SDK и контроль: Детерминированный
EventStream, политики (AlwaysConfirm,ConfirmRisky,NeverConfirm),--llm-approve, Microagents и нативный MCP с OAuth.
Модульная архитектура OpenHands V1 и EventStream
OpenHands перешла к разделенной архитектуре V1 в основном репозитории OpenHands и Software Agent SDK, объединив веб-среду и headless-конвейеры CI на одном ядре.
Разделение пакетов V1
openhands.sdk: СодержитLLM,Agent,Conversation,Eventи политики безопасности. Совместимость с LiteLLM позволяет менять провайдера через переменные окружения без правки кода.openhands.tools: Типизированные инструменты —TerminalToolдля оболочки,FileEditorToolдля точных многофайловых патчей иTaskTrackerToolдля планирования этапов.openhands.workspace: Абстрагирует границу между локальной папкой, эфемерным контейнером Docker и удаленной средой.openhands.agent_server: Предоставляет REST и WebSocket API для браузерного Agent Canvas и OpenHands CLI.
Детерминированный журнал EventStream
Вместо неструктурированной переписки OpenHands записывает каждый шаг планирования, команду оболочки, патч файла и вывод ошибок тестов в упорядоченный поток EventStream. Сервер openhands.agent_server транслирует эти события по WebSocket в браузерный интерфейс Agent Canvas и консольный клиент CLI, позволяя инженерам наблюдать изменения диффов и потоки stdout/stderr в реальном времени без прямого подключения к оболочке контейнера. С флагом LOG_ALL_EVENTS=true платформенные команды получают воспроизводимый разбор сбоев при остановке задачи, проверяемый аудиторский след для служб информационной безопасности и надежное возобновление длительных миграций после обрыва связи.
Многофайловые изменения в песочнице и цикл тестирования
Промышленные исправления и новые серверные функции почти всегда затрагивают схемы базы данных, сервисный слой, маршруты API и набор фикстур одновременно. OpenHands решает эту задачу, объединяя согласованную правку нескольких файлов с жесткой контейнерной изоляцией.
Docker Runtime, Kubernetes Remote Runtime и Local Runtime
По умолчанию Docker Runtime поднимает чистый эфемерный контейнер на каждую сессию, полностью изолируя установку библиотек, компиляцию и тестовые серверы внутри пространств имен контейнера; после закрытия сессии контейнер удаляется, а хост остается нетронутым. Для масштабных CI-конвейеров, массового обновления репозиториев и параллельных прогонов оценки Remote Runtime разворачивает изолированные поды Kubernetes, исключая конкуренцию за локальные блокировки и ресурсы. Для легких правок в заранее подготовленной локальной папке предусмотрен явный режим Local Runtime.
Замкнутая верификация до зеленых тестов
Внутри песочницы агент декомпозирует задачу через TaskTrackerTool, синхронно обновляет связанные модули через FileEditorTool, устанавливает недостающие зависимости проекта и запускает модульные и интеграционные тесты через TerminalTool. При падении проверок агент считывает трассировку стека и сообщения компилятора из EventStream, определяет первопричину в основном коде или тестовом сценарии, применяет новый патч и повторяет прогон до полного зеленого статуса. В заказной разработке программного обеспечения этот замкнутый цикл закрывает долг по тестам, ускоряет обновление фреймворков и формирует pull request с воспроизводимым протоколом прохождения проверок.
Установка, headless CLI, Docker-песочница и Python SDK
Полный справочник доступен на docs.openhands.dev и openhands.dev. Поддерживаются три способа запуска: CLI, Docker или Python V1 SDK.
Установка CLI, автономный режим и команды MCP
Установите CLI через uv на Python 3.12 (или pip install openhands-ai), запустите Agent Canvas с --mount-cwd (опционально --gpu), выполняйте headless-задачи с --llm-approve и управляйте MCP:
uv tool install openhands --python 3.12
openhands serve --mount-cwd
openhands --headless --llm-approve \
--task "Исправить гонку при обновлении токена в auth-сервисе и пройти pytest"
openhands mcp add internal-docs --url https://mcp.example.internal/sse
openhands mcp list
Запуск изолированной песочницы в Docker
Развертывание приложения с образом agent-server и полным логированием событий:
docker run -it --rm --pull=always \
-e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
-e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.openhands:/.openhands \
-v $(pwd):/workspace:rw \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-app \
docker.openhands.dev/openhands/openhands:1.8
Предупреждение
Привилегии Docker-сокета: Монтирование /var/run/docker.sock позволяет запускать соседние sandbox-контейнеры с правами управления контейнерами на хосте. Не включайте NeverConfirm на рабочих станциях с боевыми ключами облака или личными SSH-ключами; изолируйте автономные запуски на защищенных CI-раннерах или в Kubernetes Remote Runtime.
Программная оркестрация на Python V1 SDK
Платформенные команды встраивают контуры ремонта кода напрямую через openhands.sdk:
import os
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.sdk.security.confirmation_policy import ConfirmRisky
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool
llm = LLM(
model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-5-20250929"),
api_key=os.getenv("LLM_API_KEY"),
base_url=os.getenv("LLM_BASE_URL"),
)
agent = Agent(
llm=llm,
tools=[
Tool(name=TerminalTool.name),
Tool(name=FileEditorTool.name),
Tool(name=TaskTrackerTool.name),
],
)
conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.set_confirmation_policy(ConfirmRisky())
conversation.send_message(
"Исправить округление копеек в биллинге и подтвердить все unit-тесты."
)
conversation.run()
Политики безопасности, Microagents и поддержка MCP
Контейнер защищает хост, а политики контролируют допустимые команды и соблюдение стандартов репозитория.
Политики подтверждения и LLM-анализатор
AlwaysConfirm: Требует явного подтверждения перед каждой командой и правкой файла.ConfirmRisky: Сбалансированный режим по умолчанию; безопасные чтения и тесты идут без пауз, рискованные команды ждут одобрения.NeverConfirm: Полностью непрерывная работа только для эфемерных CI-песочниц с ограниченными правами.
Флаг --llm-approve подключает LLM-анализатор безопасности, который до исполнения оценивает семантику команды и блокирует деструктивное удаление, утечки секретов и сторонние скрипты.
Microagents и нативный MCP с OAuth
Архитектурные регламенты, ограничения миграций баз данных и требования к код-ревью фиксируются как Microagents в формате Markdown с YAML-заголовком (name, trigger_type, keywords) в каталоге ~/.openhands/microagents/ при полной совместимости с переносимой структурой .agents/skills/. При совпадении путей файлов или ключевых слов микроагент автоматически подгружает стандарты репозитория в контекст без ручного повторения инструкций в каждом промпте. Нативный MCP (openhands mcp add, openhands mcp list) поддерживает внешние и корпоративные серверы инструментов с OAuth-аутентификацией. Для анализа бинарных файлов и закрытых протоколов инструменты из руководства по архитектуре REA (Reverse Engineer Anything) MCP подключаются напрямую к сессии OpenHands, позволяя переводить находки реверс-инжиниринга в протестированный исходный код внутри одной изолированной песочницы.
Совет
Совет по внедрению: Начинайте работу с новым репозиторием в связке ConfirmRisky + --llm-approve и версионируйте Microagents в Git. Разбор EventStream после первого спринта позволит точно настроить пороги перед переходом к headless CI.
Архитектурное сравнение: OpenHands, OpenCode, Goose и закрытые агенты
| Критерий | OpenHands | OpenCode | Goose | Закрытые облачные / IDE-агенты |
|---|---|---|---|---|
| Модель исполнения | Автономный цикл (Agent Canvas, CLI, Headless, Python V1 SDK) | Интерактивная нативная терминальная среда (TUI) | Десктоп, CLI и программируемые API-рецепты | Закрытый плагин IDE или облако вендора |
| Изоляция песочницы | Эфемерный Docker Runtime и Kubernetes Remote (+ Local) | Локальный каталог и оболочка разработчика | Локальная среда; контейнеры внешние | Зависит от вендора; облако или IDE |
| Многофайловые тесты | Зависимости, полные тесты и итеративные правки в контейнере | Интерактивные правки с терминальными тестами | Многошаговые цепочки через расширения и рецепты | Неоднородно; сборки часто ограничены |
| Привязка к модели | Нет — лицензия MIT, коммерческие и локальные модели LiteLLM | Нет — мультипровайдер и локальные эндпоинты | Нет — открытый код, гибкий выбор моделей | Высокая — привязка к моделям вендора |
| MCP и расширяемость | Нативный MCP (openhands mcp add, OAuth), Microagents, V1 SDK | Широкая поддержка серверов MCP и инструментов | Экосистема расширений MCP и YAML-рецепты | Только одобренные закрытые коннекторы |
Для быстрой интерактивной работы в терминале стоит изучить обзор открытого терминального ИИ-агента OpenCode, а для единых сценариев десктопа, CLI и API — руководство по открытому ИИ-агенту Goose. Когда критичны контейнерная изоляция, автономные многофайловые тесты и аудит EventStream в CI, OpenHands уверенно занимает свою нишу.
Корпоративное внедрение и практика Kling Digital
Переход от локальных экспериментов с OpenHands к промышленной инженерной платформе требует четырех обязательных контуров контроля:
- Фильтрация исходящего трафика (Egress): Ограничьте сетевой доступ sandbox-контейнеров только внутренними зеркалами пакетов и корпоративным LLM-шлюзом.
- Изоляция короткоживущих секретов: Храните ключи API и Git-токены вне примонтированной рабочей папки, выдавая временные токены с минимальными правами строго на активную ветку.
- Централизованное архивирование EventStream: Направляйте журналы
LOG_ALL_EVENTS=trueв неизменяемое хранилище наблюдаемости, чтобы каждый pull request сохранял полную историю выполнения. - Обязательный человеческий контроль и SAST: Рассматривайте зеленые тесты в песочнице как подтверждение работоспособности, а не право на слияние; каждое изменение должно проходить ревью инженером и статический анализ безопасности.
Kling Digital проектирует вендор-независимые песочницы автономной разработки, кластеры Kubernetes Remote Runtime и OAuth-интеграции MCP. Обсудите архитектуру OpenHands V1 с нашей командой на странице контакты Kling Digital.




