核心功能
OpenHands 是前身 OpenDevin 更名后的正式名,定位 AI 驱动的开发。agent 在 Docker 沙箱中完成代码操作、命令执行与浏览器交互;Agent Canvas 可调度 Claude Code、Codex 等 ACP agent 做定时与事件触发自动化,提供 CLI、Web、SDK 三形态。
功能亮点
沙箱隔离
agent 在 Docker 沙箱执行,SANDBOX_VOLUMES 限目录。
对话换模型
/model 命令对话中途切换模型且保留全部上下文。
多端编排
自托管控制中心调度多个 ACP 兼容 agent 协作。
三形态接入
uv 装 CLI、Docker 跑 Canvas、SDK 二次开发。
自定义模型 / 模型接入
多厂商支持
经 litellm 接任意模型,官方验证 Anthropic、OpenAI、Mistral;支持 Ollama 等本地模型,LLM_BASE_URL 对接国产。
接入方式
- Web 设置 Settings>LLM 选择提供商与模型
- settings.json 配置 LLM_MODEL、LLM_API_KEY
- LLM_BASE_URL 指向 OpenAI 兼容端点
- 本地模型用 openai/ 前缀标识 Custom Model
- Ollama 需 OLLAMA_CONTEXT_LENGTH 至少 22000
支持模型
Anthropic ClaudeOpenAI GPTMistral AIMoonshotGeminiOllama 本地模型vLLM 部署模型
bash
配置 LLM 后启动 CLI LLM_MODEL=anthropic/claude-sonnet LLM_API_KEY=sk-xxx openhands 本地模型对接 Ollama 兼容端点 LLM_BASE_URL=http://host.docker.internal:11434/v1 LLM_MODEL=openai/qwen3.6:35b-a3b LLM_API_KEY=dummy openhands
适用场景
• 自动化修复 Bug 与补测试
• 生成代码与重构现有仓库
• 定时执行开发自动化任务
• 云端服务器持续运行 agent
安装配置
bash
uv tool install openhands --python 3.12 后运行 openhands;或 curl -fsSL https://install.openhands.dev/install.sh | sh;Docker 部署 ghcr.io/openhands/agent-canvas(Windows 需在 WSL 内运行)
使用方法
首次运行 openhands 会引导配置 LLM(保存于 ~/.openhands/settings.json),随后用自然语言下达任务,agent 在沙箱中读码、改文件、执行命令并迭代修复,可配合 /model 切换模型、接入 MCP 服务器扩展工具。
关键指标
尚未核验对标产品,此处只列本工具自身指标,不做对比结论。
指标OpenHands
价格免费
开源是
上手难度进阶
Token 消耗高
相关工具
同类工具
优点
- 沙箱隔离安全执行
- 任意 litellm 兼容模型可换
- CLI/Web/SDK 形态丰富
- 自动化编排能力强
缺点
- 本地模型需大上下文才稳定
- Windows 需借助 WSL 或 Docker
- 企业功能需付费云服务