01WHAT IT SOLVES
这个项目解决什么问题？
OpenHands 是一个面向编码代理的自托管控制台与自动化平台，把运行 AI 编码代理从本地 CLI 升级为可长期在线、可远程调度、可多人协作的后台服务。它通过统一的 Agent Server REST API 承载多个代理进程，由前端负责会话与多后端切换，再叠加 Automation Server 提供定时和事件触发的调度能力。在同类方案中，它定位于代理运行与编排层，区别于纯 SDK 或纯 IDE 插件，强调对多种代理实现（OpenHands 自家代理、Claude Code、Codex、Gemini，以及任何符合 Agent-Client Protocol 的代理）和多种 LLM 提供商的开放支持，并通过多仓库协同提供前端、Python SDK、TypeScript 客户端与自动化服务。
02CORE CAPABILITIES
核心能力
多代理多后端接入
同时支持 OpenHands、Claude Code、Codex、Gemini 及任何符合 Agent-Client Protocol 的代理，可在本地、Docker、虚拟机与云端后端间切换
自托管架构与 REST Agent Server
通过 OpenHands Agent Server 提供 REST API，单机可承载多个代理进程，控制台可连接多台服务器并来回切换
自动化与外部集成
配合 Automation Server 创建按计划或 Webhook 触发的自动化，并连接 Slack、GitHub、Notion、Linear 等第三方服务
模型与提供商可替换
支持自带任意 LLM 提供商，并可在云端设置中管理订阅、API Key 与默认或免费模型标记
桌面端与扩展机制
提供桌面端安装包（含 Linux deb）与 Canvas 扩展机制，允许加载自定义页面与脚本
03适合谁
- 希望自托管 AI 编码代理、避免把代码完全交给外部服务的研发团队
- 需要把代理接入 Slack、GitHub、Linear、Notion 等业务工具的平台或 DevOps 工程师
- 已经在使用 Claude Code、Codex、Gemini 等第三方代理、希望统一管理后端的个人或小团队
- 运维 Mac Mini、虚拟机或云服务器、希望长期在线运行代理的独立开发者
04典型使用场景
- 在云端服务器上长期运行代理，用于代码评审、依赖更新等后台任务
- 把生成周报并发到 Slack、或把 GitHub Issue 拆解成任务等流程做成定时或 Webhook 触发的自动化
- 在本地与远程后端之间无缝切换，个人代理跑在笔记本、团队代理跑在共享服务器
- 在同一界面下使用 OpenHands、Claude Code、Codex 等不同代理，灵活选择模型与厂商
05为什么值得关注
- 由 OpenHands 自家代理延伸出独立控制台，定位从代理实现扩展到代理编排层
- 显式支持 Agent-Client Protocol，未来可兼容更多第三方代理
- 通过 Automation Server 与多后端模型，强调企业自托管与长期在线场景
- 近期版本持续补齐云端 LLM 接入、桌面端安装包、Canvas 扩展等工程化能力
06采用前要注意
- 默认无沙箱运行方式会赋予代理对本地文件系统的完全访问权限，存在误操作风险
- 自托管需要 Node.js 22.12 以上、uv、Docker 等环境，并涉及公网暴露与权限安全配置
- 自身只是控制台与编排层，编码效果取决于所选代理实现与 LLM 提供商能力
- 自动化能力依赖 Slack、GitHub、Notion、Linear 等第三方服务的账号与权限配置
07RELEASE INTELLIGENCE
近期版本变化
OpenHands v1.18.0：自动化权限收紧并支持云端后端编辑
v1.18.0 重点收紧自动化权限并完善云端后端可管理性。具体包括只有创建者可重新开启自动化、支持在云端后端上编辑自动化、显示自动化运行时使用的身份，并把默认与免费模型标记改为由数据库驱动。影响混合使用本地与云端后端、依赖自动化做日常工作的团队，应关注权限模型变化。
- 自动化权限收紧，仅创建者可重新开启
- 支持在云端后端上编辑自动化
- 自动化运行时显示所使用的身份
- 前端默认与免费模型标记改为读取数据库
OpenHands v1.17.0：云端 LLM 接入与对话标签过滤上线
v1.17.0 集中扩展云端能力与对话管理，包括在云端启用 LLM 提供商连接、统一云端设置入口、新增对话标签与过滤、本地 Planner 支持、把自动化权限拆分为查看与管理两档，并修复多项与桌面端、CI、依赖安全相关的 Bug。影响在云端订阅 LLM、对长会话进行筛选分类、依赖 DOMPurify 安全补丁的用户。
- 启用云端 LLM 提供商连接并提供统一设置入口
- 对话面板支持标签与过滤
- 自动化权限拆分为 view 与 manage，新增创建者逃生口
- 修复 DOMPurify 净化绕过等安全相关问题
OpenHands v1.16.0：Linux 桌面版与 LLM 切换开关落地
v1.16.0 引入 Linux 桌面安装包、新增 LLM 切换开关与按提供商选择模型、上线 Canvas Extensions 前端、把侧边栏首页可固定为收藏页面、并在设置中提供技能显式白名单。同时修复多项 CI、本地与云端后端相关 Bug。影响偏好桌面端部署、需要精确控制 LLM 与技能启用的用户。
- 新增 Linux 桌面安装包构建
- 设置中暴露 LLM 切换开关并支持按提供商选择
- Canvas Extensions 前端（页面、侧边栏、自定义）落地
- 技能目录由全部启用改为显式白名单
OpenHands v1.15.0：入门清单与自动化目录持续打磨
v1.15.0 偏重新用户体验与自动化面板，包括侧边栏新增带设置开关的入门清单、Files 视图显示工作区路径、自动化可安装附带脚本包的目录项、本地 Agent Server 上线 LLM 提供商连接 UI，以及自动化面板、推荐栏、新建与导入流程的整体润色。同时新增会话概览面板与统一 commits 抽屉。影响刚开始部署 OpenHands、需要更直观看到运行进度与历史的用户。
- 侧边栏增加带设置开关的入门清单
- 自动化可安装带脚本包的目录条目
- 本地 Agent Server 引入 LLM 提供商连接 UI
- 会话新增概览面板与统一 commits 抽屉
OpenHands v1.14.0：结构化错误与 LLM 预校验上线
v1.14.0 在稳定性与可用性上做了多项加固：前端以结构化错误展示结果、新增 LLM 预校验以阻止保存错误配置、自动化模块新增 Git Sync 页面、默认模型切换为 Kimi K3 并标记为免费。影响所有需要避免配置错误、关心 Git 自动同步、希望使用免费默认模型的用户。
- 前端改为展示结构化错误结果
- 新增 LLM 预校验，阻止保存错误配置
- 自动化模块新增 Git Sync 页面
- 默认模型切换为 Kimi K3 并标记为免费
OpenHands v1.13.0：版本变化解读
OpenHands 发布了 v1.13.0。当前中文解读尚未完成，请以官方 Release 页面列出的变更和兼容性说明为准。
- 官方 Release 已发布，建议打开来源核对完整变更。
- 自动解读信息不足，升级前应重点查看兼容性与迁移说明。
OpenHands v1.12.0：版本变化解读
OpenHands 发布了 v1.12.0。当前中文解读尚未完成，请以官方 Release 页面列出的变更和兼容性说明为准。
- 官方 Release 已发布，建议打开来源核对完整变更。
- 自动解读信息不足，升级前应重点查看兼容性与迁移说明。
OpenHands v1.11.0：成本可见与桌面重命名
在活动日志与导出中显示单次运行的 LLM 成本，自动化与会话新增标签能力，桌面应用正式更名为 OpenHands Agent Canvas 并补齐多尺寸图标。关注成本核算与桌面部署的用户可重点跟进。
- 活动日志与导出显示单次运行 LLM 成本
- 自动化与会话引入标签筛选与芯片展示
- 桌面应用更名为 OpenHands Agent Canvas 并提供多尺寸图标
- 新增类型化智能体动作以启动本地或云端子对话
OpenHands v1.10.0：默认模型更换与自动化面板升级
本次更新将默认模型切换为 GLM 5.2，推出自动化推荐仪表板、活动日志导出、技能页面分面筛选与自动化接口子页路由，并修复若干安全与依赖漏洞；影响所有自托管部署，建议升级。
- 默认模型更新为 GLM 5.2
- 新增自动化推荐仪表板
- 技能页面增加分面筛选与活动日志导出
OpenHands v1.9.0：扩展 manifest 与多后端选择器
v1.9.0 新增域中立的扩展 manifest 主机、精简的 Cloud 与 Agent Server 后端选择器、聊天内实时代理活动显示，并将自动化 UI 由 interface manifest 驱动；同时修复 Agent Profile 默认标签、失败消息关闭、CANCELLED/SKIPPED 状态显示、运行时服务路由等多项问题，文档同步更新架构表与 AGENTS.md 指南。影响关注扩展能力与多后端接入的用户；属功能与稳定性改善，官方说明未提供更多细节。
- 新增域中立扩展 manifest 与聊天内实时活动
- 精简 Cloud 与 Agent Server 后端选择器
- 修复 CANCELLED/SKIPPED 状态显示等多项 Bug
COMPARISON PATH
继续对比同类方案
不要只看单页结论；沿同类用途继续比较能力边界、硬件门槛与维护状态。