OpenHands 离线安装包

简介

OpenHands 是一个围绕 AI 代理构建的开源软件开发平台，前身为 OpenDevin。代理能够检查你的代码仓库、编辑文件、执行命令并运行测试，把写代码、改 Bug、查资料这类重复劳动接管过来。它面向需要在内网、隔离网络或本地环境中使用 AI 编程助手的开发者、运维人员与技术学习者。核心优势在于开源且可自部署：既能跑在个人笔记本上，也能跑在 Mac Mini 这类专用设备或云端服务器上，并提供图形界面、终端 CLI 与本地部署等多种形态，运行位置与执行环境由你自己决定。

核心功能

• 代理可检查代码仓库、编辑文件、执行命令并运行测试，覆盖从读懂项目、做出改动到验证结果的完整链路。
• 支持修改和优化现有代码，并自动搜索技术方案，用于排查 Bug、重构实现与补齐缺失逻辑。
• CLI 形态通过 pip install openhands 获取，无需 Docker，命令直接在当前开发环境中执行。
• GUI 与本地部署形态依赖 Docker，相关教程要求先确保 Docker 已安装并运行，再在项目目录下启动服务。
• 提供 Process 沙箱与远程沙箱两种执行环境，可按网络条件与隔离要求选择其中一种运行代理任务。
• 可一键连接 GitHub 对接仓库，也能接入多种大语言模型的 API 来驱动编码任务。
• 提供开源版，以及面向团队的 Team、Enterprise 计划，控制能力与扩展范围以官方定价页为准。

使用场景

• 内网或无外网的开发机：把离线获取的安装介质与本地模型端点配合使用，减少对外网的持续依赖。
• 个人本地部署 AI 编程助手：在自己机器上跑服务，需要从外部访问时按 cpolar 教程注册账号、下载客户端并建立穿透通道。
• 终端内开发：习惯命令行的开发者直接用 CLI，在项目目录里让代理读代码、改文件、跑测试，不切换到图形界面。
• 存量项目维护：让代理自动优化项目代码、修改和优化既有实现，并自动搜索技术方案来定位问题。
• GitHub 仓库协作：一键连接 GitHub 处理仓库问题；有第三方报道称其在软件工程基准测试中解决了 50% 以上的真实 GitHub 问题。
• 团队使用：小团队先用开源版自部署，需要更强控制与扩展能力时再评估 Team、Enterprise 计划。

安装与获取步骤

1. 先确定形态：需要图形界面选 GUI（依赖 Docker），只要终端选 CLI（无需 Docker，命令直接在开发环境运行）。
2. 获取发行物：打开 https://github.com/OpenHands/OpenHands/releases 查看官方 Releases 列表，选择与你的平台对应的产物；离线包的文件名、体积与校验值以官方页面为准。
3. CLI 路线：执行 pip install openhands，随后确认 Docker 状态（GUI 场景需 Docker 已安装并运行），最后在项目目录下启动 openhands。
4. macOS 放行：打开 System Settings，进入 Privacy & Security，滚动到 Security 区域点击 Allow Anyway，然后重新运行 OpenHands CLI。
5. GUI 与本地部署路线：先在本机装好 Docker 并启动，再按本地部署教程启动服务；需要外网访问时注册穿透工具账号、下载其客户端并登录。
6. 接入模型：在界面或配置中填入所用大语言模型的 API，支持清单、参数与调用方式以官方文档为准。

与同类方案的区别

• 与 Cursor 这类闭源编辑器相比，OpenHands 开源且可自部署，代码与运行环境都留在自己掌控的机器上。
• 与纯聊天式 AI 助手相比，它是一个会实际执行命令、编辑文件、运行测试的代理，改动可落到仓库并被测试验证。
• 与必须依赖 Docker 的 GUI 方案相比，CLI 不需要 Docker，直接在现有开发环境执行，更适合受限环境。
• 与云端托管的 AI 编程服务相比，本地部署形态可在内网完成主要工作，对外网的依赖更低。

注意事项

• 关于版本号、文件体积、哈希值与价格，本页不作罗列：离线包的这些参数一律以官方页面 https://github.com/OpenHands/OpenHands/releases 与 https://www.openhands.dev/pricing 为准。
• GUI 与本地部署形态依赖 Docker；若 Docker 未处于运行状态，服务与沙箱无法拉起，先确认它已就绪。
• macOS 可能拦截未识别的命令行程序，出现无法打开的提示时按 Privacy & Security 路径放行，再重新运行 CLI。
• 代理会执行命令并改动文件，建议在容器或沙箱内运行，并让仓库处于版本管理之下，便于回退未经确认的改动。
• 模型 API 的可用性、额度与计费由对应模型服务商决定；OpenHands 开源版与 Team、Enterprise 计划的差异以官方定价页为准。
• 第三方文章中的基准测试结论（如解决 50% 以上真实 GitHub 问题）来自外部报道，实际表现取决于所选模型、仓库结构与任务类型。