
OpenHands 是 All-Hands-AI 团队用 Python 和 TypeScript 写的开源 AI 编程代理,9.2 万星、MIT 协议。它把模型放进一个隔离容器,让 AI 自己开终端、读文件、改代码、跑测试、看浏览器,一个任务从描述做到验证,人只负责看结果和拍板,代码和运行环境都在自己机器上。
| 项目 | 说明 |
|---|---|
| 开源协议 | MIT |
| 开发语言 | Python、TypeScript |
| 运行方式 | Docker 容器 + 浏览器界面 |
| 最低配置 | 4GB 内存,8GB 以上更稳 |
| 模型 | 兼容 OpenAI 接口的都能接,云端模型和本地模型都行 |
| 执行环境 | 代理的操作在容器内完成,可随时打断接管 |
能干什么
- 沙箱执行:命令、文件修改、测试都在容器里跑,不直接动你的本机环境
- 全过程留痕:每一步命令和输出都能回看,出问题知道是哪一步偏的
- 模型不锁定:换一家模型服务只改配置,不用换工具
- 可以从 GitHub issue 起任务:把待办丢给它,让它自己定位相关文件
- 可扩展:支持挂外部工具和数据源,把团队自己的脚本接进去
还有什么要注意的
真要用起来,任务描述比模型更关键:把验收标准写清楚,比如”这几个测试必须全过”、”不要改公共接口”,代理就少走弯路。跑完别直接合并,先看它的命令记录,判断有没有顺手改了不该改的配置。
适合谁,怎么开始
- 一个人维护多个小项目的独立开发者
- 想把修 bug、补测试这类重复活交给 AI 的团队
- 需要可复现实验记录的研究、教学场景
- 不愿意把源码交给第三方 SaaS 的团队
- 装好 Docker Desktop 或 Linux 上的 Docker 引擎
- 拉官方镜像启动容器,把模型密钥通过环境变量传进去
- 浏览器打开本机端口进入界面,填仓库地址、选模型
- 用一句话描述任务,等它自己执行
- 中途可以随时打断、人工接管,跑完自己看一遍改动再合并
常见问题
问:会不会把我的代码传出去?
容器在本机跑,但模型推理要调接口,想真正不出网就接本地模型。
问:免费吗?
软件本身免费开源,模型调用按你接的服务商计费。
问:Windows 上能跑吗?
能,前提是装 Docker Desktop 并用 WSL2 后端。
问:和编辑器里的 AI 补全有什么区别?
补全是在你写的地方帮你想下一行,OpenHands 是整个任务交给它执行,定位和边界不一样。
最后更新:2026-10-31
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。
