OpenHands – 开源AI软件工程师Agent使用教程：从入门到精通

从选型到落地的可执行指南，适合个人与团队快速上手。

教程正文

从选型到落地的实战步骤。

一、什么是OpenHands？

OpenHands（前身为OpenDevin）是一款完全开源的AI软件工程师Agent，能够自主理解用户需求、阅读代码、编写代码、运行命令、调试错误，甚至管理整个软件开发流程。它基于大语言模型（如GPT-4、Claude等），通过命令行或浏览器界面与开发者协作，是自动化编程与AI辅助开发的利器。

二、环境准备与安装

2.1 系统要求

操作系统：Linux / macOS / Windows（WSL2推荐）
硬件：至少8GB内存，20GB磁盘空间
依赖：Docker、Python 3.10+、Git

2.2 安装步骤

克隆仓库：git clone https://github.com/All-Hands-AI/OpenHands.git
进入目录：cd OpenHands
配置环境变量：复制.env.example为.env，填入你的LLM API Key（如OpenAI或Anthropic）。
启动服务：make setup（自动拉取Docker镜像并启动）

技巧Tip： 如果Docker拉取速度慢，可更换国内镜像源，在/etc/docker/daemon.json中添加{ "registry-mirrors": ["https://docker.m.daocloud.io"] }。

三、基本使用方法

3.1 通过浏览器访问

启动成功后，打开浏览器访问http://localhost:3000，你会看到一个干净的对话界面。输入你的任务，例如：

请帮我创建一个Python脚本，读取当前目录下的CSV文件，并输出每行的平均值。

OpenHands会分析需求，生成代码、创建文件，并自动执行验证。

3.2 通过命令行CLI

你也可以用CLI模式批量任务：python -m openhands.cli --model gpt-4 --task "修复src/main.py中的空指针异常"

3.3 工作区管理

OpenHands会在./workspace目录下创建一个隔离的沙箱环境，所有文件操作都在此进行。你可以把项目文件夹挂载进去：启动时添加参数-v /your/project:/workspace。

四、高级功能与实战案例

4.1 多文件项目重构

假设你有一个基于Flask的Web应用，希望将路由层、模型层分离。只需告诉OpenHands：

将这个Flask应用重构成MVC模式：把路由放到routes/，模型放到models/，并更新所有import

它会自动创建目录、移动文件、修改引用，并保持功能不变。

4.2 自动编写单元测试

在项目根目录下运行：为src/utils.py中所有函数编写pytest单元测试，覆盖边界情况。OpenHands会生成tests/test_utils.py并执行，失败则自动修正。

技巧Tip： 使用--headless模式时，可以结合CI/CD流水线，在每次提交后自动运行AI修复代码。

4.3 调试与日志分析

当遇到难以定位的bug时，将报错信息或日志贴给OpenHands：

分析以下日志，找出导致服务崩溃的原因： ...（粘贴日志内容）...

它会逐行分析，指出潜在问题并提供修复代码。

五、常见问题与优化建议

5.1 如何提高输出质量？

使用更强大的模型（如GPT-4 Turbo、Claude 3.5 Sonnet）
在.env中设置LLM_TEMPERATURE=0.1降低随机性
任务描述尽量具体，包含输入输出示例

5.2 资源占用过高？

限制Docker内存：在docker-compose.yml中添加mem_limit: 4g。另外，关闭不需要的插件可降低负载。

5.3 安全性注意事项

OpenHands可以执行任意命令，请在容器内运行，不要挂载敏感目录。生产环境建议使用--sandbox模式。

六、总结

OpenHands作为一款开源AI软件工程师Agent，极大提升了开发效率。通过本文的安装、基础使用、高级案例，你应该能立即上手并集成到工作流中。持续关注官方仓库更新，未来还会支持多Agent协作、IDE插件等特性。

现在就试试：给你的项目一个AI助手吧！