01WHAT IT SOLVES
这个项目解决什么问题？
OpenHands 当前以 Agent Canvas 作为统一控制界面，面向希望集中管理编码代理、对话会话与自动化任务的开发者。它既能运行内置 OpenHands 代理，也可接入支持 Agent Client Protocol 的第三方代理，并通过 Agent Server 在本机、容器、虚拟机或云端执行。与单一编程助手相比，它更接近常驻的开发任务控制台；与单纯 CI 工具相比，它还支持由提示词、计划任务和 Webhook 触发的代理工作流，但后端、SDK、客户端与自动化服务分属多个仓库，部署和二次开发需要理解其边界。
02CORE CAPABILITIES
核心能力
多代理统一入口
内置 OpenHands，并支持 Claude Code、Codex、Gemini、Pi、OpenCode 及其他 ACP 兼容代理
灵活后端部署
可在本机、Docker、虚拟机、OpenHands Cloud 或 Enterprise 基础设施运行代理
自动化工作流
支持按计划或 Webhook 事件触发代理任务，并连接 Slack、GitHub、Linear、Notion 等服务
自带模型选择
允许使用不同大语言模型，不绑定单一模型提供商
隔离式执行
支持为不同会话配置独立 Docker 沙箱、Agent Server 与工作区
03适合谁
- 需要在本地或自有服务器上运行编码代理的开发者
- 希望统一切换多个代理后端的团队
- 需要定时或按事件触发自动化的工程团队
- 关注自托管安全与容器隔离的技术负责人
04典型使用场景
- 在本地工作区中启动编码代理并持续查看会话结果
- 将 GitHub Issue 拆分为任务并交由代理处理
- 定时生成报告并发布到 Slack
- 混合使用本地、远程和云端代理处理不同项目
05为什么值得关注
- 前端控制中心、Agent Server、SDK 与自动化服务职责明确，生态边界逐渐清晰
- ACP 与多后端支持降低了从单一代理切换到统一工作台的迁移成本
- 近几个版本持续补充自动化模板、服务账户、主题和会话稳定性能力
- 自托管、容器与云端三种路径兼顾个人实验和团队基础设施需求
06采用前要注意
- 不使用沙箱直接运行 Agent Server 时，代理拥有本机文件系统的完整访问权限
- Docker 部署涉及工作区权限、持久卷、SELinux 标签及容器用户配置
- 项目由多个仓库共同实现，修改行为前需确认功能所属的 SDK、客户端或自动化仓库
- macOS 应用尚未使用 Apple Developer ID 签名，系统可能因 Gatekeeper 隔离而提示文件损坏
07RELEASE INTELLIGENCE
近期版本变化
OpenHands v1.39.0：自动化筛选与会话稳定性更新
本次更新为自动化看板增加按负责人筛选及服务账户选项，补充 Paper 主题并优化功能映射展示，同时修复恢复会话时间、WebSocket 过滤、HTTP 会话交付和后端配置可用性等问题。自动化管理员及自托管用户值得留意其稳定性变化。
- 自动化看板支持按负责人筛选，并提供服务账户选项
- 恢复会话时间按 UTC 解释，WebSocket 与 HTTP 交付路径得到修复
- 自动化事件键下拉框和后端配置可用性得到修正
- Paper 主题和 Canvas 功能映射界面得到更新
OpenHands v1.38.0：预算展示与自动化配置增强
本次更新加入对话预算语义计量、Paper 主题和已解决会话横幅，允许在自动化帮助中编辑可执行插件配置，并让提示词与插件预设从代理配置运行。同时修复 Docker 状态持久化、工作区挂载、模型配置竞态和聊天停止行为。使用自动化及容器部署的用户建议关注。
- 对话预算通过语义计量形式展示
- 自动化帮助支持编辑可执行插件配置，提示词与插件预设可从代理配置运行
- Docker 会话工作区与持久卷得到保留，绑定挂载不可写时会快速失败
- 修复模型配置竞态、聊天停止语义和代理配置保存问题
OpenHands v1.37.0：自动化图解与聊天性能改进
本次更新为自动化任务增加 Mermaid 图解，帮助理解执行结构，并修复恢复会话排序、启动阶段标题显示、历史回放等待和基础路径访问问题。聊天实时更新不再重复扫描历史记录，长期运行多会话的开发者可关注此次改进。
- 自动化任务可通过 Mermaid 图解说明
- 恢复会话按 UTC 历史顺序排列，生成标题在启动交接期间保持可见
- 聊天实时更新避免重复扫描历史记录
- 修复空聊天建议过早出现及无尾斜杠基础路径加载失败
OpenHands pr19394-evidence：自动化配置问题临时证据
这是一个仅用于保存自动化设置阻塞问题证据的临时版本，包含自动化设置流程的浏览器操作记录与解码后的分析载荷，不属于面向用户的产品功能发布。相关维护者可在 PR 审核完成后删除，官方说明未提供更多细节。
- 收录自动化设置死路问题的浏览器操作证据
- 收录解码后的自动化设置阻塞分析载荷
- 仅作证据存储，可在 PR 审核后删除
OpenHands v1.36.0：自动化模板与仓库接入扩展
本次更新扩充 Bitbucket Data Center、Azure DevOps 与 GitHub 自动化模板，引入默认模板推荐、服务账户运行，并统一自动化创建、查看和编辑流程；同时修复 Windows 路径、ACP 设置写入和设置助手保存问题。依赖模板化自动化的团队值得评估这些变化。
- 新增并完善 Bitbucket Data Center、Azure DevOps 和 GitHub 模板
- 自动化可作为服务账户在 Canvas 中运行
- 统一自动化的创建、查看与编辑流程
- 修复 Windows 工作区路径、ACP 后端设置和云端草稿保存问题
OpenHands v1.35.0：智能体状态展示与自动化控制完善
该版本强化聊天中的启动进度、实时智能体状态和工具调用分组，并为自动化增加事件源视图、模板匹配及 keep_alive 编辑，同时加入文件下载和服务端会话标签。依赖聊天状态判断执行过程或维护自动化的团队值得升级关注，其他用户主要受益于文件管理和侧栏交互改进。
- 聊天界面显示启动进度、实时智能体状态，并将钩子、推理与工具调用分组呈现。
- 自动化新增事件 Webhook 来源视图，并可查看和编辑 keep_alive 设置。
- 文件标签页加入下载按钮，工作区与仓库元数据改为服务端会话标签持久化。
- 侧栏支持拖动调整宽度，并改善云端仓库选择、会话恢复和模型配置错误反馈。
OpenHands v1.34.0：会话级容器运行与安全修复
本版本加入每个会话独立 Docker 运行时的配置入口，并增强自动化标签、共享范围提示和工作区沙箱启动方式，同时修复密钥传递、外部链接安全及多项界面问题。重视隔离运行或自托管安全的团队值得重点关注。
- 支持为每个会话配置独立 Docker 运行时
- 新增运行时设置页面并优化沙箱启动入口
- 修复会话密钥通过环境变量传递的问题
- 限制不可信 Markdown 设置任意链接目标和打开方式
OpenHands v1.33.0：云端登录与密钥保护修复
本次更新改善 DigitalOcean Web 构建的登录保持能力，并调整新智能体的默认虚拟机规格。自动化运行阶段显示、配置弹窗和文档维护也有更新，同时对请求与设置表单中的密钥值进行遮蔽。使用云端部署或敏感配置的团队应关注升级，但仍需自行确认环境安全配置。
- DigitalOcean Web 构建可在重启后保持登录状态
- 新智能体默认使用规格更小的虚拟机
- 请求与设置表单中的密钥值会被遮蔽显示
- 修复实时自动化 current_phase 渲染及配置弹窗交互问题
OpenHands v1.32.0：扩展自动化仓库与安装选择
该版本把固定自动化任务保存到 Agent Server 设置，允许 MCP 安装对话框选择可安装的库，并在自动化选择器中列出各可克隆提供方的仓库；Canvas 默认减少后端日志噪声。依赖维护还引入第三方发布包七天的发布年龄策略并升级相关组件。macOS 安装仍可能因未签名而被 Gatekeeper 拦截，官方给出了清除隔离标记的处理说明。
- 固定自动化任务可保存到 Agent Server 设置
- MCP 安装对话框可选择不同库安装选项
- 自动化选择器可列出可克隆提供方的全部仓库
- 后端日志默认更安静，并引入七天依赖发布年龄策略
OpenHands v1.31.0：收紧自托管凭据与集成流程
该版本修复自托管实例在 GitHub 已连接时仍暴露令牌字段的问题，并完善 MCP OAuth 安装、放弃登录提示和自动化仓库编辑后的保留；Mars/Web 桥接与 DigitalOcean 会话恢复也得到修正。它主要影响使用自托管自动化和外部集成的团队，升级时值得核对凭据与 OAuth 流程。官方同时提示 macOS 构建尚未签名，可能被系统标记为损坏。
- GitHub 已连接时，自托管实例不再显示令牌秘密字段
- MCP 仅支持 OAuth 的条目可通过其 OAuth 流程安装
- 编辑自动化时保留已选仓库
- 修正 Mars 会话传递及 DigitalOcean 认证恢复问题
COMPARISON PATH
继续对比同类方案
不要只看单页结论；沿同类用途继续比较能力边界、硬件门槛与维护状态。