OpenHands

OpenHands（前身 OpenDevin）作为全球领先的开源自主 AI 软件工程师平台，旨在打破商业编程助手在私有化部署与底层调度上的黑盒壁垒。平台以全自主代理为核心，赋予智能体在受控沙盒中调度终端、运行测试、操控无头浏览器及检索编辑代码仓库的全栈工程能力。无论是修复复杂 Issue、跨版本依赖升级，还是自动化编写回归测试，它均能通过自主推理与错误自愈实现闭环交付。理解其开源哲学、搭建容器化安全沙盒并筑牢权限防线，是团队安全引入自主智能体的核心基石。

开源自主软件工程师架构演进与生态解构

在生成式编程演进中，开发者意识到单点补全对复杂工程提效的局限。真实软件研发包含大量交互探索任务：运行构建脚本确认报错堆栈、查阅在线文档定位接口变动、在终端排障并反复修正代码。OpenHands 的架构突破正是将这一认知循环（Observe-Reason-Act）实现了自动化抽象。系统基于事件驱动架构组织智能体运行时，支持接入 Claude 3.5 Sonnet、GPT-4o 及本地部署开源大模型，实现模型无感知的自由调度，让团队彻底摆脱云厂商锁定。

基于容器沙盒的安全隔离与自托管实战

自主智能体具备执行 Shell 命令的权限，建立坚固的运行时边界是自托管的首要前提：

Docker 虚拟化执行环境与文件系统沙盒

平台要求所有代码修改与终端指令必须运行在独立 Docker 容器沙盒中，通过内核命名空间与资源限制杜绝越权访问宿主机。以下为典型的 Docker Compose 自托管部署配置：

services:
  openhands:
    image: docker.all-hands.dev/all-hands-ai/openhands:latest
    container_name: openhands_app
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:latest
      - WORKSPACE_BASE=/opt/workspaces
      - LLM_MODEL=anthropic/claude-3-5-sonnet-20241022
      - LLM_API_KEY=your_secure_api_key
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/opt/openhands/data
      - ./workspaces:/opt/workspaces

该脚本通过暴露受控的 Docker 套接字驱动动态沙盒生成，并将持久化目录映射进容器，为智能体提供既具备高自由度又受严格隔离的虚拟开发车间。

Agent 运行时状态机与持久化会话机制

为保障长时间复杂任务的可靠推进，Agent 运行时设计了完备的状态机与会话持久化机制。智能体执行过程中的每一步操作、工具调用的输入输出参数以及生成的中间代码版本，均被实时记录在底层事务事件流中。遇到网络波动或模型响应超时，会话可毫秒级实现断点续传与重试恢复，避免任务意外中断导致进度前功尽弃。

核心多模态工具链与端到端任务闭环

区别于纯文本工具，平台配备了专业的多模态交互工具箱。除标准文件读写与 Git 操作外，其内置浏览器工具允许智能体自主启动无头 Chromium 实例，实地访问前端开发服务器并截屏核验 UI 渲染效果。通过将渲染截图与 DOM 树结构反馈给视觉多模态大模型，智能体能敏锐捕获页面排版错位与控制台报错，在不依赖人工肉眼审查的情况下完成全自动前端自测与修复。

企业级权限边界收敛与生产代码审查防线

在将开源智能体融入企业 CI/CD 流水线时，团队必须坚持最小必要权限原则。首要法则是绝不在智能体沙盒中挂载生产数据库凭据或高权限云凭证，初期应限制其仅具备只读检索与生成草稿 PR 的权限。此外，团队必须建立严格的人类在环终审门禁：无论智能体生成的修改与测试结果如何完备，所有提交合并入主干前必须经过资深工程师的人工复核，确保系统逻辑与架构规范的绝对严谨。