OpenHands 是一个开源的 AI 软件开发智能体平台:你给它一个开发任务,它在自己的运行环境里读代码、改代码、跑命令,干完把结果交回来,像一个能接 issue 的远程同事。MIT 许可证,GitHub 实时 93,673 星(本站核对:2026-11-18)。本文安装步骤以官方 README 为准,本站未实机部署——它的部署在同类里偏重,第一次跑通预计要留出专门的时间。
能干什么
- 接完整的开发任务:不是补一行代码,而是「修这个 bug」「加这个功能」级别的整活:它自己翻仓库、定位、动手、验证。
- 在隔离环境里干活:通过 Docker 在本机跑,任务在一个 Web 画布(canvas)里操作与观察,项目目录以挂载方式给它,状态有独立的数据卷保存。
- 给团队留了口子:官方仓库里同时有面向本地的画布形态与更完整的部署形态,具体形态与版本以官方文档为准。
优缺点
优点:任务粒度大、自治程度高,适合把定义清楚的开发任务整件外包;开源 MIT,自托管,代码不出自己的机器与仓库边界;用 Docker 隔离,试坏了删容器重来,不污染本机环境。
缺点与边界:部署与配置是同类里偏重的一档(Docker、数据卷、项目挂载、模型接入都要配);它干活要消耗大量模型调用,任务越大账单越明显,先用小任务摸出单任务成本;自治越高越要人验收——它交回来的代码必须走你平时的评审与测试流程,不能直接合并上线。
下载与安装(官方 README 口径)
- 前提:本机装好 Docker。先定好两个路径:状态数据卷(保存它的状态)与要挂给它的项目目录(PROJECTS_PATH)。
- 按官方 README 的命令启动(镜像与版本以仓库当前 README 为准,本文核对时为 ghcr.io/openhands/agent-canvas 的 1.41.0 线):把 8000 端口映射到本机回环地址、挂上状态卷与项目目录。
- 浏览器打开 http://localhost:8000/canvas 进入画布。
- 在设置里完成模型接入(选提供商、填密钥),这是所有同类工具共同的第一道配置。
- 验证:先派一个无风险的小任务(例如给一个测试项目加一段注释或写一个小函数),看它能否读到挂载的项目、改对文件、把结果交回来。
调用与使用
- 任务描述写四段:背景(这是什么项目)、目标(要达成什么)、边界(哪些文件或行为不能碰)、验收(怎么算做完,最好是能跑的检查)。
- 先小后大:第一个任务控制在「一个文件、一个明确改动」,跑通整条链再放大。
- 过程要看:在画布里盯它的关键步——读错文件、跑偏方向要尽早叫停,别等它干完一大片再返工。
- 结果走评审:它的产出按「新同事提交」对待:看 diff、跑测试、再决定合并。
调教成自己的
- 把项目的构建、测试命令先在本机验通再交给它:验收命令不存在,它就没法自证做对了。
- 常派的任务做成模板:四段描述留空填,口径固定,质量才稳定。
- 给它的项目挂载范围收紧:只挂要改的仓库,别把整个硬盘敞开。
玩法:独立开发者的「夜班 issue 处理员」
模拟一位独立开发者:白天做新功能,卡点是积压的小 issue(文档错字、小 bug、依赖小升级)永远排不上号。他的打法:
- 下班前把 2–3 个定义最清楚的小 issue 按四段模板写好,派给 OpenHands。
- 第二天先看它的产出:逐个看 diff、跑测试,合格的合并,不合格的写清原因退回重派。
- 只派「错了也容易发现」的活:有测试覆盖、有明确验收的任务;涉及业务判断的活永远留给自己。
- 一周下来算一笔账:处理掉的 issue 数对比模型花费,值不值一目了然,再决定要不要扩大派活范围。
避坑指南
- 端口只绑本机:官方命令把端口映射在 127.0.0.1 上是有道理的,不要图方便改成对公网开放;要远程用,走正规的访问控制。
- 镜像版本认 README:这类项目迭代快,照旧文章抄的镜像名与版本号可能已经过时,以仓库当前 README 为准。
- 先算成本再放大:大任务的模型消耗不便宜,先小任务测单价。
- 产出不过评审不上线:自治程度高不是免检标志。
档案
- 仓库:github.com/OpenHands/OpenHands;许可证 MIT。
- 星数 93,673(2026-11-18 实时核对)。
- 本站验证:仓库 README 的启动命令、端口与挂载口径已核;未实机部署,步骤以官方文档为准。
常见问题
它和 OpenCode、Cline 有什么区别?OpenCode 是坐在你终端里的结对者,Cline 是编辑器里的助手,OpenHands 更像接整件任务的远程执行者:环境自带、任务粒度大、部署也最重。按任务大小选,别按名气选。
不会 Docker 能用吗?本地形态目前以 Docker 为主,不会 Docker 的先学半小时 Docker 基础,或用本站的部署服务把跑通这步交出去。
能让它直接改生产代码吗?技术上能,流程上不要:挂载范围、评审、测试三道关先建好,再谈放大权限。
站内往下读:AI智能体栏目、OpenCode 教程、harness 是什么。



