OpenHands GitHub 仓库卡片

OpenHands 是 All-Hands-AI 团队用 Python 和 TypeScript 写的开源 AI 编程代理,9.2 万星、MIT 协议。它把模型放进一个隔离容器,让 AI 自己开终端、读文件、改代码、跑测试、看浏览器,一个任务从描述做到验证,人只负责看结果和拍板,代码和运行环境都在自己机器上。

项目 说明
开源协议 MIT
开发语言 Python、TypeScript
运行方式 Docker 容器 + 浏览器界面
最低配置 4GB 内存,8GB 以上更稳
模型 兼容 OpenAI 接口的都能接,云端模型和本地模型都行
执行环境 代理的操作在容器内完成,可随时打断接管

能干什么

  • 沙箱执行:命令、文件修改、测试都在容器里跑,不直接动你的本机环境
  • 全过程留痕:每一步命令和输出都能回看,出问题知道是哪一步偏的
  • 模型不锁定:换一家模型服务只改配置,不用换工具
  • 可以从 GitHub issue 起任务:把待办丢给它,让它自己定位相关文件
  • 可扩展:支持挂外部工具和数据源,把团队自己的脚本接进去

还有什么要注意的

真要用起来,任务描述比模型更关键:把验收标准写清楚,比如”这几个测试必须全过”、”不要改公共接口”,代理就少走弯路。跑完别直接合并,先看它的命令记录,判断有没有顺手改了不该改的配置。

适合谁,怎么开始

  • 一个人维护多个小项目的独立开发者
  • 想把修 bug、补测试这类重复活交给 AI 的团队
  • 需要可复现实验记录的研究、教学场景
  • 不愿意把源码交给第三方 SaaS 的团队
  1. 装好 Docker Desktop 或 Linux 上的 Docker 引擎
  2. 拉官方镜像启动容器,把模型密钥通过环境变量传进去
  3. 浏览器打开本机端口进入界面,填仓库地址、选模型
  4. 用一句话描述任务,等它自己执行
  5. 中途可以随时打断、人工接管,跑完自己看一遍改动再合并

常见问题

问:会不会把我的代码传出去?

容器在本机跑,但模型推理要调接口,想真正不出网就接本地模型。

问:免费吗?

软件本身免费开源,模型调用按你接的服务商计费。

问:Windows 上能跑吗?

能,前提是装 Docker Desktop 并用 WSL2 后端。

问:和编辑器里的 AI 补全有什么区别?

补全是在你写的地方帮你想下一行,OpenHands 是整个任务交给它执行,定位和边界不一样。

最后更新:2026-10-31

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。