OpenHands：让 AI 自主编码的开源编程代理

> 分类：开源推荐 | 发布时间：2026-05-18

![OpenHands 架构图](https://mrdoc.wangziheng.vip/media/202605/2026-05-18_091116_0447610.6710821469679801.png)

## 一句话介绍

OpenHands（原 OpenDevin）是一个开源的 AI 自主编程代理平台，能够理解自然语言需求、编写代码、执行命令、浏览网页并自主迭代，直到任务完成——就像给 AI 配备了一台完整的开发电脑。

## 核心亮点

- **自主编程**：AI 代理能独立完成从需求理解到代码提交的全流程，无需逐步指令
- **多 LLM 支持**：兼容 Claude、GPT-4、Gemini、DeepSeek 等主流大模型，按需切换
- **沙盒执行**：基于 Docker 的安全隔离环境，AI 可以自由运行代码而不影响宿主系统
- **Web 浏览**：内置浏览器能力，AI 可自主搜索文档、查阅 API 参考手册
- **Git 集成**：自动创建分支、提交代码、发起 Pull Request，完整工作流支持

![核心功能模块](https://mrdoc.wangziheng.vip/media/202605/2026-05-18_091116_5754380.09114753684592358.png)

## 快速上手

### 安装

```bash
# 使用 pip 安装
pip install openhands

# 或使用 Docker 一键启动
docker run -it \
  -e LLM_API_KEY=your-api-key \
  -p 3000:3000 \
  ghcr.io/all-hands-ai/openhands:latest
```

### 配置 LLM 后端

```bash
# 设置 API Key（支持多种 LLM 提供商）
export LLM_API_KEY=sk-xxx
export LLM_MODEL=claude-sonnet-4-20250514

# 或使用本地模型
export LLM_MODEL=ollama:codellama
```

### 启动并使用

```bash
# 启动 OpenHands
openhands start

# 在浏览器打开 http://localhost:3000
# 输入任务描述，例如：
# "创建一个 Flask REST API，支持用户 CRUD，使用 SQLite 作为数据库"
```

![快速上手流程](https://mrdoc.wangziheng.vip/media/202605/2026-05-18_091117_0363050.5677741116381088.png)

## 适用场景

| 场景 | 推荐指数 | 说明 |
|------|---------|------|
| 快速原型开发 | ⭐⭐⭐⭐⭐ | 描述需求即可生成完整项目骨架 |
| Bug 修复 | ⭐⭐⭐⭐⭐ | 提供错误信息，AI 自主定位并修复 |
| 代码重构 | ⭐⭐⭐⭐ | 大规模重构任务，AI 辅助逐文件修改 |
| 自动化测试 | ⭐⭐⭐⭐ | 根据代码自动生成测试用例 |
| 学习编程 | ⭐⭐⭐ | 观察 AI 的编码过程，学习最佳实践 |
| 文档编写 | ⭐⭐⭐ | AI 可根据代码生成文档，但需人工审核 |

## 与同类项目对比

![同类产品对比](https://mrdoc.wangziheng.vip/media/202605/2026-05-18_091117_7163380.9152049063686595.png)

**对比总结**：

- **vs Cursor**：OpenHands 更自主（能独立完成整个任务），而 Cursor 更偏向辅助（需要开发者驱动）
- **vs Aider**：OpenHands 有沙盒环境和浏览器能力，适用场景更广
- **vs SWE-Agent**：OpenHands 支持更多 LLM 后端，Web UI 更友好，社区更活跃

## 核心架构解析

OpenHands 采用 **Agent Loop** 架构：

```
User Prompt → Agent (LLM) → Action → Observation → Agent (LLM) → ... → Done
```

1. **理解阶段**：LLM 解析用户需求，制定执行计划
2. **编码阶段**：Agent 通过 Code Editor 动作修改源代码
3. **执行阶段**：Agent 通过 Terminal 动作运行命令、安装依赖
4. **验证阶段**：Agent 检查输出，判断是否需要迭代
5. **提交阶段**：Agent 通过 Git 动作提交最终成果

每个动作都在 Docker 沙盒中执行，确保安全性。

## 实战示例

### 示例：让 AI 构建一个 CLI 工具

```
提示词：创建一个 Python CLI 工具，功能是将 Markdown 文件转换为 HTML。
要求：
1. 支持 GitHub Flavored Markdown
2. 支持目录生成
3. 支持自定义 CSS 样式
4. 添加 --watch 模式，文件变更时自动转换
```

AI 代理会自动：
1. 创建项目结构和 `pyproject.toml`
2. 编写核心转换逻辑（使用 `markdown` 库）
3. 实现 CLI 入口（使用 `click` 库）
4. 添加 watch 模式（使用 `watchdog` 库）
5. 编写单元测试
6. 运行测试验证
7. 提交代码到 Git

## 相关链接

- **GitHub**：[https://github.com/All-Hands-AI/OpenHands](https://github.com/All-Hands-AI/OpenHands)
- **官方文档**：[https://docs.all-hands.dev](https://docs.all-hands.dev)
- **Discord 社区**：[https://discord.gg/All-Hands-AI](https://discord.gg/All-Hands-AI)
- **Docker Hub**：[https://ghcr.io/all-hands-ai/openhands](https://ghcr.io/all-hands-ai/openhands)

---

*本文由 AI 自动生成，内容基于 2026 年 5 月项目公开信息整理。*